Чат / Интеграция со Slack

Интеграция со Slack

Если вы используете корпоративный мессенджер Slack, интегрируйте его с Чатом. Это позволит вам общаться с сотрудниками Иксолла напрямую, без создания дополнительных гостевых учетных записей пользователей или использования сторонних решений.

Процесс обмена сообщениями между Чатом и Slack изображен на схеме:

Чтобы интегрировать Чат со Slack:

  1. Войдите в аккаунт Slack.
  2. Создайте приложение в Slack.
  3. Настройте разрешения для приложения.
  4. Добавьте приложение в канал Slack.
  5. Подпишитесь на события.

Создание приложения в Slack

  1. Перейдите на страницу создания приложения в Slack.
  2. Выберите создание приложения с нуля.

  1. Заполните поля:
    1. В поле App Name введите название приложения. Пример: Chat Xsolla.
    2. В поле Pick a workspace to develop your app in выберите рабочее пространство, в которое вы хотите добавить приложение.
  2. Нажмите Create App.

Настройка разрешений для приложения

  1. На странице вашего приложения перейдите в раздел Features > OAuth & Permissions. Если вы находитесь на другой странице, перейдите к вашим приложениям и выберите из списка приложение, созданное на предыдущем этапе. Затем перейдите в раздел Features > OAuth & Permissions.

  1. В блоке Scopes нажмите Add an OAuth Scope и добавьте следующие разрешения:
    • channels:history — для просмотра истории сообщений в общедоступном канале с добавленным приложением.
    • chat:write — для отправки сообщений от имени приложения.
    • chat:write.customize — для отправки сообщений от имени приложения с возможностью настройки имени пользователя и аватара. Это разрешение позволяет вам идентифицировать представителя Иксоллы, с которым вы разговариваете.
    • files:read — для просмотра общедоступных файлов и прямых сообщений с помощью добавленного приложения.
    • groups:history — для просмотра истории сообщений в приватном канале с добавленным приложением.
    • im:history — для просмотра истории сообщений в личной переписке с добавленным приложением.
    • users:read — для просмотра информации о пользователях. Это разрешение позволяет представителям Иксоллы идентифицировать пользователя, с которым они общаются. Если данное разрешение не будет добавлено, сообщения будут анонимными.

  1. Чтобы добавить приложение в ваше рабочее пространство, перейдите в раздел OAuth & Permissions > OAuth Tokens & Redirect URLs и нажмите Install to Workspace.

  1. Чтобы подтвердить добавление разрешений, нажмите Allow.

Добавление приложения в канал Slack

  1. Откройте ваше рабочее пространство в Slack и выберите каналы, в которые вы хотите добавить приложение. Если необходимо, создайте новый приватный или публичный канал, выбрав +Add channels.
  2. Чтобы добавить приложение в канал, перейдите в раздел Show channel details.

  1. Перейдите в раздел More > Add apps.

  1. Выберите приложение из списка и нажмите Add.

Подписка на события

Чтобы ваши сообщения отправлялись в Чат, настройте подписку на события для вашего приложения:

  1. Передайте аккаунт-менеджеру проекта следующие данные:
    • Секретную подпись.
    • Токен.
    • Ссылки на каналы или ID каналов, в которые вы добавили ваше приложение. Это необходимо, чтобы подключить каналы из Чата к каналам в Slack. Чтобы получить ссылку, откройте контекстное меню канала и выберите Copy link.

Note
Если у вашего проекта нет аккаунт-менеджера, вы можете передать данные через виджет Чата в нижнем углу экрана в Личном кабинете Иксолла или на сайте документации.

  1. Получите URL-адрес для настройки событий у аккаунт-менеджера проекта.
  2. Перейдите на страницу Your Apps и откройте созданное вами приложение.

  1. На странице вашего приложения перейдите в раздел Event Subscriptions > Enable Events, установите переключатель Enable Events в положение On и вставьте полученный URL-адрес в поле Request URL.
  2. Убедитесь, что поле помечено как Verified. Если отметки нет, проверьте правильность URL-адреса или обратитесь к аккаунт-менеджеру проекта.
  3. Перейдите в раздел Event Subscriptions > Subscribe to bot events, нажмите Add Bot User Event и подпишитесь на следующие события:
    • message.im — отправка нового сообщения в личные сообщения в приложении.
    • message.groups — отправка нового сообщения в приватный канал.
    • message.channels — отправка нового сообщения в публичный канал.
    • file_shared — отправка пользователем файлов в личных сообщениях в приложении или в каналах, в которых добавлено приложение.

  1. Нажмите Save Changes.

Получение секретной подписи

Данная подпись используется для валидации запросов от приложений. Для ее получения на странице вашего приложения перейдите к разделу Basic information > App Credentials. Перейдите к полю Signing Secret, нажмите Show и скопируйте значение поля.

Получение токена

Данный токен используется для отправки сообщений из Чата в Slack. Чтобы получить токен:

  1. На странице вашего приложения перейдите в раздел Features > OAuth & Permissions.
  2. Скопируйте токен аутентификации из поля Bot User OAuth Token.

Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Оценить страницу
Оценить страницу
Что может сделать страницу еще лучше?

В другой раз

Спасибо за обратную связь!
Последнее обновление: 6 августа 2021

Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

Сообщите о проблеме
Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
Укажите email-адрес, чтобы мы могли связаться с вами
Спасибо за обратную связь!