Conectar a fonte de leads

Uma fonte é cada sistema que manda leads para a Bancada: o leilão onde você compra, um CRM, uma planilha com automação. Cada fonte tem o seu endereço, e a Bancada mostra quanto cada uma rendeu no dia.

Criar a fonte e copiar o endereço

1. Em Configurações, aba Leads, clique em Adicionar fonte. Só o admin da conta vê o botão.
2. Dê um nome, como o do leilão ou do sistema, e clique em Criar fonte.
3. A tela mostra o endereço da fonte, que já leva a senha dela dentro. Ele aparece uma vez só: copie na hora.
4. Cole esse endereço no sistema que manda os leads, no campo de webhook ou URL de destino.

Cuidado

Se perder o endereço, use Trocar endereço na fonte. O endereço antigo para de funcionar na hora, e quem manda os leads precisa colar o novo.

O endereço tem esta cara:

https://www.bancadahq.com.br/webhook/leads/<senha-da-fonte>

Se o sistema pedir a senha num cabeçalho em vez de dentro do endereço, abra O sistema pede o token num cabeçalho? na mesma tela e use:

POST https://www.bancadahq.com.br/webhook/leads
X-Token: <senha-da-fonte>

O que mandar

Um lead por vez, uma lista, ou { "leads": [...] }, até 1.000 por envio. Exemplo de um lead:

{
  "cpf": "123.456.789-09",
  "nome": "Maria da Silva",
  "margem": "1.234,56",
  "data_admissao": "15/03/2019",
  "data_nascimento": "02/07/1975",
  "validade": "14/11/2026 16:08",
  "telefone": "(51) 99999-0000"
}

• CPF é obrigatório. Sem ele, o lead é recusado na hora.
• Margem, admissão e nascimento são o que o corte usa. Sem um deles, o lead é descartado como “dados incompletos”.
• Validade da oferta é opcional, mas é ela que põe os mais novos na frente da fila. Oferta vencida é descartada.
• Telefone é guardado, mas a mensagem vai para o celular que a Nova Vida confirmar com WhatsApp.

Os nomes dos campos aceitam variações (documento, nomeTrabalhador, valorMargem, dataHoraValidadeSolicitacao e outras). A lista inteira está na referência da entrada de leads. Campos que a Bancada não conhece ficam guardados com o lead.

Conferir que chegou

A resposta de cada envio diz quantos entraram:

{ "recebidos": 1, "aceitos": 1, "recusados": [] }

O lead aparece em Recebidos em segundos, e a fonte mostra em Configurações quantos chegaram hoje, quantos passaram no corte e quantos receberam mensagem.

Resposta	O que é	O que fazer
401	Senha da fonte errada, trocada ou fonte desligada	Copie o endereço de novo, ou ligue a fonte em Configurações
503	Recebimento pausado em Configurações	Nada: a resposta pede reenvio em 5 minutos e nada se perde
413	Mais de 1.000 leads ou mais de 5 MB num envio	Divida o lote
400	Corpo vazio ou que não é JSON	Confira o formato do envio