Saltar al contenido principal
Ir al Studio
Integraciones

Telegram

Conecta el agente a Telegram mediante un bot registrado en @BotFather.

Telegram

La integración con Telegram permite que el agente hable con los usuarios directamente en Telegram, mediante un bot registrado en @BotFather.

Accede desde el icono Configuración → pestaña Integraciones → tarjeta Telegram.

Activar la integración​

Activa el interruptor de la tarjeta de Telegram. Los campos de configuración aparecen una vez activado.

Cómo funciona​

  1. El usuario envía un mensaje al bot en Telegram.
  2. Telegram reenvía el update al webhook de Roberty.
  3. Roberty valida la cabecera X-Telegram-Bot-Api-Secret-Token (cuando hay una configurada).
  4. El agente se ejecuta y la respuesta sale por sendMessage.

El endpoint del webhook:

https://agent-backend.roberty.app/integrations/telegram/<AGENT_ID>

Usa Copiar ID, en la parte superior de la pestaña Integraciones, para obtener el AGENT_ID.

Los campos de configuración​

CampoObligatorioQué es
Bot TokenSíEl token que te da @BotFather al crear el bot
Secret TokenNoUna cadena de seguridad: debe coincidir con el parámetro secret_token de la llamada setWebhook
Allowed Chat IDsNoIDs de chats separados por comas (123456789,-100987654321). Con esto relleno, el bot solo responde en esos chats

Crear el bot en Telegram​

1. Crear el bot​

  1. En Telegram, abre el chat con @BotFather.
  2. Envía /newbot y sigue las instrucciones para ponerle nombre.
  3. BotFather te da el Bot Token al final.

2. Registrar el webhook​

Usa la API setWebhook para registrar el endpoint de Roberty:

bash
curl -X POST "https://api.telegram.org/bot<BOT_TOKEN>/setWebhook" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://agent-backend.roberty.app/integrations/telegram/<AGENT_ID>",
    "secret_token": "TU_SECRETO_OPCIONAL",
    "allowed_updates": ["message", "edited_message"]
  }'
  • secret_token es opcional pero muy recomendable en producción.
  • Para quitar el webhook: POST /bot<TOKEN>/deleteWebhook.

3. Configurar el agente en Roberty​

Rellena Bot Token y, opcionalmente, Secret Token y Allowed Chat IDs.

4. (Opcional) Restringir quién puede hablarle​

Usa Allowed Chat IDs para restringir el bot a conversaciones concretas.

Para averiguar un chat.id:

  1. Envía /start a tu bot.
  2. Llama a https://api.telegram.org/bot<BOT_TOKEN>/getUpdates.
  3. El message.chat.id está en el JSON que vuelve.
información

Los chats no permitidos reciben un 200 en silencio, sin respuesta.

Validación de seguridad​

Con un Secret Token configurado en el agente, Telegram envía la cabecera X-Telegram-Bot-Api-Secret-Token: <valor>. Las peticiones sin ella, o con otro valor, reciben un 401.

Con Secret Token en blanco, esa validación queda desactivada.

Los tipos de update que atiende​

UpdateQué ocurre
messageEjecuta el agente con message.text.
edited_messageSe trata como un mensaje nuevo (el texto actualizado).

Los demás tipos (callbacks de botones, comandos, fotos, etc.) se ignoran en la versión actual.

Referencias​