Skip to main content
Chat Channels let you connect messaging apps to your Codeg workspace. Once connected, you can start agent tasks, send follow-up messages, approve permission requests, and monitor activity — all without opening the Codeg UI.

Supported channels

ChannelProtocolStatus
TelegramBot API (HTTP long-polling)Built-in
Lark (Feishu)WebSocket + REST APIBuilt-in
iLink (Weixin)WebSocket + REST APIBuilt-in
More channels (Discord, Slack, DingTalk, and others) are planned for future releases.

What you can do from chat

Start and manage sessions

Run full agent sessions directly from your chat app:
CommandDescription
/folderPick a project directory
/agentChoose an AI agent
/task <description>Create a session and start a task
/resume [ID]Resume the most recent session, or a specific session by ID
/cancelAbort the current running task
/sessionsList active sessions in the current folder
When a session is active, send any plain text message to continue the conversation — no command prefix needed.

Permission control

Agents can request tool-execution permissions mid-task and pause to wait for your response. Reply directly in chat without switching context:
CommandDescription
/approveApprove the pending permission request
/approve alwaysApprove and auto-approve future requests of the same type
/denyDeny the pending permission request

Query commands

CommandDescription
/search <keyword>Search conversation history by title (returns up to 10 results)
/todayView today’s coding activity: total sessions, agent breakdown, and recent titles
/statusShow connection status for all configured channels
/helpDisplay available commands with descriptions

Event notifications

Codeg pushes the following events to all enabled channels in real time:
  • Turn completions — when an agent finishes responding, with the stop reason (completed or cancelled)
  • Tool calls — details of tools the agent invokes during a task
  • Agent errors — error messages when an agent encounters a failure
  • Permission requests — interactive prompts when an agent needs approval to proceed

Daily reports

Enable the daily report on any channel to receive an automated summary at a scheduled time each day. Each report includes:
  • Total number of sessions for the day
  • Breakdown of sessions by agent type
  • Key activities and recent project titles
Configure the schedule time per channel in Settings → Chat Channels.

Multi-language support

Message templates are available in 10 languages. Set the message language in channel settings:
CodeLanguage
enEnglish
zh-cnSimplified Chinese
zh-twTraditional Chinese
jaJapanese
koKorean
esSpanish
deGerman
frFrench
ptPortuguese
arArabic

Security

Credentials (bot tokens, app secrets, session tokens) are stored in the OS keyring — never written to config files, logs, or the database. Deleting a channel also removes its stored credential from the keyring.

Message formatting

Codeg renders messages using the native formatting capabilities of each platform:
  • Telegram — MarkdownV2 formatting with bold titles and emoji level indicators; falls back to plain text if rendering fails
  • Lark — card-based layout for rich structured messages
  • All platforms — plain-text fallback always available

Command prefix

The default command prefix is /. You can change it to any 1–3 non-alphanumeric characters in Settings → Chat Channels → Command Prefix. The change applies to all channels.

Setup

1

Open Chat Channels settings

In Codeg, go to Settings → Chat Channels.
2

Create a channel

Click Add Channel and select the channel type: Telegram, Lark, or iLink.
3

Enter credentials

Provide your bot token (Telegram), App ID and App Secret (Lark), or scan the QR code (iLink). Credentials are saved immediately to the OS keyring.
4

Configure event filters and daily report

Choose which events to receive on this channel. Optionally enable the daily report and set its delivery time.
5

Connect

Click Connect. Codeg establishes the connection and starts forwarding agent events.

Channel guides

Telegram

Set up a Telegram bot and connect it to your workspace.

Lark

Connect a Lark (Feishu) app for enterprise team notifications.

iLink

Authenticate with iLink (Weixin) via QR code scan.