Un formulario en su propio sitio web — la descarga de un informe, una solicitud de demo, una página de contacto — puede crear leads en AB Sales directamente, y también puede hacerlo un backend o una herramienta de automatización. Ambos usan una misma clave de recepción de la Configuración de CRM. Nada en su sitio necesita iniciar sesión, y un formulario HTML sencillo no necesita JavaScript en absoluto.
Dónde está la clave
Abra su espacio de trabajo → Ajustes → la tarjeta Formulario web y API. La primera vez que un Owner o un Admin la abre, se crea una clave; los miembros ven la misma clave en modo de solo lectura. La tarjeta muestra la clave con un botón para copiarla, un fragmento de Formulario HTML listo para pegar, un ejemplo de API y un botón Regenerar clave.
Dos vías de entrada
Un formulario HTML sencillo
Su formulario actual envía directamente a AB Sales y lleva al visitante a su página de agradecimiento. Lo mejor para un formulario de descarga o de contacto en un sitio sin un desarrollador a mano.
La API JSON
Su backend, Zapier, Power Automate o cualquier herramienta capaz de hacer una petición web envía los mismos campos como JSON (un formato de texto plano para datos estructurados) con la clave como token bearer.
1. Apunte un formulario HTML a AB Sales
- Copie el fragmento. En la tarjeta Formulario web y API, haga clic en Copiar junto a Formulario HTML. Ya lleva su clave.
- Cambie la URL de agradecimiento. El campo oculto
redirectes donde aterriza su visitante tras enviar el formulario — su página de descarga o de agradecimiento, como direcciónhttps://completa. - Conserve los campos ocultos y añada los suyos.
keyyredirecthacen el trabajo;ab_hpes un honeypot (un campo que las personas nunca ven, de modo que un bot que rellena todos los campos que encuentra se delata y su envío se descarta). Añadacompany,phone,websiteomessagecomo campos adicionales con exactamente esos nombres. - Envíelo una vez usted mismo. El lead aparece en Leads en un momento, con el origen 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>message como Downloaded: Pricing guide aterriza en las Notas del lead, de modo que quien lo recoja sepa por qué está aquí esta persona — y la investigación con IA también lee las Notas.Campos
Solo email es obligatorio — es como se reconoce un envío repetido y como se contacta con el lead. Todo lo demás es opcional.
| Campo del formulario | Campo de la API | Se convierte en |
|---|---|---|
email obligatorio | email | Correo |
name | name | Nombre del contacto — o el Nombre del lead cuando no se indica empresa |
company | company | Nombre. Cuando está presente, name pasa a ser la persona de contacto, igual que hace el bot de Teams |
phone, website, industry | igual | Teléfono, Sitio web, Sector |
source | source | Origen. Por defecto Website; la lista de Leads filtra por él, así que conviene limitarse a unos pocos valores |
message | message | Notas, hasta 4.000 caracteres |
country, language, timezone | countryCode, preferredLanguage, timeZone | País (JP), idioma preferido (ja-JP), zona horaria (Asia/Tokyo). Un valor que no sea un código válido se rechaza, de modo que el lead nunca guarda uno que nada pueda leer después |
Los campos de texto tienen un máximo de 200 caracteres. Si se rechaza un envío, la respuesta indica qué campo.
2. La API JSON
Los mismos campos, en camelCase, con la clave como token bearer (enviada en la cabecera Authorization). Para una herramienta que no pueda establecer esa cabecera, una cabecera X-AB-Key lleva la clave en su lugar.
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"}'| Estado | Significado |
|---|---|
| 201 | Un lead nuevo. El cuerpo lleva su leadId. |
200 existing: true | Una repetición: en su lugar se ha añadido una nota a ese lead (más abajo). |
| 400 | Un campo era incorrecto. El error indica cuál. |
| 401 | Clave desconocida — mal escrita, o regenerada desde entonces. |
| 429 | El espacio de trabajo ha superado su cupo de leads, o una misma dirección envía más de 60 peticiones por minuto. |
Los envíos repetidos no crean duplicados
Un segundo envío desde un correo que ya pertenece a un lead activo del espacio de trabajo no crea otro lead. Se añade una nota al existente — “Submitted again through the website form.” (enviado de nuevo a través del formulario web) más lo que hayan escrito — de modo que el equipo ve el interés renovado donde ya está trabajando, y el cupo no se gasta dos veces en la misma persona. La coincidencia ignora mayúsculas y minúsculas; un lead archivado no cuenta, así que quien vuelve después de haber sido archivado empieza de cero.
Qué ve su visitante
Con un redirect, siempre su página de agradecimiento — también cuando el envío era una repetición, un bot, o el espacio de trabajo ha superado su cupo de leads. El límite de su plan es asunto suyo, no de su visitante. Sin redirect (un formulario enviado con JavaScript), el endpoint responde con el JSON de la tabla anterior.
Si se abusa de la clave
El abuso le cuesta leads de spam y cupo, nada más. Haga clic en Regenerar clave en la tarjeta, confirme, y la clave antigua deja de funcionar al instante — después pegue la nueva clave en todos los formularios e integraciones que la usaban. Las peticiones también tienen un límite de frecuencia por dirección de origen, así que un scraper se topa con un muro que una página real nunca verá.
Su formulario web es solo otra forma de que llegue un lead: el mismo lead, el mismo embudo, el mismo cupo — solo que ya no hay que teclear.