Manual de uso de ConectorTelegram

ConectorTelegram envia avisos automaticos a Telegram desde FacturaScripts. Esta guia explica como ponerlo en marcha paso a paso.

1. Crear un bot de Telegram

En Telegram, abre un chat con @BotFather.
Envia el comando /newbot y sigue las instrucciones (nombre y usuario del bot).
BotFather te dara un Bot Token con el formato 123456789:ABCdef.... Guardalo.

2. Obtener el Chat ID del canal o grupo

Crea un canal o grupo en Telegram y anade tu bot como administrador.
Publica un mensaje cualquiera en el canal.
Abre en el navegador: https://api.telegram.org/bot{TOKEN}/getUpdates (sustituye {TOKEN}).
Busca el valor chat id (para canales suele empezar por -100...). Tambien puedes usar @nombredelcanal.

3. Instalar el plugin

Descarga el ZIP desde esta pagina.
En FacturaScripts ve a Panel de control > Plugins > Anadir, sube el ZIP y pulsa Activar.

4. Configurar

En Panel de control > Conector Telegram:

Bot Token: pega el token de BotFather.
Chat ID: pega el id del canal/grupo (o @usuario).
Eventos: activa los que quieras notificar (factura cobrada, stock bajo, pedido aprobado, presupuesto enviado, albaran creado, vencimientos, impagos).
Opciones: modo silencioso, dias para considerar impago y dias de antelacion de vencimientos.
Pulsa Probar conexion: el bot validara el token y enviara un mensaje de prueba al canal.

5. Eventos en tiempo real

Estos se envian en cuanto ocurren, desde la propia ficha:

Factura cobrada: al guardar una factura de cliente marcada como pagada.
Pedido aprobado: al pasar un pedido de cliente a estado aprobado.
Presupuesto enviado: al pasar un presupuesto a estado enviado.

Cada evento se notifica una sola vez por documento.

6. Eventos por tarea programada (cron)

El plugin revisa cada hora, mediante el cron de FacturaScripts:

Stock bajo: articulos con stock por debajo del minimo.
Impagos: recibos de cliente vencidos sin pagar (segun los dias configurados).
Vencimientos: si tienes instalado el plugin AvisaDoc, avisa de documentos proximos a vencer.

Para que funcione, asegurate de tener configurada la tarea cron de FacturaScripts. No se duplican avisos en 24 horas.

7. Registro de envios

En Admin > Conector Telegram veras el historial de notificaciones con su estado (enviado / error) y la respuesta de la API. El Bot Token nunca se guarda en el registro.

8. Requisitos

FacturaScripts 2026, PHP 8.1+, cURL. Compatible con MySQL 8+ y PostgreSQL 11+. La API de Telegram es gratuita.

ConectorTelegram — YAST TELECOM SL (Adelantia). Licencia LGPL-3.0.