brieffyv0.1.0

Receber leads por webhook

Mande leads de outras ferramentas (Zapier, Make, Typebot, RD) para o funil do time.

Atualizado em 13 de outubro de 2026

O webhook é um endereço do time que aceita leads enviados por outra ferramenta: Zapier, Make, Typebot, RD Station ou o back-end de um formulário. O lead entra no funil como se tivesse chegado pelo site.

Onde encontrar o endereço

  1. Abra Leads e clique no ícone Configurar captura de leads (Dono e Admin). Se você está em vários times, escolha antes o time em Time em foco, no menu lateral: cada time tem a própria URL.
  2. Se a captura ainda não estiver ativada, preencha Domínios permitidos, clique em Ativar captura e abra o ícone de novo.
  3. Abra a aba Webhook.
  4. Clique em Copiar URL do webhook.

Como enviar

Faça um POST com o corpo em JSON:

curl -X POST "https://brieffy.app/api/leads/inbound/SEU_TOKEN" \
  -H "content-type: application/json" \
  -d '{"name":"Ana","email":"ana@exemplo.com","phone":"11987654321",
       "message":"Quero orçamento","channel":"formulario","source":"instagram",
       "utm_campaign":"implante","procedimento":"clareamento"}'
CampoO que é
name, email, phone, messageO contato do lead
channelO canal: o nome na lista do time (ex.: "WhatsApp") ou o tipo (whatsapp, form, phone…). Sem ele, ou com um valor que não está na lista, Formulário
sourceA fonte: o nome na lista do time (ex.: "Instagram") ou o tipo (google_ads, social, referral…). Sem ela, ou com um valor que não está na lista, a fonte é escolhida como num lead do site: Google Ads com gclid, gbraid ou wbraid; senão, as regras das fontes, o buscador ou Direto
utm_source, utm_medium, utm_campaign, utm_term, utm_contentA campanha de origem
gclid, gbraid, wbraidO identificador do clique no Google Ads, se você tiver
page, referrerA página e o site de origem. Mande o referrer como endereço completo (https://www.instagram.com/…): sem o https://, as regras de site de origem e o buscador não o reconhecem
Qualquer outroVira Outras informações no lead (até 50 campos)

É obrigatório mandar ao menos email, phone ou gclid.

Respostas

CódigoSignificado
201Lead criado (ou juntado a um que já existia). O corpo traz o id
401A URL está errada ou foi trocada, ou o módulo Leads está desligado
422O JSON é inválido ou falta contato. O corpo traz o error
429O time passou do limite de 1.000 leads novos por hora

Os envios recusados ficam registrados em Logs do Google Ads (em Configurações › Google Ads, no cartão Envio ao Google Ads, Ver logs): corpo inválido como "Webhook recusado", e o limite por hora como "Captura recusada: limite de 1.000 por hora do time atingido". Essa página só existe com o módulo Google Ads ligado e só Dono e Admin a veem. Sem o módulo, confira a resposta 422, que traz o motivo no error.

Um lead que chega pelo webhook com fonte Google Ads e e-mail ou telefone pode ser enviado ao Google Ads quando for qualificado, mesmo sem gclid, se tiver chegado há menos de 90 dias. Para isso, o time precisa estar com o Envio automático (API) e o interruptor Conversões otimizadas para leads ativadas no Google Ads ligados em Configurações › Google Ads. Sem isso, só vão os leads com clique de anúncio: gclid pelo feed CSV ou pelo envio automático, e gbraid ou wbraid só pelo envio automático. Veja Enviar conversões ao Google Ads.

Zapier e Make

Use a ação Webhooks › POST (Zapier) ou o módulo HTTP › Make a request (Make), com o método POST, o formato JSON e os campos acima.