| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Lines of code | 619 |
| Technical Name |
telegram_19v1 |
| License | OPL-1 |
| Website | https://www.todoo.uz |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Lines of code | 619 |
| Technical Name |
telegram_19v1 |
| License | OPL-1 |
| Website | https://www.todoo.uz |
📨 Send Telegram from Odoo
Send text messages and PDF reports to Telegram contacts directly from any Odoo record
This module requires a publicly accessible server URL for the Telegram webhook. It does NOT work on Odoo Online (odoo.com) or any environment where your server is not reachable from the internet.
Features
Appears in the chatter area of any configured model — next to WhatsApp button if installed.
Select any allowed PDF report and send it directly as a document to Telegram.
Send a plain text message, a PDF, or both at the same time to multiple recipients.
Contact sends /start to your bot — Odoo auto-fills their Telegram Chat ID via webhook.
Control which models show the button, which reports are allowed, and which users can send.
Every send is logged — recipient, status, error, timestamp — plus a chatter note on the record.
Screenshots
Contact form — Telegram Username and Chat ID fields added to every partner
Settings → Telegram — enter your Bot Token and Webhook Secret Token
Telegram → Configuration → Model Configs — configure per-model access and allowed reports
Send Telegram button appears in the chatter area of any configured model (e.g. Delivery Order)
How to Configure
-
Create a Telegram bot via @BotFather
Open Telegram → search
@BotFather→ send/newbot→ follow instructions → copy the Bot Token. -
Enter Bot Token and Webhook Secret in Odoo Settings
Go to Settings → Telegram. Enter your Bot Token. For Webhook Secret, choose any random string you like, for example:
myodoo_tg_secret_2026Remember this string — you will use it in the next step.
-
Register the webhook with Telegram
Open this URL in your browser once (replace the placeholders):
https://api.telegram.org/bot<BOT_TOKEN>/setWebhook?url=https://<YOUR_DOMAIN>/telegram/webhook/<WEBHOOK_SECRET><BOT_TOKEN> — token from @BotFather (step 1)
<YOUR_DOMAIN> — your Odoo server domain, e.g.mycompany.odoo.com
<WEBHOOK_SECRET> — the secret you entered in Settings (step 2), e.g.myodoo_tg_secret_2026Full example:
https://api.telegram.org/bot8602697632:AAEBSxxxxxxxxxxxxxxxxxxxxxxxxxxxx/setWebhook?url=https://mycompany.odoo.com/telegram/webhook/myodoo_tg_secret_2026If successful, Telegram returns:
{"ok":true,"result":true,"description":"Webhook was set"} -
Create Model Configs
Go to Telegram → Configuration → Model Configs → New.
Select a model (e.g. Sales Order), set Active ✅.
Optionally restrict which PDF reports and which users can send. -
Add Telegram Username to contacts
Open any contact in Contacts. Fill in Telegram Username (without @).
Example: if their Telegram is@john_smith→ enterjohn_smith. -
Contact sends /start to your bot
The contact opens your bot in Telegram and sends
/start.
Odoo automatically fills their Telegram Chat ID on the contact record.
After this they can be selected as a recipient. -
Send from any record
Open a Sales Order, Invoice, Delivery, or any configured model.
Click Send Telegram in the chatter area.
Select recipients, optionally choose a PDF report and/or type a message → Send.
Technical Notes
- Odoo version: 19 (Community & Enterprise)
- Depends on:
mail,base— no extra Python packages required - Webhook endpoint:
/telegram/webhook/<secret_token> - Bot token and webhook secret stored in
ir.config_parameter(System Parameters) - Sending is synchronous (no background jobs)
- Bulk send limit: 20 recipients per action
- PDF rendering uses Odoo's built-in
ir.actions.report - All sends logged in Telegram → Message Logs and as chatter notes
- Incoming messages from Telegram are not processed (outgoing only)
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module