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 Namefield, enter the name of your app. For example, Chat Xsolla.
- In the
Pick a workspace to develop your app infield, enter the workplace to which you want to add the app.
- In the
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 to Features > OAuth & Permissions.
- In the
Scopesblock, click Add an OAuth Scopeand 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 URLsand click Install to Workspace.
Allowto confirm adding permission scopes.
Add the app to the Slack channel
- Open your Slack workspace and select the channels that you want to add the app. If needed, create new private or public channels by selecting
- To add the app to a channel, go to the
Show channel detailssection.
- Go to
More > Add apps.
- Select the app from the list and click
Subscribe to events
To send your messages to Chat, set up event subscriptions for your app:
- Send the following info to your Account Manager:
- Get a URL for receiving events from your Account Manager.
- Go to
Your Appspage and open the app you created.
- On the setting page of your app go to
Event Subscriptions > Enable Events, set the Enable Eventstoggle to On, and paste the received URL to the Request URLfield.
- 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, click Add Bot User Eventand 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.
Get signing secret
This secret is used to validate requests from applications. To get it, on the app settings page, go to
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 Tokenfield.
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.