Find your place.

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.

Beispiel

Partnerportal, Leads exportieren: Stand Verkauft gewählt, 214 Leads, Export als CSV-Datei — für Excel, Numbers oder Ihr CRM. Beispiel.

Beispiel

Export

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.

Beispiel

Webhook · 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.

Beispiel

Lead 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.

MerkmalPartnerportalWebhookLead API
StandVerfügbarPreviewPreview
Leads ansehen und als CSV exportierenJaNeinNein
Ein signiertes Ereignis je Änderung am LeadNeinJaNein
Leads einreichen und ihren Stand abfragenNeinNeinJa
AbsicherungAnmeldungHMAC-SHA256API-Schlüssel
Sandbox getrennt von LiveNeinJaJa
Zugriff von Place auf Ihr System nötigNeinNeinNein

Preview heißt: Format und Schnittstelle stehen fest, die Anbindung richten wir beim Start mit Ihnen ein.

Sicher übergeben.

Für Entwickler
  • Die 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.

Leads über Place erhalten.

Erzählen Sie uns, was wir für Sie vermarkten sollen.