Integrations
Connect your agents to the messaging platforms you already use. When someone sends a message on Discord, Telegram, Slack, WhatsApp, or iMessage, your agent receives it and responds automatically.
What Are Integrations?
By default, you chat with your agents through the Autonomis dashboard. But what if you want to message your agent on Discord? Or have it respond to Telegram messages? That's what integrations are for.
An integration connects a messaging platform to your agent. Once set up, messages sent to your agent on that platform are forwarded to your Autonomis agent, and responses are sent back automatically. It's like giving your agent a phone number on each platform.
Available Integrations
Autonomis currently supports five messaging platforms:
- Discord — Chat with your agents in Discord channels. You can map different channels to different agents, so each channel has its own specialist.
- Telegram — Message your agents via a Telegram bot. Supports both private messages and group chats. You control who can message the bot.
- Slack — Connect agents to your Slack workspace. Map specific channels to specific agents so each team channel gets the right specialist.
- WhatsApp — Chat with your agents via WhatsApp, just like messaging a contact. Uses WhatsApp Business for the connection.
- iMessage — Reach your agents through iMessage for a seamless Apple ecosystem experience.
How to Set Up an Integration
Setting up an integration follows the same general steps for every platform:
- Go to your Dashboard and click "Integrations" in the sidebar
- Choose the platform you want to connect (Discord, Telegram, Slack, WhatsApp, or iMessage)
- Follow the step-by-step setup guide for that platform — it walks you through creating a bot, pasting tokens, and choosing which agent handles messages
- Test the connection by sending a message on the platform and checking for a response
Each platform card shows its connection status: "Connected" or "Not connected". Click any card to start or manage the setup.
Discord Setup
The Discord integration lets people in your Discord server talk to your agents via channels. Here's how to set it up:
- Create a Discord bot — Visit the Discord Developer Portal, click "New Application", then go to the "Bot" tab to get your bot token
- Enable message permissions — In the Bot settings, turn on Message Content Intent so the bot can read messages
- Paste the token in Autonomis — Go to Dashboard → Integrations → Discord and enter your bot token
- Invite the bot to your server — Autonomis generates an invite link for you. Click it to add the bot
- Map channels to agents — Choose which agent responds in which channel. Unmapped channels go to your default agent
Telegram Setup
With Telegram, your agents appear as a bot that people can message directly or add to group chats.
- Create a Telegram bot — Open Telegram, search for
@BotFather, send/newbot, and follow the prompts. Copy the bot token it gives you - Paste the token in Autonomis — Enter the token in the Telegram integration page
- Choose an agent — Select which agent handles Telegram messages
- Set access controls — Decide who can message the bot: anyone, only approved users, or only specific group chats
- Activate — Click "Activate" and your bot goes live!
Slack Setup
Connect your agents to Slack so they appear as bot users in your workspace. No public URL needed — Slack's Socket Mode handles the connection.
- Create a Slack app — Visit api.slack.com/apps and click "Create New App"
- Enable Socket Mode — This generates an App-Level Token. Copy it
- Add permissions and install — Add the required message permissions, then install the app to your workspace. Copy the Bot Token
- Paste both tokens in Autonomis — Enter the App-Level Token and the Bot Token
- Map channels to agents — Choose which agent responds in which Slack channel
WhatsApp Setup
With WhatsApp, people can message your agent just like any other contact. The setup wizard walks you through connecting your WhatsApp Business account.
- Open the WhatsApp integration in your Dashboard
- Follow the pairing wizard to link your WhatsApp Business account
- Configure contacts — Choose who can message your agent
- Activate — Once connected, your agent starts responding automatically
iMessage Setup
The iMessage integration lets you reach your agents through Apple's messaging platform. Follow the setup wizard in the Integrations hub to connect your iMessage account.
Mapping Channels to Agents
For Discord, Telegram, and Slack, you can route different channels to different agents. This is really useful when you have multiple agents with different specialties:
- #research channel → your researcher agent
- #content channel → your writer agent
- All other channels → your manager agent (the default)
The @mention Option
Most integrations have a "Require @mention" toggle. When turned on, the bot only responds when someone tags it by name (e.g., @my-agent). This is helpful in busy channels where you don't want the bot replying to every message.
When turned off, the bot responds to every message in the mapped channels.
Disconnecting an Integration
If you want to remove a connection, it only takes a moment:
- Go to the integration's page in the Integrations hub
- Click the "Disconnect" button at the top
- The bot is removed and all stored tokens are securely deleted
You can always reconnect later by going through the setup again.
Security
Your integration tokens (bot tokens, OAuth tokens) are encrypted before being stored. They are never saved as plain text and are only decrypted inside your agent's secure environment at runtime.