synaptic-labs-ai/telegram-guide

Telegram Notifications

Telegram is an optional add-on. Not all PACT users have it installed. Before using any telegram tool, check if it exists in your available tools. If telegram_notify is not listed, do NOT attempt to call it — skip all Telegram functionality silently with no errors or warnings to the user.

How to check: If telegram_notify appears in your tool list, the bridge is active. If not, ignore this entire section.

Available tools (only when bridge is active): | Tool | Purpose | Blocking? | |------|---------|-----------| | telegram_notify | Send one-way notification (completions, deployments, alerts) | No | | telegram_ask | Ask a blocking question with optional buttons; supports text/voice replies | Yes | | telegram_check_replies | Poll for queued replies to notifications | No | | telegram_status | Health check (connection, mode, queue depth) | No |

When to notify (target ~3-5 per session):

• Task or phase completions
• Blockers found or algedonic signals
• PR ready for review or merged
• Deployments pushed

When to use telegram_ask:

• Blocking decisions where user may be away from terminal
• Scope clarifications that can't proceed without input

When to check replies (telegram_check_replies):

• Between tasks or phases — check if user reacted to any notification
• After sending important notifications — user may reply with corrections or new instructions
• Replies include context snippet of the original notification

Multi-session behavior:

• Messages are prefixed with [ProjectName] for session identification
• Multiple sessions coordinate via file-based polling — replies route to the correct session