Перейти к содержанию

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

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

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

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

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

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

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

login-slack

Как создать рабочее пространство?
  1. Нажмите на кнопку Create a new workspace
  2. На новой странице нажмите на кнопку Create a workspace

workspace

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

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

    company-name

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

    personal-name

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

    add-coworker

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

    channel-name

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

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

    permission

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

    check-app

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

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

create-instance

developer

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

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

    scan-qr

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

    scan-qr

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

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

console

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

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

Важно

Используя приложение Green API в Slack вы не можете написать первым, вы должны получить входящее сообщение, на которое вы отправляете ответ.

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

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

    show-users

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

    go-to-integrations

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

    add-an-app

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

    add-green-api

added

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

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

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

commands-api

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

Также можете вставить скопированные значения из раздела "Настройка приложения Green API"

add-instance

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

success-add

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

start-instance

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

При успешном запуске получении сообщении автоматически устанавливается настройка инстанса:

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

Время установки настроек может занимать до 5 минут. В этот момент Вы не будете получать сообщения.

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

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

Примечание

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

example-incoming-message

incoming-message

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

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

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

create-message

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

sending-message

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

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

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

    example-1

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

    example

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