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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Удалить бот

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

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

Оценить страницу

Что может сделать страницу еще лучше? Отправить

В другой раз

Спасибо за обратную связь!