O webhook é uma forma de conectar dois sistemas e levar informação de um para o outro no momento exato em que uma ação acontece, permitindo que automações ocorram automaticamente na outra ponta. Aqui você entende quais disparos o Tintim oferece e como configurá-los.
- No Tintim, vá em Informações do cliente e localize a tela de Endereços de webhook.
- Clique em editar para abrir os campos de configuração dos webhooks, na parte de baixo da tela.
- Escolha em qual disparo deseja configurar o webhook. O Tintim tem quatro disparos:
- Criação de conversa: dispara toda vez que uma conversa é criada (evento
lead_create) – Acontecerá uma única vez - Alteração da conversa: dispara toda vez que há alteração de etapa da jornada da conversa (evento
lead_update). - Nova mensagem na conversa: dispara toda vez que há uma nova mensagem, trazendo o conteúdo tanto do lead quanto do atendente (evento
message_create). - Alteração da origem da conversa: dispara toda vez que a origem muda, por exemplo de “Outras Origens” para “Google Ads” (evento
lead_source_update).
- Criação de conversa: dispara toda vez que uma conversa é criada (evento
- Cole no campo correspondente a URL do webhook obtida na sua ferramenta de integração (o Tintim não disponibiliza essas URLs).
- Clique em salvar. Pronto, o webhook está configurado.
ATUALIZAÇÃO IMPORTANTE
Disparo de Webhook por Origens de Conversa
Agora você escolhe de onde quer receber.
Dentro das Informações do Cliente, na seção de Endereço de Webhooks, ao clicas em editar, aparece uma nova opção: quais origens de conversa devem acionar o disparo de webhook. Por padrão, todas continuam selecionadas. Mas você pode desmarcar as que não interessam e manter só as relevantes para sua integração.
Para quem usa Make (ou qualquer ferramenta de automação semelhante), cada disparo consome uma operação. Receber webhook de origens que não importam para aquela automação é desperdício direto.
Dicas e observações
- Você pode configurar dentro do até 3 webhooks diferentes para cada evento.
- O Tintim não fornece as URLs de webhook. Essas URLs você obtém nas ferramentas de integração, como Make (antigo Integromat), Zapier, Pluga ou n8n. Toda ferramenta de integração disponibiliza um endereço de URL de webhook.
- O corpo de requisição da criação da conversa (
lead_create) traz informações como conta, código e nome da conta no Tintim, anúncio, data da criação, event type, nome, phone, source (origem), status, ID e nome da etapa da jornada, parâmetros e informações do dispositivo. - Quando o lead vem via link rastreável, os parâmetros vêm na URL e aparecem no corpo do webhook, dentro do
visit. - Quando o lead vem via campanha de mensagem (campanha click to whatsApp no Meta Ads), o webhook traz as informações do anúncio, dentro do
ad: nome e ID da campanha, nome e ID do conjunto, nome e ID do anúncio. - O payload da alteração da conversa (
lead_update) é praticamente idêntico ao da criação de conversa; muda o event type e as informações de status ou de origem. - O webhook de criação de mensagem (
message_create) tem corpo um pouco diferente, trazendo, por exemplo,from_me(se foi o atendente ou o lead que enviou), a mensagem e o phone do lead. - O Tintim não presta serviço de integração, mas você pode fazer essas integrações via webhook usando as ferramentas de integração (Make, Zapier etc.).
- Para casos de uso e exemplos de corpo de requisição, consulte a documentação de webhooks do Tintim.
- Toque aqui para acessar nossa documentação de API
- Toque aqui para acessar nossa documentação de Webhooks
- Se seu webhook foi desativado automaticamente, toque aqui para entender o motivo!