Skip to main content
On your own instance the Slack app is yours: create it, add the six bot scopes and the redirect URI, then put its client id and secret in your environment.
1

Create Slack App

Head to Slack Applications Dashboard and select “From scratch”, fill out all the required Information.
2

Set up OAuth Scopes and redirect URIs

Your Slack OAuth2 Redirect URI:
  • Production: https://postqueen.example.com/integrations/social/slack
  • Local development: https://redirectmeto.com/http://localhost:4200/integrations/social/slack
  • Docker: https://redirectmeto.com/http://localhost:4007/integrations/social/slack
Slack will not send a visitor back to a plain http address, so when your FRONTEND_URL is not https she wraps the callback through redirectmeto.com on its way home. That wrapped address is the literal string she sends to Slack, which makes it the one you register. Local development and Docker both fall into this case. Register the bare localhost URI instead and the login stops on Slack with a redirect mismatch.
Head to Features > OAuth & Permissions
  1. Add the redirect URI you copied from PostQueen
  2. At Scopes > Bot Token Scopes, add all six of these Scopes:
    • chat:write
    • channels:read
    • users:read
    • groups:read
    • channels:join
    • chat:write.customize
3

Set an App Icon

Head back to Settings > Basic Information > Display InformationNow set an Icon that meets these Requirements:
  1. It has to be a Square
  2. It has to be 512px×512px to 2000px×2000px
If you do not set an App Icon, PostQueen will not let you install the Integration.
4

Copy Client ID and Secret

Head back to App Credentials, copy the Client ID and Secret and paste it to your Environment:
5

Restart and add the Slack channel

​
Next steps

What she can post to Slack

Limits, post types and settings

Configuration reference

Every variable she reads

Connect errors

Invalid state, invalid_grant and the rest

Another channel

Every network, and what each one asks for