# Telegram

Подключите Telegram-аккаунт клиента, чтобы один AI-агент обрабатывал его личные и групповые чаты

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

Подключение Telegram позволяет AI-агенту вашего клиента отвечать на личные сообщения Telegram и упоминания в группах с реального аккаунта пользователя — Happ подключается через **MTProto** (GramJS) с постоянной сессией, а не через бота с вебхуком.

<ChannelDetailDemo channel="telegram" />

## Подключение [#connect]

1. В **Интеграциях** в разделе **Мессенджеры** нажмите плитку **Telegram**. Откроется окно с QR-кодом.
2. На телефоне откройте Telegram → **Настройки** → **Устройства** → **Подключить устройство** и отсканируйте код.
3. Если на аккаунте включена двухэтапная проверка, введите её пароль, когда окно попросит.
4. После подключения выберите, сколько последних чатов и сообщений импортировать, и назначьте AI-агента.

**Нет возможности отсканировать?** Нажмите ссылку на **код подтверждения** под QR-кодом: введите номер телефона аккаунта, отправьте код, введите код от Telegram (и пароль 2FA, если он есть) и подтвердите.

## Поля [#fields]

| Поле       | Значение                                                         |
| ---------- | ---------------------------------------------------------------- |
| QR-код     | Основной способ — отсканируйте его из Telegram на телефоне       |
| Телефон    | Только для входа по коду: номер, привязанный к аккаунту Telegram |
| Пароль 2FA | Нужен, только если на аккаунте включена двухэтапная проверка     |

Нетекстовые сообщения (фото, голосовые, файлы, стикеры) приходят агенту как заглушки вида `[User sent a photo]`. Отдельно [Telegram Push-уведомления](/docs/integrations/notifications) могут оповещать вашу команду о передаче разговора.

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

## Дальше [#next]

* [Каналы](/docs/integrations/messengers) — все мессенджеры
* [Агенты](/docs/agents) — настройте, кто отвечает