Central de conhecimento HubSpot

Definir gatilhos de fluxo de trabalho 'Quando um webhook é recebido'

Written by HubSpot Support | 29/jul/2025 18:19:55

Defina gatilhos de inscrição para inscrever automaticamente registros em um fluxo de trabalho quando um webhook for recebido de um terceiro externo. Saiba mais sobre como configurar o inscrevo de fluxo de trabalho .

Observação:

  • O fluxo de trabalho só será acionado se houver um registro existente com um valor de propriedade exclusivo correspondente na sua conta HubSpot.
  • Os gatilhos do webhook suportam apenas dados de entrada enviados com o aplicação/json tipo de conteúdo.


Para acionar um fluxo de trabalho de um webhook:

  1. Clique no nome de um fluxo de trabalho existente ou crie um novo fluxo de trabalho.
  2. Se você estiver criando um fluxo de trabalho do zero:
    • No painel esquerdo, clique para expandir a Eventos personalizados & eventos externos seção.
    • Clique em Recebeu um webhook de um aplicativo externo
  3. Se você estiver trabalhando em um fluxo de trabalho existente:
    • No editor de fluxo de trabalho, clique no cartão inscrevo de Gatilho para [objeto].
    • Se houver gatilhos de fluxo de trabalho existentes, no painel esquerdo, clique em Alterar gatilhoinicial. Isso apagará todos os disparadores de registro atuais. 
    • Na caixa de diálogo, clique em Confirmar.
    • No painel esquerdo, em Opções avançadas, clique em Quando um webhook for recebido.
  1. Para adicionar um novo webhook, clique em + Adicionar um webhook . Você pode criar até 100 eventos de webhook exclusivos.

 

  1. Adicione um nome de evento de Webhook . Em seguida, clique em Próximo.
  2. Copie o URL do Webhook e cole-o na página de configurações do webhook do aplicativo com o qual deseja integrar. No seu aplicativo, use a URL do webhook para enviar um evento de teste.

     

     
  3. Na seção Revise seu evento de teste, revise o evento de webhook e faça as edições necessárias. Em seguida, clique em Próximo.
  4. Mapeie os dados das propriedades do seu webhook:
    • Edite o rótulo da propriedade do HubSpot conforme necessário.
    • Clique no menu suspenso Tipo de dados para selecionar um tipo de dados para cada rótulo de propriedade.
      • Você pode usar string, enumeração, número e valores booleanos.
      • As propriedades de data e hora não são suportadas e devem ser mapeadas como valores de string. Depois, você pode usar uma ação de código personalizada com strtotime para converter em um objeto de data e hora e, em seguida, usar unixtimestamp para obter uma marca de data e hora. 
    • Para remover um rótulo de propriedade, clique no ícone Excluir.
  5. Clique em Próximo.
  6. Corresponda a propriedade de inscrição selecionando uma propriedade do seu webhook de terceiros que corresponda exatamente à propriedade personalizada do HubSpot. Em seguida, clique em Próximo.
  7. Clique em Prosseguir para a configuração do gatilho.
  8. Para usar o webhook como um gatilho de inscrição, clique no nome do webhook no painel esquerdo. Em seguida, clique em Salvar.