⚡️ Direct Integration from Odoo to Telegram: Forget the Limits!
Now you can send text messages and PDF reports to Telegram from any Odoo document (Sales, Invoice, Inventory, etc.) in just a few seconds!
Important note:OnlySelf-hosted(on a personal server) versions. Does not work on Odoo Online platform.
✨ Amazing features that will surprise you:
A convenient button will appear in the chat interface (chatter) just like WhatsApp. Now there's no need to leave the system to contact the client!
Select any report in PDF format and send it as a document with just one click. Fast, high-quality, and modern!
Save your time by sending both a text message and a PDF file to multiple recipients at the same time.
Without complex settings! It's enough for the client to send the /start command to the bot — Odoo will automatically detect their Chat ID number via Webhook and link it to the database.
Fully control which models the button appears on, which reports can be sent, and which users have this right.
The status, time, and result of each sent message are recorded in the system. Additionally, an automatic reminder about the completed tasks is left in "Chatter."
Connection form — Telegram Username and Chat ID fields are added for each partner.
Settings → Telegram — Enter the Bot Token and Webhook Secret Token.
Telegram → Configuration → Model Configs — Set up access rights and allowed reports for each model.
🛠 Sozlash bo‘yicha qo‘llanma
1. @BotFather orqali Telegram bot yaratish
Telegram-ni oching → @BotFather profilini toping → /newbot buyrug‘ini yuboring → Ko‘rsatmalarga amal qiling va yakunda berilgan Bot Token-ni nusxalab oling.
2. Bot Token va Webhook Secret-ni Odoo-ga kiritish
Settings (Sozlamalar) → Telegram menyusiga o‘ting. Nusxalangan Bot Token-ni kiriting. Webhook Secret maydoniga esa o‘zingiz xohlagan ixtiyoriy maxfiy so‘z yoki kodni yozing (masalan: myodoo_tg_secret_2026).
Ushbu maxfiy kodni eslab qoling, u keyingi bosqichda kerak bo‘ladi.
3. Webhookni Telegramda ro‘yxatdan o‘tkazish
Brauzeringizda quyidagi havolani bir marta oching
https://api.telegram.org/bot<BOT_TOKEN>/setWebhook?url=https://<YOUR_DOMAIN>/telegram/webhook/<WEBHOOK_SECRET>
<BOT_TOKEN> — @BotFather bergan token (1-bosqich).
<YOUR_DOMAIN> — Odoo serveringiz manzili (masalan: kompaniya.uz).
<WEBHOOK_SECRET> — Sozlamalarda o‘zingiz yozgan maxfiy kod (2-bosqich).
To‘liq misol:
Full Example: https://api.telegram.org/bot8602697632:AAEBSxxxxxxxxxx/setWebhook?url=https://company.uz/telegram/webhook/myodoo_tg_secret_2026
Agar hammasi to‘g‘ri bo‘lsa, ekranda {"ok":true,"result":true,"description":"Webhook was set"} yozuvi chiqadi.
4. Modellar konfiguratsiyasini yaratish
Telegram → Configuration → Model Configs → New menyusiga o‘ting. Kerakli modelni tanlang (masalan: Sales Order) va Active ✅ holatiga o‘tkazing. Bu yerda qaysi PDF hisobotlarni va qaysi foydalanuvchilar yubora olishini cheklashingiz ham mumkin.
5. Kontaktlarga Telegram Username qo‘shish
Contacts (Kontaktlar) bo‘limidan kerakli shaxsni tanlang va Telegram Username maydoniga uning foydalanuvchi nomini (@ belgisiz) yozing. Masalan: foydalanuvchi @nodir_bek bo‘lsa → nodir_bek deb yoziladi.
6. Kontakt botga /start buyrug‘ini yuborishi
Mijoz yoki hamkor Telegram-da sizning botingizni ochib, /start tugmasini bosishi kerak. Shunda Odoo avtomatik ravishda uning Telegram Chat ID raqamini kontakt ma’lumotlariga to‘ldirib qo‘yadi. Shundan so‘ng u qabul qiluvchi sifatida ro‘yxatda ko‘rinadi.
7. Istalgan hujjatdan xabar yuborish
Sotuv buyurtmasi, Faktura yoki boshqa sozlangan hujjatni oching. Chat (chatter) bo‘limidagi Send Telegram tugmasini bosing. Qabul qiluvchini tanlang, xohlasangiz PDF hisobotni biriktiring yoki matn yozing va Send tugmasini bosing. ✅