Leads a partir do formulário do seu site ou da API

Um formulário no seu próprio site — o download de um whitepaper, um pedido de demonstração, uma página de contato — pode criar leads no AB Sales diretamente, e um backend ou uma ferramenta de automação também. Os dois usam uma única chave de recebimento das Configurações do CRM. Nada no seu site precisa fazer login, e um formulário HTML simples não precisa de JavaScript nenhum.

A chave de recebimento é uma chave de formulário, não uma senha. Ela fica no código-fonte da sua página, e isso não é problema: ela só consegue criar leads em um espaço de trabalho — não consegue listar, ler nem alterar nada. O que vale lembrar é o inverso: gerar uma nova chave quebra todo formulário e toda integração que a usam até você colar a nova.

Onde a chave está

Abra o seu espaço de trabalho → Configurações → o cartão Formulário web e API. Na primeira vez que um Owner (proprietário) ou Admin (administrador) abre o cartão, uma chave é criada; os membros veem a mesma chave somente leitura. O cartão mostra a chave com um botão Copiar, um trecho de Formulário HTML pronto para colar, um exemplo de API e um botão Gerar nova chave.

Os leads vindos da chave pertencem ao administrador que a gerou. Eles chegam à lista Leads com a origem Website, exatamente como um lead digitado — mesmo cartão no Teams, mesmo lugar no funil — e contam para a franquia de leads do espaço de trabalho do mesmo jeito (veja Cobrança). Reatribua-os a partir da lista como qualquer outro lead.

Dois caminhos de entrada

Um formulário HTML simples

O formulário que você já tem envia direto para o AB Sales e manda o visitante para a sua página de agradecimento. Ideal para um formulário de download ou de contato em um site sem desenvolvedor à disposição.

A API JSON

O seu backend, o Zapier, o Power Automate ou qualquer ferramenta capaz de fazer uma requisição web envia os mesmos campos como JSON (um formato de texto simples para dados estruturados), com a chave como bearer token.

1. Aponte um formulário HTML para o AB Sales

Copie o trecho. No cartão Formulário web e API, clique em Copiar ao lado de Formulário HTML. Ele já traz a sua chave.
Troque a URL de agradecimento. O campo oculto redirect é onde o visitante chega depois de enviar — a sua página de download ou de agradecimento, como um endereço https:// completo.
Mantenha os campos ocultos e adicione os seus. key e redirect fazem o trabalho; ab_hp é um honeypot (um campo que as pessoas nunca veem, então um robô que preenche todo campo que encontra se entrega, e o envio dele é descartado). Adicione company, phone, website ou message como campos extras com exatamente esses nomes.
Envie uma vez você mesmo. O lead aparece em Leads em instantes, com a origem Website.

<form method="post" action="https://blz.actionbridge.io/api/crm/leads/form">
  <input type="hidden" name="key" value="lk_…your key…">
  <input type="hidden" name="redirect" value="https://www.example.com/thank-you">
  <input type="text" name="ab_hp" value="" tabindex="-1" autocomplete="off" style="display:none">

  <input name="name" placeholder="Your name">
  <input name="company" placeholder="Company">
  <input name="email" type="email" required placeholder="Work email">
  <button type="submit">Download</button>
</form>

Diga o que a pessoa baixou. Um campo message oculto como Downloaded: Pricing guide cai nas Notas do lead, e assim quem pegar o lead sabe por que essa pessoa está aqui — e a pesquisa com IA também lê as Notas.

Campos

Só o e-mail é obrigatório — é por ele que um envio repetido é reconhecido e que o lead é contatado. Todo o resto é opcional.

Campo do formulário	Campo da API	Vira
`email` obrigatório	`email`	E-mail
`name`	`name`	Nome do contato — ou o Nome do lead quando nenhuma empresa é informada
`company`	`company`	Nome. Quando presente, `name` passa a ser a pessoa de contato, do mesmo jeito que o bot do Teams faz
`phone`, `website`, `industry`	iguais	Telefone, Site, Setor
`source`	`source`	Origem. O padrão é Website; a lista Leads filtra por ela, então fique com poucos valores
`message`	`message`	Notas, até 4.000 caracteres
`country`, `language`, `timezone`	`countryCode`, `preferredLanguage`, `timeZone`	País (`JP`), idioma preferido (`ja-JP`), fuso horário (`Asia/Tokyo`). Um valor que não seja um código válido é recusado, para que o lead nunca guarde algo que nada adiante consiga ler

Os campos de texto têm limite de 200 caracteres. Se um envio for recusado, a resposta diz qual foi o campo.

2. A API JSON

Os mesmos campos, em camelCase, com a chave como bearer token (enviada no cabeçalho Authorization). Para uma ferramenta que não consegue definir esse cabeçalho, um cabeçalho X-AB-Key leva a chave no lugar dele.

curl -X POST https://blz.actionbridge.io/api/crm/leads \
  -H "Authorization: Bearer lk_…your key…" \
  -H "Content-Type: application/json" \
  -d '{"name":"Aoi Sato","company":"Contoso","email":"aoi@contoso.com","message":"Downloaded the pricing guide"}'

Status	Significado
201	Um lead novo. O corpo traz o `leadId` dele.
200 `existing: true`	Uma repetição: em vez de um lead novo, uma nota foi adicionada ao lead existente (abaixo).
400	Um campo estava errado. O erro diz qual.
401	Chave desconhecida — digitada errado, ou substituída desde então.
429	O espaço de trabalho passou da franquia de leads, ou um mesmo endereço está enviando mais de 60 requisições por minuto.

Envios repetidos não geram duplicatas

Um segundo envio de um e-mail que já pertence a um lead ativo no espaço de trabalho não cria outro lead. Uma nota é adicionada ao lead existente — “Submitted again through the website form.” (enviou de novo pelo formulário do site) mais o que a pessoa escreveu — para que a equipe veja o interesse renovado onde já está trabalhando, e a franquia não seja gasta duas vezes com a mesma pessoa. A comparação ignora maiúsculas e minúsculas; um lead arquivado não conta, então alguém que volta depois de ter sido arquivado começa do zero.

O que o visitante vê

Com um redirect, sempre a sua página de agradecimento — inclusive quando o envio foi uma repetição, um robô, ou o espaço de trabalho está acima da franquia de leads. O limite do seu plano é assunto seu, não do visitante. Sem redirect (um formulário enviado com JavaScript), o endpoint responde com o JSON da tabela acima.

Acima da franquia, os leads do formulário não são salvos — e o visitante não é avisado. A recusa fica registrada, e a barra de franquia na página Leads é onde você vai perceber. Se o formulário estiver em uma página movimentada, acompanhe essa barra, ou adicione um Lead Pack antes da campanha, e não depois. Veja Cobrança e a franquia de leads.

Se a chave for usada de forma abusiva

O abuso custa leads de spam e franquia, nada mais. Clique em Gerar nova chave no cartão, confirme, e a chave antiga para de funcionar na hora — depois cole a nova chave em todo formulário e integração que a usavam. As requisições também têm limite de taxa por endereço de origem, então um scraper bate em um muro que uma página de verdade nunca encontra.

O formulário do seu site é só mais um jeito de um lead chegar: o mesmo lead, o mesmo funil, a mesma franquia — só a digitação foi embora.

Publicado em 2026-10-06

Versão 1