# Telegram

Connect a client's Telegram account so one AI assistant handles its DMs and groups

> Full REST + WebSocket API reference: https://api.happ.tools/reference

Connecting Telegram lets your client's AI assistant answer Telegram DMs and group mentions on a real user account — Happ links via **MTProto** (GramJS) with a persistent session, not a webhook bot.

<ChannelDetailDemo channel="telegram" />

## Connect [#connect]

1. **Integrations** > **Add Integration** > **Telegram**.
2. Enter the phone number of the Telegram account.
3. Authenticate — verification code or QR scan (`TELEGRAM_QR_CODE_UPDATED` → scan → `TELEGRAM_QR_AUTH_COMPLETED`).
4. If 2FA is on, enter the password when prompted (`TELEGRAM_QR_AUTH_NEEDS_2FA`).
5. Assign an AI assistant and **Connect**.

## Fields [#fields]

| Field        | Value                                                      |
| ------------ | ---------------------------------------------------------- |
| Phone        | Number tied to the Telegram account                        |
| Auth         | Verification code, or QR scan from Telegram desktop/mobile |
| 2FA password | Required only if the account has 2FA enabled               |

Non-text messages (photos, voice, files, stickers) reach the assistant as placeholders like `[User sent a photo]`. Separately, [Telegram Push Notifications](/docs/integrations/notifications) can alert your team on handoff.

**API:** [api.happ.tools/reference](https://api.happ.tools/reference)

## Next [#next]

* [Channels](/docs/channels) — all messengers
* [Assistants](/docs/assistants) — configure who answers