> For the complete documentation index, see [llms.txt](https://assistant-docs.2people.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://assistant-docs.2people.io/for-users/integracii.md).

# Интеграции

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

{% hint style="info" %}
Ссылка на раздел с интеграциями: <https://assistant.2people.io/cabinet/integrations>
{% endhint %}

## Общая информация

Функционал интеграций позволяет интегрировать ваших ИИ-ассистентов в различные текстовые каналы коммуникации, такие как мессенджеры, чат-платформы, helpdesk-системы, CRM-системы и прочие.

## Список интеграций

Список ваших интеграций доступен по ссылке: <https://assistant.2people.io/cabinet/integrations>.\
При нажатии на интеграцию вы перейдете на страницу ее управления.

## Создание интеграции

Чтобы создать новую интеграцию, перейдите в раздел интеграций (<https://assistant.2people.io/cabinet/integrations>) и нажмите на кнопку "Создать" в карточке с нужными типом интеграции (например, Telegram-интеграции). После этого создастся новая интеграция с выбранным типом, и вас автоматически перебросит на страницу с ее управлением.

{% hint style="info" %}
Количество и типы доступных интеграций ограничены тарифом. Подробнее в разделе [Тарифы](/get-started/tarify.md).
{% endhint %}

## Управление интеграцией

{% hint style="info" %}
**Чтобы перейти к функционалу управления интеграцией:**

1. Зайдите на страницу со списком ваших интеграций: <https://assistant.2people.io/cabinet/integrations>
2. Выберите необходимую интеграцию и нажмите на нее (или создайте новую, нажав на кнопку "Создать")
3. Вас перебросит на страницу управления выбранной интеграцией
   {% endhint %}

Вы можете осуществить следующие действия с интеграцией

* изменить настройки интеграции
* изменить ассистента интеграции
* включить/отключить интеграцию
* удалить интеграцию

{% hint style="info" %}
Вы не можете изменить тип существующей интеграции. Только удалить текущую интеграцию и создать новую.
{% endhint %}

### Изменение настроек интеграции

Каждый тип интеграции имеет свой индивидуальной список настроек.

Изменять настройки можно только у невключенной (неактивной) интеграции.

### Изменение ассистента интеграции

В каждой интеграции обязательно должен быть указан один ИИ-ассистент, который будет интегрирован.

Изменять ИИ-ассистента можно только у невключенной (неактивной) интеграции.

### Включение/отключение интеграции

Чтобы включить (активировать) интеграцию, необходимо указать корректные настройки интеграции и указать ИИ-ассистента. По умолчанию все новые интеграции являются невключенными (неактивными).

### Удаление интеграции

Вы можете удалить только невключенную (неактивную) интеграцию.

## Типы и настройки интеграций

Сервис имеет готовые интеграции с популярными чат-платформами, helpdesk-системами, месcенджерами, CRM-системами, а также имеет свой API для интеграции с кастомными системами.

{% hint style="info" %}
В бесплатном тарифе "Старт" доступна только Telegram-интеграция (создание Telegram-бота). Читайте подробнее о тарифах в[ разделе Тарифы](/get-started/tarify.md).
{% endhint %}

### Telegram-интеграция

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

Telegram-интеграция позволяет превратить любого Telegram-бота в ИИ-ассистента.

Для активации Telegram-интеграции вам необходимо заполнить только токен вашего Telegram-бота ([инструкция, как его получить](/poleznoe/poluchenie-tokena-telegram-bota.md)) и выбрать ИИ-ассистента, которого хотите интегрировать.

### API-интеграция

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

API-интеграция предоставляет возможность кастомной интеграции с любой системой через протокол REST API.

Для активации API-интеграции вам необходимо только выбрать ИИ-ассистента, которого хотите интегрировать.&#x20;

Далее скопируйте ваш уникальный API-ключ для данной интеграции в настройках и следуйте документации по REST API:

{% content-ref url="/pages/l6ZjfQmprSXoEIF7GUD4" %}
[Документация REST API](/api-dlya-razrabotchikov/dokumentaciya-rest-api.md)
{% endcontent-ref %}

### Прочие интеграции

{% hint style="info" %}
Прочие интеграции пока не представлены на платформе и в документации, но вы можете получить к ним ранний доступ, отправив соответствующий запрос нашей службе поддержки: <assistant_help@2people.io>
{% endhint %}