Skip to main content
Erys

Channel Setup

Connect your agents to the platforms your users already use.

Erys supports 7 delivery channels. Each channel is configured per-agent from the dashboard — no code required for most channels.

Supported Channels

Telegram

Connect via BotFather. Supports text, images, and inline buttons.

Slack

Install as a Slack App. Supports threads, channels, and direct messages.

Discord

Add as a Discord bot. Supports servers, channels, and slash commands.

WebChat

Embed a chat widget on your website with a single script tag.

WhatsApp

Connect via the WhatsApp Business API for customer conversations.

Email

Receive and respond to emails. Supports attachments and HTML formatting.

SMS

Send and receive text messages via Twilio integration.

REST API

Send messages programmatically via the REST API.

Microsoft Teams

Coming soon

Connect to Teams channels and direct messages.

LINE

Coming soon

Reach users on LINE Messenger, popular across Asia.

How Channels Work

Every channel follows the same pattern: your agent receives messages from any connected channel, processes them, and the Dispatch service routes the response back to the correct platform. This means your agent logic stays the same regardless of channel — you configure channels, not code.

User messageChannel adapterAgentDispatchResponse

General Setup

All channels are configured from the Erys dashboard. The general process is:

  1. 1Navigate to your agent in the dashboard and open the Channels tab
  2. 2Click Add Channel and select the platform
  3. 3Enter the required credentials (API tokens, webhook URLs, etc.)
  4. 4Save and test — Erys validates the connection and sends a test message

Telegram

Full setup guide — takes about 3 minutes

1Create a Bot with BotFather

Open Telegram and search for @BotFather. Send the /newbot command and follow the prompts:

telegram-botfather
# In Telegram, message @BotFather:

/newbot

# BotFather will ask for:
# 1. A display name (e.g. "My Support Agent")
# 2. A username ending in "bot" (e.g. "my_support_agent_bot")

# BotFather responds with your bot token:
# "Use this token to access the HTTP API:
#  7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxx"

Important: Copy the bot token immediately. You'll need it in the next step. Never share this token publicly.

2Add the Telegram Channel in Erys

In the Erys dashboard, navigate to your agent's Channels tab:

  1. Click Add Channel and select Telegram
  2. Paste the bot token from BotFather into the Bot Token field
  3. Click Save & Connect

Erys automatically registers a webhook with Telegram so your bot receives messages in real time. No additional server setup is needed.

3Test Your Bot

Open Telegram, search for your bot by its username, and send a message. Your agent will respond within seconds.

Example conversation:

Hello! What can you help me with?
Hi there! I'm your support agent. I can help with product questions, troubleshooting, and general enquiries. What would you like to know?

Telegram Tips

  • Set a profile photo and description via BotFather using /setuserpic and /setdescription
  • Your bot can be added to group chats — it will respond when mentioned by name or when privacy mode is disabled
  • Telegram has a 4,096-character message limit — longer responses are automatically split
  • Use BotFather's /setcommands to add command suggestions (e.g. /help, /status)

Slack

Full setup guide — takes about 5 minutes

1Create a Slack App

Go to the Slack API portal and click Create New App. Choose From scratch, give it a name, and select your workspace.

2Configure Bot Permissions

Navigate to OAuth & Permissions in the sidebar and add the following bot token scopes:

slack-scopes
# Required Bot Token Scopes:
app_mentions:read     # Respond when @mentioned
chat:write            # Send messages
channels:history      # Read channel messages
groups:history        # Read private channel messages
im:history            # Read direct messages
im:write              # Send direct messages
users:read            # Look up user information

3Enable Event Subscriptions

Navigate to Event Subscriptions, toggle it on, and add these bot events:

  • app_mention — triggers when someone @mentions your bot
  • message.im — triggers on direct messages to your bot

Erys provides the webhook URL automatically when you connect the channel in the dashboard. You'll add it here in Step 5.

4Install the App

Navigate to Install App and click Install to Workspace. Authorise the requested permissions. After installation, copy the Bot User OAuth Token (starts with xoxb-).

You'll also need the Signing Secret from the Basic Information page.

5Connect in Erys

In the Erys dashboard, navigate to your agent's Channels tab:

  1. Click Add Channel and select Slack
  2. Paste the Bot Token (xoxb-...)
  3. Paste the Signing Secret
  4. Click Save & Connect
  5. Copy the generated Request URL and paste it back into the Slack Event Subscriptions settings

Note: Slack will verify the URL by sending a challenge request. Erys handles this automatically — just paste the URL and Slack will confirm it within seconds.

6Test Your Bot

Invite your bot to a channel with /invite @your-bot-name and @mention it with a message. Your agent will respond in a thread.

Slack Tips

  • Your bot automatically responds in threads to keep channels tidy
  • Direct messages work without @mentioning — just message the bot directly
  • Add a custom bot icon and description in the Slack App settings for a professional look
  • Use Slack's Block Kit formatting — Erys automatically converts markdown to Slack-compatible formatting

Other Channels

Detailed setup guides for the remaining channels are coming soon. In the meantime, all channels follow the same general pattern described above — add the channel in the dashboard, enter your credentials, and you're connected.

Discord

Create a Discord Application at discord.com/developers, create a Bot user, copy the token, and add it in the Erys dashboard. Invite the bot to your server using the OAuth2 URL generator with the bot and applications.commands scopes.

WebChat

Embed a chat widget on any website with a single script tag. Navigate to your agent's Channels tab, add WebChat, and copy the embed code:

embed.html
<script
  src="https://cdn.erys.ai/webchat.js"
  data-agent-id="YOUR_AGENT_ID"
  data-theme="auto"
  async
></script>

WhatsApp

Requires a WhatsApp Business API account via Meta Business. Add your phone number ID, business account ID, and permanent access token in the Erys dashboard. Erys handles webhook verification automatically.

Email

Configure an inbound email address that forwards to your agent. Supports Postmark, SendGrid, and custom SMTP. Responses are sent as properly formatted HTML emails with your branding.

SMS

Connect via Twilio. Add your Twilio Account SID, Auth Token, and phone number in the Erys dashboard. Erys registers the webhook URL with Twilio automatically.

REST API

No channel setup needed — the REST API is available by default. See the Quickstart Guide for API usage examples.

Need Help?

Having trouble connecting a channel? Email us at support@erys.ai or check the documentation hub for more resources.