Slack Notifications

Slack Notifications Plugin for Botble CMS

The Slack Notifications Plugin enables Slack integration for your Botble CMS store. It allows sending real-time notifications specifically for new orders and new customer registrations to your team members.

[!IMPORTANT]
This plugin focuses exclusively on notification delivery. It does not handle order fulfillment, payments, or inventory updates.

📍 Plugin Location

After installation and activation, access the plugin settings in your Botble Admin panel under:
Settings → Slack

Here you can configure Slack tokens, select channels or users, and define notification rules for each event.

🚀 Current Plugin Scope

✅ Functionality

• Event-Based Notifications: Supports New Order and New Customer events.
• Destination Selection: Send notifications to public channels, private channels, or direct messages.
• Dynamic Rules: Each event can have multiple active rules with customized message templates.
• Template Variables: Use variables like {{order_id}}, {{customer_name}}, {{total}} in messages.
• Logging: Debug logs capture all Slack notifications for troubleshooting.

❌ Limitations

• Does not create orders or trigger fulfillment actions.
• Users cannot manually post messages through the plugin unless a User OAuth Token is provided.
• Notifications rely on the bot being a member of channels for full functionality.

⚙️ Slack Integration Steps

1️⃣ Create Your Slack App

1. Go to the Slack App Dashboard and click Create New App → From scratch.
2. Set a descriptive App Name and select the workspace where notifications will be sent.
3. Confirm creation; your app will appear in the dashboard.

2️⃣ Configure OAuth & Permissions

At a minimum, configure the following Bot Token Scopes:

Additional scopes may be added by the user if needed.

3️⃣ Install App to Workspace

1. Click Install to Workspace and authorize the app.
2. Slack generates a Bot User OAuth Token (xoxb-...).
3. Paste the Bot User OAuth Token into the plugin settings.

4️⃣ Add Bot to Channels

Important:
The bot can only post to channels where it is a member. Invite it using:
/invite @YourAppName

5️⃣ Testing & Verification

• Send a DM → bot must deliver the message.
• Send to a public channel → bot must be a member.
• Send to a private channel → bot must be invited.
• Check tokens if messages fail.

📦 Message Rules & Template Variables

Rule Configuration

• Each rule specifies:
  • Event: New Order or New Customer
  • Destination Type: Channel or User
  • Destination ID: Slack channel or user ID
  • Message Template: Supports variables
  • Status: Active or Inactive

Available Template Variables

📊 Admin Panel Table Overview

The plugin provides a table view for all rules:

🔒 Security & Scope Reminder

• Messages are sent only via the Bot User OAuth Token.
• Users cannot post manually unless a User OAuth Token is provided.
• Direct messages, public channels, and private channels require the bot to be invited and proper scopes to be set.

For more details:

• Slack Quickstart Guide
• Slack API Scopes Documentation

🛠️ Botble CMS Requirements

• Botble Core: 7.0.0+
• Ecommerce Plugin: Installed and active
• HTTPS: Required for secure communication
• Slack App: Must have Bot Token and required scopes

🐞 Debug Mode

• All notifications are logged for auditing and debugging.
• Use logs to troubleshoot channel/user delivery and OAuth issues.

⚠️ Important Notes

• Invite the bot to all target channels to ensure notifications work.
• Test each event type after configuration before going live.