La integración de Telegram con Ágora hace llegar a un chat o a un grupo de Telegram los avisos de error y los ficheros que generan las integraciones de Ágora de un local: un salto en la numeración de las facturas de ARCA, un pedido de la tienda online que no entra en Ágora, un fallo de una exportación contable o el PDF de un informe. Cada integración tiene su propio campo de chat, así que cada aviso puede ir a quien le toca.
Este manual es para el técnico de FOS o del distribuidor que deja configurados esos avisos. No es una integración que se dé de alta por separado: es un campo más en las integraciones que lo admiten, en https://app.connectmanager.es.
Qué hace la integración#
- Manda los mensajes desde el bot de Telegram de Connect Manager al chat que indiques: una conversación privada con el bot o un grupo en el que esté el bot.
- Integraciones fiscales (AFIP / ARCA): avisa de los saltos de numeración de los comprobantes que encuentra la revisión de cada hora.
- Integraciones de pedidos (WooCommerce): avisa cuando un pedido no se puede procesar, por ejemplo porque falta configuración en la integración o porque el proceso falla.
- Integraciones de contabilidad (Workday, Querry (SII), GSD (SAP) y SAP HANA (BTP)): avisa de los errores de la generación o del envío, con el local, la fecha y el mensaje del error.
- Integraciones de informes (Ventas por periodo del día, JDE Avanza, Informe de cierre de caja) y de etiquetas (Cambios de precio): envía el PDF al chat cada vez que se genera, además de por correo.
- Permite un chat distinto en cada integración del local, y deja el campo vacío para no usar Telegram en esa integración.
- Además, FOS recibe los mismos avisos de error en su propio canal interno, aunque no haya chat configurado.
Qué no hace#
- No genera los informes por sí misma: solo entrega lo que generan las integraciones. Si un informe no llega tampoco por correo, el problema está en la integración de informes, no en Telegram.
- No permite elegir el chat en las integraciones de Uber Eats, Glovo y Just Eat: su pantalla no muestra el campo de Telegram y sus avisos se configuran por correo.
- No envía avisos en la integración fiscal de efsta (Portugal), aunque su pantalla tenga el campo.
- No sirve para hablar con el bot: el chat está pensado solo para recibir avisos.
Requisitos#
- Una cuenta de Telegram y, si el aviso es para varias personas, un grupo.
- El nombre del bot de Connect Manager, que facilita FOS.
- La integración del local ya creada en Connect Manager (fiscal, de pedidos, de contabilidad, de informes o de etiquetas). El alta la hace FOS.
- No hace falta abrir nada en la red del local: los mensajes salen de los servidores de Connect Manager hacia Telegram.
Datos que necesitamos#
| Dato | Quién lo facilita / dónde se saca | Ejemplo o formato | Obligatorio |
|---|---|---|---|
| Nombre del bot de Connect Manager | FOS | @nombre_del_bot | Sí |
| Grupo o persona que recibe los avisos | Cliente | Grupo «Avisos Local Demo» | Sí |
| Id. del chat | FOS, una vez que el bot está en el chat | Grupo: -1001234567890; persona: 123456789 | Sí |
| Integraciones que deben avisar a ese chat | Cliente y distribuidor | ARCA y Workday al grupo de administración | Sí |
Configuración paso a paso#
En Telegram#
- Crea el grupo que recibirá los avisos (o usa una conversación privada si es para una sola persona).
- Añade el bot de Connect Manager al grupo. Si es una conversación privada, abre el chat con el bot y pulsa Iniciar: un bot no puede escribir a quien no ha hablado antes con él.
- Pide a FOS el id. de ese chat. Copia el número completo: en los grupos empieza por un signo menos, y sin él no funciona.
En Connect Manager#
- En
https://app.connectmanager.es, ve a Administración → Locales y abre el local. - Entra en el módulo de la integración y abre la integración:
- Integraciones fiscales (AFIP): campo Id. de chat de Telegram para recibir notificaciones.
- Integraciones de pedidos (WooCommerce): campo Id. de chat de Telegram para recibir notificaciones.
- Integraciones de contabilidad (Workday, Querry (SII), GSD (SAP), SAP HANA (BTP)): campo Id. de chat de Telegram para recibir notificaciones.
- Integraciones de informes (salvo los informes generales y tabulares en TPV) y de etiquetas (Cambios de precio): campo Id. de chat de Telegram para recibir el archivo.
- Pega el id. del chat, sin espacios, y pulsa Guardar.
- Repite en cada integración que deba avisar a ese chat. Para no usar Telegram en una integración, deja el campo vacío.
[!TIP] Usa grupos por tema (fiscal, pedidos, contabilidad) en lugar de uno para todo: cada integración tiene su campo y los avisos llegan a quien puede resolverlos.
Cómo funciona#
Cuando una integración termina un proceso con error, o genera un fichero, prepara el mensaje y lo envía por dos caminos a la vez: al canal interno de FOS y, si la integración tiene chat configurado, al chat del cliente. El envío a Telegram se hace en segundo plano desde los servidores de Connect Manager a través del bot; si el aviso lleva un PDF, llega como documento adjunto con un texto que lo identifica.
sequenceDiagram
participant INT as Integración del local
participant CM as Connect Manager
participant TG as Bot de Telegram
participant CHAT as Chat del cliente
INT->>CM: Error o fichero generado
CM->>CM: Prepara el aviso con local, fecha y detalle
CM->>TG: Mensaje al canal interno de FOS
CM->>TG: Mensaje o PDF al chat configurado
TG-->>CHAT: Aviso en el grupo o en el chat privado
Qué mensajes llegan#
- ARCA: «Ocurrió un error en la numeración de documentos de AFIP:» seguido de los comprobantes afectados.
- WooCommerce: «Generar pedido de WooCommerce (Error)» con el local, el proveedor y el error, o el aviso de revisar la configuración.
- Contabilidad: «Ocurrió un error en …» con el nombre del proceso, el local, la fecha y el mensaje de la excepción.
- Informes y etiquetas: el PDF generado, por ejemplo al pulsar Generar facturación por periodos o Generar PDF en el Inicio del panel.
Cada aviso de error va siempre al canal interno de FOS. Al cliente le llega por Telegram solo si la integración tiene el id. de chat rellenado; si no, solo por correo, cuando la integración tiene correos configurados.
flowchart LR
A[Evento de una integración] --> B{Tiene chat de Telegram}
B -- Sí --> C[Aviso al chat del cliente]
B -- No --> D[Solo correo si lo tiene]
A --> E[Aviso al canal interno de FOS]
Comprobar que funciona#
- Con el bot ya en el grupo, guarda el id. del chat en una integración de informes o de etiquetas.
- En el Inicio de
https://app.connectmanager.es, genera ese informe con su widget (Generar facturación por periodos o Generar PDF). - En unos minutos debe llegar el PDF al grupo y al correo configurado.
- Si el chat es para avisos de error, comprueba con FOS que el id. es el del grupo correcto: no hay mensaje de prueba y el primer aviso llegará con el primer error real.
Errores frecuentes y solución#
| Síntoma | Causa | Solución |
|---|---|---|
| No llega nada al grupo | El bot no está en el grupo o lo han expulsado. | Vuelve a añadir el bot y comprueba el id. con FOS. |
| No llega nada al chat privado | La persona nunca ha iniciado la conversación con el bot. | Abre el chat con el bot y pulsa Iniciar. |
| Funciona el correo pero no Telegram | Id. de chat mal copiado (sin el signo menos, con espacios) o de otro grupo. | Copia de nuevo el número completo. |
| Los avisos llegan a un grupo equivocado | Varias integraciones comparten el id. de chat. | Revisa el campo en cada integración del local. |
| No aparece el campo de Telegram en la integración | Ese tipo de integración no lo admite (Uber Eats, Glovo, Just Eat, informes generales y tabulares en TPV…). | Usa el correo de notificaciones de esa integración. |
| El grupo pasó a supergrupo y dejó de recibir | Telegram cambia el id. del chat al convertir un grupo en supergrupo. | Pide a FOS el id. nuevo y actualízalo en las integraciones. |
Preguntas frecuentes#
¿Cómo recibo en Telegram los avisos de las integraciones de Ágora?#
Añade el bot de Connect Manager a un grupo, pide a FOS el id. de ese chat y pégalo en el campo de Telegram de cada integración del local.
¿Puedo mandar cada integración a un grupo distinto?#
Sí. Cada integración tiene su propio campo de chat.
¿Cuesta algo usar Telegram?#
No hace falta contratar nada aparte: es un canal más de las integraciones del local.
¿Llegan por Telegram los pedidos de Uber Eats, Glovo o Just Eat que fallan?#
No se puede configurar desde el panel: esas integraciones avisan por correo.
¿Puedo recibir el informe de ventas en PDF por Telegram?#
Sí: si la integración de informes tiene chat configurado, el PDF llega al chat cada vez que se genera.
Referencias#
- Ficha de la integración: Telegram en el catálogo de Connect Manager.
- Integración de ARCA con Ágora.
- Integración de WooCommerce con Ágora.
- Bots de Telegram: https://core.telegram.org/bots.