> 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/en/using-sipgate/sipgate-ai-agents/wie-kann-ich-ci-webhooks-fur-sipgate-conversational-intelligence-einrichten.md).

# How can I set up CI webhooks for sipgate AI Assist?

With CI Webhooks, call data from sipgate calls can be automatically transmitted to external systems such as a CRM. This allows call logs, summaries, and classifications to be integrated directly into existing processes.

#### Requirements

* You have a destination URL to which the data should be sent.
* Your system is able to process HTTP POST requests with a JSON payload using Transfer-Encoding: chunked.
* The webhooks only work for shared channels. Calls made via a private channel do not trigger CI Webhooks.

#### Typical use cases

* CRM integration: Automatic transfer of call notes to customer records.
* Support systems: Creating tickets after incoming calls.
* Analytics: Forwarding classifications to a reporting tool.

#### Store webhook targets

1. Log in as an admin in the sipgate app or in the workspace.
2. Open the Conversion Intelligence section in Settings.
3. Open the CI Webhooks configuration
4. Enter the desired webhook URL.

#### How it works

* After a call is completed, sipgate sends the call data via HTTP POST to the stored webhook URL.
* The data is transmitted as a JSON payload.
* Your system can then store or further process this payload (e.g., in the CRM, ticket system, or internal databases).

Example:\
A call ends ➔ call log is created ➔ data is automatically forwarded to your database ➔ your team has the information immediately available.

Example 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: Good day, I'm calling about my contract. I received an invoice last week that was higher than expected.\nCallee: Good day, I'd be happy to take a look. Could you give me your customer number?\nCaller: Yes, it's 12345. Also, I'd like to know whether I can change my plan.\nCallee: I can see the invoice. The amount is correct because an additional package was booked. We can of course change your plan. I'll send you the options by email.",
      "chunks": [
        {
          "speaker": "CALLER",
          "startTime": 3200,
          "endTime": 12400,
          "content": "Good day, I'm calling about my contract. I received an invoice last week that was higher than expected."
        },
        {
          "speaker": "CALLEE",
          "startTime": 13100,
          "endTime": 18900,
          "content": "Good day, I'd be happy to take a look. Could you give me your customer number?"
        },
        {
          "speaker": "CALLER",
          "startTime": 19500,
          "endTime": 26300,
          "content": "Yes, it's 12345. Also, I'd like to know whether I can change my plan."
        },
        {
          "speaker": "CALLEE",
          "startTime": 27000,
          "endTime": 40100,
          "content": "I can see the invoice. The amount is correct because an additional package was booked. We can of course change your plan. I'll send you the options by email."
        }
      ]
    },
    "callScenarios": null,
    "callHeadline": {
      "content": "Invoice inquiry and plan change"
    },
    "summary": {
      "content": "The customer called about an unexpectedly high invoice. The amount was correct because an additional package was active. In addition, a plan change was discussed, and the options will be sent by email.",
      "keyPoints": [
        "The invoice was correct — the higher amount resulted from a booked additional package.",
        "The customer wants to change their plan.",
        "The available plan options will be sent by email."
      ],
      "topics": [
        "Invoice",
        "Additional package",
        "Plan change"
      ]
    },
    "actionItems": [
      {
        "content": "Send the plan options to the customer by email."
      },
      {
        "content": "Check the additional package and cancel it if necessary."
      }
    ],
    "smallTalkItems": [
      {
        "topic": "Greeting",
        "description": "Both participants greeted each other at the start of the conversation."
      }
    ]
  }
}
```

#### Security

To ensure that only requests from sipgate are forwarded to your webhook integration, check the source IP address of incoming requests. Add the following IP address to your allow list:\
217.116.118.254


---

# 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/en/using-sipgate/sipgate-ai-agents/wie-kann-ich-ci-webhooks-fur-sipgate-conversational-intelligence-einrichten.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.
