Bot Integrations

Overview#

Bots become most powerful when they are reachable from the tools your team already uses. Integrations let your bots receive messages and respond on external platforms, turning them into always-available assistants.

Available Integrations#

Slack#

Connect your bot to a Slack workspace so team members can message it directly or mention it in channels.

Setup:

1. Open your bot's configuration page.
2. Go to the Integrations tab.
3. Click Add Integration and select Slack.
4. Follow the OAuth flow to authorize Wyatt in your Slack workspace.
5. Choose which channels the bot should listen in.

Once connected, your bot responds to direct messages and @mentions in the configured channels.

Discord#

Similar to Slack, you can connect your bot to a Discord server.

Setup:

1. Open your bot's configuration page.
2. Go to the Integrations tab.
3. Click Add Integration and select Discord.
4. Authorize the bot for your Discord server.
5. Select the channels where the bot should be active.

Webhooks#

Webhooks give you a URL endpoint that accepts POST requests. This is the most flexible integration -- you can trigger your bot from any service that supports outbound webhooks.

Setup:

1. Open your bot's configuration page.
2. Go to the Integrations tab.
3. Click Add Integration and select Webhook.
4. Copy the generated webhook URL.
5. Configure your external service to send POST requests to that URL.

Webhook payload format:

{
  "message": "Your message to the bot",
  "user": {
    "name": "Jane Smith",
    "id": "user-123"
  },
  "channel": "general",
  "thread_id": "optional-thread-id",
  "metadata": {}
}

The bot processes the message and returns its response in the webhook response body.

API Access#

Every bot interaction is tracked as a run with full metadata:

• Model used and tokens consumed
• Duration of the request
• Tools called during execution
• Documents accessed by the bot

You can view run history in the bot's configuration page to monitor usage and debug behavior.

Managing Integrations#

From the bot's configuration page, you can:

• Add new integrations at any time
• Pause a bot to temporarily stop it from responding on all platforms
• Remove an integration without affecting others

Related#

• Bots -- overview of what bots are
• Bot Configuration -- system prompt, model, and resource setup
• Automations -- another way to trigger actions automatically