> 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="https://342844369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq4WjYxFhwMfMHFcGmR97%2Fuploads%2Fg5wfI6Ui5flKsDJTdoZR%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202024-02-22%20%D0%B2%2013.39.40.png?alt=media&amp;token=6a2f3963-3714-4198-ba14-54f218295ed3" 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="https://342844369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq4WjYxFhwMfMHFcGmR97%2Fuploads%2FDeZj0zSxUBEbSD2ByWEk%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202024-02-22%20%D0%B2%2013.57.23.png?alt=media&amp;token=e88f5918-f1ad-4a0c-9529-8aca8f96b5f8" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://342844369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq4WjYxFhwMfMHFcGmR97%2Fuploads%2FqLkOT62jjq9FrEDnT9N2%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202024-02-22%20%D0%B2%2014.04.17.png?alt=media&amp;token=3afb338d-c826-4e6f-8871-676356e4f858" 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 %}