Яндекс Мессенджер

Что умеет агент

• Получает все сообщения в чатах, куда добавлен бот, и сохраняет вложения (до 50 МБ).
• Отвечает текстом, ставит реакции, показывает, что печатает, и присылает в чат подготовленные файлы.
• Называет пространство по реальному названию чата.

Доступ и оплата

Бот действует от своего имени, а не от имени сотрудника. Отдельных галочек прав (скоупов) у токена бота Мессенджера нет: токен сразу разрешает боту всё, что умеют боты. Вместо прав действуют два условия: выпустить токен может только администратор организации, и бот должен быть добавлен в чаты, которые он обслуживает.

Идентификатор организации вводить не нужно: Octo его не спрашивает, токен уже привязан к одному боту в одной организации. Токен хранится зашифрованным и в браузер не возвращается. Платит владелец подключения; подключение стоит 10 единиц энергии один раз.

Как подключить

1. Администратор организации открывает админку Яндекс 360 → Мессенджер → «Боты в Мессенджере»: admin.yandex.ru/bot-platform.
2. «Создать бота»: задайте имя, которое увидят в чатах. Токен сформируется и скопируется в буфер обмена. Яндекс не хранит токены ботов: потерянный токен можно только перевыпустить («Перевыпустить токен» в настройках бота).
3. В кабинете откройте Интеграции → Яндекс Мессенджер, вставьте токен в поле «OAuth-токен бота», при желании задайте метку и нажмите «Создать».
4. Нажмите «Проверить». При создании токен не проверяется, поэтому проверка обязательна.
5. В Мессенджере добавьте бота в нужные чаты через список участников, по имени бота.

Можно подключить и из Telegram: отправьте боту @octomatica_bot команду /yandex в личном чате. Сообщение с токеном бот сразу удаляет.

Чаты, пространства и консоль

Каждый чат, где есть бот, автоматически становится отдельным пространством владельца подключения. Для организации открывается консоль интеграции: сотрудники и их расход, месячный лимит на сотрудника, пространства, набор возможностей по умолчанию, совладельцы и общий Яндекс Диск организации.

Другие сервисы привязываются к этим пространствам по пространству, по тегу или по интеграции: Подключения и пространства.

Когда бот отвечает

• В личном чате: на каждое сообщение.
• В групповом чате: когда к боту обращаются по имени («Окто», «Octo») или прозвищу, отвечают на его сообщение или пишут в ветке, которую начал бот.
• Первое обращение нового сотрудника ждёт одобрения владельца подключения, как в Битрикс24.

Ограничения

• Мессенджер работает только через опрос (getUpdates), без вебхука: бот проверяет новые сообщения каждые 3 секунды.
• Одно подключение на организацию у одного владельца.
• Месячный лимит на сотрудника (в консоли) действует во всех пространствах организации, вместе с лимитами пространств.

Решение проблем

Проверка: «HTTP 401 от Яндекса»

Токен не работает: скопирован не полностью, взят не у бота (например, токен «Яндекс ID») или уже перевыпущен. Выпустите токен заново в «Ботах в Мессенджере» и вставьте новое значение.

Проверка: «HTTP 403 от Яндекса»

Токен в порядке, но боты в организации выключены. Администратор организации Яндекс 360 должен включить ботов.

Проверка: «Не удалось связаться с Яндексом»

Это не про ваш токен. Наша сторона не достучалась до botapi.messenger.yandex.net: проблема в нашем сетевом доступе, а не в ваших настройках. Повторите позже и напишите в поддержку, если ошибка не уходит.

«Подключение для этой организации уже существует»

Этот токен уже подключён. Меняйте токен или метку на существующей карточке.

Бот молчит

Бот добавлен в чат? К нему обратились по имени, ответом на его сообщение или в его ветке? Автор ждёт одобрения?