OdooWiki OCA HUB

Telegram Standalone

mail_gateway_telegram_standalone folder_open OCA/social open_in_new
Social License: AGPL-3

This module provides a generic engine to integrate Telegram Bots with Odoo. It serves as a foundation for other modules to send notifications, allowing you to manage bot tokens and authorized chat IDs in a centralized way.

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Lets administrators register Telegram chats on a Telegram mail gateway, automatically discover chat IDs from people who messaged the bot, and send test messages to verify the connection works.

This module adds Telegram-specific tools to the mail gateway configuration screen. When a gateway is of type Telegram, two buttons appear in its header and a new "Telegram Chats" tab is shown.

  • "Fetch Chats" asks Telegram for recent messages received by the bot and creates a chat record for each new sender, using the username or first name as the friendly name and the numeric chat ID. It refuses to run while a webhook is active, because Telegram does not allow fetching updates manually in that case.
  • "Test Connection" sends a short success message to every registered chat and shows a confirmation pop-up. It asks you to add or fetch at least one chat first.

On the Telegram Chats tab you can list chats manually with a friendly name and a numeric chat ID, or edit the ones that were fetched. Each chat belongs to one gateway and is deleted with it.

Behind the scenes the module can send a raw text message to a chat through the Telegram API, with HTML formatting by default; failures are logged rather than blocking the user. Only system administrators can create, edit or delete chat records. The module touches the mail.gateway model and introduces a new telegram.chat model.

Depends on

basemailmail_gateway_telegram
Models and fields (2)
  • mail.gateway · extends an existing modeltelegram_chat_ids (Authorized Chats)
  • telegram.chat · new modelname, chat_id, gateway_id (Mail Gateway)

Text generated by AI (DeepSeek) from reading the Odoo 18.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 1 confirmed, 8 with no information of 9 versions.

terminal Installation and usage

OCA documentation · Odoo 18.0

Usage

Source · Odoo 18.0

To use this module:

  • Go to Settings > Technical > Email > Gateways.
  • Create a new Gateway, set the Gateway Type to "Telegram", and enter the Token provided by @BotFather.
  • Click the Fetch Chats button to automatically find Chat IDs of people who have messaged the bot.
  • Click Test Connection to verify that Odoo can communicate with Telegram.

No verified information in OCA: Installation, Configuration.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.