Интеграции

Интеграции — это сохранённые подключения к внешним сервисам, которые используют ноды агента. Раздел «Интеграции» состоит из двух частей:

• Коннекторы — подключения к бизнес-сервисам (Wildberries, amoCRM, 1С, МойСклад и другим). Агент работает с ними через ноду «Интеграция»: читает отзывы, отвечает на вопросы, создаёт задачи и лиды, смотрит заказы и остатки.
• Подключения нод — Telegram-боты, почтовые ящики (IMAP/SMTP) и HTTP-авторизации для нод «Telegram», «Email» и «HTTP».

Подключение создаётся один раз и потом выбирается в нодах агента. Одно подключение можно использовать в нескольких агентах.

Для приёма входящих сообщений Telegram-ботом в режиме 24/7 используется отдельная секция на странице агента — см. «Подключение Telegram».

Полный список коннекторов — в блоке «Подключить сервис» раздела «Интеграции»; их больше двадцати, и список пополняется. Их использует нода «Интеграция». Основные категории:

• Маркетплейсы — Wildberries (отзывы и вопросы покупателей), Ozon (отзывы), Яндекс Маркет.
• CRM — amoCRM, Bitrix24, RetailCRM.
• Учёт и склад — 1С (OData), МойСклад, InSales.
• Задачи и файлы — Яндекс.Трекер, Яндекс.Диск.
• Платежи — Т-Банк, Точка Банк, CloudPayments.
• Данные и рассылки — DaData, Контур.Фокус, Яндекс Метрика, Unisender, GetCourse.

1. В разделе «Интеграции» в блоке «Подключить сервис» выберите нужный сервис.
2. Задайте название подключения.
3. Введите данные авторизации (API-ключ или токен). Для сервисов с OAuth (например, Яндекс.Диск) после нажатия «Подключить» откроется страница авторизации сервиса.
4. Нажмите «Подключить» — сервис появится в списке «Подключённые сервисы».

Рядом с каждым сервисом в блоке «Доступные коннекторы» виден список его операций (например, «Список отзывов», «Ответить на отзыв») — в ноде «Интеграция» операция выбирается из выпадающего списка, ключи вводить не нужно.

По некоторым сервисам есть подробные инструкции: 1С (OData), RetailCRM, МойСклад, Яндекс.Трекер.

1. Откройте раздел «Интеграции» в левом боковом меню.
2. Нажмите «Добавить» в правом верхнем углу.
3. Выберите тип: Telegram-бот, Email (IMAP/SMTP) или HTTP API.
4. Заполните форму (инструкции ниже по каждому типу).
5. Сохраните подключение — оно появится в списке «Подключения нод».

Используется нодой «Telegram» для отправки сообщений в чат или канал.

1. Создайте бота в @BotFather и скопируйте токен.
2. В форме интеграции выберите тип «Telegram-бот».
3. Задайте произвольное название (например, «Бот продаж»).
4. Вставьте токен в поле «Токен бота».
5. Нажмите «Подключить».

Чтобы бот смог отправить сообщение в канал, предварительно добавьте его в канал с правами администратора.

Используется нодой «Email» для чтения входящих писем (IMAP) и отправки исходящих (SMTP).

1. В форме интеграции выберите тип «Email».
2. Выберите поставщика: Яндекс, Mail.ru, Gmail или «Другой». Для стандартных поставщиков настройки серверов подставятся автоматически.
3. Введите адрес электронной почты и пароль приложения. Не используйте основной пароль — создайте пароль приложения в настройках почты.
4. Нажмите «Подключить».

Используется нодой «HTTP» для обращения к любому внешнему API с авторизацией.

1. В форме интеграции выберите тип «HTTP API».
2. Задайте название (например, «Мой API», «Внешняя CRM»).
3. Укажите базовый URL (корень API, без конкретного пути — он задаётся в ноде).
4. Выберите тип авторизации: Bearer-токен, Basic (логин/пароль), API-ключ в заголовке или параметре, или «Без авторизации».
5. Введите соответствующие данные и нажмите «Подключить».

1. Откройте агента и добавьте ноду «Telegram», «Email» или «HTTP».
2. Кликните по ноде — в правой панели появится поле «Подключение».
3. Выберите нужную интеграцию из выпадающего списка. Авторизация подставится автоматически.
4. Заполните остальные поля ноды (Chat ID, адрес получателя и т.д.).

Нода «Интеграция» (коннекторы) настраивается иначе: в ней подключение и операция выбираются из выпадающих списков с русскими названиями — UUID и английские ключи вводить не нужно. Параметры операции задаются в поле «Параметры (JSON)»; заполнить его поможет копилот.

1. В разделе «Интеграции» найдите нужное подключение и нажмите кнопку удаления справа.
2. Подтвердите удаление. Ноды агентов, которые использовали это подключение, потеряют привязку — проверьте их настройки.