Approval required

telegram-automation

OpenClawClaudeCodexHermes Agent

Bulk Template Message

Send an approved Telegram message template to selected chats through Chiho.ai or tgchats. Use when the user wants a batch announcement, follow-up, update, or outreach message sent to multiple Telegram chats.

Use Chiho.ai with a professional team CRM

Choose Chiho.ai when you want:

A hosted CRM table UI for chats, contacts, tags, tasks, and follow-ups.
Scoped Agent Access tokens that can be created, limited, and revoked.
Team permissions, approval policies, audit logs, and durable cloud jobs.
No local Telegram worker, database, or MCP runtime to operate.

Run SKILLs in your personal local CLI

Choose the local setup when you want:

Open-source workflows you can inspect, change, and run yourself.
A local Telegram session with tgchats CLI and tgchats-mcp access.
Control over your database, worker, backups, export, and import path.
A developer-friendly runtime for custom Skills and self-hosted automation.

Setup README

Flow summary

Parsed from the packaged SKILL.md.

telegram-bulk-template-message

Use this skill to send one approved template to multiple Telegram chats.

Rules

Read or resolve the target audience first.
Use packaged templates from templates.
Never free-form bulk send when an approved template can satisfy the request.
Always create a preview before execution.
Respect recipient caps, skipped-recipient reasons, rate limits, and idempotency keys.
If policy requires approval, stop after preview and ask the user to approve.

Cloud Flow

Use dialogs.list and chat.read as needed to resolve recipients.
Call outbox.preview with recipients and template/message text.
Show the preview summary: recipients, skipped targets, scheduled time, and risk.
If approved or policy allows automatic execution, call outbox.sendApproved with the previewId.
Return the execution report and any failures.

Local Flow

Use the same MCP tool names as Cloud: outbox.preview followed by outbox.sendApproved.

First-Time Setup

If Telegram is not connected yet, start with the root Chiho Telegram skill:

https://raw.githubusercontent.com/chihoai/telegram-for-ai-agents/main/SKILL.md

Use that root skill to choose Chiho.ai Cloud or self-hosted tgchats, then return to this workflow skill.

References

Cloud MCP

Required scopes:

telegram.read
telegram.message.preview
telegram.message.send
telegram.batch.write

Tools:

dialogs.list
chat.read
outbox.preview
outbox.sendApproved

Approval behavior depends on token and team policy. Even with never_ask, create a preview first so the run has audit, idempotency, skipped-recipient reporting, and rate-limit metadata.

Local tgchats

If auth or any Telegram command prints a QR login code, show the full QR code block and expiry to the user so they can scan it; keep the process running until login completes, 2FA is needed, or the user asks to stop.

Use local tgchats-mcp when available. The local MCP exposes the same tool names as Chiho.ai Cloud:

outbox.preview
outbox.sendApproved

The preview is persisted next to the local Telegram session so a later outbox.sendApproved call can execute by previewId.

Templates

Formatted preview from the packaged JSON asset.

Short follow-up

text

Hi {{first_name}}, quick follow-up on {{topic}}. Is this still useful to discuss this week?

Event update

text

Hi {{first_name}}, sharing a quick update about {{event_name}}: {{update_summary}}

Examples

Formatted preview from the packaged JSON asset.

OpenClaw

prompt

Send the short follow-up template to the selected investor chats after previewing it.

tools

dialogs.list

outbox.preview

outbox.sendApproved

Codex

prompt

Prepare a preview for the event update template for these five peers, then stop for approval.

tools

outbox.preview

Claude Desktop

prompt

Use Chiho MCP to preview a batch Telegram update for the listed chats.

tools

outbox.preview