Leads aus Ihrem Website-Formular oder per API

Ein Formular auf Ihrer eigenen Website — ein Whitepaper-Download, eine Demo-Anfrage, eine Kontaktseite — kann Leads direkt in AB Sales anlegen, und ein Backend oder ein Automatisierungswerkzeug kann das ebenso. Beide verwenden einen Empfangsschlüssel aus den CRM-Einstellungen. Nichts auf Ihrer Website muss sich anmelden, und ein einfaches HTML-Formular braucht überhaupt kein JavaScript.

Wo der Schlüssel liegt

Öffnen Sie Ihren Workspace → Einstellungen → die Karte Webformular und API. Beim ersten Öffnen durch einen Owner oder Admin wird ein Schlüssel erzeugt; Mitglieder sehen denselben Schlüssel schreibgeschützt. Die Karte zeigt den Schlüssel mit einer Schaltfläche zum Kopieren, einen fertigen HTML-Formular-Ausschnitt zum Einfügen, ein API-Beispiel und eine Schaltfläche Schlüssel neu erzeugen.

Zwei Wege hinein

1. Ein HTML-Formular auf AB Sales richten

1. Den Ausschnitt kopieren. Klicken Sie auf der Karte Webformular und API auf Kopieren neben HTML-Formular. Er enthält bereits Ihren Schlüssel.
2. Die Danke-URL ändern. Das versteckte Feld redirect bestimmt, wo Ihr Besucher nach dem Absenden landet — Ihre Download- oder Dankeseite, als vollständige https://-Adresse.
3. Die versteckten Felder behalten, eigene hinzufügen. key und redirect erledigen die Arbeit; ab_hp ist ein Honeypot (ein Feld, das Menschen nie sehen — ein Bot, der jedes Feld ausfüllt, das er findet, verrät sich damit, und seine Einsendung wird verworfen). Fügen Sie company, phone, website oder message als weitere Eingabefelder mit genau diesen Namen hinzu.
4. Einmal selbst absenden. Der Lead erscheint kurz darauf unter Leads, mit der Quelle 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>

Felder

Nur email ist Pflicht — darüber wird eine wiederholte Einsendung erkannt und der Lead erreicht. Alles andere ist optional.

Textfelder sind auf 200 Zeichen begrenzt. Wird eine Einsendung abgewiesen, nennt die Antwort das Feld.

2. Die JSON-API

Dieselben Felder in camelCase, mit dem Schlüssel als Bearer-Token (gesendet im Header Authorization). Für ein Werkzeug, das diesen Header nicht setzen kann, trägt stattdessen ein Header X-AB-Key den Schlüssel.

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

Wiederholte Einsendungen erzeugen keine Duplikate

Eine zweite Einsendung von einer E-Mail-Adresse, die bereits zu einem aktiven Lead im Workspace gehört, legt keinen weiteren Lead an. Dem bestehenden wird eine Notiz hinzugefügt — “Submitted again through the website form.” (erneut über das Website-Formular gesendet) plus das, was die Person geschrieben hat — damit das Team das erneute Interesse dort sieht, wo es bereits arbeitet, und das Kontingent nicht zweimal für dieselbe Person verbraucht wird. Groß- und Kleinschreibung spielen beim Abgleich keine Rolle; ein archivierter Lead zählt nicht, sodass jemand, der nach einer Archivierung zurückkommt, neu beginnt.

Was Ihr Besucher sieht

Mit einem redirect immer Ihre Dankeseite — auch wenn die Einsendung eine Wiederholung oder ein Bot war oder der Workspace sein Lead-Kontingent überschritten hat. Ihr Tariflimit ist Ihre Sache, nicht die Ihres Besuchers. Ohne Redirect (ein per JavaScript abgesendetes Formular) antwortet der Endpunkt mit dem JSON aus der Tabelle oben.

Wenn der Schlüssel missbraucht wird

Missbrauch kostet Sie Spam-Leads und Kontingent, sonst nichts. Klicken Sie auf der Karte auf Schlüssel neu erzeugen, bestätigen Sie, und der alte Schlüssel ist sofort ungültig — fügen Sie den neuen anschließend in jedes Formular und jede Integration ein, die ihn verwendet haben. Anfragen werden außerdem pro aufrufender Adresse begrenzt, sodass ein Scraper gegen eine Wand läuft, die eine echte Seite nie erreicht.

Ihr Website-Formular ist nur ein weiterer Weg, auf dem ein Lead ankommt: derselbe Lead, derselbe Funnel, dasselbe Kontingent — nur das Tippen entfällt.