Integration with Slack
If you are using the Slack messaging app, integrate it with Chat. Integrating Slack with Chat enables you to chat with Xsolla representatives within Slack. You don’t need to create additional guest accounts or use third-party solutions.
The scheme below illustrates the process of exchanging messages between Chat and Slack:
To set up Slack integration with Chat:
- Log in to Slack.
- Create an app in Slack.
- Set up app’s permission scopes.
- Add the app to the Slack channel.
- Subscribe to events.
Create app in Slack
- Open the app creation page.
- Choose to build an app from scratch.
- Fill out the form fields:
- In the
App Name field, enter the name of your app. For example,Chat Xsolla . - In the
Pick a workspace to develop your app in field, enter the workplace to which you want to add the app.
- In the
- Click
Create App .
Set up app’s permission scopes
- On the page of your app, go to
Features > OAuth & Permissions . If you are on another page, go to your apps and select from the list the application created in the previous step. Then, go toFeatures > OAuth & Permissions .
- In the
Scopes block, clickAdd an OAuth Scope and add the following permission scopes:channels:history — to view the message history in the public channel with the added app.chat:write — to send messages in the name of the app.chat:write.customize — to send messages in the name of the app with the ability to customize username and avatar. This permission scope allows you to identify the Xsolla representative you’re chatting with.files:read — to view files shared in channels and direct messages with the added app.groups:history — to view the message history in the private channel with the added app.im:history — to view the message history in direct messages with the added app.users:read — to view users’ info. This permission scope allows Xsolla representatives to identify the user they’re chatting with. If this permission scope is not added, messages will be anonymous.
- To add the app to your workspace, go to
OAuth & Permissions > OAuth Tokens & Redirect URLs and clickInstall to Workspace .
- Click
Allow to confirm adding permission scopes.
Integration with Slack
- Open your Slack workspace.
- Mark the channel you want to add to the app. You can also create new private or public channels.
- Open the channel’s context menu and choose
Open channel details .

- Go to tab
Integrations and clickAdd an App .

- Choose the Chat
Xsolla app from the list and clickAdd .

Subscribe to events
To send your messages to Chat, set up event subscriptions for your app:
- Send the following info to your Account Manager:
- Signing secret.
- Token.
- Links to the channels or channel IDs to which you added your app. This is required to connect channels from Chat to channels in Slack. You can find the link in the context menu of the channel: go to chapter
Settings > Slack Connect and chooseShare link .
- Get a URL for receiving events from your Account Manager.
- Go to
Your Apps page and open the app you created.
- On the setting page of your app go to
Event Subscriptions > Enable Events , set theEnable Events toggle toOn , and paste the received URL to theRequest URL field. - Make sure the field is marked as
Verified . If there is no “Verified” mark, check if the URL is correct or contact your Account Manager. - Go to
Event Subscriptions > Subscribe to bot events , clickAdd Bot User Event and subscribe to the following events:message.im — a new message is sent to the app’s direct messages.message.groups — a new message is sent to the private channel.message.channels — a new message is sent to the public channel.file_shared — a user shared a file in the app’s direct messages or channels with the added app.
- Click
Save Changes .
Get signing secret
This secret is used to validate requests from applications. To get it, on the app settings page, go to
Get token
This token is used to send messages from Chat to Slack. To get a token:
- On the app settings page, go to
Features > OAuth & Permissions . - Copy the authentication token from the
Bot User OAuth Token field.
Control bots
Add bot to the new channel to connect with Chat Xsolla
- In the dialog window of your channel, enter
@chat-xsolla to find the bot and choose it from the list.

- In the opened window, click
Invite to Channel .

- Copy the channel link or ID and send it to your Account Manager to connect with chat. You can find the link in the channel context menu: go to chapter
Settings > Slack Connect and chooseShare link .
Delete the bot
- Open the bot list. The list of bots you added in your Slack workspace will appear on the
Configuration tab.

- Click on the pencil icon and go to
Edit configuration . In the opened page, clickRemove .

Was this article helpful?
Rate this page
Don’t want to answer
Thank you for your feedback!
Found a typo or other text error? Select the text and press Ctrl+Enter.