Skip to main content
Connect Slack to let Duckie respond to messages in channels and DMs.

Capabilities

CapabilitySupported
Knowledge Source✓ Search message history
Deployment Trigger✓ Respond to messages
Tool Actions✓ Send messages, react, search

Setup

Connect via OAuth

  1. Go to Settings → Connections in Duckie
  2. Find Slack and click Connect
  3. You’ll be redirected to Slack to authorize
  4. Select the workspace to connect
  5. Review and approve the permissions
  6. You’ll be redirected back to Duckie

Permissions Granted

Duckie requests these bot permissions:
  • Read messages in channels it’s added to
  • Send messages and reactions
  • Read user profiles
  • Access files shared in conversations

Using as a Deployment Trigger

Deploy an agent to Slack:
  1. Go to Deploy
  2. Click Create Deployment
  3. Select your agent
  4. Choose Slack as the trigger
  5. Configure the trigger:

Trigger Options

OptionDescription
ChannelsSpecific channels to monitor
@mention onlyOnly respond when @Duckie is mentioned
All messagesRespond to every message in the channel
DMsRespond to direct messages

Channel Setup

After creating a deployment, invite Duckie to the channels:
  1. Go to the Slack channel
  2. Type /invite @Duckie or add from channel settings
  3. Duckie will now receive messages in that channel

Available Tools

ToolDescription
slack_send_messageSend a message to a channel or user
slack_add_reactionAdd an emoji reaction
slack_search_messagesSearch message history
slack_get_userGet user profile information
slack_upload_fileShare a file

Using as Knowledge Source

Search your Slack history for context:
  1. Go to Train → Knowledge
  2. Click Add Source
  3. Select Slack
  4. Choose which channels to index
  5. Click Start Sync
Slack message history requires a paid Slack plan for full access.

Best Practices

Use @mention Mode for Busy Channels

In high-traffic channels, set the trigger to @mention only so Duckie only responds when directly asked.

Create Dedicated Support Channels

Consider creating channels like #ask-duckie where customers or team members can ask questions.

Thread Responses

Duckie responds in threads by default to keep channels organized.

Example Use Cases

Internal IT Helpdesk

Deploy an agent to #it-help that answers common IT questions using your internal documentation.

Customer Support (Slack Connect)

If you use Slack Connect for customer support, deploy Duckie to those shared channels.

Team Knowledge Bot

Create a #ask-anything channel where employees can ask questions about company policies, processes, and tools.

Troubleshooting

”Duckie not responding”

  • Verify Duckie is invited to the channel
  • Check if the deployment is in Live mode (not Shadow)
  • Ensure the trigger matches (@mention vs all messages)

“Missing message history”

  • Duckie can only see messages after it was added to the channel
  • Historical search requires the Slack knowledge source to be synced

”Permission denied”

  • The workspace admin may need to approve Duckie
  • Re-authenticate if permissions changed