Messaging Integration

Messaging Integration

Connect your agents to messaging platforms so users can chat with them directly, and scheduled runs post results automatically.

---

Supported Platforms

Platform	Status
Slack	Supported
Discord	Supported
Telegram	Supported
Microsoft Teams	Supported
WhatsApp	Supported

---

General Setup

1. Open Settings → Messaging
2. Select a platform tab
3. Follow the platform-specific instructions below
4. Assign the messaging channel to an agent

---

Slack

Requirements: A Slack App with bot permissions.

Setup steps:

1. Go to api.slack.com/apps and create a new app
2. Add the following bot token scopes:
   • chat:write — send messages
   • channels:history — read messages in channels
   • app_mentions:read — respond to @mentions
3. Install the app to your workspace
4. Copy the Bot User OAuth Token (xoxb-...)
5. In Synapse: Settings → Messaging → Slack
   • Paste the Bot Token
   • Enter the channel name (e.g., #ai-agent)
   • Select the agent to bind
6. Invite the bot to your Slack channel: /invite @YourBotName

---

Discord

Requirements: A Discord Application with bot token.

Setup steps:

1. Go to discord.com/developers and create an application
2. Add a Bot and copy the Bot Token
3. Enable Message Content Intent under Privileged Gateway Intents
4. Invite the bot to your server with permissions: Send Messages, Read Message History
5. In Synapse: Settings → Messaging → Discord
   • Paste the Bot Token
   • Enter the Channel ID
   • Select the agent to bind

---

Telegram

Requirements: A Telegram bot created via BotFather.

Setup steps:

1. Message @BotFather on Telegram: /newbot
2. Follow the prompts to create your bot
3. Copy the Bot Token (format: 123456789:ABCdef...)
4. In Synapse: Settings → Messaging → Telegram
   • Paste the Bot Token
   • Select the agent to bind
5. Start a chat with your bot and send any message to initialize

---

Microsoft Teams

Requirements: Microsoft 365 organization and admin access to register an app.

Setup steps:

1. Register an application in Azure Active Directory
2. Configure webhook or bot framework integration
3. In Synapse: Settings → Messaging → Teams
   • Enter the webhook URL or bot credentials
   • Select the agent to bind

---

WhatsApp

Requirements: WhatsApp Business API access.

Setup steps:

1. Set up WhatsApp Business API (via Meta or a provider like Twilio)
2. Configure the webhook to point to your Synapse backend
3. In Synapse: Settings → Messaging → WhatsApp
   • Enter API credentials
   • Select the agent to bind

---

Multi-Agent Mode

Enable Multi-Agent Mode in any messaging channel to let users switch agents mid-conversation.

Commands available in multi-agent channels:

Command	Description
/agent <name>	Switch to a specific agent
/agents	List all available agents

The channel's bound agent is the default. Users can switch on demand.

---

Scheduled Run Notifications

When you create a schedule for an agent that has a messaging channel configured, results are automatically posted to that channel after each scheduled run.

Example: Schedule a daily standup agent to run at 8 AM. Results post to #standup on Slack automatically.

See Scheduling for details.

---

See Also

• Agents — creating and configuring agents
• Scheduling — setting up automated runs with messaging notifications