Conectar Telegram a Elido

Elido envía notificaciones de Telegram mediante un bot que creas tú. El bot envía mensajes a un chat concreto: un mensaje directo privado contigo o un grupo. El token del bot es tuyo; Elido solo lo almacena cifrado.

Paso 1: crea un bot con BotFather

1. Abre Telegram y busca @BotFather, o abre https://t.me/BotFather.
2. Envía /newbot.
3. Sigue las indicaciones: elige un nombre visible y luego un nombre de usuario (debe terminar en bot, por ejemplo AcmeElidoBot).
4. BotFather responde con tu token de API. Tiene este aspecto: 123456789:AABBccDD.... Cópialo ahora: puedes recuperarlo más tarde desde /mybots, pero es más rápido copiarlo de entrada.

Paso 2: encuentra tu ID de chat

Necesitas el ID de chat numérico del lugar al que quieres enviar los mensajes.

Para mensajes directos (solo tú):

1. Envía cualquier mensaje a tu nuevo bot.

2. Abre esta URL en un navegador, sustituyendo TOKEN por tu token:

   https://api.telegram.org/botTOKEN/getUpdates
   

3. Busca "chat":{"id":...} en la respuesta. Ese número es tu ID de chat. Normalmente es un entero positivo de 9 dígitos para los chats personales.

Para un grupo:

1. Añade el bot al grupo.
2. Envía un mensaje en el grupo que mencione al bot con @ (por ejemplo @AcmeElidoBot hello).
3. Abre la misma URL de getUpdates de arriba. Los ID de chat de grupo son números negativos (por ejemplo -1001234567890).

Paso 3: configura Elido

1. Ve a Settings → Notifications → Telegram → Add channel.
2. Pega el token del bot y el ID de chat.
3. Pulsa Save. Elido envía un mensaje de prueba. Espéralo en Telegram en 2 segundos.

Elegir eventos

Una vez conectado, pulsa Configure events para seleccionar qué eventos activan un mensaje:

• link.broken: punto de partida recomendado; el monitor de enlaces rotos encontró un destino que ya no funciona.
• usage.threshold_80 y usage.threshold_100: el workspace usó el 80 % o el 100 % de la cuota de su plan.
• link.expired y link.cap_reached: un enlace caducó o alcanzó su límite de clics.
• link.created: útil en workspaces compartidos donde quieres visibilidad de los enlaces nuevos.
• domain.verified y domain.ssl_failed: estado de los dominios personalizados.

La lista completa de tipos de evento está en la guía de webhooks.

Quitar la integración

Ve a Settings → Notifications → Telegram → Remove. Esto elimina el token del bot de la base de datos de Elido. Si quieres, revoca también el propio bot en BotFather con /revoke.

Solución de problemas

"Unauthorized" en el registro de entregas: El token es incorrecto. Compruébalo pegando esto en un navegador:

https://api.telegram.org/botTOKEN/getMe

Si devuelve {"ok":false,...}, el token no es válido.

"Chat not found": El ID de chat es incorrecto, o el bot nunca se añadió al grupo. En grupos, confirma que el bot es miembro y envía un mensaje que lo mencione antes de llamar a getUpdates.

No llega ningún mensaje tras pulsar Test: Revisa getUpdates para confirmar que el bot recibió alguna interacción. Si la respuesta está vacía, Telegram aún no ha registrado ningún contacto entre el usuario o grupo y el bot.

Los mensajes del grupo no se ven: Algunos grupos de Telegram tienen "modo lento" o permiten publicar solo a los administradores. Convierte al bot en administrador con el permiso "Post messages".