Docs
Slack Integration
Slack Integration
Connect GudDesk to Slack to receive notifications and reply to customers directly from Slack.
The Slack integration lets your team receive conversation notifications in Slack channels and reply to customers without leaving Slack.
Setting Up
1. Connect Your Workspace
- Go to Dashboard > Settings > Integrations
- Find Slack and click Connect
- Authorize GudDesk to access your Slack workspace
- Select the default channel for notifications
2. Configure Notifications
Choose which events trigger Slack notifications:
| Event | Description |
|---|---|
| New conversation | A customer started a new conversation |
| New message | A customer replied to an existing conversation |
| Assignment | A conversation was assigned to you |
| Escalation | An AI agent escalated to a human |
| Mention | A team member mentioned you in a note |
3. Channel Mapping (Optional)
Route notifications to specific channels based on tags or teams:
| Condition | Slack Channel |
|---|---|
| Tag: "billing" | #support-billing |
| Tag: "bug" | #engineering-bugs |
| Team: Enterprise | #enterprise-support |
| Default | #support-general |
Replying from Slack
When you receive a conversation notification in Slack:
- Click Reply on the notification message
- Type your response in the thread
- Your reply is sent to the customer through GudDesk
Internal notes: Start your message with /note to add an internal note instead of a customer-facing reply.
Slash Commands
| Command | Description |
|---|---|
/guddesk status | Show your open conversation count |
/guddesk assign @user conv_id | Assign a conversation |
/guddesk resolve conv_id | Resolve a conversation |
/guddesk snooze conv_id 2h | Snooze a conversation |
Requirements
- A Slack workspace with permission to install apps
- GudDesk Pro plan (for bi-directional replies) or Free plan (notifications only)
SLACK_CLIENT_IDandSLACK_CLIENT_SECRETenvironment variables configured (self-hosted only)