telegram-message Card

Sending Telegram Messages

To send a message to a Telegram chat, create a card in _bookkeeping/output/ with the .telegram-message.card extension.

Required frontmatter

• chat-id: — The Telegram chat ID (negative for groups)
• text: — The message text (max 4096 chars), sent as plain text.

Lifecycle

1. Create the card with status: pending
2. Stage and commit
3. The telegram connector sends it during bbx wakeup or bbx finalize
4. On success: card is deleted
5. On failure: status becomes failed, an error field is added. Failed cards are not retried — fix or delete them.

The contains: field

Give this card a one-sentence contains: — the prime retrieval field for bbx search and listings. How to write a good one (carry the information when it's concise, never a list of parts, under 200 characters) is in the agent guide's ABOUT_CARDS section.