Prospects depuis le formulaire de votre site web ou l'API

Un formulaire sur votre propre site web — téléchargement d’un livre blanc, demande de démonstration, page de contact — peut créer des prospects directement dans AB Sales, et un backend ou un outil d’automatisation le peut aussi. Les deux utilisent une seule clé de réception, disponible dans les Paramètres CRM. Rien sur votre site n’a besoin de se connecter, et un formulaire HTML ordinaire n’a besoin d’aucun JavaScript.

Où se trouve la clé

Ouvrez votre espace de travail → Paramètres → la carte Formulaire web et API. La première fois qu’un Owner (propriétaire) ou un Admin (administrateur) l’ouvre, une clé est créée ; les membres voient la même clé en lecture seule. La carte affiche la clé avec un bouton Copier, un extrait Formulaire HTML prêt à coller, un exemple API et un bouton Régénérer la clé.

Deux voies d’entrée

1. Pointer un formulaire HTML vers AB Sales

1. Copiez l’extrait. Sur la carte Formulaire web et API, cliquez sur Copier à côté de Formulaire HTML. Il contient déjà votre clé.
2. Changez l’URL de remerciement. Le champ masqué redirect indique où votre visiteur arrive après l’envoi — votre page de téléchargement ou de remerciement, sous forme d’adresse https:// complète.
3. Gardez les champs masqués, ajoutez les vôtres. key et redirect font le travail ; ab_hp est un pot de miel (un champ que personne ne voit, de sorte qu’un robot qui remplit tous les champs qu’il trouve se trahit et que son envoi est écarté). Ajoutez company, phone, website ou message comme champs supplémentaires, avec exactement ces noms.
4. Envoyez une fois vous-même. Le prospect apparaît dans Prospects en quelques instants, avec la source 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>

Champs

Seul email est obligatoire — c’est ainsi qu’un envoi répété est reconnu et que le prospect peut être joint. Tout le reste est facultatif.

Les champs texte sont limités à 200 caractères. Si un envoi est refusé, la réponse nomme le champ en cause.

2. L’API JSON

Les mêmes champs, en camelCase, avec la clé en jeton bearer (envoyée dans l’en-tête Authorization). Pour un outil qui ne peut pas définir cet en-tête, un en-tête X-AB-Key transporte la clé à la place.

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"}'

Les envois répétés ne créent pas de doublons

Un second envoi depuis une adresse e-mail qui appartient déjà à un prospect actif de l’espace de travail ne crée pas un autre prospect. Une note est ajoutée au prospect existant — « Submitted again through the website form. » suivi de ce que la personne a écrit — afin que l’équipe voie l’intérêt renouvelé là où elle travaille déjà, et que le quota ne soit pas dépensé deux fois pour une même personne. La correspondance ignore la casse ; un prospect archivé ne compte pas, de sorte qu’une personne qui revient après avoir été archivée repart de zéro.

Ce que voit votre visiteur

Avec un redirect, toujours votre page de remerciement — y compris lorsque l’envoi était un doublon, un robot, ou que l’espace de travail a dépassé son quota de prospects. La limite de votre forfait vous regarde, pas votre visiteur. Sans redirection (un formulaire envoyé en JavaScript), le point de terminaison répond avec le JSON du tableau ci-dessus.

Si la clé est détournée

Un usage abusif vous coûte des prospects indésirables et du quota, rien de plus. Cliquez sur Régénérer la clé sur la carte, confirmez, et l’ancienne clé cesse de fonctionner immédiatement — collez ensuite la nouvelle clé dans chaque formulaire et chaque intégration qui l’utilisait. Les requêtes sont aussi limitées par adresse appelante, de sorte qu’un robot d’extraction se heurte à un mur qu’une vraie page ne rencontrera jamais.

Le formulaire de votre site web n’est qu’une façon de plus pour un prospect d’arriver : le même prospect, le même entonnoir, le même quota — seule la saisie a disparu.