# Интеграции

<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 %}


---

# 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://assistant-docs.2people.io/for-users/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.