Integrationen
Vom Lead in Ihr System.
Leads stehen im Partnerportal und gehen als Export in jedes System. Webhook und Lead API sind in der Preview — signiert, mit getrennten Umgebungen. Ihr Stand kommt auf demselben Weg zurück.
Der Weg eines Leads: Er steht im Partnerportal als Übergeben, ein signiertes Ereignis lead.received geht an Ihr CRM, das es mit 200 annimmt; Ihre Rückmeldung kommt zurück und der Stand im Portal wechselt auf Angenommen. Beispiel.
BeispielPartnerportal, Leads exportieren: Stand Verkauft gewählt, 214 Leads, Export als CSV-Datei — für Excel, Numbers oder Ihr CRM. Beispiel.
BeispielExport
Sofort und ohne Technik: Im Partnerportal wählen Sie den Stand und laden die Leads als CSV — für Excel, Numbers oder Ihr CRM.
Eine Webhook-Zustellung an Ihr CRM, Zeile für Zeile: POST an Ihre Adresse mit Place-Event-Id, Place-Timestamp und Place-Signature, darunter das Ereignis; danach drei Prüfungen auf Ihrer Seite: Signatur passt, nicht älter als fünf Minuten, Antwort 200. Beispiel.
BeispielWebhook · Preview
Jede Zustellung ist signiert, mit Zeitstempel und Ereignis-Kennung. Heute kommt eine Testzustellung echt bei Ihnen an; die automatische Zustellung der Lead-Ereignisse ist noch nicht eingeschaltet.
Die Lead API in der Sandbox: POST /v1/leads wird mit 201 und der Kennung pl_lead_8a1f3c beantwortet; beim Abfragen mit GET wechselt der Stand von received über validated zu assigned. Beispiel.
BeispielLead API · Preview
Leads einreichen, Stand abfragen: received, validated, assigned und weiter. In der Sandbox mit Testschlüssel, live mit eigenem — getrennt, damit kein Test im echten Bestand landet.
Drei Wege im Vergleich.
| Merkmal | Partnerportal | Webhook | Lead API |
|---|---|---|---|
| Stand | Verfügbar | Preview | Preview |
| Leads ansehen und als CSV exportieren | Ja | Nein | Nein |
| Ein signiertes Ereignis je Änderung am Lead | Nein | Ja | Nein |
| Leads einreichen und ihren Stand abfragen | Nein | Nein | Ja |
| Absicherung | Anmeldung | HMAC-SHA256 | API-Schlüssel |
| Sandbox getrennt von Live | Nein | Ja | Ja |
| Zugriff von Place auf Ihr System nötig | Nein | Nein | Nein |
Preview heißt: Format und Schnittstelle stehen fest, die Anbindung richten wir beim Start mit Ihnen ein.
Sicher übergeben.
Für EntwicklerDie Kopfzeile Place-Signature mit Zeitstempel und HMAC-SHA256.
Jede Zustellung signiert
Zwei API-Schlüssel im Partnerportal: CRM-Anbindung in Gebrauch, Auswertung noch nicht benutzt.
Schlüssel je Partner, einzeln widerrufbar
Webhook an crm.ihr-unternehmen.de — kein Zugang zu Ihrem System nötig.
Place schickt nur an Ihre Adresse
Häufige Fragen
Alles, was eine CSV-Datei einliest, sofort. Was einen Webhook oder eine API annimmt, über die Anbindung in der Preview.
Nein. Wir schicken an eine Adresse, die Sie uns geben. Den Stand geben Sie uns über Webhook, API oder Export zurück.
Noch nicht. Format, Kopfzeilen und Signatur stehen fest, jedes Ereignis wird aufgezeichnet, und eine Testzustellung kommt echt und signiert bei Ihnen an. Die automatische Zustellung schalten wir ein, sobald sie fertig ist — die Entwickler-Doku sagt es zuerst.
lead.received, lead.validated, lead.assigned, lead.contacted, lead.appointment_created, lead.won und lead.lost.
Über die Kopfzeile Place-Signature: t=<Zeit>,v1=<HMAC-SHA256 über Zeit und Rumpf> mit Ihrem Geheimnis. Ältere Zustellungen als fünf Minuten verwerfen Sie.
Ja. Sandbox und Live sind getrennt — mit eigenen Schlüsseln (sk_place_test_ und sk_place_live_) und eigenen Webhook-Endpunkten.
Alle Bereiche des Portals.
Zum Partnerportal- KampagnenProdukt, Regionen, Volumen und Preis je Lead — vereinbart, bevor jemand losgeht.Fester Preis je Lead
- GebieteNach PLZ-Bereich, Stadt oder Bundesland — nur dort, wo Sie liefern können.PLZ · Stadt · Bundesland
- LeadsMit Einwilligung und Zeitstempel. Sie sehen nur Ihre Leads, nie die anderer Partner.Einwilligung am Lead
- PerformanceÜbergeben, angenommen, verkauft, storniert — Monat für Monat.Kein Stand ohne Rückmeldung
- AbrechnungJe Lead zum vereinbarten Preis. Was storniert wird, wird gutgeschrieben.Keine Grundgebühr
- IntegrationenWebhook, Lead API (Preview) und Export — und Ihr Stand kommt auf demselben Weg zurück.Diese Seite
Leads über Place erhalten.
Erzählen Sie uns, was wir für Sie vermarkten sollen.