Como ligar o formulário do site ao CRM
Em Configurações > Formulários do site ficam o endereço de envio, a lista de campos aceitos e exemplos de código em PHP / WordPress, Node.js e curl. Quem cuida do site faz o formulário enviar para o servidor do próprio site, e esse servidor chama o CRM com a chave de API.
A chave nunca deve ir no HTML nem no JavaScript da página. A mesma chave que envia leads também lista e exporta os leads da empresa, e qualquer visitante copiaria uma chave exposta. Ela aparece uma única vez ao ser gerada; gerar outra invalida a anterior na hora, e o site precisa ser atualizado.
Campos aceitos pela API de leads
O envio é um JSON com os dados do contato. Só o e-mail é obrigatório.
- email, name, phone, city e state (estado em sigla, como SP)
- subject e message, o assunto e a mensagem do formulário
- form_type, para separar cada formulário nos relatórios
- fields, com campos extras que vão para a qualificação do lead
- consent, o aceite de marketing do contato (LGPD)
- tracking, com página, site, origem, UTMs e identificadores de clique dos anúncios
- hp, um campo oculto antispam: preenchido, o envio é aceito e o lead descartado
O que o CRM faz com cada lead recebido
O Reverba cria o lead, abre uma negociação no funil padrão, faz o enriquecimento por IA e roda os fluxos ativos com o gatilho Lead criado. A conversão fica registrada no lead com o tipo de formulário. Se a mesma pessoa, pelo e-mail ou pelo telefone, enviar de novo em até 24 horas, o CRM registra como reenvio do mesmo lead.
O cabeçalho opcional Idempotency-Key leva um código por envio: repetido, o CRM devolve a mesma resposta sem criar outro lead. Quando a empresa exige consentimento na entrada, lead sem o aceite marcado é recusado. Um campo opcional de sistema de origem marca leads carregados de outra ferramenta como importados, fora das métricas de captação.
Testar a integração antes de publicar
O botão Enviar lead de teste manda um lead chamado [teste] Integração de formulário pelo mesmo endereço que o site usa. Se der certo, a tela mostra que o CRM recebeu. É um lead de verdade: ganha negociação, passa pelo enriquecimento e pelos fluxos, então apague o lead e a negociação depois do teste.
Perguntas frequentes
Posso usar a mesma chave em vários formulários do site?
Pode. Mude só o form_type de cada formulário para separar a origem nos relatórios.
Gerei uma chave nova e os leads pararam de chegar. Por quê?
A chave anterior deixa de valer na hora. Atualize a chave no servidor do site e em toda integração que usava a antiga.
O limite de leads do plano barra os leads do site?
Não. O limite trava o cadastro manual e a importação. Leads do site entram sempre.
Onde vejo a chave de API atual?
Ela não aparece de novo depois de criada. Se não estiver guardada, gere outra e atualize as integrações.