Tempo de Leitura: 10min.
💡O que você aprenderá com este artigo:
- como enviar webhook
- como receber webhook
- como atualizar negócios via webhook
Afinal, o que é Webhook?
Os Webhooks funcionam como mensageiros, permitindo que a Clint se comunique de forma inteligente com outras ferramentas, enviando e recebendo informações. Mudanças de status ou etapa representam marcos na jornada do cliente, como uma compra ou a entrada em um grupo de WhatsApp. A Clint pode tanto receber dados de outras ferramentas para atualizar contatos e negócios, quanto enviar informações para outras ferramentas com base em eventos pré-definidos, como as mudanças de status, por exempli
Como integrar outras ferramentas com a Clint através de webhook?
Passo 1: após fazer login na Clint, na tela inicial clique em "Mais", ou direto na origem que deseja indo na engrenagem de configurações.
Passo 2: clique na aba "Integrações" e depois em "+Nova Integração".
Passo 3: clique em "Webhook".
Passo 4: escolha se você quer "Receber" ou "Enviar" informações via webhook e clique em "Começar".
Receber webhook
Após selecionar "Receber webhook" podemos definir se queremos criar/atualizar contatos ou negócios e atribuir um nome a integração.
Importante destacar aqui que temos algumas possibilidades:
Criar negócio: Toda vez que recebermos um webhook, independente se existe ou não um negócio com o mesmo contato (Email e/ou Telefone) já criado na origem, será criado um novo negócio;
Atualizar negócio: Toda vez que recebermos um webhook e que exista um negócio com o mesmo contato (Email e/ou Telefone) já criado na origem, será apenas atualizado;
Criar ou atualizar negócio: Toda vez que recebermos um webhook e não existir um negócio com o contato já criado na origem ele será criado. Caso já tenha um negócio com o mesmo contato (Email e/ou Telefone) será atualizado o negócio.
Após criar a integração vamos ter a URL para conectar com outras plataformas.
Na atualização de negócio é possível:
➡️ Mudar o negócio de etapa do funil
Como: Devemos receber o valor do webhook com o nome ou posição da etapa.
Valor: "Prospecção" ou "2"
Ex: O card do negócio pode mudar de etapa base para prospecção.
➡️ Adicionar um dono do negócio
Como: Devemos receber o valor do webhook com o e-mail do usuário que queremos definir como dono.
Valor: nomedocontato@gmail.com
Ex: Quando o lead entrar na Clint ele vai ter um dono do negócio de maneira automática.
➡️ Mudar de status
Como: Devemos receber o valor do webhook com o nome do status
Ex: Quando o lead passar por uma etapa X da automação, ele vai mudar de status "Aberto" para "Ganho" na Clint.
➡️ Atualizar qualquer campo
Como: Podemos atualizar qualquer campo de contato ou negócio recebendo este novo valor.
Ex: Atualizar o campo de interesse conforme conversão no formulário.
Para que isso aconteça, faça o mapeamento dos campos que deseja receber as informações na Clint e clique em "Continuar".
Na coluna da esquerda, é o nome do campo que está na ferramenta que está enviando o webhook.
Na coluna da direita, é o campo que você vai mapear na Clint (status do negócio, dono do negócio ou etapa do funil).
Na atualização de negócio você sempre precisa mapear um campo de identificação, e-mail e/ou telefone, desta forma o sistema identifica qual contato está se referindo.
Em configurações adicionais, no último passo, selecione uma tag para incluir nos negócios que chegarem através dessa integração. Aqui você também pode definir em qual etapa e status os negócios serão atribuídos.
Enviar webhook
Após selecionar "Enviar webhook" podemos definir qual gatilho será acionado esse webhook, temos as seguintes opções de gatilho:
O negócio for criado
Entrar em uma etapa
Mudar de etapa
Mudar de status
Definido o gatilho de envio do webhook, agora vamos escolher um nome para a nossa integração e adicionar o link que fará a ligação entre as ferramentas. Nessa etapa, também precisamos definir se o envio será via GET ou POST.
GET: Quando um webhook é acionado usando o método GET, os dados são enviados como parâmetros na URL. Esses parâmetros são visíveis na barra de endereço do navegador e podem ser armazenados em caches ou logs do servidor. Como resultado, é recomendado que os dados confidenciais não sejam enviados via GET.
POST: Já com o método POST, os dados são enviados no corpo da requisição HTTP, o que significa que eles não são visíveis na barra de endereço do navegador e não são armazenados em caches ou logs do servidor. O método POST é mais seguro para o envio de dados confidenciais.
Clique em "Continuar".
No mapeamento vamos definir quais informações queremos enviar. Alguns campos serão apresentados e você pode editar o identificador do campo e excluir os campos que não deseja enviar. Finalize clicando em "Salvar".
Alguns exemplos que campos que você pode usar pra enviar as informações da Clint.
Você vai encontrar esse campos no grupo "Configurações de negócio" na hora de selecionar as informações que deseja enviar.
📌 Importante:
Caso o webhook de saída falhe 3 vezes consecutivas, o webhook é desativado, isso ocorre porque existe algo de errado com a configuração ou algum problema onde ele está tentando enviar a informação.
Para integrações entre origens na Clint, o status do negócio sempre chegará como "Aberto".
No Header da sua requisição tem que ter o Content-Type = application/json, pois nosso content-type é nesse padrão (observação para plataformas próprias).
🌟 Extra! Artigos relacionados que podem ser interessantes