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 webhook com fluxos de trabalho do HubSpot

Ultima atualização: January 3, 2019

Disponível para

Marketing Hub
marketing-enterprise
Enterprise
Sales Hub
sales-enterprise
Enterprise
Service Hub
service-enterprise
Enterprise

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

Observação: os usuários que compraram o Marketing Hub Professional ou o Sales Hub Professional antes de 1º de novembro de 2018 também terão acesso à ação de fluxo de trabalho do acionador do webhook. Os usuários após 1º de novembro de 2018 precisarão comprar o Marketing Hub Enterprise ou  o Sales Hub Enterprise  para obter acesso à ação Acionador de fluxo do webhook.

O que são webhooks?

Os webhook são usados para enviar dados de um aplicativo da web para outro depois que uma ação é concluída no aplicativo de origem. Você pode usar webhook para enviar dados, notificações, alertas ou quaisquer outras atualizações em tempo real.

Exemplos de casos de uso populares para webhooks incluem:

  • Postar dados de contatos da HubSpot em outro sistema, como um CRM, quando esse contato preenche um formulário específico em seu site.

  • Envio de dados de contato em um sistema externo que cira uma avaliação do software para o contato.

  • Os alertas de chat enviados do seu sistema externo para o fluxo de bate-papo da sua empresa, que permite que os funcionários saibam que algo importante aconteceu.

Configurar um webhook em um fluxo de trabalho baseado em contato

Essas etapas se aplicam somente a fluxos de trabalho baseados em contato.

  • Na sua conta da HubSpot, navegue até Automação > Fluxos de trabalho.
  • Clique no nome do fluxo de trabalho com base em contato para editar.
  • Clique no ícone de + para adicionar uma ação.
  • No painel direito, clique em Acionar um webhook.
  • Clique no menu suspenso Método e selecione GET ou POST.
    • GET - envia uma solicitação GET para o URL especificado.
    • POST - envia uma solicitação POST (envia dados) para o URL especificado.
  • Digite o URL do webhook.

Observação: os URLs do webhook estão restritos a um protocolo seguro e devem começar com HTTPS.

  • Se a solicitação ao seu sistema exigir autenticação, selecione a opção Usar autenticação? e adicione um nome de usuário e senha.
  • Clique em Salvar.

Configurar um webhook em outros tipos de fluxos de trabalho

Essas etapas se aplicam a fluxos de trabalho baseados em empresa, baseados em transações, baseados em tíquetes e orçamentos.

  • Na sua conta da HubSpot, navegue até Automação > Fluxos de trabalho.
  • Clique no nome do fluxo de trabalho baseado na empresa, baseado em transação, baseado em tíquete ou orçamento para editar.
  • Clique no ícone + para adicionar uma ação e, no painel direito, clique em Acionar um webhook.
  • Insira a URL do webhook.

Observação: os URLs do webhook estão restritos a um protocolo seguro e devem começar com HTTPS.

  • Clique em Salvar.

Observação: a ação Acionamento de um webhook em fluxos de trabalho baseados na empresa, baseados em ofertas, baseados em tíquetes e orçados apenas 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, acesse 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.

O exemplo abaixo mostra o corpo da solicitação do webhook acima, que revela informações meta sobre o contato específico, incluindo informações de contato, envios de formulários, associações a listas 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
User-added image

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

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.