Содержание руководства
Для подключения нужен бот вашей организации в Яндекс 360 и его токен — секретный ключ доступа. Администратор создаёт бота в Яндексе, а владелец подключения добавляет его в Octo и одобряет участников. Программировать или настраивать вебхук не потребуется.
Что подготовить
- Организация в Яндекс 360 с доступом к бот-платформе. Создать бота может администратор организации. Если вы не администратор, попросите его выполнить первый шаг и безопасно передать токен.
- Аккаунт Octomatica с доступом к разделу «Интеграции». Настройку удобнее пройти в веб-версии.
- Рабочий чат Яндекс Мессенджера внутри вашей организации, в который можно добавить бота. Начните с отдельного чата для проверки.
Создайте бота в Яндекс 360
Откройте бот-платформу под аккаунтом администратора организации. Нажмите «Создать бота», задайте имя, например Octo, добавьте аватар и нажмите «Создать».
Яндекс выдаст OAuth-токен бота. Сохраните его: позже посмотреть этот же токен нельзя. Если потеряли — выпустите новый; старый перестанет работать.
Токен нужен только для поля подключения в Octo. Не отправляйте его в чат агенту, в поддержку или на скриншоте. Это токен бота, а не вашего личного Яндекс ID.
Добавьте бота в рабочий чат
В Яндекс Мессенджере откройте нужный чат, перейдите к его участникам и добавьте созданного бота по имени.
Бот получает все сообщения чата, в который его добавили: обращаться через @ не обязательно. В чаты, где он не состоит, доступа нет. Поэтому выбирайте чат с подходящим рабочим контекстом.
Подключите бота к Octo
В веб-версии Octomatica откройте «Интеграции» → «Yandex Messenger». Нажмите «Подключить Yandex Messenger».
Вставьте сохранённый ключ в поле «OAuth-токен бота». При желании заполните «Метка (необязательно)» — например «Команда маркетинга». Нажмите «Создать».
У созданного подключения нажмите «Проверить». Успешная проверка подтверждает, что Octo может обратиться к Яндексу с этим токеном. Теперь проверьте ответ в самом чате.
Для Мессенджера не нужны ID организации и отдельная настройка вебхука. Достаточно токена бота.
Одобрите участника и получите ответ
Напишите боту в подключённом чате. Для проверки достаточно простого сообщения ниже.
Владелец подключения должен открыть «Участники» в настройках этой интеграции в Octo и одобрить отправителя. Новый участник сначала ожидает одобрения: его задачи ещё не выполняются и не оплачиваются.
После одобрения Octo обработает ожидающие сообщения. Вернитесь в Яндекс Мессенджер и убедитесь, что ответ пришёл именно в нужный чат. Повторите одобрение для коллег, которые будут ставить задачи агенту.
Привет, Octo! Проверяем подключение. Ответь коротко, что получил это сообщение.
Пример результата
Первая рабочая задача
- Отправьте свои заметки после встречи и попросите: «Собери краткий итог. Отдельно выпиши решения, задачи с ответственными и сроками, открытые вопросы. Если данных не хватает, так и напиши».
- Проверьте имена, сроки и договорённости по заметкам. Уточните формат в том же диалоге.
- Подключённые Диск, Почта или Трекер расширят доступные задачи. Само подключение Мессенджера не даёт агенту доступ к этим сервисам.
Главный нюанс и проверка
Успешная проверка токена ещё не означает, что все участники могут работать с ботом. Полная проверка — сообщение от одобренного участника и ответ Octo в нужном чате.
Перед тем как использовать результат
- Бот добавлен в нужный чат организации.
- Подключение включено, проверка проходит без ошибки.
- Отправитель одобрен в разделе «Участники».
- Ответ появился в Яндекс Мессенджере.
Как повторить на своей задаче
Когда первая задача получилась, попросите Octo сохранить ваш порядок работы и требования к результату. В следующий раз передайте новые материалы и попросите повторить задачу по этим правилам.
Если не получается
Нет доступа к созданию бота
Ботов создаёт администратор организации Яндекс 360. Попросите его открыть бот-платформу и создать бота. Если раздел недоступен и ему, нужно проверить доступность сервиса для вашей организации в Яндексе.
Проверка проходит, но бот молчит
Убедитесь, что подключение включено, а бот добавлен именно в этот чат. Затем откройте «Участники» в настройках интеграции и одобрите отправителя. До одобрения его сообщения ожидают обработки.
Ошибка 401 или 403
Проверьте, что скопирован полный токен нужного бота. Если его перевыпускали, старый уже недействителен. В Octo откройте «Настроить», вставьте новый токен, нажмите «Сохранить», затем «Проверить».
Ошибка «Could not reach Yandex»
Octo не удалось связаться с Яндексом. Повторите проверку позднее. Если ошибка сохраняется, обратитесь в поддержку через Octo: сообщите время и текст ошибки, но не отправляйте токен.
Такое подключение уже существует
Найдите существующее подключение и откройте «Настроить». Обновите его параметры вместо создания второго подключения для того же бота.
Вход через Яндекс уже подключает Диск и Почту?
Нет. Вход через Яндекс ID — это вход в аккаунт Octomatica. Мессенджер, Диск, Почта и Трекер подключаются отдельно. Для Диска, Почты и Трекера также нужно выбрать рабочее пространство, которому вы предоставляете доступ.
Подключите своего бота
Начните с небольшого рабочего чата и одной понятной задачи.