How to Connect Appalix to Slack

What you'll need

• An Appalix account on Core plan or above
• A Slack workspace where you have admin rights (or permission to install apps)
• A configured bot in Appalix

Step 1 — Create a Slack integration in Appalix

1. Go to Integrations → Add integration and choose Slack.
2. Name the integration and select a bot. You'll fill in the Slack credentials after creating the Slack app.
3. Click Create integration, then open the integration setup page — copy the webhook endpoint URL.

Step 2 — Create a Slack app

1. Go to api.slack.com/apps and click Create New App → From scratch.
2. Enter an app name (e.g. Appalix Bot) and choose your workspace. Click Create App.

Step 3 — Add bot permissions

1. In the app settings sidebar, click OAuth & Permissions.
2. Under Bot Token Scopes, add these scopes:
   • channels:history — read messages in channels
   • im:history — read direct messages
   • chat:write — send replies
   • app_mentions:read — receive @mentions

Step 4 — Enable Event Subscriptions

1. In the sidebar, click Event Subscriptions and toggle it On.
2. Paste the Appalix webhook URL in the Request URL field:

   https://api.appalix.ai/webhooks/slack/{your-integration-id}

   Slack will immediately send a challenge request — Appalix will respond correctly and Slack will show a green ✓ verified status.
3. Under Subscribe to bot events, add:
   • message.channels — messages in public channels
   • message.im — direct messages to the bot
   • app_mention — @mentions in any channel
4. Click Save Changes.

Step 5 — Install the app & copy credentials

1. Go to Install App in the sidebar and click Install to Workspace. Authorise the permissions.
2. Copy the Bot User OAuth Token (starts with xoxb-).
3. Go to Basic Information → App Credentials and copy the Signing Secret.

Step 6 — Save credentials in Appalix

1. In Appalix, click Edit on your Slack integration.
2. Paste the Bot Token and Signing Secret from Step 5.
3. Click Save changes.

Step 7 — Test it

1. In Slack, invite your bot to a channel: /invite @AppallixBot.
2. @mention the bot or send it a DM: "@AppalixBot what can you help with?"
3. The bot should reply in the thread within a few seconds.
4. The conversation appears in Appalix under Conversations with platform tagged as Slack.

Tips & best practices

• Thread replies — Appalix replies in-thread by default to keep channels tidy.
• Internal assistant — for team use, create a bot with type Internal assistant and train it on your internal docs, SOPs, and product knowledge base.
• Human handoff — configure a separate Slack webhook in the Handoff section so a different channel gets notified when a user escalates.