Wie kann ich CI Webhooks für sipgate Conversation Intelligence einrichten?

Webhooks einrichten, um Gesprächsdaten automatisch an CRM oder andere Systeme zu senden.

CI Webhooks sind Teil von Conversation Intelligence. 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.

CI Webhooks werden in der App Web konfiguriert und sind von dem separaten AI Assist Webhook zu unterscheiden, der direkt in der sipgate Desktop App eingerichtet wird (siehe Wie richte ich den sipgate AI Assist Webhook ein?).

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 App Web an.

2. Öffnen Sie in den Einstellungen den Bereich Conversation 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