Чат / Интеграция со 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.
  2. Отметьте канал, в который вы хотите добавить приложение. Если необходимо, создайте новый приватный или публичный канал.
  3. Откройте контекстное меню канала и выберите пункт Open channel details.

  1. Перейдите на вкладку Integrationsи нажмите Add an App.

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

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

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

  1. Передайте аккаунт-менеджеру проекта следующие данные:
    • Секретную подпись.
    • Токен.
    • Ссылки на каналы или ID каналов, в которые вы добавили ваше приложение. Это необходимо, чтобы подключить каналы из Чата к каналам в Slack. Вы можете найти ссылку в контекстном меню канала: перейдите в раздел Settings > Slack Connect и выберите Share 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.

Управление ботами

Добавление бота в новые каналы для подключения к Чату Иксолла

  1. В диалоге вашего канала введите @chat-xsolla и выберите его из списка.

  1. В открывшемся окне нажмите Invite to Channel.

  1. Скопируйте ссылку или ID канала и передайте ее аккаунт-менеджеру для подключения к чату. Вы можете найти ссылку в контекстном меню канала: перейдите в раздел Settings > Slack Connect и выберите Share link.

Удалить бот

  1. Откройте список ботов. На вкладке Configurationпоявится список ботов, добавленных в ваше рабочее пространство в Slack.

  1. Нажмите на значок карандаша и перейдите в Edit configuration. На открывшейся странице нажмите Remove.

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

В другой раз

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

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

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