Todos os artigos

Envie leads das DMs para o seu CRM com webhooks

Por , fundador do Chat335 min de leitura
Um balão de conversa enviando um fluxo de dados para um banco de dados e uma caixa de cartões de contato

Um lead que só existe na caixa de mensagens do Instagram é um lead que acaba esquecido. A pessoa pediu um orçamento, se candidatou a uma parceria ou entrou em uma lista de espera, e uma semana depois ninguém lembra quem era.

Os webhooks resolvem isso. Um webhook é uma mensagem que sua automação envia a outro sistema no momento em que algo acontece. Coloque um em uma automação de DM e cada lead cai onde sua equipe já trabalha: um CRM, uma planilha, uma central de atendimento ou seu próprio banco de dados.

As duas etapas

As automações do Chat33 têm duas etapas para conversar com outros sistemas.

Enviar dados para um webhook envia uma requisição POST com uma descrição em JSON do que acabou de acontecer para uma URL que você escolhe. É a opção simples, feita para ferramentas que recebem o webhook.

Chamar uma API chama uma URL com o método que você escolher: GET, POST, PUT ou DELETE. Com POST e PUT ela inclui os mesmos detalhes no corpo. Toda requisição leva os IDs da automação e do contato como cabeçalhos, X-Flow-Id e X-Contact-Id. Use quando você estiver chamando a sua própria API.

As duas são de mão única: enviam dados para fora, e a automação segue sem usar a resposta. As automações também rodam direto, de cima para baixo; elas não param para esperar a próxima mensagem da pessoa. Uma pergunta que você faz em uma automação é respondida por outra automação, disparada pela resposta.

O que o webhook envia

A etapa de webhook envia um corpo assim:

{
  "event": "flow_webhook",
  "flowId": "flow_123",
  "contactId": "contact_456",
  "recipientId": "1784...",
  "platform": "instagram",
  "triggerText": "Hi, I'd like a quote for 50 units",
  "triggerType": "dm_keyword",
  "keyword": "QUOTE",
  "postId": null,
  "commentId": null,
  "contact": {
    "name": "Anna",
    "externalId": "1784...",
    "platform": "instagram"
  },
  "timestamp": "2026-04-04T10:15:00.000Z"
}

O campo mais útil costuma ser triggerText: a mensagem ou o comentário que iniciou a automação, nas palavras da própria pessoa. keyword é a palavra-chave do gatilho que combinou e, em um comentário, postId e commentId indicam de qual publicação veio.

O que ele não inclui: endereços de e-mail nem telefones. O Instagram não os compartilha com apps, então, se seu CRM precisa de dados de contato, peça-os na conversa ou envie um link para um formulário.

Se o dado de que você precisa é um e-mail, uma etapa Coletar e-mail pede esse dado na DM, e o Chat33 pode enviar cada endereço coletado direto para o HubSpot ou o Mailchimp, sem webhook. Capture leads do Instagram no HubSpot mostra essa configuração.

Para onde enviar

Qualquer coisa que receba uma requisição HTTPS serve:

  • O webhook de entrada de uma plataforma de automação. A maioria oferece um gatilho de "receber webhook" que dá uma URL. Dali, adicione uma linha a uma planilha, crie um contato no CRM ou publique em um chat da equipe.
  • O webhook de entrada do seu CRM, se ele tiver um.
  • Seu próprio backend, pela etapa Chamar uma API.

Se você prefere chamar o Instagram do seu próprio código, o guia da API de DM do Instagram mostra o que isso exige.

Configurando

  1. Pegue a URL receptora na ferramenta que vai aceitar os dados.
  2. Adicione uma etapa Enviar dados para um webhook à automação que roda depois que o lead disse algo útil, por exemplo a automação da palavra-chave orçamento que responde a um toque em "Pedir orçamento".
  3. Cole a URL.
  4. Ative a automação e dispare-a com uma segunda conta do Instagram.
  5. Confira na ferramenta receptora a requisição de teste e depois mapeie os campos de que precisa.

Uma automação de captação de leads: uma palavra-chave de orçamento marca o contato com uma tag, uma etapa de webhook envia o lead a um CRM, e a pessoa recebe uma confirmação com respostas rápidas cujas respostas disparam as próprias automações.

Protegendo o endpoint

A requisição do webhook não é assinada, então trate a própria URL como o segredo:

  • Use uma URL longa e aleatória ou inclua um token secreto na query string que o seu receptor confira.
  • Aceite só os campos que você espera e ignore todo o resto.
  • Confira se flowId corresponde a uma das suas automações antes de agir sobre os dados.
  • Use HTTPS.

Confiabilidade

Cada etapa faz uma tentativa com timeout de 10 segundos. Se o lado receptor estiver fora do ar nesse momento, o evento não é entregue de novo.

Para a maior parte da captação de leads isso é aceitável, porque a conversa continua na caixa de mensagens do Chat33 e o contato continua marcado. Para algo crítico, faça o receptor responder rápido (guarde primeiro, processe depois) e combine o webhook com uma etapa Adicionar tag, para sempre encontrar os leads no Chat33 se algo escapou. Nosso guia de tags tem um esquema de nomes que funciona bem para isso.

Automações de leads que valem a pena montar

  • Pedidos de orçamento: palavra-chave orçamento, tag e webhook, e depois uma pergunta com respostas rápidas cujas opções disparam cada uma a própria automação (e o próprio webhook, se a resposta importa para o seu CRM).
  • Pedidos de parceria: palavra-chave parceria, link do media kit, webhook para a planilha que seu empresário lê. Veja automação de DMs para criadores.
  • Listas de espera: palavra-chave em resposta a story, uma confirmação, uma tag e um webhook para a contagem atualizar em tempo real.
  • Atacado: uma etapa Verificar uma condição que olha se a mensagem contém "atacado" e envia só esses leads ao seu funil B2B.
Integrações do Chat33

Webhooks, requisições HTTP e as outras formas de o Chat33 se conectar às ferramentas que você já usa.