Verbinde Rinkel mit deinem CRM, deinem Helpdesk, Slack oder einem eigenen Tool. Mit der Rinkel API und Webhooks landen deine Gesprächsdaten genau dort, wo du sie brauchst — und du automatisierst eine Menge manueller Arbeit.
Gut zu wissen ❗
API und Webhooks sind für Professional- und Expert-Abonnements verfügbar (Webhooks waren früher nur für Expert — jetzt auch für Professional). Es handelt sich um technische Arbeit: eine Entwickler:in oder IT-Verantwortliche hat es schnell eingerichtet, du kannst es aber auch selbst in Angriff nehmen, wenn du etwas Zeit mitbringst.
Die gesamte technische Dokumentation findest du auf developers.rinkel.com (auf Englisch). Brauchst du Inspiration? Schau auf der Integrationsseite vorbei — dort findest du konkrete Beispiele.
Was ist ein API-Schlüssel und wofür brauchst du ihn?
Ein API-Schlüssel ist ein einzigartiger Code — ähnlich wie ein Passwort — mit dem dein System Zugriff auf die Daten deines Rinkel-Kontos erhält. Kein Schlüssel, kein Zugriff.
Du erstellst einen API-Schlüssel in MyRinkel (hier).
Achtung ❗
Behandle deinen API-Schlüssel wie ein Passwort. Teile ihn nicht öffentlich und füge ihn nicht in Code ein, den du in ein öffentliches Repo pushst.
Loslegen mit der Rinkel API
Die API basiert auf REST und du findest alle Endpoints, Parameter und Beispiele auf developers.rinkel.com.
Mit Webhooks arbeiten
Ein Webhook sendet automatisch eine Nachricht an dein System, sobald etwas in Rinkel passiert. Zum Beispiel: eingehender Anruf? Öffne ein Ticket. Gespräch beendet? Aktualisiere die Kundenkarte in deinem CRM.
Webhook einrichten
Gehe zu dieser Seite in MyRinkel.
Wähle den Webhook, den du einrichten möchtest, und gib die URL deines Endpoints ein (muss POST-Anfragen empfangen können).
Welche Events kannst du nutzen?
Eingehender Anruf — ein Gespräch kommt rein (noch nicht beantwortet). Sendet id, datetime, to und from.
Ausgehender Anruf — du rufst nach außen an (noch nicht beantwortet). Gleiche Felder wie oben.
Gesprächsbeginn — das Gespräch wurde angenommen. Sendet id, datetime, answeredBy und die gewählte Anrufmenü-Option, falls vorhanden.
Gesprächsende — das Gespräch ist beendet. Sendet id, datetime und cause (sechs mögliche Gründe: nicht beantwortet, beantwortet, gesperrt, Voicemail, Warteschleife, außerhalb der Geschäftszeiten).
Hast du AI Insights? Dann kannst du auch das Call insights-Event nutzen, um Zusammenfassung, Sentiment und Themen an dein eigenes System zu senden. Verknüpfe es über dieselbe id mit einem Gespräch.
Die genauen Payload-Felder findest du auf developers.rinkel.com.
Sicherheit
Der gesamte Webhook-Datenverkehr läuft über HTTPS und das Payload ist JSON. Akzeptiere auf deiner Seite ausschließlich Anfragen von der Rinkel-Domain.
Webhook funktioniert nicht?
Geh diese Punkte durch:
Stimmt deine Endpoint-URL und ist sie über das Internet erreichbar?
Akzeptiert dein Endpoint POST-Anfragen?
Sendet deine Anwendung bei Empfang ein 200 OK zurück?
Erlaubst du Anfragen von der Rinkel-Domain?
Steckst du immer noch fest? Schick die Fehlermeldung an [email protected] — wir helfen dir weiter.
Häufige Fragen
Bei welchen Abonnements kann ich API und Webhooks nutzen?
Professional und Expert.
Kann ich AI Insights an mein CRM weitergeben?
Ja, über das Webhook-Event Call insights. Verknüpfe es über dieselbe id mit anderen Webhook-Events, wenn du auch Telefonnummern brauchst.
Ich möchte den Namen des Anrufers live in meinem CRM sehen — geht das?
Ja. Nutze den Webhook für eingehende Anrufe, um die Daten direkt beim Eingang des Anrufs an dein CRM zu senden.
Funktioniert Rinkel mit Zapier, Make oder Integrately?
Die direkte Zapier-Integration wurde eingestellt. Über Webhooks verbindest du Rinkel selbst mit jeder Plattform, die Webhooks empfangen kann — Zapier, Make und Integrately funktionieren problemlos.
Technische Frage? Schick sie mit so vielen Details wie möglich an [email protected]. Für alle anderen Fragen ist unser Support-Team unter [email protected] erreichbar.