OpenParable
Skip to content
← Back to skills

Channel Bot

Apps & Automation
channel-bot

Channel 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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
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

FileResponsibility
base.pyShared channel adapter interface
telegram.pyTelegram adapter (aiogram v3)
slack.pySlack adapter (Events API + Socket Mode)
router.pyMaps an inbound platform message → conversation/session → agent run → reply
chart_render.pyRenders 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

  1. Implement an adapter in services/channels/<platform>.py against the base.py interface (parse inbound → normalized message; send outbound).
  2. Wire it into router.py so inbound messages reach the agent and replies stream back.
  3. Add a webhook route under api/routes/v1/ (signature-verified) and/or a polling entrypoint.
  4. Reuse the existing conversation/session model — don't fork the agent pipeline.

Rules

  • Inbound messages flow through router.py into 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.