Avisos per Telegram

Notificacions automàtiques del teu negoci a Telegram

Rep avisos a Telegram quan passen coses al teu negoci: factures cobrades, stock sota mínim, comandes aprovades, pressupostos enviats, venciments propers i impagats. Gratis, sense intermediaris i sense cost d'API: només necessites el Bot Token de Telegram (@BotFather) i el Chat ID d'un grup o canal.

Com funciona

Què fa i què necessites

Envia notificacions a Telegram quan passen esdeveniments al teu negoci: factures cobrades, stock sota mínim, comandes aprovades, pressupostos enviats, albarans creats, venciments propers i recibos impagats. Fa servir la Bot API de Telegram, que és gratuïta i sense intermediaris: només necessites el Bot Token i el Chat ID. Requisits: GestioERP 2026, PHP 8.1+ i cURL.

Crear el bot i obtenir el Bot Token

A Telegram, obre un xat amb @BotFather, envia /newbot i segueix les instruccions (nom i nom d'usuari del bot). En acabar, BotFather et dona el Bot Token, amb el format 123456789:ABCdef.... Copia'l a Administració → Panell de control → Configuració de notificacions Telegram → Bot Token de Telegram. Tracta el token com una contrasenya.

Obtenir el Chat ID

Crea un grup o canal a Telegram i afegeix-hi el teu bot com a administrador (així tot l'equip rep els avisos). El Chat ID pot ser numèric (els canals solen començar per -100...) o el nom públic del canal amb el format @nomdelcanal. Per veure l'ID numèric, escriu qualsevol missatge al grup i obre al navegador https://api.telegram.org/bot<TOKEN>/getUpdates: hi trobaràs el camp chat.id. Posa'l a Chat ID o username del canal i prem Provar connexió: si tot és correcte, rebràs un missatge de prova al Telegram.

Esdeveniments que notifica

A la configuració actives o desactives cada tipus d'avís amb una casella. N'hi ha de dos tipus:

En temps real (en el moment que passen, des de la fitxa del document): factura cobrada, comanda aprovada, pressupost enviat i albarà creat.
Per vigilància (detectats per la tasca programada): stock sota mínim, recibos impagats i venciments propers (aquest últim requereix el mòdul AvisaDoc instal·lat).

Opcions

Notificacions silencioses: envia els missatges sense so (l'usuari els veu però no sona). Dies de retard per considerar impagat (per defecte 3): dies vençuts d'un recibo no pagat abans d'avisar. Dies d'antelació per avisar de venciments (per defecte 7): amb quanta antelació avisar d'un venciment proper.

Tasca programada i sense duplicats

Els avisos de stock baix, impagats i venciments els detecta el cron de GestioERP, que revisa aquestes condicions cada hora. Perquè funcionin, cal tenir el cron del programa configurat. Per no atabalar, un mateix avís no es repeteix en 24 hores i cada esdeveniment en temps real es notifica un sol cop per document.

Historial de notificacions

A la llista de notificacions Telegram tens l'esdeveniment, la referència, el text enviat, l'estat (enviat/error) i la resposta de l'API en cas d'error. El Bot Token mai no s'escriu al registre.