> 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/die-sipgate-app/wie-richte-ich-den-sipgate-ai-assist-webhook-ein.md).

# Wie richte ich den sipgate AI Assist Webhook ein?

Den AI Assist Webhook in der sipgate Desktop App einrichten, um AI-Assist- Ergebnisse eines Channels automatisch an externe Systeme zu senden.

Mit dem AI Assist Webhook können Sie die AI-Assist-Ergebnisse eines Channels – etwa Transkript, Zusammenfassung, To-dos und Smart Answers – automatisch an eine externe Ziel-URL senden, zum Beispiel um sie mit Zapier in ein CRM oder andere Tools zu übertragen.

{% hint style="info" %}
Der AI Assist Webhook ist von den [CI Webhooks](/cloud-telefonanlage/sipgate-nutzen/die-sipgate-app/wie-kann-ich-ci-webhooks-fur-sipgate-conversational-intelligence-einrichten.md) zu unterscheiden: Der AI Assist Webhook wird in der **Desktop App** eingerichtet und überträgt die AI-Assist-Ergebnisse eines einzelnen Channels. CI Webhooks werden dagegen in der **App Web** konfiguriert und übermitteln Conversation-Intelligence-Daten account-weit.
{% endhint %}

#### Voraussetzungen

* Der Webhook kann nur von Administratoren des sipgate Kontos eingerichtet werden.
* Er gilt nur für Channels – es wird also ein Channel mit Rufnummer benötigt.

#### Wo richte ich den Webhook ein?

1. Öffnen Sie als Admin die sipgate Desktop App.
2. Öffnen Sie in den Einstellungen den Bereich **AI Assist ➔ AI Assist Webhook**.
3. Tragen Sie unter **konfigurieren** die gewünschte Ziel-URL ein.
4. Wählen Sie das gewünschte Datenformat: Standard-JSON.
5. Speichern Sie die Einstellung.

Nach jedem Anruf über einen Channel werden die AI-Assist-Ergebnisse automatisch als Bundle an die hinterlegte URL übertragen, sobald alle Inhalte verfügbar sind.

#### Payload-Format

**Standard-JSON** enthält unter anderem folgende Felder:

```json
{
  "callHeadline": "...",
  "call": {
    "id": "...",
    "caller": "...",
    "callee": "...",
    "startTime": 0,
    "endTime": 0,
    "duration": 0,
    "direction": "inbound"
  },
  "channel": {
    "id": "...",
    "name": "..."
  },
  "transcriptions": [
    { "speaker": "caller", "startTime": 0, "endTime": 0, "text": "..." }
  ],
  "summary": "...",
  "actionItems": [{ "id": "...", "text": "..." }],
  "smallTalkItems": [{ "id": "...", "topic": "...", "description": "..." }],
  "smartAnswers": [{ "id": "...", "question": "...", "answer": "..." }]
}
```

Eine praktische Anwendung des AI Assist Webhooks mit Zapier, HubSpot, Slack und Google Sheets finden Sie im Artikel [Wie nutze ich den sipgate AI Assist in Verbindung mit Hubspot, Slack & Google Sheet?](/cloud-telefonanlage/anbindungen-und-integrationen/integrationen-fur-die-sipgate-app/wie-nutze-ich-den-sipgate-ai-assist-in-verbindung-mit-hubspot-slack-google-sheet.md)


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.sipgate.de/cloud-telefonanlage/sipgate-nutzen/die-sipgate-app/wie-richte-ich-den-sipgate-ai-assist-webhook-ein.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.