> For the complete documentation index, see [llms.txt](https://docs.fstrk.io/knowledge_base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fstrk.io/knowledge_base/intagrations/omnidesk/podklyuchenie-integracii.md).

# Подключение интеграции

## Подготовка к интеграции

Для интеграции вам потребуются:

1. Домен вашего аккаунта в Omnidesk
2. API-ключ
3. Почта администатора в Omnidesk (или другого сотрудника с достаточным набором прав)
4. Идентификатор канала

### Домен

Скопируйте домен вашего аккаунта в Omnidesk:

<figure><img src="/files/4m6OLTmdOTlhZju6iCrv" alt=""><figcaption></figcaption></figure>

### API-ключ

Откройте настройки проекта, перейдите в раздел "API" и нажмите "Добавить API-ключ"

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

Оставьте примечание (не обязательно) и нажмите "Добавить"

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

После сохранения в таблице появится API-ключ. Скопируйте его для настроек в Fasttrack.

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

### Почта сотрудника

В настройках Fasttrack вам необходимо указать почту владельца API-ключа.

{% hint style="warning" %}
Все запросы будут отправляться с API-ключом и почтой ответственного сотрудника. Важно убедиться что у сотрудника с указанной почтой есть соответствующий уровень доступа в Omnidesk.
{% endhint %}

### Идентификатор канала

Fasttrack работает через кастомный канал в Omnidesk. Чтобы получить идентификатор такого канала, его нужно создать и настроить через интерфейс Omnidesk.

* Откройте раздел "Каналы" → "Кастомные каналы".
* Нажмите кнопку "Добавить кастомный канал"

<figure><img src="/files/6Dp4NLtxyYuChvAvgEUU" alt=""><figcaption></figcaption></figure>

* Заполните поля с настройками канала
* Нажмите кнопre "Создать канал"

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

<table><thead><tr><th width="217.23046875">Настройка</th><th>Комментарий</th></tr></thead><tbody><tr><td>Название</td><td>Произвольное название для канала</td></tr><tr><td>Группа по умолчанию</td><td>Тематика канала в Omnidesk</td></tr><tr><td>Webhook URL</td><td><p>Адрес сервера Fasttrack для получения событий из Omnidesk.</p><pre data-overflow="wrap"><code>https://dashboard.fstrk.io/integrations/omnidesk/chats/webhooks/:bot uuid/new_message/
</code></pre><ul><li>:bot uuid – идентификатор вашего проекта в Fasttrack.</li></ul></td></tr><tr><td>Тип канала</td><td>Обязательно указать "<strong>Синхронный</strong>" тип канала.</td></tr></tbody></table>

После сохранения нового каналы вы можете скопировать его идентификатор.

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

## Настройки в Fasttrack

* Авторизуйтесь в Fasttrack и откройте проект
* Перейдте в раздел "Интеграции"
* Найдите карточку "Omnidesk"
* Заполните поля формы настройки интеграции
* Нажмите "Подключить"

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

## Дополнительные заметки

* У всех сотрудников, которые будет общаться через кастомный канал, который проинтегрирован с Fasttrak, в настройках профиля долна быть установлена галочка для работы с кастомным канолом.

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