Approval required
telegram-automation
OpenClawClaudeCodexHermes Agent

Add Colleagues To Group

Add or invite one Telegram user to selected group chats. Use when the user wants to add a colleague, teammate, contractor, or partner to Telegram groups.

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.
Chiho.ai Telegram CRM workspace
Sign up and Create API token

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.
Chiho.ai Telegram CRM workspace

Flow summary

Parsed from the packaged SKILL.md.

telegram-add-colleagues-to-group

Use this skill to add or invite one Telegram user to one or more group chats.

Rules

  • Resolve the target user and target groups before preview.
  • Do not invite users to unrelated groups based on name similarity alone.
  • Always create an invite preview before execution.
  • Explain whether execution may directly add the user or fall back to an invite link.
  • Respect group limits, permission failures, and privacy failures.

Flow

  1. Use dialogs.list to resolve candidate groups.
  2. Use chat.read only when group context is needed for disambiguation.
  3. Call members.invitePreview with the target user and groups.
  4. Show the preview summary and ask for approval when policy requires it.
  5. Call members.inviteApproved with the previewId.
  6. Report added groups, invite-link fallbacks, skipped groups, and failures.

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.members.invite

Tools:

  • dialogs.list
  • chat.read
  • members.invitePreview
  • members.inviteApproved

Use members.invitePreview for every run. Approval mode controls whether the user must confirm, not whether a preview is created.

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 with:

  • members.invitePreview
  • members.inviteApproved

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

Templates

Formatted preview from the packaged JSON asset.

Invite link fallback

text

Hi {{first_name}}, you've been invited to join {{group_name}}: {{invite_link}}

Examples

Formatted preview from the packaged JSON asset.

OpenClaw

OpenClaw

prompt

Preview adding this colleague to the selected partner groups.

tools

dialogs.list
members.invitePreview

Codex

Codex

prompt

Add user 12345 to these three groups if the preview looks right.

tools

members.invitePreview
members.inviteApproved

Claude Desktop

Claude Desktop

prompt

Show which groups this colleague would be invited to and stop.

tools

members.invitePreview