# Wie kann ich CI Webhooks für sipgate Conversational Intelligence 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 an.
2. Öffnen Sie den Bereich Conversion Intelligence.
3. Gehen Sie in dem Bereich zu CI Webhooks
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: 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:

```
GET https://help.sipgate.de/cloud-telefonanlage/sipgate-nutzen/sipgate-ai-agents/wie-kann-ich-webhooks-fuer-sipgate-ai-agents-einrichten.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.