Ihr System führt, unseres antwortet
Kein Konnektor, den Sie pflegen müssen, und kein Fahrplan von uns, auf den Sie warten. Ihr System legt Leads an, fordert Vergleiche an und startet Verträge über unsere API — und bekommt ein signiertes Event, sobald sich etwas ändert. Was Sie bauen, gehört Ihnen.
Was „API friendly“ bedeutet
Drei konkrete Dinge. Dass alles, was ein Mensch im CRM tut, aus Ihrem System über die API geht, nach denselben Regeln. Dass Sie nicht nachfragen müssen: ändert sich etwas, sagen wir es Ihnen per Webhook. Und dass die API ein Vertrag ist: dokumentiert, versioniert, ohne Felder, die ohne Ankündigung kommen oder gehen.
Ergebnis: Ein Kanal mit eigenem CRM, eigener Website oder ERP muss das Werkzeug nicht wechseln, um mit uns zu arbeiten.
Was Ihr System tun kann
| Aktion | Was Sie bekommen |
|---|---|
| Lead anlegen | Die Opportunity entsteht im CRM mit Ihrem Eingangskanal und, wenn gewünscht, einem Vertriebler zugeordnet. |
| Vergleich anfordern | Mit Rechnung oder CUPS. Liefert die Katalogtarife des Kanals gegen den aktuellen, mit aufgeschlüsselter Ersparnis. |
| Vertrag starten | Mit dem angenommenen Vergleich oder direkt. Er kommt in die Abwicklung, und von dort erreichen Sie die Events. |
| Status abfragen | Eines Leads, einer Akte oder Ihres Bestands, mit Grund, falls etwas steht. |
| Abrechnungen abfragen | Angefallen, abgerechnet und offen, je Kanal. |
Einige dieser Funktionen kommen in Phasen. In der Demo sagen wir Ihnen, welche heute offen sind und mit welchen Grenzen; eine Liste, die veraltet, veröffentlichen wir hier nicht.
Webhooks: wir sagen es Ihnen
Jede relevante Änderung — Lead angelegt, Vergleich fertig, Angebot angenommen, Vertrag gesendet, Vertrag abgelehnt mit Grund, Vertrag aktiviert, Abrechnung geschlossen — löst ein Event an Ihre registrierte URL aus.
- Signiert. Jedes Event trägt eine Signatur mit dem Geheimnis Ihres Kanals; Sie prüfen, dass es von uns kommt und unterwegs nicht verändert wurde.
- Wiederholungen. Antwortet Ihr Endpoint nicht, wiederholen wir stundenlang mit wachsendem Abstand. Nichts geht durch ein ungünstiges Deployment bei Ihnen verloren.
- Und wenn es weiter ausfällt, ein Mensch. Das Event wird nicht stumm verworfen: die Opportunity erscheint als Aufgabe für jemanden aus Ihrem Team, mit dem offenen Event angehängt.
- Idempotent. Jedes Event hat eine Kennung; kommt es zweimal an, erkennen Sie es.
Authentifizierung und Umgebungen
- Schlüssel je Kanal, einer für Produktion, einer zum Testen. Beim Erstellen einmal angezeigt; danach nur die letzten Zeichen.
- Mit Ablauf. Schlüssel laufen ab und werden im CRM selbst rotiert, ohne uns zu fragen.
- Testumgebung mit erfundenen Daten, damit Ihr Team baut, ohne echte Kunden zu berühren.
- Je Kanal begrenzt. Ein Schlüssel sieht nur die Daten des Kanals, der ihn erstellt hat. Es gibt keinen Schlüssel, der alle sieht.
Was nie über die API herausgeht
Die API liefert eine Projektion: eine Feld für Feld deklarierte Menge, dieselbe, die der Messaging-Bot und der Sprachagent lesen. Deklariert wird, was herausgeht, nicht, was verborgen bleibt — deshalb erscheint ein neues Datenbankfeld in keiner Integration, bis es jemand absichtlich hinzufügt.
Draußen, konstruktionsbedingt: die Kanalmarge, Provisionen anderer Kanäle und die IBAN. Nicht mit dem Produktionsschlüssel, nicht mit dem Testschlüssel, nicht auf Anfrage.
So fangen Sie an
Testschlüssel anfordern im CRM Ihres Kanals und Ihre Webhook-URL registrieren.
Lead anlegen und Vergleich anfordern mit einem Test-CUPS. Die ersten beiden Events kommen an.
Vertrag starten und die Akte bis zur Aktivierung verfolgen, mit ihren Events. Wenn es läuft, auf den Produktionsschlüssel wechseln.
FAQ
Gibt es eine öffentliche API-Dokumentation?
Die Dokumentation wird mit dem Testschlüssel übergeben, zusammen mit der Testumgebung und einer Beispielsammlung. Sie ist nicht offen veröffentlicht, weil ein Teil der API in Phasen kommt und wir wollen, dass Sie lesen, was Sie heute nutzen können.
Kann ich mein CRM ohne Programmierung anbinden?
Für HubSpot, Salesforce und Pipedrive gibt es einen Spiegel der Akte ohne Entwicklung Ihrerseits: die Akte erscheint in Ihrem CRM mit denselben Feldern, die die API liefert. Die API ist für Maßgeschneidertes.
Was passiert, wenn Sie die API ändern?
Sie ist versioniert. Brechende Änderungen kommen in eine neue Version, die alte läuft für eine angekündigte Zeit weiter. Ein zusätzliches Feld bricht nie etwas, weil Ihr System nur die Felder liest, die es kennt.