| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Inventory (stock)
• Sales (sale_management) • Contacts (contacts) • Discuss (mail) • Invoicing (account) |
| Community Apps Dependencies | Show |
| Lines of code | 2189 |
| Technical Name |
chat_commerce_telegram |
| License | OPL-1 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Inventory (stock)
• Sales (sale_management) • Contacts (contacts) • Discuss (mail) • Invoicing (account) |
| Community Apps Dependencies | Show |
| Lines of code | 2189 |
| Technical Name |
chat_commerce_telegram |
| License | OPL-1 |
Chat Commerce: Telegram Connector
Transform Telegram into a powerful sales channel with automated ordering and checkout.
Sell products directly through Telegram. This module automates the entire sales processâfrom product browsing to payment confirmationâright inside the chat.
Key Features
Automated Bot Interactions
Fully automated conversation flow for product lookups, cart management, and checkout.
Seamless Checkout
Customers can provide their name, phone, and delivery address directly in the chat.
Payment Slip Verification
Support for manual payment methods where customers upload a photo of the transfer slip for admin review.
Rich UI Elements
Utilizes Telegram Inline Buttons and Keyboard Replies for a smooth user experience.
How It Works
1. Browse
Customers search for products by code or name via the Telegram bot.
2. Cart
Items are added to a persistent Odoo cart, ready for one-click checkout.
3. Confirm
Admin confirms the order in Odoo after verifying the uploaded payment slip.
Easy Configuration
Set up your bot in minutes using the Telegram Bot Token. Built-in health checks and webhook management ensure your bot stays connected.
Support
Need help? Contact our support team for setup assistance or customizations.
Email Support# Telegram ↔ Odoo Setup Guide
This guide explains the Telegram setup flow in Odoo.
This applies when the chat_commerce_telegram addon is installed.
## Setup Flow
- create a Telegram bot with BotFather
- paste the bot token into Odoo
- save the Telegram bot record
- click Set Telegram Webhook
- click Check Telegram
- test /start
## What You Need
- the chat_commerce_telegram addon installed
- a Telegram bot token from BotFather
- your public Odoo base URL
## Step 1: Create The Bot
In Telegram:
- open BotFather
- run /newbot
- choose the bot name
- choose the bot username
- copy the bot token
## Step 2: Open Bot Settings
In Odoo:
- go to Chat Commerce > Bot Settings
- create or open a record with: - Platform = Telegram - Active = True
## Step 3: Fill Telegram Fields
Set:
- Telegram Bot Token
Then save.
## Step 4: Set The Webhook
Click Set Telegram Webhook.
Typical webhook URL:
- https://<your-domain>/chat_commerce/telegram/webhook
Important:
- after changes to inline-button handling, set the webhook again so Telegram registers the current allowed updates
## Step 5: Check Telegram
Click Check Telegram.
Expected result:
- Connection Status = Ready
- Webhook Status = OK
## Step 6: Test The Bot
- open the bot in Telegram
- send /start
- confirm Odoo receives the webhook
- confirm the registration flow starts
## Telegram UX
Telegram uses the same shared commerce flow as the other connectors, but the UI behavior is Telegram-specific:
- product browsing uses inline buttons attached to the bot message
- product browsing is paginated
- quantity uses inline buttons 1 to 5 plus Custom
- if the user taps Custom, they type the quantity manually
- users can still type product codes manually
## Notes
- Telegram does not use Meta OAuth or Facebook Page selection
- Telegram setup is token + webhook based
- Telegram-specific config belongs in chat_commerce_telegram, not in the base addon
## Recommended Result
Your Telegram bot record should end with:
- Platform = Telegram
- Active = True
- valid Telegram Bot Token
- Connection Status = Ready
- Webhook Status = OK
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