Интеграция WhatsApp в Rocket.Chat с помощью GREEN-API#

Хотите объединить возможности WhatsApp с удобством платформы Rocket.Chat? С нашим приложением GREEN-API это легко!

В этом руководстве мы покажем, как установить приложение, зарегистрировать рабочее пространство и агентов, создать и подключить GREEN-API инстанс для эффективной работы с WhatsApp прямо из Rocket.Chat.

Это краткая версия инструкции, если нужны подробности - смотрите наше видео.

Содержание#

• Видеоинструкция
• Шаг 1. Установка приложения GREEN-API
• Шаг 2. Создание канала для управления WhatsApp
• Шаг 3. Получение Personal Access Token
• Шаг 4. Регистрация рабочего пространства
• Шаг 5. Регистрация агента
• Шаг 6. Регистрация агента в интеграции
• Шаг 7. Создание GREEN-API инстанса
• Шаг 8. Подключение инстанса и начало работы
• Заключение

Видеоинструкция#

Шаг 1. Установка приложения GREEN-API#

1. В Rocket.Chat нажмите на три вертикальные точки в меню и выберите “Marketplace”.

   

2. В поисковой строке Marketplace введите “GREEN-API WhatsApp”.

3. Найдите приложение GREEN-API WhatsApp в результатах поиска, нажмите на него и нажмите “Install”.

   

4. Если в вашем рабочем пространстве используется тариф Community, появится окно с условиями. Нажмите “Next” и затем “Agree” для продолжения установки.

5. После установки вы увидите уведомление в правом верхнем углу: “GREEN-API WhatsApp installed”.

Шаг 2. Создание канала для управления WhatsApp#

1. Вернитесь на главную страницу Rocket.Chat.

2. Нажмите на кнопку создания нового канала.

   

3. Дайте каналу имя, например “GREEN-API WhatsApp”. Вы можете выбрать любое удобное для вас имя.

Шаг 3. Получение Personal Access Token#

1. Нажмите на значок своего профиля в левом верхнем углу и выберите “Profile”.

   

2. В боковой панели выберите “Personal Access Tokens”.

3. Создайте токен, нажав “Add”.

4. Введите имя для токена, чтобы его было легко идентифицировать.

   

5. Система запросит ваш пароль. Введите его и нажмите “Verify”.

6. Вы увидите свой токен и User ID. Они будут показаны только один раз, поэтому обязательно сохраните их в надежном месте!

   

Шаг 4. Регистрация рабочего пространства#

1. Вернитесь в канал, созданный на Шаге 2.

2. Начните вводить команду /, чтобы увидеть список доступных команд. Выберите /greenapi.register-workspace.

   

3. Введите аргументы:

   • В качестве первого аргумента введите свой User ID (полученный на Шаге 3).
   • В качестве второго аргумента введите свой Personal Access Token (полученный на Шаге 3).

Шаг 5. Регистрация агента#

1. На главной странице нажмите на три вертикальные точки и выберите “Omnichannel”.

   

2. В боковой панели выберите “Agents”.

3. Введите имя агента в поле “Username”, выберите нужного агента и нажмите “Add”.

4. Для получения сообщений, статус агента должен быть “Available” (Доступен).

   

Шаг 6. Регистрация агента в интеграции#

1. Вернитесь в канал, созданный на Шаге 2.

2. Начните вводить команду /, чтобы увидеть список доступных команд. Выберите /greenapi.register-agent.

   

3. Введите аргументы:

   • В качестве первого аргумента введите свой User ID (из аккаунта агента).
   • В качестве второго аргумента введите свой Personal Access Token (из аккаунта агента).

Важно: если агент является одновременно администратором workspace, он может использовать те же User ID и Personal Access Token, которые он создал как администратор.

Шаг 7. Создание GREEN-API инстанса#

1. Перейдите в личный кабинет GREEN-API. Если у вас нет аккаунта, зарегистрируйтесь и создайте свой первый инстанс. Вы получите ID и токен инстанса. Каждый агент не должен регистрироваться отдельно. Администратор может создать единую учетную запись и управлять всеми инстансами там.

   

2. Вернитесь в канал, созданный на Шаге 2.

3. Начните вводить команду /, чтобы увидеть список доступных команд. Выберите /greenapi.create-instance.

   

4. Введите аргументы:

   • В качестве первого аргумента введите ID инстанса (idInstance).
   • В качестве второго аргумента введите токен инстанса (apiTokenInstance).

Шаг 8. Подключение инстанса и начало работы#

1. После выполнения команды вы увидите сообщение об успешном создании инстанса. Необходимо подождать около 5 минут, пока настройки применятся. Этот инстанс будет связан с агентом, создавшим его.
2. Теперь вы можете получать сообщения из WhatsApp и общаться с клиентами прямо из Rocket.Chat!
3. Вы можете отправлять текст, эмодзи, файлы и другие типы сообщений.

Заключение#

Следуя этим простым шагам, вы сможете интегрировать WhatsApp в Rocket.Chat с помощью GREEN-API, создать и подключить GREEN-API инстанс, и начать эффективно управлять общением с клиентами. Администраторы workspace имеют доступ к дополнительным командам, о которых можно прочитать в документации на нашем сайте.

GREEN-API всегда рад помочь вам в интеграции WhatsApp с другими платформами.