Webhooks
Adressen, über die andere Systeme Leads und Bewerbungen an Leadmode senden, mit Aufbau, Antworten und Grenzen.
Webhooks sind Adressen, an die ein anderes System per POST Daten schickt, zum Beispiel ein Website-Formular, eine Meta- oder Google-Anzeige, Make, Zapier, n8n oder deine KI. Du findest sie unter Einstellungen → Anbindungen → Weitere Anbindungen → Webhooks.
Das Modul CRM muss aktiv sein. Adressen für Projekte, Lead-Fragebögen und Landingpages legt die Projektleitung oder ein Organisationsadmin an. Gesendete Leads entstehen im Namen der Person, die die Adresse angelegt hat, solange sie Mitglied der Organisation ist.
Welche Adressen es gibt
Die Seite „Webhooks“ zeigt Kacheln. Je Kachel legst du Adressen an.
| Kachel | Wohin die Anfragen gehen |
|---|---|
| Allgemeiner Lead-Eingang | als Lead in ein Projekt, ohne Seite oder Stelle |
| Lead-Fragebögen | als Antwort eines deiner Lead-Fragebögen; zählt in dessen Auswertung |
| Landingpages | als Anfrage einer deiner Landingpages; zählt in deren Auswertung |
| Bewerbungen | als Bewerbung auf eine Stelle oder als Initiativbewerbung ins Recruiting-Board, Stufe „Neu“ |
Bei Lead-Fragebögen, Landingpages und Bewerbungen zeigt die Liste je Eintrag den Stand („Nicht eingerichtet“, „Webhook aktiv“, „Pausiert“) und die Zahl der Eingänge. Mit Anlegen erzeugst du die Adresse. Danach kopierst du mit Adresse die URL oder mit Anleitung für KI einen fertigen Text für deine KI. Details öffnet die Seite, auf der die Adresse verwaltet wird: den Lead-Fragebogen oder die Landingpage (Bereich „Externe Anbindung (Webhook)“) beziehungsweise die Stelle im Recruiting.
Pro Lead-Fragebogen, Landingpage und Stelle gibt es höchstens eine Adresse. Für ein Projekt kannst du mit Weitere Adresse anlegen beliebig viele erzeugen, zum Beispiel eine je Quelle.
Die Adresse und das Geheimnis
Die Adresse enthält ein geheimes Token. Weitere Zugangsdaten sind nicht nötig. Gib die Adresse nur an Systeme weiter, die senden sollen.
Leads: POST https://<DEINE-LEADMODE-ADRESSE>/api/public/leads/<ORGANISATION>/<GEHEIMNIS>
Bewerbungen: POST https://<DEINE-LEADMODE-ADRESSE>/api/public/applications/<ORGANISATION>/<GEHEIMNIS>Die fertige Adresse kopierst du aus der Oberfläche. Mit Neue Adresse erzeugen wird das Token ersetzt; die alte Adresse funktioniert sofort nicht mehr, und du musst die neue in allen Systemen eintragen. Mit dem Schalter (Aktiv oder Pausiert) pausierst du eine Adresse. Beim Löschen erhalten sendende Systeme einen Fehler; bereits angelegte Leads und Bewerbungen bleiben.
Leads senden
Content-Type: application/json oder application/x-www-form-urlencoded. Größe bis 200 KB. Browser-Formulare auf anderen Seiten dürfen die Adresse aufrufen.
curl -X POST 'https://<DEINE-LEADMODE-ADRESSE>/api/public/leads/<ORGANISATION>/<GEHEIMNIS>' \
-H 'Content-Type: application/json' \
-d '{ "name": "Anna Beispiel", "email": "anna@beispiel.de", "phone": "0171 1234567", "company": "Beispiel GmbH", "message": "Bitte um Rückruf", "externalId": "anfrage-4711" }'Felder
Pflicht ist email oder phone. Alles andere ist freiwillig. Gängige Namen wie Vorname, Nachname, Telefon, Firma oder Nachricht erkennt Leadmode selbst, ebenso das Format von Meta Lead Ads.
| Feld | Bedeutung |
|---|---|
name oder firstName und lastName | Name |
email, phone | E-Mail, Telefon |
company, jobTitle, website | Firma, Position, Website |
street, postalCode, city | Anschrift |
message | Freitext, Anliegen |
externalId | eigene Kennung der Anfrage, verhindert Doppelte bei Wiederholung |
utm_source, utm_medium, utm_campaign, utm_term, utm_content | Herkunft der Anzeige |
Alle weiteren Felder hängt Leadmode als Zeilen „Feld: Wert“ an die Nachricht an (bis zu 30 Felder). Ungültige E-Mail-Adressen, Telefonnummern und Websites lässt Leadmode weg, statt den Lead zu verwerfen. Bleibt weder eine gültige E-Mail noch eine Telefonnummer übrig, wird die Anfrage abgelehnt.
Erkennt Leadmode ein Feld nicht, ordnest du es im Projekt-Lead-Eingang unter „Felder ohne Zuordnung im letzten Eingang“ einem Ziel zu oder wählst „Nicht verwenden“. Die Zuordnung gilt für alle künftigen Eingänge. Unter „Letzte Eingänge“ siehst du die letzten 20 Anfragen mit dem, was erkannt wurde. Mit Testlead senden schickst du einen Testlead („Testlead Webhook“), den du später löschen kannst.
Antworten
| Antwort | Bedeutung |
|---|---|
201 {"status":"created"} | Neuer Lead angelegt, mit Aufgabe „Neuer Lead – anrufen“ |
200 {"status":"returning"} | Die Person gibt es im Projekt schon (gleiche E-Mail-Adresse, ohne E-Mail die gleiche Telefonnummer). Leadmode legt am bestehenden Kontakt die Aufgabe „Erneute Anfrage – zurückrufen“ an, aber keine zweite Karte. |
200 {"status":"duplicate"} | Genau diese Anfrage kam schon an. Nichts doppelt angelegt. |
422 {"status":"rejected","error":"…"} | Keine gültige E-Mail und keine gültige Telefonnummer; die Meldung nennt den Grund |
400 | Daten weder als JSON noch als Formular |
404 | Adresse ungültig, pausiert oder gelöscht |
429 | Zu viele Anfragen; später erneut senden |
Doppelte Anfragen
Leadmode merkt sich die Anfragen je Adresse. Mit externalId zählt allein diese Kennung. Ohne sie vergleicht Leadmode den Inhalt (Felder mit Zeit- oder Datumsangaben bleiben dabei außen vor). Dieselbe Anfrage zweimal zu senden ist daher unschädlich.
Herkunftsklasse und Quelle
Jeder Lead bekommt eine Herkunftsklasse: Kalt, Warm oder Website. Beim Anlegen einer Projekt-Adresse wählst du Quelle (zum Beispiel „Website-Formular“, „Meta Ads (Facebook, Instagram)“, „Google Ads“, „LinkedIn“, „Webinar“, „Empfehlung“, „Warme Anfrage“, „Sonstige“) und Herkunftsklasse; die Quelle schlägt eine passende Klasse vor. Bei Lead-Fragebögen und Landingpages kommen Projekt, Quelle, Herkunft und Zuständiger von der Seite. Wer die neuen Aufgaben bekommt, richtet sich nach dem eingestellten Zuständigen, sonst nach der Projektleitung.
Bewerbungen senden
Gleiche Technik, andere Adresse und andere Felder. Auf der Stelle im Recruiting findest du sie unter „Externe Anbindung (Webhook)“ mit Webhook-Adresse anlegen. Siehe auch Recruiting.
curl -X POST 'https://<DEINE-LEADMODE-ADRESSE>/api/public/applications/<ORGANISATION>/<GEHEIMNIS>' \
-H 'Content-Type: application/json' \
-d '{ "firstName": "Lena", "lastName": "Bergmann", "email": "lena@beispiel.de", "phone": "+49 30 123456", "message": "Ich bewerbe mich als Telefonvertriebler.", "file": { "name": "Lebenslauf.pdf", "content": "<BASE64-DER-DATEI>" } }'| Feld | Bedeutung |
|---|---|
firstName und lastName (oder name) | Pflicht |
email | Pflicht |
phone | freiwillig |
message | Anschreiben, freiwillig |
file | freiwillig: name und content (Base64). PDF, Word, Bilder und OpenDocument bis 5 MB. Bei Formular-Übertragung ohne Datei. |
Weitere Felder landen als Zeilen „Feld: Wert“ in der Notiz der Bewerbung.
| Antwort | Bedeutung |
|---|---|
201 {"status":"created"} | Bewerbung angelegt |
200 {"status":"duplicate"} | Dieselbe E-Mail hat sich in den letzten 30 Tagen schon auf diese Stelle beworben |
422 | Angaben unvollständig; die Meldung nennt, was fehlt |
400 | Datei leer, zu groß oder falscher Dateityp |
404 | Adresse ungültig, pausiert, gelöscht oder die Stelle ist nicht mehr offen |
429 | Zu viele Anfragen |
Grenzen
- Leads: höchstens 120 Anfragen je Minute und Absender-Adresse und 600 je zehn Minuten je Webhook-Adresse. Wiederholt ungültige Adressen sperren den Absender zeitweise.
- Bewerbungen: höchstens 300 Anfragen je zehn Minuten je Adresse.
- Leadmode speichert je Lead-Adresse die letzten 20 Eingänge zur Ansicht.
- Es gibt nur eingehende Webhooks.