| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Lines of code | 590 |
| Technical Name |
aosqa_mail_telegram |
| License | LGPL-3 |
| Website | https://github.com/aosqa/mail_telegram |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Lines of code | 590 |
| Technical Name |
aosqa_mail_telegram |
| License | LGPL-3 |
| Website | https://github.com/aosqa/mail_telegram |
Telegram Integration for Odoo
Send Telegram messages, business documents, and chatter notifications directly from Odoo 17 using your own Telegram bot.
Overview
This module adds Telegram messaging capabilities to Odoo. Users can compose Telegram messages from Odoo, select recipients from contacts, attach files, use reusable templates, and send generated QWeb PDF reports through Telegram.
It also records sent and failed Telegram messages, making it easier to review delivery results and resend messages when needed.
Key Features
Telegram Composer
Compose and send Telegram messages from a familiar Odoo wizard with receivers, message body, attachments, and template selection.
Reusable Templates
Create Telegram templates for Odoo models, render dynamic fields, and reuse message layouts for common communication.
PDF Report Attachments
Attach Odoo QWeb reports as PDF documents, such as quotations, invoices, or any configured business report.
Chatter Notifications
Send Telegram notifications when Odoo messages include configured partners, helping users follow important discussions.
Message History
Track Telegram message status with receiver, related document, attachments, failure reason, and resend action.
MarkdownV2 Formatting
Format outgoing Telegram messages through MarkdownV2 conversion for cleaner text delivery in Telegram.
How It Works
Create Your Bot
Create a Telegram bot with BotFather and save the bot token in Odoo.
Configure Contacts
Add Telegram Username and Telegram Chat ID on partner records.
Compose Message
Open the Telegram composer, choose contacts, write the message, and attach files.
Review History
Check message delivery status and resend failed messages from the history menu.
Configuration
- Install the module from Odoo Apps.
- Go to Settings > Technical > Telegram > Outgoing bot messages.
- Create a bot configuration and enter your Telegram bot token.
- Select a test recipient and use the Test button to verify delivery.
- Add Telegram Username and Telegram Chat ID on partner records.
Technical Details
| Category | Communication |
| Dependencies | base, mail |
| Python Package | telegramify-markdown |
Developer Usage
Developers can open the Telegram composer from any business document by passing the model, record ID, recipients, and optional template in the action context.
def action_send_telegram(self):
return {
'type': 'ir.actions.act_window',
'name': 'Compose Telegram Message',
'res_model': 'telegram.compose.message',
'view_mode': 'form',
'target': 'new',
'context': {
'default_model': self._name,
'default_res_id': self.id,
'default_record_name': self.display_name,
'default_partner_ids': [(6, 0, self.partner_id.ids)],
},
}Installation Notes
Make sure the required Python package is installed on your Odoo server before installing the module:
pip install telegramify-markdownAfter installation, configure the Telegram bot and partner chat IDs before sending messages.
Support and Author
Developed by Abduselam M.(abdulselam4246@gmail.com)
Website: https://github.com/aosqa/mail_telegram
Please log in to comment on this module