• Manual de uso de ConectorTelegram

Manual de uso de ConectorTelegram

Guía de uso de ConectorTelegram

ConectorTelegram envía notificaciones automáticas a Telegram cuando ocurren eventos en FacturaScripts: facturas cobradas, stock bajo mínimo, pedidos aprobados, presupuestos enviados, albaranes creados, vencimientos próximos e impagos. Está pensado para cualquier empresa que quiera enterarse al instante de lo que pasa en su negocio sin entrar al programa. Es gratuito y sin coste de API: solo necesitas el Bot Token de Telegram.

1. Instalación

1. Descarga el ZIP de ConectorTelegram.
2. En FacturaScripts, ve a Administrador → Plugins, pulsa Añadir y sube el ZIP.
3. Actívalo y pulsa Reconstruir.

Requisitos: FacturaScripts 2026 o superior y PHP 8.1+. No requiere otros plugins ni servicios de pago.

Al activarse, el plugin fija los valores de configuración por defecto (eventos habituales activados) la primera vez.

2. Crear el bot de Telegram (paso previo)

1. En Telegram, abre una conversación con @BotFather.
2. Envía el comando /newbot y sigue las instrucciones para dar nombre al bot.
3. BotFather te devolverá un Bot Token (una cadena larga). Cópialo.
4. Decide dónde recibir los avisos: un chat contigo, un grupo o un canal. Necesitarás el Chat ID o el username del canal (por ejemplo @micanal). Para un grupo/canal, añade el bot como miembro.

3. Configuración de las notificaciones

Ruta de menú: Admin → Panel de control (Ajustes) → pestaña Conector Telegram.

En esta pestaña dispones de:

• Credenciales de Telegram: introduce el Bot Token de Telegram y el Chat ID o username del canal.
• Probar conexión: botón que envía un mensaje de prueba. Si todo es correcto verás Conexión correcta. Bot: ... Mensaje de prueba enviado.; si falla, se muestra el error devuelto.
• Eventos que generan notificación (activa/desactiva cada uno):
  • Notificar cuando se cobra una factura.
  • Notificar cuando el stock baja del mínimo.
  • Notificar cuando se aprueba un pedido.
  • Notificar cuando se envía un presupuesto.
  • Notificar cuando se crea un albarán.
  • Notificar vencimientos de documentos próximos.
  • Notificar recibos impagados.
• Opciones:
  • Notificaciones silenciosas (sin sonido).
  • Días de retraso para considerar impago (por defecto 3).
  • Días de antelación para avisar vencimientos (por defecto 7).

Guarda los cambios con el botón Guardar de la pantalla de ajustes.

4. Cómo funcionan los avisos

• Los eventos de documentos (factura cobrada, pedido aprobado, presupuesto enviado, albarán creado) se notifican en el momento en que ocurren dentro de FacturaScripts.
• Los avisos de vencimientos próximos e impagos y las comprobaciones periódicas se envían mediante el cron de FacturaScripts. Asegúrate de tener el cron programado en tu servidor para que estos avisos lleguen a diario.

5. Historial de notificaciones

Ruta de menú: Admin → Conector Telegram.

Muestra el registro de todas las notificaciones enviadas, con columnas Evento, Referencia, Estado (Enviado / Error) y Respuesta API. Puedes:

• Buscar por evento, referencia o texto del mensaje.
• Filtrar por Estado (Enviado / Error).
• Filtrar por rango de fechas (desde / hasta) y ordenar por fecha o por evento.

Es la pantalla para comprobar qué se ha enviado y diagnosticar errores de entrega.

Preguntas frecuentes

No veo el menú del plugin. Ve a Administrador → Plugins y pulsa Reconstruir; después recarga la página.

Pulso "Probar conexión" y da error. Revisa que el Bot Token sea correcto y que el bot esté añadido al grupo o canal indicado en Chat ID o username del canal.

No llegan los avisos de vencimientos ni de impagos. Estos avisos dependen del cron de FacturaScripts. Verifica que el cron esté configurado y ejecutándose en tu servidor.

¿Tiene algún coste? No. Telegram y su API de bots son gratuitos; el plugin no usa intermediarios de pago.

¿Puedo silenciar los mensajes de noche? Activa Notificaciones silenciosas (sin sonido) en las Opciones para que lleguen sin alerta sonora.

Soporte: soporte@adelantia.com