Slack Integration
Send messages to Slack channels or direct messages from your workflows.
Overview
Integrate Slack with your workflows to notify your team about important events—new leads, support requests, form submissions, or any conversation milestone.
How to Set Up Slack Integration
- Create a Slack App:
- Go to api.slack.com/apps
- Click "Create New App" → Select "From scratch"
- Name your app (e.g., "Monology Notifications")
- Select the workspace where you want to install it
- Click "Create App"
- Configure Bot Token Scopes:
- In your app settings, go to "OAuth & Permissions" (left sidebar)
- Scroll down to "Scopes" → "Bot Token Scopes"
- Click "Add an OAuth Scope" and add the following scopes:
chat:write- Send messages as the botchat:write.public- Send messages to channels without joiningchannels:read- View basic channel info (optional)users:read- View user info for DMs (optional)
- Install App to Workspace:
- Scroll to the top of the "OAuth & Permissions" page
- Click "Install to Workspace"
- Review the permissions and click "Allow"
- You'll be redirected back to the OAuth page
- Copy the Bot Token:
- On the "OAuth & Permissions" page, find "Bot User OAuth Token"
- Copy the token (starts with
xoxb-) - Keep this token secure - it grants access to send messages on behalf of your app
- Invite Bot to Channels (if needed):
- For private channels, you need to invite the bot first
- In Slack, go to the channel and type:
/invite @YourAppName - For public channels with
chat:write.publicscope, this step is optional
- Configure in Monology:
- In your workflow, add an Action Node
- Select "Slack" as the action type
- Paste your Bot Token in the credentials field
- Enter the channel name (e.g.,
#leads) or user ID for DMs - Compose your message with dynamic variables
Tip: To find a channel ID, right-click on the channel in Slack → "View channel details" → Scroll to the bottom. For user IDs, click on a user's profile → "More" → "Copy member ID".
Configuration Options
Channel or DM
Choose where to send messages:
- Channel: Public or private channel (e.g., #leads, #support)
- Direct Message: Send to a specific user
Message Body
Compose your message with dynamic variables from the conversation:
🎉 New Lead Alert!
Name: {{form.name}}
Email: {{form.email}}
Company: {{form.company}}
Interest: {{agent.classified_intent}}Error Handling
- Retry on failure: Automatically retry if sending fails
- Continue on error: Don't block the workflow if Slack fails
Common Use Cases
Lead Notifications
Alert sales team when a qualified lead submits a contact form.
Support Escalations
Notify support channel when a conversation needs human intervention.
Daily Summaries
Send conversation summaries to team channels.
Next Steps
Zendesk Integration
Create support tickets automatically