Recursos Como funciona Canais Conexão MCP Webhooks Começar agora →
Webhooks · Requisição externa

Seu Instagram conversando com o seu sistema

Cada DM, comentário e lead novo chega no seu CRM, planilha ou n8n na hora. E a automação pode consultar a sua API no meio da conversa e responder com o que voltar.

Liberado em todos os planos, inclusive no grátis.

Uma avisa o seu sistema. A outra pergunta pra ele.

Webhooks

O ConverteAí avisa o seu sistema

Você cadastra uma URL e escolhe os eventos. Cada vez que um acontece, os dados chegam lá na hora, com o contato completo.

Ver os eventos e as garantias ↓
Requisição externa

A automação pergunta pro seu sistema

Um bloco da automação chama a sua API no meio da conversa, e o que ela devolver entra na próxima mensagem da DM.

Ver como funciona ↓

Avisos em tempo real, com o contato completo

Escolha quais eventos quer receber. Todo aviso já traz nome, @, e-mail, telefone, tags e campos personalizados do contato, sem precisar consultar nada depois.

  • DM recebidamessage.received
  • Comentário recebidocomment.received
  • Lead novocontact.created
  • Tag adicionada ou removidacontact.tag_*
  • Dados do contato atualizadoscontact.updated
  • Automação concluídaautomation.completed
O que chega no seu sistema
POST https://seu-sistema.com/webhooks
X-ConverteAi-Event: comment.received
X-ConverteAi-Signature: t=1790712728,v1=5f2c…

{
  "id": "4b1e9c0a-…",
  "type": "comment.received",
  "created_at": "2026-09-29T14:32:08Z",
  "data": {
    "text": "LINK",
    "source": "instagram_post",
    "contact": {
      "name": "Marina Souza",
      "username": "marina.s",
      "email": "marina@email.com",
      "phone": "+5511999990000",
      "tags": ["lead-quente"],
      "custom_fields": { "cidade": "São Paulo" }
    }
  }
}

Exemplo resumido de um aviso de comentário. O id é único por evento.

Assinatura de segurança

Cada envio vem assinado. O seu sistema confere que veio do ConverteAí e não de alguém se passando por ele.

Histórico de 30 dias

Cada entrega mostra status, tentativas, resposta do seu sistema e duração. Dá pra reenviar qualquer uma.

Sem duplicidade

Cada evento tem um id único. Se chegar duas vezes, por um reenvio por exemplo, o seu sistema reconhece.

Botão de teste

Manda um aviso de exemplo na hora, pra você conferir se o seu sistema está recebendo.

Desativação com aviso

Se o endereço passar 3 dias falhando, ele é desativado e o dono da conta recebe um e-mail.

Configurado pelo agente

Pela Conexão MCP, é só pedir: “cria um webhook de lead novo pro meu n8n”.

Seu sistema caiu? O aviso não se perde.

7 novas tentativas ao longo de cerca de 2 dias.

Falhouagora
1ª1 min
2ª5 min
3ª30 min
4ª2 h
5ª6 h
6ª12 h
7ª24 h

A automação consulta o seu sistema e responde na DM

A mensagem do contato vai para a sua API, e o que voltar (protocolo, link de pagamento, status do pedido) vira texto na próxima mensagem. Por exemplo: “Seu protocolo é {{protocolo}}”.

  • Deu certo ou deu erro: se a sua API falhar ou demorar, a automação segue por outro caminho em vez de travar ou mandar mensagem quebrada.
  • Envia o que você precisa: nome, @, e-mail, telefone, o que a pessoa acabou de escrever ou o contato inteiro, em JSON ou texto.
  • Cofre de segredos: o token da sua API fica guardado cifrado e entra como {{segredo.API_TOKEN}}. Ninguém que abre a automação vê o valor, nem o agente do MCP.
  • Até 3 tentativas em falhas passageiras, com um id em cada chamada pra sua API não processar a mesma coisa duas vezes. Tempo limite de 1 a 30 segundos.
  • Teste com contato real: no construtor, você vê exatamente o que seria enviado e recebido. Depois, a aba “Execuções” mostra cada chamada, e as métricas mostram quantas falharam em cada bloco.
  • Protegido: o que o contato digita não consegue alterar a estrutura do envio, e a chamada não pode apontar para endereços internos do servidor.
DM do contatoCadê meu pedido 4263?
Requisição externa POST api.sualoja.com/pedidos · Bearer {{segredo.API_TOKEN}}
Resposta da sua API { "protocolo": "PED-4263", "status": "Saiu para entrega" } 503 · a API não respondeu a tempo
✓ Deu certo✕ Deu erro
Resposta na DM Seu pedido PED-4263 saiu para entrega 🚚 Nosso sistema está instável agora, já te respondemos por aqui 🙏

O que dá pra fazer com isso

Com webhooks

Os avisos chegam em qualquer sistema que receba uma URL.

Todo lead novo no CRMLead na planilhaAvisar o vendedor no WhatsApp ou Slack quando chega DMDisparar um fluxo no n8n, Make ou Zapier

Com requisição externa

A resposta da sua API volta pra conversa na hora.

Consultar pedido ou rastreio pela DMGerar link de pagamento ou cupomCadastrar no CRM e devolver o número do atendimentoVer se o e-mail já é de cliente

Ou peça pro seu agente de IA configurar

Com o ConverteAí conectado a um agente como o Claude, tudo isso se configura conversando.

“Cria um webhook de lead novo pro meu n8n.”
“Guarda esse token no cofre.”
“Faz uma automação que manda cada DM pro meu CRM e responde com o protocolo.”
“Quais entregas falharam hoje? Reenvia.”

Antes de ligar no seu sistema

Preciso saber programar?

Não. Ferramentas como n8n, Make e Zapier geram uma URL de webhook: você cola essa URL no ConverteAí e escolhe os eventos. Se preferir, peça ao seu agente de IA pela Conexão MCP. E se travar, chama a gente no WhatsApp.

Funciona no plano grátis?

Sim. Webhooks, requisição externa, cofre de segredos e Conexão MCP estão liberados em todos os planos, inclusive no grátis.

Como o meu sistema sabe que o aviso veio do ConverteAí?

Cada aviso vem com o cabeçalho X-ConverteAi-Signature, uma assinatura HMAC-SHA256 feita com um segredo que só você e o ConverteAí conhecem, junto com o horário do envio. O seu sistema recalcula a assinatura e descarta o que não bater ou for antigo.

E se o meu sistema estiver fora do ar?

O ConverteAí tenta de novo 7 vezes ao longo de cerca de 2 dias (1 min, 5 min, 30 min, 2 h, 6 h, 12 h e 24 h). No histórico você vê cada tentativa e pode reenviar. Se o endereço passar 3 dias falhando, ele é desativado e você recebe um e-mail.

A requisição externa trava a conversa se a minha API cair?

Não. O bloco tem duas saídas, “Deu certo” e “Deu erro”. Se a API falhar ou passar do tempo limite, a automação segue pelo caminho de erro, com a mensagem que você escolher.

Grátis de verdade, e não acaba em 7 dias

Ligue o Instagram no seu sistema hoje

Crie sua conta, conecte o Instagram e cadastre sua primeira URL. Se precisar, a gente configura com você pelo WhatsApp.