> ## Documentation Index
> Fetch the complete documentation index at: https://docs.architect.new/llms.txt
> Use this file to discover all available pages before exploring further.

# Telegram

> The Telegram tool allows your AI agents to send blazing-fast notifications and messages directly to your phone or community groups. By connecting Telegram to Architect, your apps can operate as personal pocket assistants or autonomous group moderators.

## Why Use Telegram in Architect?

Sometimes you need alerts immediately, without logging into a heavy enterprise platform. With Architect's vibe coding, you can quickly spin up lightweight bots that talk directly to you on Telegram. It’s perfect for personal alerting, community management, or sending on-the-go workflow updates.

* **Personal Alerting:** Build agents that act as your personal radar, sending you a Telegram message the second a specific client emails you or a server goes down.
* **Community Moderation:** Create bots that monitor Telegram group chats for spam, welcome new members, and answer frequently asked questions autonomously.
* **On-the-Go Reporting:** Have your agent fetch daily financial metrics or crypto prices and send you a formatted morning brief directly to your phone.

## Vibe Coding Examples

Try these natural language prompts to build instant-messaging agents:

<CardGroup cols={1}>
  <Card title="Example 1: The VIP Monitor">
    "Build a personal alert app. Monitor my support inbox. If an email comes in from '[investor@company.com](mailto:investor@company.com)', immediately use the Telegram tool to send me a direct message containing the email subject line and a 1-sentence summary."
  </Card>

  <Card title="Example 2: Community Welcomer">
    "Create a community bot. When a new user joins my public Telegram group, use the Telegram tool to post a welcome message tagging them, outlining the group rules, and offering a brief summary of what the community discusses."
  </Card>

  <Card title="Example 3: Morning Market Brief">
    "I want a daily digest agent. At 7:00 AM every day, fetch the top 3 tech news headlines. Format them nicely with bullet points and emojis, and use the Telegram tool to send the digest to my personal chat."
  </Card>
</CardGroup>

<Tip>
  Vibe code a research assistant for your commute! Have the agent use the Arxiv tool to find new papers on AI, summarize them, and send the summaries to your Telegram so you can read them on your phone.
</Tip>

## Available Actions

The Telegram tool exposes the following actions to your agents. Architect automatically picks the right one based on your prompt.

<Accordion title="View all 17 Telegram actions" icon="list">
  * `TELEGRAM_ANSWER_CALLBACK_QUERY`
  * `TELEGRAM_DELETE_MESSAGE`
  * `TELEGRAM_EDIT_MESSAGE`
  * `TELEGRAM_EXPORT_CHAT_INVITE_LINK`
  * `TELEGRAM_FORWARD_MESSAGE`
  * `TELEGRAM_GET_CHAT`
  * `TELEGRAM_GET_CHAT_ADMINISTRATORS`
  * `TELEGRAM_GET_CHAT_HISTORY`
  * `TELEGRAM_GET_CHAT_MEMBERS_COUNT`
  * `TELEGRAM_GET_ME`
  * `TELEGRAM_GET_UPDATES`
  * `TELEGRAM_SEND_DOCUMENT`
  * `TELEGRAM_SEND_LOCATION`
  * `TELEGRAM_SEND_MESSAGE`
  * `TELEGRAM_SEND_PHOTO`
  * `TELEGRAM_SEND_POLL`
  * `TELEGRAM_SET_MY_COMMANDS`
</Accordion>