# Can I retrieve my AI-generated channel data via API?

#### What requirements must be met?

With the sipgate app, you can have transcripts, summaries, tasks, and Smart Answers created for each of your calls using the AI features. These are then automatically saved in the sipgate app. You can also use **admin** via a webhook to transfer the stored information from the **shared channels** to external databases or your CRM system for further analysis or processing. We explain how this works in this article.

{% hint style="warning" %}
**Important**: All admins share the same configuration. If multiple users of an account have the admin role, in case of doubt existing settings of one admin can be overwritten by changes made by another admin.
{% endhint %}

First, you need a URL to which the data is automatically sent as soon as all AI-generated content is available after a phone call.

{% hint style="warning" %}
**Important:** Only calls from shared channels are taken into account here. **Private telephony** is excluded from data transfer.
{% endhint %}

#### Where do I enter the configuration data?

As **admin** in the **sipgate Desktop App** go to Conversation Intelligence → CI Webhooks. There you enter the desired target URL and save it. After that, after each call from a channel, the entire AI-generated content is transmitted to this URL as a bundle via the webhook.

{% hint style="info" %}
**Important:** The content is automatically sent after each channel call - however, it may take a moment, as the transfer only takes place once all AI-generated content is available.
{% endhint %}

#### What does it all look like?

The data is generally provided in JSON. However, in the sipgate app you can set whether it should be output in vCon format. "vCon" stands for Virtualized Conversations and is a special format for storing and sharing conversation data, such as chat logs, transcripts, and recordings. Further information about this format can be found [here](https://ietf-wg-vcon.github.io/draft-ietf-vcon-vcon-container/draft-ietf-vcon-vcon-container.html).

This is the JSON payload **without vCON:**

```json
{
  "callHeadline": "Customer asked about product availability and pricing",
  "call": {
    "id": "call_12345",
    "caller": "+491751234567",
    "callee": "+498912345678",
    "startTime": 1718202000000,
    "endTime": 1718202300000,
    "duration": 300,
    "direction": "inbound"
  },
  "channel": {
    "id": "channel_98765",
    "name": "Sales Hotline"
  },
  "transcriptions": [
    {
      "speaker": "caller",
      "startTime": 0,
      "endTime": 5000,
      "text": "Hi, I wanted to ask if the new product is available."
    },
    {
      "speaker": "callee",
      "startTime": 5001,
      "endTime": 10000,
      "text": "Yes, it is available and currently on a promotional offer."
    },
    {
      "speaker": "caller",
      "startTime": 10001,
      "endTime": 15000,
      "text": "Great! How much does it cost with the discount?"
    },
    {
      "speaker": "callee",
      "startTime": 15001,
      "endTime": 20000,
      "text": "The discounted price is 49.99 Euros including VAT."
    }
  ],
  "summary": "The caller inquired about the availability and pricing of a new product. The agent confirmed availability and provided the discounted price.",
  "note": {
    "content": "Customer seemed interested in the promotional offer and may convert soon."
  },
  "actionItems": [
    {
      "id": "action_1",
      "text": "Follow up with the customer in 2 days to offer further assistance."
    }
  ],
  "smallTalkItems": [
    {
      "id": "smalltalk_1",
      "topic": "Weather",
      "description": "Caller mentioned the sunny weather at the beginning.",
      "pinned": false,
      "dismissed": false
    }
  ],
  "smartAnswers": [
    {
      "id": "smartanswer_1",
      "question": "Is the new product available?",
      "answer": "Yes, it is currently available and on promotion."
    },
    {
      "id": "smartanswer_2",
      "question": "What is the price?",
      "answer": "The promotional price is 49.99 Euros including VAT."
    }
  ]
}
```

If you have any further questions about AI Assistant Webhooks, write to us: <labs@sipgate.de>


---

# Agent Instructions: 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:

```
GET https://help.sipgate.de/cloud-telefonanlage/en/using-sipgate/die-sipgate-app/kann-ich-meine-ai-generierten-channel-daten-via-api-schnittstelle-abrufen.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.