Telegram Messenger Integration

v 18.0 Third Party 7

Availability	Odoo Online Odoo.sh On Premise
Odoo Apps Dependencies	Discuss (mail)
Lines of code	907
Technical Name	`messengers_client`
License	LGPL-3
Website	https://github.com/SpringlesMcOutrage

You bought this module and need support? Click here!

✈️

Odoo 18 · Discuss

Telegram Messenger Integration

Bring Telegram directly into your Odoo backend — receive messages, reply to customers, and manage all conversations without switching apps.

Odoo 18.0 v18.0.1.0.0 Long Polling + Webhook LGPL-3 EN · UK · DE · ES

Full Telegram integration, native Odoo UI

One BotFather token. A complete messenger inside Odoo Discuss.

🤖

Bot Configuration

Connect any Telegram bot via its BotFather token. One-click connection test fetches bot name and username automatically.

💬

Chat List & History

Browse all active Telegram conversations. Open any chat to read the full message thread and reply inline.

🔄

Long Polling & Webhook

Choose polling (no public URL needed) or webhook (instant delivery). Both modes are fully supported and switchable.

📊

Unread Message Counter

See how many unread messages each chat has. Mark conversations as read when you open them.

⚡

Mini Messenger Sidebar

A lightweight sidebar widget lets you send quick replies from anywhere in the Odoo backend without navigating away.

⏱️

Scheduled Cron Polling

A configurable scheduled action polls all active bots automatically. New chats are created on first contact with no manual setup.

Two delivery modes — pick what fits your server

Switch between modes at any time from the configuration form.

Long Polling

Recommended

Works behind NAT & firewalls
No public HTTPS URL required
Great for development & private servers
Odoo cron polls at set intervals
Zero extra infrastructure

Webhook

Production

Instant message delivery
Requires public HTTPS URL
Registered with Telegram automatically
Lower latency than polling
Scales to high message volumes

Up and running in under 5 minutes

No coding, no server config — just a BotFather token.

Create a Telegram bot

Open @BotFather in Telegram, send /newbot, and follow the prompts to get your bot token.

Open the configuration form

In Odoo, go to Discuss → Telegram → Configuration and click New.

Paste the token & test the connection

Paste your BotFather token and click Test Connection. Odoo will verify the token and display the bot name.

Enable Long Polling and save

Toggle Long Polling on. The scheduled cron will start fetching messages on the next run.

Send a message to your bot

Send any message to your bot in Telegram, then open Discuss → Telegram → Chats. The conversation appears automatically.

Data model

Three lightweight models, all accessible from standard Odoo list/form views.

telegram.config

name bot_token bot_username (readonly) bot_name (readonly) polling_enabled webhook_url last_update_id

telegram.chat

chat_id name username message_ids → telegram.message

telegram.message

chat_id → telegram.chat message_id content sender_name is_incoming is_read

Requirements

Odoo18.0

Python requestsIncluded in standard Odoo environment

Public HTTPS URLWebhook mode only — not needed for long polling

Telegram BotCreate one for free at @BotFather

Please log in to comment on this module

The author can leave a single reply to each comment.
This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
If you want to start a discussion with the author, please use the developer contact information. They can usually be found in the description.