Telegram Notifications & Bot for ERPNext

ECOSIRE builds a proper Frappe app — its own module with clean DocTypes, not a pile of loose server scripts — that connects ERPNext to the Telegram Bot API. On the outbound side, we wire hooks.py doc events (on_submit, on_update, on_change, after_insert) and scheduler_events so that the documents and conditions you care about push formatted messages to the right chats. Recipients are resolved dynamically: a Telegram Recipient DocType maps ERPNext Users, Customers, Suppliers, or any linked party to their Telegram chat IDs, and message templates are rendered with Jinja against the source document so an alert can quote the actual order number, amount, customer name, and a deep link back into ERPNext. Filtering runs through the same condition expressions you already use in ERPNext Notifications, so you decide exactly which records fire.

The interactive side is a bot that listens for commands and callback buttons. We register a whitelisted webhook endpoint (a @frappe.whitelist(allow_guest=True) method that validates Telegram's secret token) so incoming updates hit ERPNext directly — no polling daemon to babysit. From there the bot can run inline-keyboard approvals (Approve / Reject a Leave Application or Purchase Order straight from the chat, writing the workflow action back through the Frappe REST API), answer read-only queries (/orders, /stock ITEM-CODE, /invoice INV-0001) scoped by the requesting user's role profile and permissions, and broadcast operational updates to channels and groups. Every action respects ERPNext permissions — a user can only approve or query what their roles allow, and unmapped Telegram accounts are rejected. Add a "Send to Telegram" button on any form via a client script so staff can push a document to a chosen chat on demand.

Because this is build-to-order, nothing is a black box. We start with a short scoping call to pin down exactly which DocTypes, events, conditions, recipient mappings, and bot commands you need, then build against a copy of your configuration and target Frappe/ERPNext v15 or v16. You get the installable app source, deployment on your bench, UAT on a staging site, and the full git repository at handover — so your team (or ours, under a support window) can extend it later.