Подключения
Битрикс24
Агент как чат-бот в чатах портала Битрикс24: входящий вебхук с правом imbot, подключение, правила ответов, одобрение сотрудников, лимиты и ошибки.
Обновлено:
На этой странице
Что умеет агент
- Получает все сообщения в чатах, куда добавлен бот, и хранит их как контекст для следующих ответов.
- Скачивает вложения из сообщений (до 50 МБ) и работает с ними.
- Отвечает с форматированием Битрикс24 и показывает, что печатает. Отправлять файлы в чат Битрикс24 агент пока не умеет.
Доступ и оплата
Подключение использует входящий вебхук портала: все вызовы идут от имени пользователя Битрикс24, создавшего вебхук. Через него регистрируется отдельный чат-бот. Вебхук хранится зашифрованным и в браузер не возвращается.
Платит владелец подключения. Подключение портала стоит 10 единиц энергии один раз; расход по сотрудникам виден на карточке подключения («Энергия по пользователям»).
Как подключить
В Битрикс24
- Войдите в портал как администратор: создавать вебхуки может только администратор.
- Откройте «Приложения → Разработчикам → Другое → Входящий вебхук».
- В правах вебхука отметьте «Создание и управление Чат-ботами (imbot)». Без этого права подключение не пройдёт.
- Сохраните и скопируйте URL целиком, вида
https://portal.bitrix24.ru/rest/1/abc…/. В нём уже есть домен портала и токен.
В кабинете
- Откройте Интеграции → Битрикс24 и нажмите «Подключить Битрикс24».
- Вставьте вебхук в поле «Входящий вебхук», задайте имя бота и нажмите «Создать».
- Добавьте бота в чаты портала, где он должен работать.
На карточке подключения есть проверка связи, отключение, смена вебхука или имени, удаление и список участников. Отключение останавливает бота.
Чаты и пространства
Каждый чат портала, куда пишут боту, и каждый личный диалог с ним автоматически становятся отдельным пространством владельца подключения. Внешние сервисы привязываются к этим пространствам по пространству, по тегу или по интеграции (см. Подключения и пространства). Яндекс Диск можно привязывать к новым таким пространствам автоматически.
Когда бот отвечает
- В личном диалоге: на каждое сообщение.
- В групповом чате: когда бота упоминают, называют по имени («Окто», «Octo») или по прозвищу, заданному для пространства.
Ограничения
- Одно подключение на портал у одного владельца.
- Бот проверяет новые сообщения каждые 3 секунды и сам замедляется, если Битрикс24 просит подождать.
- Действуют лимиты расхода владельца: на пространство или на сотрудника.
Решение проблем
- «Вебхук отклонён: выдайте право imbot»
- Пересоздайте входящий вебхук с правом «Создание и управление Чат-ботами (imbot)» и вставьте новый URL.
- «Это не похоже на URL REST-вебхука»
- Вставьте URL целиком, с /rest/, номером пользователя и токеном, а не только домен портала.
- «Не удалось связаться с порталом» или ответ HTTP с ошибкой
- Проверьте адрес портала в вебхуке и что вебхук не удалён в Битрикс24.
- «Недостаточно энергии для подключения (нужно 10)»
- Пополните баланс и повторите.
- «Подключение для этого портала уже существует»
- Используйте существующую карточку: в ней можно сменить вебхук или имя бота.
- Бот молчит в чате
- Бот добавлен в чат? К нему обратились по имени или упоминанием? Автор ждёт одобрения (см. отметку на карточке подключения)? Подключение не отключено?