# Telegram

Conecta un bot de Telegram a un proyecto y elige quién puede enviarle tareas.

Canonical page: https://beeuni.ai/docs/es/connect/telegram

Un bot de Telegram permite enviar tareas al agente de un proyecto desde un chat. Las respuestas llegan al mismo chat y puedes consultar el historial completo de la sesión en Beeuni.

## Conectar el bot

1. Abre **@BotFather** en Telegram y crea un bot con `/newbot`. Copia su token.
2. Abre la página **Canales** del proyecto. Busca **Telegram**, introduce el token y conecta el bot.
3. Envía `/start` al bot en Telegram. Si aún no tienes permiso, su respuesta muestra tu ID numérico de Telegram.
4. Añade ese ID a la lista de personas permitidas en Beeuni y guarda los cambios. Envía una tarea al bot.

Si la lista está vacía, nadie puede ejecutar tareas. Para conectar el bot o cambiar la lista necesitas permiso para administrar los conectores del proyecto. El token se guarda en el servidor: no se devuelve en los datos de instalación ni se entrega al agente.

## Sesiones y acceso

La primera tarea de un chat inicia una sesión. Los mensajes posteriores la continúan. Cada tema de un foro tiene su propia sesión. Envía `/new` para que el siguiente mensaje inicie otra sesión; el historial anterior permanece en Beeuni.

Las personas permitidas ejecutan tareas con la identidad de automatización del proyecto. Las sesiones son visibles en el proyecto. Esto no inicia sesión en Beeuni con la cuenta de cada remitente. Añade solo a quienes deban ejecutar tareas con los permisos compartidos del proyecto.

Para dejar de recibir tareas mediante el bot, desconéctalo en la página Canales.

## SDK

El SDK incluye `getTelegramInstallation`, `connectTelegram`, `setTelegramAllowedUsers` y `disconnectTelegram`. Pasa el ID del proyecto a cada función. Consulta [Autenticación del SDK](/docs/es/sdk/auth) para configurar el token de acceso.