jongwony/cc-plugin/telegram-report

Telegram report — one message per routine run

Prerequisites

• bash, curl, python3 on PATH.
• TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID in the session environment (a cloud

environment's variables). Nothing is read from a file.

Send

At the end of the run, after the final report is composed:

printf '%s' "<report>" | bash <checkout>/telegram-report/scripts/tg-report.sh <thread-id> -

• <thread-id> is the one the routine file records. Never create a topic or pick another id.
• <report> is the final report condensed to fit 4096 characters: the routine's name on the

first line, then the outcome. A failed run says what failed.

• One message per run, including a run with nothing to do.

Outcome

• Exit 0 prints sent thread=… message_id=….
• Exit 3 (credentials missing) or 5 (send failed, with Telegram's description): state it in

the final message and stop. Do not retry through another channel.

Boundaries

• Send only; never call an update-reading Bot API method. The group's resident bridge is the

bot's only reader, and a second reader breaks it.

• Never put a token, a chat id, or an environment dump in the text.