Todas as coleções
Integrações
Como integrar plataformas através de webhook
Como integrar a Clint com outras plataformas via webhook
Como integrar a Clint com outras plataformas via webhook

Descubra o que é e como realizá-las com facilidade.

Atualizado essa semana

Afinal, o que é Webhook?

Os Webhooks são como mensageiros que permitem que a Clint se comunique com outras ferramentas de maneira inteligente. É como se a Clint pudesse pegar informações de outras ferramentas e também enviar informações para elas.

Agora, quando se fala em "mudança de status" ou "etapa", pense nisso como marcos que acontecem na jornada de um cliente com a empresa dentro da clint. Por exemplo, quando um cliente faz uma compra, isso pode ser um marco. Quando ele entra num grupo de whatsapp, outro marco. A Clint pode saber quando esses marcos acontecem e até contar para outras ferramentas.

Antes de mais nada é importante lembrar que a Clint pode receber ou enviar Webhook, ou seja, podemos receber os dados preexistentes em outras ferramentas para criar novos contatos e atualizar negócios aqui na Clint.

Como também podemos a partir de algum evento pré definido, como mudança de status ou etapa, enviar informações para outras ferramentas.


Como integrar outras ferramentas com a Clint através de webhook

Após fazer login na Clint, na tela inicial clique em "Mais", ou direto na origem que deseja indo na engrenagem de configurações.

Clique na aba "Integrações", e "+Nova Integração".

Clique em "Webhook".

Lembrando que na tela exibida abaixo temos algumas opções de ferramentas nativas com a Clint, ou seja, nós já temos a ponte construída para receber essas informações. A integração do webhook é para caso não seja nenhuma destas opções nativas.

Escolha se você quer receber ou enviar informações via webhook:

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 criação da integração vamos ter a URL para conectar com outras plataformas.

Realize mapeamento dos campos, cada ferramenta tem o seu próprio envio de campos

TOME NOTA

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, no passo 3, 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 (manychat, typeform, active campaign etc).

  • 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, EMAIL 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 o "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 pra 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

Observações:

  • 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á com o status 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 plataforma próprias).

Após realizar as integrações vocês poderão editar no painel de integrações


Respondeu à sua pergunta?