Como enviar os leads do seu site para o seu Atendimento

O que você recebe

Duas informações, geradas na conta e entregues pela equipe:

• Endereço: para onde o formulário envia.
• Chave: o que prova que o envio é mesmo dessa página. Ela aparece uma vez na tela e vale como senha.

O envio

Um POST com JSON. A chave vai no cabeçalho X-XCON-Key.

curl -X POST https://xconpro.com.br/api/hook/lead/SEU_ENDERECO \
  -H "X-XCON-Key: SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "nome": "Maria Silva",
    "telefone": "11988887777",
    "email": "maria@email.com",
    "valor_credito": 250000,
    "prazo": 180,
    "extras": { "finalidade": "comprar apartamento" }
  }'

// a chave fica visível no código da página:
// peça para cadastrarem o domínio do site antes de usar assim
fetch("https://xconpro.com.br/api/hook/lead/SEU_ENDERECO", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-XCON-Key": "SUA_CHAVE"
  },
  body: JSON.stringify({ nome, telefone, email, extras: { finalidade } })
})

Se a ferramenta usada não permitir configurar cabeçalho, a chave também é aceita na própria URL, em ?key=. Funciona, mas prefira o cabeçalho: na URL ela aparece em registro de acesso.

Os campos

Tudo que for enviado dentro de extras aparece como comentário no lead, com o nome do campo do jeito que veio. É por ali que entram as perguntas próprias do formulário, como finalidade, cidade ou melhor horário, sem precisar de nada do nosso lado.

As respostas

O corpo da resposta sempre traz o motivo em português, no campo motivo, e o 201 devolve o identificador do lead criado. Vale mostrar esse motivo no formulário quando o envio falhar, em vez de um erro genérico.

Boas práticas

• Enviar pelo servidor sempre que a página tiver um back-end: a chave não chega ao visitante.
• Se o envio for pelo navegador, informar o domínio do site para a equipe cadastrar. A partir daí, só ele pode enviar.
• Tratar a chave como senha: não versionar em repositório público nem mandar por canal aberto.
• Um webhook por página ou ferramenta. Fica mais fácil saber de onde veio cada lead e desligar só uma origem.
• Repetir o envio em caso de erro de preenchimento: 422 significa que o dado precisa ser corrigido, não reenviado.

O que acontece depois do envio

1. na hora O contato vira um lead no Atendimento, na fila definida na conta.
2. na hora Os campos extras entram como comentário no lead, para o vendedor ler.
3. se a conta pedir Sai uma mensagem oficial de abertura no WhatsApp, e a conversa começa.
4. quando o lead responde O atendimento automático segue a conversa, com o roteiro configurado na conta.

Uma observação de expectativa: a plataforma não mede o desempenho de uma página hospedada fora dela. O acompanhamento da página continua sendo pela ferramenta de análise de quem a desenvolveu.