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

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

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

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>


---

# 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.fstrk.io/knowledge_base/intagrations/omnidesk/podklyuchenie-integracii.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.