> For the complete documentation index, see [llms.txt](https://help.sipgate.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.sipgate.de/cloud-telefonanlage/sipgate-nutzen/sipgate-ai-agents/wie-kann-ich-ci-webhooks-fur-sipgate-conversational-intelligence-einrichten.md). # Wie kann ich CI Webhooks für sipgate AI Assist einrichten? Mit CI Webhooks können Gesprächsdaten aus sipgate Anrufen automatisch an externe Systeme wie ein CRM übermittelt werden. So lassen sich Protokolle, Zusammenfassungen und Klassifikationen von Anrufen direkt in bestehende Prozesse integrieren. #### Voraussetzungen * Sie verfügen über eine Ziel-URL, an die die Daten gesendet werden sollen. * Ihr System ist in der Lage, HTTP POST Requests mit JSON-Nutzlast mit Tranfer-Encoding: chunked zu verarbeiten. * Die Webhooks funktionieren nur für geteilte Channels. Gespräche, die über einen privaten Channel geführt werden, triggern keine CI Webhooks. #### Typische Anwendungsfälle * CRM-Integration: Automatische Übergabe von Gesprächsnotizen an Kundendatensätze. * Support-Systeme: Erstellung von Tickets nach eingehenden Anrufen. * Analytics: Weiterleitung von Klassifikationen an ein Reporting-Tool. #### Webhook-Ziele hinterlegen 1. Melden Sie sich als Admin in der sipgate App oder im Workspace an. 2. Öffnen Sie in den Einstellungen den Bereich Conversion Intelligence. 3. Öffnen Sie die CI Webhooks Konfiguration 4. Hinterlegen Sie die gewünschte Webhook-URL. #### Funktionsweise * Nach Abschluss eines Anrufs sendet sipgate die Gesprächsdaten per HTTP POST an die hinterlegte Webhook-URL. * Die Daten werden als JSON-Payload übermittelt. * Ihr System kann diese Payload anschließend speichern oder weiterverarbeiten (z. B. im CRM, Ticket-System oder internen Datenbanken). Beispiel:\ Ein Anruf wird beendet ➔ Gesprächsprotokoll wird erstellt ➔ Daten werden automatisch an Ihre Datenbank weitergeleitet ➔ Ihr Team hat die Informationen sofort verfügbar. Beispiel Payload: ``` { "version": "1", "call": { "id": "pbx-a1b2c3d4-e5f6-7890-abcd-ef1234567890", "from": "4921163553400", "to": "4921163553401", "startTime": "2026-04-08T09:22:41.663Z", "endTime": "2026-04-08T09:24:04.329Z", "duration": 82666, "direction": "IN", "users": [ { "userId": "w0", "accountId": "1234567", "fullUserId": "1234567w0", "firstName": "Max", "lastName": "Mustermann", "fullName": "Max Mustermann" } ], "channel": { "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479", "name": "Support Channel" } }, "assist": { "provider": { "llm": "AZURE" }, "transcription": { "content": "Caller: Guten Tag, ich rufe an wegen meines Vertrags. Ich habe letzte Woche eine Rechnung erhalten, die höher als erwartet ausfiel.\nCallee: Guten Tag, das schaue ich mir gerne an. Können Sie mir Ihre Kundennummer nennen?\nCaller: Ja, die ist 12345. Außerdem würde ich gerne wissen, ob ich meinen Tarif wechseln kann.\nCallee: Ich sehe die Rechnung. Der Betrag ist korrekt, da ein Zusatzpaket gebucht wurde. Einen Tarifwechsel können wir natürlich vornehmen. Ich sende Ihnen die Optionen per E-Mail zu.", "chunks": [ { "speaker": "CALLER", "startTime": 3200, "endTime": 12400, "content": "Guten Tag, ich rufe an wegen meines Vertrags. Ich habe letzte Woche eine Rechnung erhalten, die höher als erwartet ausfiel." }, { "speaker": "CALLEE", "startTime": 13100, "endTime": 18900, "content": "Guten Tag, das schaue ich mir gerne an. Können Sie mir Ihre Kundennummer nennen?" }, { "speaker": "CALLER", "startTime": 19500, "endTime": 26300, "content": "Ja, die ist 12345. Außerdem würde ich gerne wissen, ob ich meinen Tarif wechseln kann." }, { "speaker": "CALLEE", "startTime": 27000, "endTime": 40100, "content": "Ich sehe die Rechnung. Der Betrag ist korrekt, da ein Zusatzpaket gebucht wurde. Einen Tarifwechsel können wir natürlich vornehmen. Ich sende Ihnen die Optionen per E-Mail zu." } ] }, "callScenarios": null, "callHeadline": { "content": "Rechnungsrückfrage und Tarifwechsel" }, "summary": { "content": "Der Kunde rief wegen einer unerwartet hohen Rechnung an. Der Betrag war korrekt, da ein Zusatzpaket aktiv war. Zusätzlich wurde ein Tarifwechsel besprochen, die Optionen werden per E-Mail zugesendet.", "keyPoints": [ "Die Rechnung war korrekt — der erhöhte Betrag resultierte aus einem gebuchten Zusatzpaket.", "Der Kunde möchte seinen Tarif wechseln.", "Die verfügbaren Tarifoptionen werden per E-Mail zugesendet." ], "topics": [ "Rechnung", "Zusatzpaket", "Tarifwechsel" ] }, "actionItems": [ { "content": "Tarifoptionen per E-Mail an den Kunden senden." }, { "content": "Zusatzpaket prüfen und ggf. kündigen." } ], "smallTalkItems": [ { "topic": "Begrüßung", "description": "Beide Teilnehmer begrüßten sich zu Beginn des Gesprächs." } ] } } ``` #### Sicherheit Um sicherzustellen, dass nur Requests von sipgate an Ihre Webhook-Integration weitergeleitet werden, prüfen Sie die Quell-IP-Adresse der eingehenden Requests. Nehmen Sie dazu die folgende IP-Adresse in Ihre Allow List auf:\ 217.116.118.254 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.sipgate.de/cloud-telefonanlage/sipgate-nutzen/sipgate-ai-agents/wie-kann-ich-ci-webhooks-fur-sipgate-conversational-intelligence-einrichten.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.