Receba os leads dos seus canais, sem digitar um por um.
Cada contato que chega por webhook entra na sua fila, é classificado pela IA como Quente, Morno ou Frio e, se for Quente, avisa você por e-mail. Quem conversa com o cliente continua sendo a sua equipe: o Cadu AI não envia mensagem sozinho.
Gere o token. Ele aparece uma única vez: copie na hora e guarde como se fosse uma senha.
O endereço é sempre https://caduai.com.br/api/ingest/leads, com o método POST e o cabeçalho Authorization: Bearer SEU_TOKEN.
Campos aceitos: name (obrigatório), phone, email, company, message e source (nome da origem, como “Meta Lead Ads”). Telefone pode ir como número e campo vazio como null.
{
"name": "Ana Souza",
"phone": "11999998888",
"email": "ana@exemplo.com.br",
"message": "Quero visitar o apartamento de 2 quartos no Brooklin.",
"source": "Meta Lead Ads"
}
Para testar de um terminal, troque SEU_TOKEN pelo seu e rode:
curl -X POST https://caduai.com.br/api/ingest/leads \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name":"Ana Souza","phone":"11999998888","message":"Quero visitar o apartamento no Brooklin.","source":"Meta Lead Ads"}'
Se o mesmo contato for enviado duas vezes em até 15 minutos, o Cadu AI devolve o que já existe e não duplica. Gerar um token novo desativa o anterior.
2. Meta Lead Ads pelo Zapier
No Zapier, crie um Zap com gatilho em Facebook Lead Ads, escolha a página e o formulário do anúncio.
Na ação, escolha Webhooks by Zapier e o evento POST.
Em URL, cole o endereço do webhook. Em Payload Type, escolha json.
Em Data, mapeie: name para o nome completo do lead, phone para o telefone, email para o e-mail, message para as respostas do formulário e source para “Meta Lead Ads”.
Em Headers, adicione Authorization com o valor Bearer SEU_TOKEN.
Teste o Zap, confirme que o contato apareceu no portal e ligue o Zap.
No Make o caminho é o mesmo: módulo Facebook Lead Ads como gatilho e módulo HTTP, Make a request como ação, com método POST, corpo JSON e o mesmo cabeçalho.
3. ZAP, VivaReal e OLX por e-mail
Hoje os portais entregam o contato ao corretor por e-mail. A ideia é pegar esse e-mail e transformá-lo em chamada ao webhook.
No Zapier, use o gatilho Email Parser by Zapier. No Make, use o gatilho Mailhooks, Custom mailhook. Cada um dá um endereço de e-mail exclusivo.
No painel do portal (ou no seu e-mail), encaminhe os avisos de lead para esse endereço. Se o portal permitir um e-mail extra para receber leads, use este.
Mostre ao leitor um e-mail de exemplo e marque onde estão o nome, o telefone e a mensagem do cliente.
Na ação, use o mesmo POST do passo anterior, com source igual ao nome do portal.
Cada portal tem um modelo de e-mail diferente, então o leitor precisa ser ajustado para o formato do seu. Se um dia o portal mudar o texto, o fluxo pode quebrar: confira os primeiros leads do dia no portal do Cadu AI.
Se der erro
Respostas do webhook
Código
O que significa
201
Contato salvo. A resposta traz o id e, quando a IA classificou, a temperatura.
400
Corpo inválido ou campo errado, como nome vazio ou telefone fora do padrão.
401
Token ausente, errado ou desativado. Gere de novo e atualize no Zapier ou no Make.
402
O período gratuito terminou ou a assinatura não está ativa.
413
Corpo maior que 12 KB. Envie só os campos necessários.
429
Muitas tentativas ou limite de envios por hora. Aguarde e tente de novo.
O token vale como senha do seu workspace. Não o cole em páginas públicas, prints ou conversas. Se ele vazar, gere um novo no portal.