Leads entrando sozinhos no funil

Todo lead que chega pelo seu site, pelo anúncio ou por outra ferramenta pode cair direto no funil do Vibe Board, com a origem do anúncio. Você não copia nada à mão, e o Painel passa a mostrar quanto cada canal trouxe de verdade.

Três caminhos, do mais simples ao mais técnico

Começar pela API

1. No Vibe Board, abra Ajustes › Integrações › Chaves de API e toque em Nova chave. Dê um nome (onde ela vai ser usada) e escolha o canal em que os leads vão entrar.
2. Copie a chave na hora. Ela aparece uma única vez. Se perder, revogue e crie outra.
3. O endereço da API é https://api.appvibeboard.com (está também na tela da chave). Nos exemplos abaixo, a sua chave aparece como $BD_CHAVE.
4. Toda chamada leva a chave no cabeçalho Authorization: Bearer $BD_CHAVE.

Teste a conexão (é o que o botão Testar agora da tela da chave faz). A resposta traz o nome do negócio e da chave:

curl https://api.appvibeboard.com/v1/me \
  -H "Authorization: Bearer $BD_CHAVE"

{
  "workspace": {"id": "…", "name": "Studio da Bia"},
  "key": {"id": "…", "name": "Zapier", "prefix": "bd_live_AbCdEf"}
}

Criar um lead

curl -X POST https://api.appvibeboard.com/v1/leads \
  -H "Authorization: Bearer $BD_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Ana Souza",
    "phone": "(11) 99999-8888",
    "email": "ana@exemplo.com",
    "stage_id": "mql",
    "utm_source": "instagram",
    "utm_campaign": "consultoria-outubro",
    "objetivo": "Ganhar força"
  }'

201  {"lead_id": "Q3r8LmZp0aXv2Kt9WcYh", "duplicate": false}

Também aceita application/x-www-form-urlencoded, além de JSON. O lead aparece no funil na hora, com "Chegou pela integração" e o nome da chave na linha do tempo.

Repetidos, atualizações e reenvios

• Mesmo telefone ou e-mail em 30 dias não cria outro lead: o envio entra na linha do tempo do lead que já existe, e só os contatos que faltavam são preenchidos. A resposta é 200 com "duplicate": true e o lead_id de quem já estava no funil.
• Lead perdido há mais de 7 dias que volta entra como lead novo: é uma pessoa retomando o interesse.
• external_id: o mesmo id manda sempre para o mesmo lead, em qualquer data.
• Reenvio seguro: mande o cabeçalho Idempotency-Key com um id único por envio (o Zapier e o Make têm o id da execução). Se a mesma chave chegar de novo em 24 horas, a resposta é a mesma e nada é gravado de novo.

Canais e etapas

curl https://api.appvibeboard.com/v1/channels -H "Authorization: Bearer $BD_CHAVE"

{"channels": [
  {"id": "paid_landing", "name": "Tráfego (Página)", "kind": "paid_landing"},
  {"id": "referral", "name": "Indicação", "kind": "referral"}
]}

curl https://api.appvibeboard.com/v1/stages -H "Authorization: Bearer $BD_CHAVE"

Lista as etapas do funil. Pela API, o lead entra como lead ou mql ("accepts_new_leads": true). O resto do caminho (call, venda) acontece no Vibe Board.

Erros e limites

Todo erro vem como {"error": {"code": "…", "message": "…"}}.

Recusados e aceitos aparecem em Ajustes › Integrações › Recebidos por 30 dias, com o motivo. Recusados não guardam nome nem contato. A chave errada (unauthorized) não aparece lá: sem chave válida, não dá para saber de qual negócio é.

Receitas

Para conferir qualquer receita, mande um envio de teste pela própria ferramenta (o "Enviar teste" do Vibe Board testa o funil, não a sua integração) e veja em Recebidos se ele chegou e como.

Segurança e dados

• A chave de API é secreta. Use só de servidor para servidor (Zapier, Make, n8n, o backend da agência). Nunca a coloque no código de uma página, porque qualquer visitante veria. No site, use o formulário pronto, que não precisa de chave.
• Vazou? Revogue em Integrações. A chave para de funcionar na hora.
• Os dados dos leads são seus: você é o controlador, e o Vibe Board é o operador, como nos Termos de uso e na Política de privacidade. Mande só leads que você pode tratar (quem pediu contato, com o consentimento do seu formulário), nunca lista comprada.
• O formulário pronto e o link direto passam pelo Cloudflare (entrega da página e verificação anti-robô).