Подключение Rocket.Chat¶

Подключение Rocket.Chat¶

Rocket.Chat — это платформа для обмена сообщениями с открытым исходным кодом, предназначенная для командной работы и коммуникации.

Эта пошаговая инструкция поможет вам подключить чат-бот Wisebot в Rocket.Chat для упрощения процесса коммуникации, сбора данных и других бизнес-операций.

Этапы интеграции:

• Шаг 1. Создание бота в Rocket.Chat
• Шаг 2. Создание канала в Rocket.Chat
• Шаг 3. Настройка интеграции в Wisebot
• Шаг 4. Настройка интеграции в Rocket.Chat

Шаг 1. Создание бота в Rocket.Chat¶

Создайте нового пользователя, который будет выполнять функции бота и отвечать конечным пользователям в Rocket.Chat.

1. Авторизуйтесь в Rocket.Chat с правами администратора.

2. Вызовите меню и выберите пункт Рабочее пространство.

   

3. Откроется раздел Администрирование.

4. Перейдите в подраздел Пользователи и нажмите кнопку Новый пользователь.

   

5. Откроется форма создания нового пользователя.

6. Укажите адрес электронной почты, имя и логин.
7. Установите пароль. Сохраните логин и пароль, они понадобятся в дальнейшем.
8. Выберите роль Бот в поле Роли.
9. Нажмите Добавить пользователя.

В списке пользователей появится новый пользователь со статусом «На рассмотрении».

Авторизуйтесь в Rocket.Chat с учетными данными созданного бота, чтобы активировать учетную запись.

Шаг 2. Создание канала в Rocket.Chat¶

Создайте канал, в который будет подключен бот. Если у вас уже есть канал, вы можете пропустить этот шаг.

1. Авторизуйтесь в Rocket.Chat.

2. Вызовите меню по кнопке Создать и выберите пункт Канал.

   

3. Откроется форма создания нового канала.

   

4. Заполните все необходимые поля формы и нажмите Создать.

   Новый канал появится в списке каналов.

   

   Убедитесь, что канал доступен боту, созданному на предыдущем шаге. Если канал закрытый, добавьте бота в канал.

   

Шаг 3. Настройка интеграции в Wisebot¶

1. Откройте Wisebot и убедитесь, что настраиваете нужного бота. В боковом меню должно отображаться его имя.
2. Перейдите в раздел Настройки → Учетные данные.

3. Выберите вкладку со средой развертывания Development или Production.

   

4. Добавьте конфигурацию для Rocket.Chat.

   rocketchat:
     server_url: "https://your-rocket-chat-url"  # URL вашего Rocket.Chat
     user: "your-bot-username"            # Логин пользователя, созданного на шаге 2
     password: "your-bot-password"        # Пароль пользователя, созданного на шаге 2
   

   Замените значения URL, логина, пароля на свои.

   

5. Нажмите Сохранить и подтвердите перезапуск инстанса для выбранного окружения.

   

Сохраните значения base_url и socket_path. Они понадобятся на следующем шаге.

Шаг 4. Настройка интеграции в Rocket.Chat¶

Создайте новую интеграцию в Rocket.Chat.

1. Авторизуйтесь в Rocket.Chat с правами администратора.
2. Перейдите в раздел Администрирование → подраздел Интеграции.

3. Нажмите кнопку Новый.

   

4. В открывшейся форме перейдите на вкладку Исходящие.

5. Установите в Event Trigger вариант Сообщение отправлено.
6. Укажите название интеграции в поле Имя.
7. Укажите название созданного канала в поле Каналы. Название канала должно начинаться с символа #.

8. При необходимости настройте Слова-триггеры. Это позволит боту не реагировать на всё, что вы говорите. Он будет активироваться, когда вы обратитесь к нему. Например, в качестве триггера можно указать логин бота. Логин бота должна начинаться с символа @.

   

9. Укажите URL-адрес проекта Wisebot в формате https://your-domain.com/dev/123434/webhooks/rocketchat/webhook в поле URLs.

   Укажите значения, сохраненные на предыдущем шаге:

   • Замените your-domain.com на значение из строки base_url.
   • Замените /dev/123434/ на значение из строки socket_path (без /socket.io/ ).

   

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

    

11. Раскройте блок Дополнительные настройки и деактивируйте переключатель Повторный запрос по неудавшемуся URL.

    

12. Нажмите Сохранить в форме создания интеграции.

Дополнительную информацию о настройке вебхуков можно найти в Руководстве по Rocket.Chat.

Отправьте сообщение в созданном канале и убедитесь, что бот отвечает. Если все настроено правильно, бот будет обрабатывать сообщения и отправлять ответы.