> 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?

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/sipgate-ai-agents/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.
* Aktuell befindet sich diese Funktion in der App im Beta-Status und ist über **Labs** in den Einstellungen zu finden, sofern Sie zu den Beta-Testern gehören. Nach dem vollständigen Release wird die Funktion unter **AI Assist** aufgeführt.

#### Wo richte ich den Webhook ein?

1. Öffnen Sie als Admin die sipgate Desktop App.
2. Öffnen Sie in den Einstellungen den Bereich **Labs ➔ AI Assist Webhook**.
3. Tragen Sie die gewünschte Ziel-URL ein.
4. Wählen Sie das gewünschte Datenformat: Standard-JSON oder **VCON**.
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": "..." }]
}
```

Alternativ kann das Format **VCON** ("Virtualized Conversations") gewählt werden – ein Standard-Format zum Speichern und Teilen von Gesprächsdaten wie Transkripten und Aufzeichnungen. Mehr dazu in der [vCon-Spezifikation](https://ietf-wg-vcon.github.io/draft-ietf-vcon-vcon-container/draft-ietf-vcon-vcon-container.html).

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
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=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.