Isenção de responsabilidade de tradução: esse conteúdo foi traduzido para sua conveniência com o uso de software e pode não ter sido revisado por uma pessoa. O texto oficial é a versão em inglês e sempre será o texto mais atualizado. Para ver a versão em inglês, clique aqui.
Workflows

Usar webhooks com fluxos de trabalho do HubSpot

Ultima atualização: Setembro 25, 2020

Disponível para

Marketing Hub  Enterprise
Sales Hub  Enterprise
Service Hub  Enterprise

Use webhook em fluxos de trabalho para passar informações do HubSpot para outro aplicativo da web. 

Há uma variedade de usos para webhooks, como enviar dados e notificações por push.

Exemplos de casos de uso populares para webhooks incluem:

  • A publicação dos dados de contatos da HubSpot em outro sistema, como um CRM, quando esse contato preencher um formulário específico no seu site.

  • O envio de dados do negócio para um sistema de tratamento de envio externo para criar um pedido de compra.

  • O envio de alertas de chat do seu sistema externo para o fluxo de chat da sua empresa, que permite que os funcionários sejam informados de algo importante.

O HubSpot regula o tráfego de webhook separadamente de outros processos de fluxo de trabalho. Isso é feito para simplificar o fluxo de trabalho e o desempenho do webhook. Quando um webhook estiver lento ou expirado, a ação do fluxo de trabalho poderá demorar mais do que o esperado para ser executada.

Observação: o HubSpot tentará novamente os webhooks por até 3 dias.

Para obter mais informações sobre os aspectos técnicos dos webhooks, confira nossa documentação de desenvolvedores.

 Configurar um webhook no seu fluxo de trabalho

Observação: As contas do Marketing Hub Professional ou as licenças do Sales Hub Professional adquiridas antes de 1º de novembro de 2018 têm acesso à ação de fluxo de trabalho Disparar um webhook. 
  • Na sua conta da HubSpot, navegue até Automação > Fluxos de trabalho.
  • Clique no nome do fluxo de trabalho.
  • Clique no ícone de + para adicionar uma ação.
  • No painel direito, selecione Acionar um webhook.
  • Digite o URL do webhook. As URLs de webhook estão restritas a um protocolo seguro e devem começar com HTTPS.
  • Marque a caixa de seleção Assinar assinatura de solicitação para autenticar todas as solicitações ao seu webhook e insira seu ID do aplicativo . Saiba como verificar assinaturas de solicitação.
  • Clique em Salvar.

Observação: a ação Acionar um webhook só suporta o método POST.

Teste seu webhook

Depois de criar seu fluxo de trabalho com uma ação de webhook, você pode executar um teste rápido com uma URL fictícia de webhook. Em seu navegador, navegue até https://webhook.site e copie o URL exclusivo que é criado automaticamente. No campo de Webhook URL em sua ação de webhook, cole a URL.

trigger-a-webhook-action

O exemplo abaixo mostra o Corpo da solicitação do webhook acima, que revela metainformações sobre um contato específico, incluindo informações do contato, envios de formulário, associações de lista, etc. Quando a ação do fluxo de trabalho foi acionada, o HubSpot enviou todo o registro do contato formatado em JSON para o URL especificado.

User-added image

O sistema de recebimento pode, então, analisar os dados JSON e usá-los para seu próprio aplicativo.

Observação: os valores de propriedade antigos serão devolvidos apenas em fluxos de trabalho baseados em contato. Os webhooks usados em todos os outros tipos de fluxo de trabalho retornarão o valor mais recente.

Saiba mais sobre webhooks na documentação dos webhooks dos desenvolvedores. Se você tiver dúvidas sobre sua implementação específica de webhooks com o HubSpot, entre em contato com o HubSpot Developers Forums.

Verificar assinaturas de solicitação em webhooks de fluxo de trabalho

Quando você selecionou Solicitar assinatura na seção Autenticação da ação Acionar um webhook, o HubSpot preencherá o webhook com um cabeçalho X-HubSpot-Signature um hash SHA-256 da concatenação do aplicativo secreto para seu aplicativo, o método HTTP, o URI e o corpo não analisado. Saiba mais sobre isso na documentação dos desenvolvedores.

Para verificar se as solicitações recebidas no seu URL são do HubSpot:

/pt/Workflows/How-do-I-use-webhooks-with-HubSpot-Workflows