Bee Box documentation · directory: https://beebox.run/docs/reference/cards/ · index: https://beebox.run/docs/reference/cards/index.md · root: https://beebox.run/llms.txt

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