Channel Bot
Apps & Automationchannel-botChannel Bot is an Agent Skill for apps & automation published in the vstorm-co/full-stack-ai-agent-template repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Work with messaging-channel bots (Telegram / Slack) — register a bot, route inbound messages through the AI agent, handle webhooks vs polling, or add a new channel adapter. Use when wiring chat into a messaging platform or debugging bot delivery.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/vstorm-co/full-stack-ai-agent-template/blob/HEAD/template/{{cookiecutter.project_slug}}/.claude/skills/channel-bot/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/channel-bot, but wait for my approval before writing files or running scripts.Copying this prompt does not install or run the skill. Review third-party files before use.
Messaging Channels (Telegram / Slack)
Channels are a thick service at backend/app/services/channels/: per-platform adapters plus a router that funnels inbound messages into the same agent pipeline as the web chat.
Layout
| File | Responsibility |
|---|---|
base.py | Shared channel adapter interface |
telegram.py | Telegram adapter (aiogram v3) |
slack.py | Slack adapter (Events API + Socket Mode) |
router.py | Maps an inbound platform message → conversation/session → agent run → reply |
chart_render.py | Renders chart tool output as PNG for channels |
Bots are stored in the DB (channel_bot), with per-user identity (channel_identity) and per-thread session (channel_session) tables. Bot tokens are encrypted at rest with CHANNEL_ENCRYPTION_KEY (Fernet).
Register / manage a bot
uv run {{ cookiecutter.project_slug }} cmd channel ... # see `cmd channel --help`
Webhook vs polling
- Polling (dev): the adapter long-polls the platform — no public URL needed.
- Webhook (prod): the platform POSTs to
POST /api/v1/telegram/{bot_id}/webhook/ the Slack events endpoint. Verify the signature/secret (HMAC for Telegram, signing secret for Slack) before processing.
Add a new channel adapter
- Implement an adapter in
services/channels/<platform>.pyagainst thebase.pyinterface (parse inbound → normalized message; send outbound). - Wire it into
router.pyso inbound messages reach the agent and replies stream back. - Add a webhook route under
api/routes/v1/(signature-verified) and/or a polling entrypoint. - Reuse the existing conversation/session model — don't fork the agent pipeline.
Rules
- Inbound messages flow through
router.pyinto the same agent/session pipeline as web chat — don't duplicate agent logic per platform. - Always verify webhook signatures before acting on a payload.
- Store tokens encrypted (
CHANNEL_ENCRYPTION_KEY); never log or echo them. - Respect per-group/per-thread concurrency controls already in the adapters.