Wie kann ich Webhooks für sipgate AI-Agents einrichten?
Mit Webhooks können Gesprächsdaten aus sipgate AI Agents 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 zu verarbeiten.
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
- Melden Sie sich als Admin an.
- Öffnen Sie den Bereich Webhook-Einstellungen.
- Hinterlegen Sie die gewünschte Webhook-URL.
- Optional können Sie zusätzliche Parameter im JSON-Format angeben:
- Timeout für die Verbindung
- HTTP-Header (z. B. Content-Type oder benutzerdefinierte Header)
Es können mehrere Webhook-Ziele gleichzeitig eingetragen werden.
Beispielkonfiguration:
{
"webhooks": [
{
"url": "https://sipgate.de:8084/webhook-endpoint",
// optional
"timeout": 10000,
// optional
"additionalHeaders": {
"X-Custom-Header": "custom-value"
}
},
{
"url": "https://sipgate.de:8085/webhook-endpoint",
// optional
"timeout": 10000,
// optional
"additionalHeaders": {
"X-Custom-Header": "custom-value"
}
}
]
}
Funktionsweise
- Nach Abschluss eines Anrufs sendet sipgate AI Agents 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": "v1",
"call": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"from": "+4921161234567",
"to": "+4930987654321",
"startTime": 1703862000000,
"endTime": 1703862300000,
"duration": 300,
"direction": "in"
},
"callScenarios": [
{
"name": "Order Status Inquiry",
"smartAnswers": {
"setName": "Shipping",
"setItems": [
{
"title": "Order Number",
"question": "What is your order number?",
"answer": "The caller provided the order number 12345."
},
{
"title": "Delivery Address",
"question": "What is your delivery address?",
"answer": "The caller was not able to provide the delivery address and therefore could not successfully authenticate."
}
]
}
}
],
"summary": {
"content": "Customer inquiry about delayed order #12345. Agent asked for delivery address and Customer was not able to provide the delivery address and therefore could not successfully authenticate.",
"keyPoints": [
"Order #12345 delivery inquiry",
"Customer was not able to provide the delivery address and therefore could not successfully authenticate"
],
"topics": [
"order status",
"delivery address",
"customer service",
"authentication"
]
}
}
}
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
Dadurch verhindern Sie unberechtigte Zugriffe auf Ihre Webhook-Integration.