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

# Telegram Bot Integration

Streamline your crypto operations by connecting Telegram directly to your blockchain workflows. Use B3OS to automate real-time notifications, manage com...

![Telegram Bot logo](https://ai-icon.b3.fun/logo/telegram-bot) Integration available

Streamline your crypto operations by connecting Telegram directly to your blockchain workflows. Use B3OS to automate real-time notifications, manage community interactions, and execute on-chain commands through a seamless Telegram interface.


**[Public page](https://b3os.org/integrations/app/telegram-bot)**

Open the user-facing integration overview for examples, templates, and sharing.
  **[Action reference](/actions/reference)**

Schema-level references for executable actions and test payloads.
  **[Trigger reference](/actions/trigger-reference)**

Event and schedule triggers that can start B3OS workflows.

## Build With Telegram Bot

Use Telegram Bot when a workflow needs to react to Telegram Chat Message, Telegram: Button Click / Interaction and follow up with actions such as AI Format Message, Send Telegram Message. Start in the visual editor to connect an account, then use the references below for payload shape, required fields, and API testing.

## Available Actions

| Action | ID | Connector | Required fields |
| --- | --- | --- | --- |
| ![AI Format Message logo](https://ai-icon.b3.fun/logo/ai) [AI Format Message](/actions/reference/generated/ai-format-message) | `ai-format-message` | `-` | `rawText` |
| ![Send Telegram Message logo](https://ai-icon.b3.fun/logo/telegram-bot) [Send Telegram Message](/actions/reference/generated/send-telegram-message) | `send-telegram-message` | ![telegram-bot logo](https://ai-icon.b3.fun/logo/telegram-bot) `telegram-bot` | `chatId`, `text` |


## Available Triggers

| Trigger | ID | Required configuration |
| --- | --- | --- |
| [Telegram Chat Message](/actions/trigger-reference/triggers/telegram-channel) | `telegram-channel` | `chatId` |
| [Telegram: Button Click / Interaction](/actions/trigger-reference/triggers/telegram-new-interaction-event) | `telegram-new-interaction-event` | - |


## Common Use Cases

**Real-time Whale Alerts**

Automatically send instant Telegram notifications to your private group whenever a specific large-scale transaction is detected on-chain.
  **Interactive DAO Voting**

Enable community members to participate in governance by using Telegram button interactions to cast votes that are directly recorded on the blockchain.
  **Automated Customer Support**

Trigger specific support workflows or wallet status checks automatically when users send predefined commands to your project's Telegram bot.
  **Token Minting via Chat**

Simplify the user experience by allowing authorized users to initiate token minting or staking processes through simple text commands in Telegram.

## Connector Notes

- Create the connector from a trusted B3OS organization before publishing workflows that call external accounts.
- Keep OAuth tokens, API keys, bot tokens, channel IDs, and account IDs in connector settings or workflow props, not in reusable public template text.
- Test with the visual editor or `POST /v1/actions/{type}/test` before routing production traffic.

## Related Templates

| Template | Description | Tags |
| --- | --- | --- |
| [Coinbase Biz + Morpho: Rebalance for Max Yield](https://b3os.org/templates/treasury-usdc-rebalancer) | This is a workflow you can have running on a preset cadence where your Coinbase Biz balance w... | coinbase, wallet, payment, treasury, accounting |
| [Telegram: Wallet Control](https://b3os.org/templates/telegram-wallet-control) | This workflow allows you to control your organization Treasury Wallet via Telegram on Base. Y... | telegram-bot-api |
| [Daily Portfolio Sentiment Recap](https://b3os.org/templates/daily-portfolio-sentiment-recap) | This workflow monitors the assets in your wallet, identified the top-performing tokens and th... | defi, trading, wallet |
| [Drake News → Polymarket Auto-Bet](https://b3os.org/templates/drake-news-polymarket-auto-bet) | Monitors music-news X accounts every minute for breaking Drake stories, asks AI YES/NO on you... | polymarket, twitter, prediction-market, bet |
| [Morpho: LTV Alerts + Repay](https://b3os.org/templates/morpho-ltv-alerts-repay) | Watches every Morpho Blue borrow position you have on the chosen chain. When any position cro... | defi, lending, morpho |
| [Plume: Auto-Rebalance your Nest Vaults Daily](https://b3os.org/templates/plume-auto-rebalance-nest-vaults) | Moves your pUSD between Nest vaults on Plume to chase higher APYs. Runs daily at 08:00 UTC. W... | defi, nest, vault |
| [Plume: Looped pUSD Yield via Nest + Morpho](https://b3os.org/templates/nest-morpho-leverage-loop) | This workflow builds a leveraged pUSD yield position on Plume by looping deposits between Nes... | defi, lending, nest, plume |
| [Polymarket: AI Bets When It Disagrees with the Market](https://b3os.org/templates/polymarket-ai-contrarian-bets) | Trades US-based policy events based on AI forecasts. On a set schedule, the workflow scrapes... | trading, wallet, polymarket |

## FAQ

**How do I connect my Telegram bot to B3OS?**

You can either use the pre-configured B3OS Bot for instant setup or connect your own custom bot by obtaining an API token from @BotFather and entering it into the B3OS integration settings.
  **Can I trigger blockchain workflows via Telegram messages?**

Yes, you can set up 'Telegram Chat Message' as a trigger, allowing specific text commands or messages to initiate complex automated workflows within your B3OS environment.
  **What is the difference between the B3OS Bot and my own bot?**

The B3OS Bot is designed for rapid deployment with zero configuration, while bringing your own bot via @BotFather allows for custom branding and specific permission management for your community.
  **Can I use Telegram buttons to trigger automation?**

Absolutely. By using the 'Telegram: Button Click / Interaction' trigger, you can create interactive menus in your chat that allow users to trigger specific blockchain actions with a single tap.
  **Is this integration secure for managing crypto assets?**

Yes, B3OS follows industry-standard security protocols. The Telegram integration acts as a communication layer, ensuring that command triggers are processed securely through your defined automation logic.