Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.enconvo.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

The IM Channels extension connects EnConvo to your team’s messaging platforms. Send and read messages on Slack, Discord, Telegram, and Feishu (Lark) directly through AI conversations, or set up automated bot listeners that reply to incoming messages using your configured LLM. This turns EnConvo into a unified messaging hub where your AI assistant can communicate across platforms on your behalf.

Slack

Send messages, read channels, Socket Mode listener

Discord

Channel messaging via REST API and Gateway WebSocket

Telegram

Bot API messaging with long-polling listener

Feishu / Lark

Open API integration with auto-refreshing tokens

​
Setting Up Channels

Each platform requires its own bot token or API credentials. Configure them in the extension settings.

​
Slack

1

Create a Slack App

Go to api.slack.com/apps and create a new app for your workspace
2

Configure Bot Permissions

Under OAuth & Permissions, add the scopes your bot needs (e.g., chat:write, channels:read, channels:history)
3

Install to Workspace

Install the app to your Slack workspace and copy the Bot User OAuth Token (xoxb-...)
4

Enter Token in EnConvo

Go to Settings -> IM Channels -> Slack Channel and paste your Bot Token
5

(Optional) Enable Socket Mode

For the bot listener feature, create an App-Level Token (xapp-...) with connections:write scope and enter it in the App Token field

​
Discord

1

Create a Discord Application

Go to the Discord Developer Portal and create a new application
2

Create a Bot

Navigate to the Bot section and click Add Bot. Copy the bot token.
3

Set Permissions

Under OAuth2 -> URL Generator, select the bot scope and the permissions you need (Send Messages, Read Message History, etc.)
4

Invite to Server

Use the generated URL to invite the bot to your Discord server
5

Enter Token in EnConvo

Go to Settings -> IM Channels -> Discord Channel and paste your Bot Token

​
Telegram

1

Create a Bot via BotFather

Open Telegram and message @BotFather. Send /newbot and follow the prompts to create your bot
2

Copy the Bot Token

BotFather will provide a token in the format 123456:ABC-DEF...
3

Enter Token in EnConvo

Go to Settings -> IM Channels -> Telegram Channel and paste the Bot Token

​
Feishu / Lark

1

Create a Feishu App

Go to the Feishu Open Platform and create a new application
2

Get App Credentials

Copy the App ID and App Secret from the app’s credentials page
3

Configure Permissions

Add the messaging permissions your bot needs (send messages, read messages, etc.)
4

Enter Credentials in EnConvo

Go to Settings -> IM Channels -> Feishu / Lark Channel and enter the App ID and App Secret
5

(Optional) Set API Domain

For Lark (international version), change the API Domain to https://open.larksuite.com. The default is https://open.feishu.cn for the China version.

​
Using Messaging in Conversations

Once channels are configured, the AI can send and read messages on your behalf.

​
Sending Messages

"Send a message to the #general channel on Slack saying the deployment is complete"
"Message the QA team on Discord that the build is ready for testing"
"Send a Telegram message to the support chat with today's status update"

​
Reading Messages

"Show me the last 10 messages from #engineering on Slack"
"What did the team say in the Discord dev channel today?"
"Read recent messages from the Telegram project group"

​
Cross-Platform Communication

"Post the meeting summary to both Slack #team and Discord #announcements"
"Read messages from Telegram and forward the important ones to Slack"

​
Bot Listener

The Channel Listener Service runs in the background and automatically replies to incoming messages using your configured AI model.

​
How It Works

  1. The listener connects to each configured platform (Slack via Socket Mode, Discord via Gateway WebSocket, Telegram via long-polling)
  2. When someone messages or mentions your bot, the listener receives the message
  3. The message is processed by your configured LLM provider
  4. The AI’s response is sent back to the channel

​
Agent Binding

You can bind specific channels to specific AI agents. This lets different channels use different system prompts, tools, and behaviors.
ConceptDescription
One agent to many channelsA single agent can serve multiple channels across platforms
One channel to one agentEach channel is bound to exactly one agent
Default fallbackUnbound channels use the default LLM configuration

​
Configuring the Listener

  1. Go to Settings -> IM Channels -> Channel Listener Service
  2. Select the AI Model Provider to use for bot replies
  3. The listener automatically starts for all configured channels with valid credentials
You can bind different AI agents to different channels. For example, a customer support agent for your Telegram support group and a development assistant for your Slack engineering channel.

​
Platform Details

PlatformTransportListener MethodMax Message Length
SlackHTTPS Web APISocket Mode WebSocket4,000 characters
DiscordHTTPS REST v10Gateway WebSocket2,000 characters
TelegramHTTPS Bot APILong-polling (30s)4,096 characters
FeishuHTTPS Open APIPolling4,000 characters
Long messages are automatically split into multiple parts at natural break points (newlines, then spaces) to stay within platform limits.

​
Using Channels in Workflows

Messaging channels integrate with EnConvo workflows for automated communication:
WorkflowDescription
Status BroadcastAutomatically post status updates to multiple channels
Alert PipelineMonitor events and send alerts to the appropriate channel
Daily DigestCompile information and post a daily summary
Cross-Platform RelayRead from one platform and forward to another

​
Troubleshooting

Verify that the bot token or API credentials are entered correctly in Settings -> IM Channels. Tokens must be valid and not expired.
Ensure the bot has been invited to the target channel/group and has the correct permissions. On Slack, the bot must be added to channels before it can post.
Check that the Channel Listener Service is running. For Slack, Socket Mode requires an App-Level Token. For Discord, the bot needs the Message Content intent enabled in the Developer Portal.
Each platform has a maximum message length. EnConvo automatically splits long messages, but very long responses may be sent across multiple messages.
Feishu tokens auto-refresh, but if you see authentication errors, verify your App ID and App Secret. For Lark international, make sure the API Domain is set to https://open.larksuite.com.

Gmail Integration

Email management via Gmail API

Apple Ecosystem

Native Apple Mail, Reminders, Calendar

Workflows

Automate messaging in workflows

Agents

Bind AI agents to messaging channels