Webhooks

Mit Webhooks lassen sich Gesprächsdaten aus sipgate AI Agents automatisch an externe Systeme weiterleiten. So können Informationen aus Anrufen direkt in bestehende Prozesse übernommen werden, etwa in ein CRM, ein Ticket-System oder ein internes Reporting.

Webhooks kommen immer dann zum Einsatz, wenn nach einem Gespräch automatisch etwas passieren soll, ohne dass Daten manuell übertragen werden müssen.

Wofür werden Webhooks genutzt?

Typische Anwendungsfälle sind die Übergabe von Gesprächszusammenfassungen an ein CRM, das automatische Erstellen von Support-Tickets nach einem Anruf oder die Weiterleitung von Klassifikationen und Themen an Analyse- oder Reporting-Tools. Auch interne Workflows lassen sich so anstoßen, etwa Benachrichtigungen an Teams oder das Anlegen von Aufgaben.

Voraussetzungen

Um Webhooks nutzen zu können, benötigen Sie eine Ziel-URL, an die die Daten gesendet werden sollen. Das empfangende System muss HTTP-POST-Requests mit einer JSON-Nutzlast verarbeiten können.

Webhooks einrichten

1

Öffnen Sie Meine Telefonie.

2

Gehen Sie zu AI Agents, wählen Sie den gewünschten Agent aus oder legen Sie einen neuen an. In der Konfiguration des Agents finden Sie auf der linken Seite den Punkt Webhooks.

3

Hinterlegen Sie dort eine oder mehrere Webhook-URLs, an die nach Abschluss eines Anrufs automatisch Gesprächsdaten gesendet werden.

4

Optional lassen sich zusätzliche Einstellungen vornehmen, zum Beispiel ein Timeout für die Verbindung oder eigene HTTP-Header.

Die Änderungen werden nach dem Speichern für alle folgenden Gespräche des Agents angewendet.

Wie Webhooks funktionieren

Nach Abschluss eines Anrufs erstellt sipgate AI Agents ein Gesprächsprotokoll. Anschließend werden die Gesprächsdaten automatisch per HTTP-POST an die hinterlegte Webhook-URL gesendet. Die Daten werden als JSON-Payload übermittelt und können im Zielsystem gespeichert oder weiterverarbeitet werden.

Ein typischer Ablauf sieht so aus: Ein Anruf endet, das Gespräch wird zusammengefasst und die Informationen werden direkt an ein angebundenes System weitergeleitet. Ihr Team hat die relevanten Daten sofort zur Verfügung, ohne manuelles Eingreifen.

Welche Daten werden übertragen?

Der Webhook enthält unter anderem Metadaten zum Anruf, Informationen zu durchlaufenen Szenarien sowie eine Zusammenfassung des Gesprächs inklusive erkannter Themen. Ein gekürztes Beispiel für eine Payload sieht so aus:

{
  "version": "v1",
  "call": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "from": "[phone]",
    "to": "[phone]",
    "startTime": 1703862000000,
    "endTime": 1703862300000,
    "duration": 300,
    "direction": "in"
  },
  "summary": {
    "content": "Anruf zu einer verzögerten Bestellung.",
    "keyPoints": [
      "Nachfrage zum Bestellstatus",
      "Identifikation nicht erfolgreich"
    ],
    "topics": [
      "order status",
      "customer service"
    ]
  }
}

Die vollständige Payload kann zusätzlich Informationen aus Szenarien enthalten, etwa erfasste Antworten oder Klassifikationen.

Sicherheit

Um sicherzustellen, dass nur Requests von sipgate AI Agents verarbeitet werden, sollte die Quell-IP-Adresse der eingehenden Webhook-Requests geprüft werden. Die Requests stammen von folgender IP-Adresse:

217.116.118.254

Diese Adresse sollte in der Allow List des empfangenden Systems hinterlegt werden, um unberechtigte Zugriffe zu verhindern.

Einordnung

Webhooks liefern die Grundlage für Automatisierung, übernehmen aber selbst keine Verarbeitung. Was mit den gesendeten Daten passiert, wird im jeweiligen Zielsystem festgelegt. In Kombination mit Szenarien, Gesprächsprotokollen und Analysen lassen sich so durchgängige, automatisierte Abläufe aufbauen.