# Omnidesk

### Подключение Omnidesk к боту в Савви.

Заходим во вкладку “**Каналы**”, нажимаем **"Omnidesk"**

<figure><img src="/files/V6nYrtxTq77AlEEUIvMb" alt=""><figcaption></figcaption></figure>

Работа **Omnidesk** требует аутентификации. Она производится по API-ключу, но дополнительно нужно указать email-адрес **сотрудника** (не администратора), так как некоторые методы требуют определения сотрудника. Используйте email-адрес сотрудника, который едва ли будет когда-то отключен или удален.

{% hint style="warning" %}
Рекомендуем для этой цели создать отдельного сотрудника.

Сотрудника лучше создавать с полным доступом, так как от его уровня доступа зависит список обращений которые можно получить по API.
{% endhint %}

<figure><img src="/files/sWaBLCkBLA9ZwPeAsu3Q" alt=""><figcaption></figcaption></figure>

**Как получить API-ключ?**

1. Войдите в аккаунт администратора.
2. Перейдите в раздел **«Настройки»**, подраздел **«API»**.
3. Нажмите на ссылку **«добавить API-ключ»**.

<figure><img src="/files/7KkyV752bXqecy3Pojf0" alt=""><figcaption></figcaption></figure>

Дальше нажать **«Добавить»**

<figure><img src="/files/E3TL9STkGatBIQzGPQe4" alt=""><figcaption></figcaption></figure>

Сгенерируется **API-ключ**, который надо скопировать

<figure><img src="/files/Pu54UjZLS9JK7FFsEXKD" alt=""><figcaption></figcaption></figure>

Затем вставить **API-ключ** в настройках интеграции Савви.

<figure><img src="/files/KApoMA9L6YdtI3bY3hEp" alt=""><figcaption></figcaption></figure>

* Заполнить **email** сотрудника
* Заполнить домен (его можно скопировать в адресной строке браузера):

<figure><img src="/files/9tAk6KQDyOjmFZ1UHLYM" alt=""><figcaption></figcaption></figure>

* Нажать **"Подключить"**

#### После подключения вам станут доступны следующие настройки:

<figure><img src="/files/t6XtO1M7I0fgQvpXC8I0" alt=""><figcaption></figcaption></figure>

* **Режим "co-pilot"** - позволяет передавать в **Omnidesk** не сообщения, а примечания. Данный режим — своего рода помощник для оператора, когда бот даёт быстрые подсказки и снижает вероятность ошибок при ответе конечному клиенту.

#### Дальше нужно создать правила:

Копируем **URL для получения уведомлений**:

<figure><img src="/files/AW9vsX7F0qCBr3t0aJ9b" alt=""><figcaption></figcaption></figure>

Переходим в раздел **Омнипанель → Создать правило** на стороне **Omnidesk**.

<figure><img src="/files/osc23NFsyze4lYXHVb5a" alt=""><figcaption></figcaption></figure>

Выбираем **входящие обращения** и нажимаем **"Добавить правило"**

<figure><img src="/files/uHzSeubZ7fRbyOyj4Exd" alt=""><figcaption></figcaption></figure>

В открывшемся окне производим следующие настройки:

<figure><img src="/files/x830BLXfl1Ch8hZiDLcE" alt=""><figcaption></figcaption></figure>

1. Заполняем поле - **Название правила**
2. Нажимаем - **Добавить действие**
3. Выбираем **Выполнить вебхук** и метод **POST**
4. Вставляем скопированный **URL для получения уведомлений**
5. Стандартный запрос, выбираем **- JSON**
6. Необходимо выбрать все поля. Если выбрать только определенные, то сообщения могут не обрабатываться.
7. Нажимаем - **Создать правило**

Появится сообщение **- Правило создано успешно** и само правило появится в списке:

<figure><img src="/files/xh0dTWdpnZHHpn6HWPja" alt=""><figcaption></figcaption></figure>

Дальше аналогично настраиваем правила для **изменённые сообщения**:

<figure><img src="/files/A5UGMoYDK4MmiJsnD6zO" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/eipsCQ4T2rAct3eTgjpt" alt=""><figcaption></figcaption></figure>

1\. Заполняем поле - **Название правила**

2. Выбираем - **Любые из заданных условий**: **Изменения выполнены** - **пользователем**; **Добавлен ответ** - **в обращении при активном чате**
3. Нажимаем - **Добавить действие**
4. Выбираем **Выполнить вебхук** и метод **POST**
5. Вставляем скопированный **URL для получения уведомлений**
6. Стандартный запрос, выбираем **- JSON**
7. Выбираем необходимые поля
8. Нажимаем - **Создать правило**

#### На этом интеграция закончена.

### Важно помнить о лимитах на количество запросов в зависимости от вашего тарифного плана:

<figure><img src="/files/gmKaFePWuDFcoDuqJiFO" alt=""><figcaption></figcaption></figure>


---

# 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://docs.suvvy.ai/ru/kanaly/khelpdesk-sistemy/omnidesk.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.