Настройка интеграции#

Slack — это корпоративный мессенджер, предназначенный под рабочее общение сотрудников внутри команд любого размера.

В сервисе Slack платформа Green-API имеет свое приложение, с его помощью Вы сможете отправлять сообщения в WhatsApp.

Чтобы воспользоваться приложением Green API, нужно получить регистрационный токен и ID инстанса в личном кабинете. Для тестирования нашего API рекомендуем воспользоваться бесплатным тарифом разработчика.

Порядок настройки интеграции:
1. Настройка приложения Slack
2. Настройка приложения Green API
3. Получение сообщения
4. Отправка сообщения

1. Настройка приложения Slack#

• Войдите или создайте новое робочее пространство в Slack.

Как создать рабочее пространство?

1. Нажмите на кнопку Create a new workspace
2. На новой странице нажмите на кнопку Create a workspace

Слак создает новое рабочее пространство, в котором надо настроить имя, пользователей и каналы. Порядок настройки:

• В поле What's the name of your company or team введите название рабочего пространства и нажмите на кнопку Next
  

  

• В поле What's your name введите имя Вашего аккаунта, также можете сменить фотографию Вашего аккаунта. После нажмите на кнопку Next
  

  

• В поле Who else is on the 'Name' team? можете добавить других пользователей или работников через почту. Также можете скопировать ссылку приглашение, нажав на кнопку Copy Invite Link. После нажмите на копку Next или можете пропустить добаление пользователей, нажав на кнопку Skip this step
  

  

• В поле What's your team working on right now? введите название публичного канала. После нажмите Next
  

  

Готово! Рабочее пространство готово к использованию!

• Добавьте приложения Green API в рабочее пространство. Для этого перейдите по ссылке.

• Выберите рабочее пространство куда будет устанавливатся приложение Green API и нажмите на кнопку Allow, чтобы разрешить использование приложения.
  

  

• В разделе Apps можете проверить доступность приложения.
  

  

2. Настройка приложения Green API#

• Войдите или зарегистрируйте учетную запись в Green API.
• Создайте инстанс на бесплатном тарифе "Developer". Для этого в личном кабинете нажмите кнопку Создать инстанс. Для тестирования выберите тариф "Developer".

• Авторизуйте телефон. Для этого:

  Можно отсканировать QR-код на странице настройки инстанса. В мобильном приложении WhatsApp или WhatsApp Business войдите в связанные устройства и отсканируйте полученный QR-код.

  

  Или запросите шестизначный код авторизации для привязки по номеру телефона. В мобильном приложении WhatsApp или WhatsApp Business войдите в связанные устройства и нажмите Связать по номеру телефона.

  

После успешной авторизации, в личном кабинете инстанс должен получить статус Авторизован (Статус не всегда может автоматически менять статус, в случаи необходимости нужно сделать обновление страницы). Проверить статус инстанса вы можете используя метод GetStateInstance.

• Скопируйте значения idInstance и apiTokenInstance, эти значения нужны для настройки работы инстанса со Slack.

3. Получение сообщения#

Для получения сообщении в Slack требуется настроить приложение Green API в канале.

Порядок добавления приложения в канал:#

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

• В канале нажмите на кнопку просмотра пользователей.
  

  

• В окне просмотра пользователей перейдите в интеграции, нажав кнопку Integrations.

  

• Нажмите на кнопку Add an App, чтобы перейти на список доступных приложении.

  

• Нажмите на кнопку Add рядом с приложеним Green API в списке In your workspace

  

Готово! Приложение добавлено в канал!

Порядок настройки приложения в канале:#

• Введите / или нажмите на кнопку чтобы вывести список команд

• Введите /greenapi add "idInstance" and "apiTokenInstance", чтобы добавить инстанс в канал. Вставьте значения Вашего инстанса вместо idInstance и apiTokenInstance (Получение сообщений будет вестись с номера привязанного к этому инстансу)

• Если инстанс добавлен успешно в канале появится сообщение от бота: The instance has been successfully added.

• Введите /greenapi start "idInstance", чтобы начать получать сообщения от WhatsApp.

• Если получение сообщении запустилось успешно, в канале появится сообщение от бота: Started receiving incoming notifications.

"webhookUrl": "https://slack.greenapi.com/webhook",
"webhookUrlToken": "1dc99fe0bdb93c0a...............................................",
"incomingWebhook": "yes"

• Пример входящего сообщения

  При получении входящего сообщения бот формирует тред(чат), указывая номер телефона, имя отправителя и номер инстанса.
  Чтобы увидеть входящее сообщение, нажмите на reply.
  

4. Отправка сообщения#

Для отправки сообщении в Slack требуется получить входящее сообщение, на которое формируется ответ.

• Нажмите на кнопку или на reply, чтобы открыть тред(чат)

• В появившемся треде(чате) сформируйте сообщение и нажмите на кнопку отправки

Готово! Вы отправили сообщение!

Примеры сообщении#

• Примеры сообщении в Slack
  

  

• Примеры сообщении в WhatsApp

  

Готово! Вы можете отправлять и получать сообщения через Slack!