Ações - Webhook

Descrição da Ação

A ação "Webhook" envia uma solicitação HTTP POST ou GET para uma URL especificada, transferindo dados para uma aplicação ou serviço externo. Esta ação pode ser usada para acionar automações em sistemas de terceiros, atualizar bancos de dados externos ou enviar dados para APIs personalizadas. A ação oferece flexibilidade para integrar fluxos de trabalho com outras ferramentas.

Detalhes da Ação

Guia Passo a Passo

1. Escolha o Tipo de Ação:

   • Selecione "Webhook" da lista de ações disponíveis no construtor de fluxos de trabalho.

2. Dê um Nome à Ação:

   • Insira um nome descritivo para a ação, como "Enviar Informações de Contato para CRM Externo."

3. Insira a URL do Webhook:

   • Forneça a URL do aplicativo externo para o qual os dados devem ser enviados. Geralmente, esta é uma URL de endpoint fornecida por sistemas de terceiros, como CRMs, ferramentas de marketing por e-mail ou outras APIs.

4. Configurar Payload:

   • Defina os dados que serão enviados através do webhook no formato JSON. Você pode usar campos dinâmicos para incluir automaticamente informações como detalhes de contato, status de oportunidade ou campos personalizados. Exemplo:

     { "first_name": "{{contact.first_name}}", "last_name": "{{contact.last_name}}", "email": "{{contact.email}}", "phone": "{{contact.phone}}", "status": "{{contact.status}}"}

5. Adicionar Headers (Opcional):

   • Se o sistema externo exigir autenticação ou headers específicos, você pode adicioná-los aqui. Por exemplo, pode ser necessário incluir uma chave API ou um header de tipo de conteúdo, como:

     • Authorization: Bearer <API_KEY>

     • Content-Type: application/json

6. Adicionar Dados Personalizados (Opcional):

   • Se desejar enviar dados personalizados, você pode adicionar o par de chave e valor na ação, como:

     • Chave: Addr

     • Valor: Endereço do seletor de valores 

   • Mais informações sobre os tipos de dados disponíveis aqui

7. Testar Webhook (Opcional):

• Antes de finalizar, você pode usar ferramentas de teste como Webhook.site ou Postman para verificar se os dados estão sendo enviados corretamente para o sistema externo.

Exemplo

Cenário: Você deseja sincronizar dados de contato com um CRM externo sempre que um novo contato for criado.

1. Criar Gatilho de Fluxo de Trabalho:

   • Configurar um gatilho de fluxo de trabalho para iniciar quando um novo contato for criado.

2. Adicionar Ação de Webhook:

   • Selecione a ação "Webhook" e nomeie como "Sincronizar Contato com CRM".

3. Inserir URL do Webhook:

   • Forneça o endpoint da API do CRM para atualizações de contato, por exemplo, https://api.externaltestcrm.com/contacts/create

4. Configurar Payload:

   • Defina os detalhes do contato a serem enviados em formato JSON, como por exemplo
     

     {
     "first_name": "{{contact.first_name}}",
     "last_name": "{{contact.last_name}}",
     "email": "{{contact.email}}",
     "phone": "{{contact.phone}}"
     }

     JavScript

5. Adicionar Cabeçalhos:

   • Inclua qualquer detalhe necessário de autenticação, como:

     • Authorization: Bearer abc123xyz

     • Content-Type: application/json

6. Salvar e Ativar o Fluxo de Trabalho:

   • Uma vez que o fluxo de trabalho estiver ativo, sempre que um novo contato for criado, os detalhes serão automaticamente enviados para o CRM externo.