# Telegram (/es/docs/integrations/telegram)

Conecta un bot de Telegram a un workspace de Sift para monitorear grupos y canales de soporte, ingestar conversaciones directas, y responder desde la bandeja junto con cada otro canal.

## De un vistazo [#de-un-vistazo]

| | |
| --- | --- |
| Entrante: Mensajes de grupo (hilos, respuestas) | ✅ |
| Entrante: Mensajes de canal | ✅ |
| Entrante: Mensajes directos abiertos vía comando `/sift` | ✅ |
| Entrante: Backfill al conectar | ✅ últimos 30 días |
| Entrante: Respuestas de botón de CSAT | ✅ |
| Saliente: Responder en un grupo / canal (en hilo) | ✅ publicado por el Bot de Sift |
| Saliente: Mensaje directo a un usuario | ✅ en conversaciones que el usuario abrió |
| Saliente: Enviar prompt de CSAT al cerrar | ✅ basado en botones |
| Múltiples canales + múltiples grupos por workspace | ✅ |
| Bots de respuesta automática | ✅ |
| Secret Chats (cifrado de extremo a extremo) | ❌ Telegram no los expone vía Bot API |

## Configurarlo [#configurarlo]

{/* setup-screenshot */}
<figure>
  <img src="/assets/screenshots/telegram/setup.png" alt="La página de configuración de Telegram en Sift, mostrando cuentas conectadas (nombres de cuenta redactados para los docs)." />
  <figcaption>Configuración de Telegram en Sift - gestiona las cuentas conectadas aquí.</figcaption>
</figure>

Ve a [Configuración → Integraciones → Telegram](https://app.getsift.ai/app/settings/integrations/) y:

1. **Conecta**: pega tu token de Bot de Telegram (genera uno vía [@BotFather](https://t.me/BotFather)).
2. **Agrega el Bot de Sift** a los grupos y canales que quieres monitorear.
3. **(Opcional) Configura el trigger `/sift`**: cambia el comando slash o keyword que abre un ticket 1:1.
4. **Asigna cada grupo / canal a una cola** (opcional) para enrutamiento.

El bot necesita permisos de **lectura** en cada grupo para ingestar mensajes, y permisos de **enviar** para publicar respuestas. En canales, el bot debe ser admin para leer mensajes.

Una vez que agregas el bot a un canal, los últimos 30 días de mensajes se extraen. El historial más viejo no es alcanzable a través de la API de Telegram.

**Agrega a un compañero nuevo a tus chats.** Cuando un compañero conecta su propia cuenta de Telegram, selecciona los chats en la lista y haz clic en **Añadir compañero**. Su cuenta se une a cada chat en el que aún no está. En un chat público, se une directamente. En un chat privado, un bot de Sift o una cuenta conectada que es administradora allí crea un enlace de invitación para una persona, y la cuenta del compañero se une con él. Si no hay ninguno y tu propia cuenta está en el chat, tu cuenta lo añade. Telegram limita la velocidad, así que una lista larga puede tardar. Al terminar recibes un aviso con los chats a los que se unió y los que necesitan un administrador. Puede iniciarlo el propietario de la cuenta o un administrador de la organización. La misma barra de selección permite supervisar o ignorar chats pendientes y añadir o quitar etiquetas de canal.

## Lo que puedes hacer [#lo-que-puedes-hacer]

**Responde en hilo** en cualquier grupo o canal donde esté el bot - se publica de vuelta a Telegram como el Bot de Sift. **Responde en un ticket 1:1** abierto vía `/sift`:** el usuario ve un DM normal del bot. Envía un prompt de CSAT** al cerrar - botones interactivos; el tap del usuario regresa como una actualización de acción.

**Activa workflows** según cualquier señal de Telegram (grupo, remitente, keyword). Enruta al equipo correcto automáticamente. **Aplica bots de respuesta automática** para patrones de FAQ.

## Cómo entran las conversaciones a Sift [#cómo-entran-las-conversaciones-a-sift]

Sift usa una **cuenta bot** de Telegram que agregas a tus grupos y canales. Hay dos caminos que una conversación puede tomar para llegar a la bandeja:

**1. Mensajes de grupo + canal**: una vez que el Bot de Sift se agrega a un grupo o canal, cada mensaje nuevo ahí fluye a la bandeja como una acción, enhebrado por el topic del grupo / cadena de respuestas. Úsalo para flujos "monitorea nuestra comunidad" o "monitorea nuestro grupo de soporte".

**2. Comando `/sift` en un grupo**: un usuario escribe `/sift` (o tu trigger personalizado) dentro de un grupo, y se abre una conversación privada entre ese usuario y el Bot de Sift. Cada mensaje después se vuelve un ticket 1:1 en Sift, separado del ruido del grupo. Úsalo para flujos "deja que los usuarios pidan soporte desde dentro de la comunidad sin spammear el canal".

## No soportado hoy [#no-soportado-hoy]

- **Secret Chats**: la superficie personal cifrada de extremo a extremo de Telegram no se expone a la Bot API. Cualquier cosa que necesite mantenerse E2E-cifrada se queda en Telegram, no en Sift.
- **Login con cuenta de usuario** (vs. cuenta bot) - Sift conecta como bot, no como usuario humano. Si necesitas que los mensajes aparezcan publicados por un individuo en vez del Bot de Sift, eso no está disponible hoy.
- **Ediciones y eliminaciones después del hecho**: si un usuario edita o elimina un mensaje en Telegram, el original se queda en Sift (la bandeja es un registro de auditoría, no un espejo en vivo).