# Telegram

Conecta la cuenta de Telegram de un cliente para que un agente de IA atienda sus mensajes directos y grupos

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

Conectar Telegram permite que el agente de IA de tu cliente responda a mensajes directos y menciones en grupos de Telegram desde una cuenta de usuario real: Happ se vincula mediante **MTProto** (GramJS) con una sesión persistente, no con un bot de webhook.

<ChannelDetailDemo channel="telegram" />

## Conectar [#connect]

1. En **Integraciones**, en la sección **Mensajeros**, haz clic en el mosaico **Telegram**. El diálogo se abre con un código QR.
2. En tu teléfono, abre Telegram → **Ajustes** → **Dispositivos**, elige vincular un dispositivo de escritorio y escanea el código.
3. Si la cuenta tiene verificación en dos pasos, introduce su contraseña cuando el diálogo la pida.
4. Una vez conectada, elige cuántos chats y mensajes recientes importar y asigna un asistente de IA.

**¿No puedes escanear?** Haz clic en el enlace del **código de verificación** bajo el QR: introduce el número de teléfono de la cuenta, solicita el código, escribe el código que envía Telegram (y la contraseña 2FA, si la hay) y confirma.

## Campos [#fields]

| Campo          | Valor                                                                       |
| -------------- | --------------------------------------------------------------------------- |
| Código QR      | Método predeterminado: escanéalo desde Telegram en tu teléfono              |
| Teléfono       | Solo para el método por código: el número vinculado a la cuenta de Telegram |
| Contraseña 2FA | Solo si la cuenta tiene verificación en dos pasos                           |

Los mensajes que no son texto (fotos, voz, archivos, stickers) llegan al asistente como marcadores del tipo `[User sent a photo]`. Por separado, las [notificaciones push de Telegram](/docs/integrations/notifications) pueden avisar a tu equipo cuando hay un traspaso.

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

## Siguiente [#next]

* [Canales](/docs/integrations/messengers): todos los mensajeros
* [Agentes](/docs/agents): configura quién responde