WhatsApp Web Integration for Odoo | QR Personal Number Chat
by DevIntelle Consulting Service Pvt.Ltd https://www.devintellecs.com$ 44.52
WhatsApp Web Integration in Odoo
QR Connect • Discuss Chat • Media Both Ways • Delivery Receipts • No Cloud API
WhatsApp Web Integration Odoo app lets your team chat with
customers from a normal, personal WhatsApp number linked by
scanning a QR code, exactly like WhatsApp Web on a computer. There
is no Meta Cloud API to set up, no Business account to apply for,
no message templates to get approved, no 24-hour reply window, and
no per-message cost. Link your number in a couple of minutes and
start talking.
Every incoming message opens as a conversation in Odoo Discuss,
where your team replies with text, images, video, audio, and
documents just like any other chat, and each reply goes out
through your own number. Delivery and read receipts are tracked on
every message, unknown senders become contacts automatically, and
a stat button on each contact opens their conversation in one
click. A lightweight Node.js bridge that Odoo starts and
supervises for you keeps the number online, resumes the session
after restarts, and reconnects on its own, so your team stays
connected without touching a terminal.
Please note: This app connects through an unofficial WhatsApp automation library. That is against WhatsApp's Terms of Service and a number can be banned, especially with bulk usage. Use it for one to one agent conversations only, not for mass messaging.
KEY HIGHLIGHTS
Scan to Connect
Link a personal WhatsApp number by scanning a live QR code right inside the account form.
No Cloud API Needed
Works with a normal number. No Business account, no templates, no approvals, no per-message cost.
Two-Way Discuss Chat
Every conversation is mirrored into an Odoo Discuss channel that your team replies from.
Delivery and Read Receipts
Sent, delivered, and read status is tracked on every outgoing message.
Media Both Ways
Send and receive images, video, audio, and documents, saved as Odoo attachments.
Auto-Managed Bridge
Odoo starts and supervises the Node bridge for you, with no manual setup and no secret to copy.
Session Auto-Reconnect
The session resumes after restarts and reconnects on its own, kept alive by a health cron.
Auto Contact Creation
Unknown senders become contacts automatically, with proper international phone formatting.
FEATURES
QR Scan-to-Connect
A live, self-refreshing QR code appears right in the account form. Scan it from your phone's Linked Devices and the panel flips to Connected in seconds.
No Meta Cloud API
Use a normal, personal WhatsApp number. There is no Business account to apply for, no templates to approve, no 24-hour window, and no per-message cost.
Two-Way Discuss Messaging
Incoming messages open a dedicated WhatsApp Web channel in Odoo Discuss, and your replies go straight out through your number just like any other chat.
Delivery and Read Receipts
The check-mark status of every agent message is tracked, so you can see when a message was sent, delivered, and read by the customer.
Full Media Support
Send and receive images, video, audio notes, and documents in both directions, with every file saved automatically as an Odoo attachment.
Auto-Managed Node Bridge
In managed mode Odoo starts and supervises the bundled bridge, auto-generates the secret, picks the port, and keeps it alive, so there is no manual step and no connection error.
Managed or External Bridge
Let Odoo run the sidecar for you, or turn off auto-manage and run the bridge yourself on another host or in Docker for platforms that do not allow spawning child processes.
Session Resume and Auto-Reconnect
Your linked session survives server restarts and drops, reconnecting on its own. A five-minute health cron keeps the bridge alive across reboots.
Live Message Notifications
A dedicated WhatsApp tab appears in the messaging menu, so agents see new customer messages the moment they arrive.
Auto Contact Creation
When a new number messages you, the sender is turned into a contact automatically with correct international phone formatting.
Contact Conversation Button
A WhatsApp stat button on each contact opens their conversation in Discuss directly, so agents jump into any chat from the partner form.
Central Message Log
Every inbound and outbound message is recorded in one place, together with its delivery status, so you always have a full audit trail.
Secure Bridge Communication
Odoo and the bridge authenticate each other with a shared secret, and every event posted back to Odoo is verified with an HMAC signature.
Quick, Low-Cost Setup
Install the app, create an account, and scan. The only server prerequisite is Node.js, so you are chatting with customers in minutes at no per-message cost.
CONNECT IN MINUTES
From a fresh install to your first reply, here is how linking your WhatsApp number and chatting from Odoo Discuss works, with Odoo taking care of the technical bridge for you.
01Install the App
Drop the module into your addons path and install it from Apps. The one server prerequisite is Node.js, which the bridge needs to speak the WhatsApp Web protocol.
02Create an Account
Open WhatsApp Web, add a new account, give it a name, and save. There are no API keys, tokens, or credentials to paste in anywhere.
03Scan the QR Code
Click Connect and a live QR code appears and refreshes itself. On your phone open WhatsApp, go to Linked Devices, and scan. The panel flips to Connected right away.
04Chat from Discuss
Incoming messages open a channel in Odoo Discuss. Reply with text and media just like any chat, and every message goes out through your linked number.
05Track Every Message
Delivery and read receipts are recorded on each message, and the full message log gives you a complete history of every conversation.
Link Your Number by Scanning a QR Code
Connect a personal WhatsApp number in seconds. Click Connect and a live, self-refreshing QR code appears right in the account form. Scan it from your phone's Linked Devices and the panel flips to Connected, with no API keys or credentials to enter.
Unified WhatsApp Communication Inside Odoo
Manage every customer conversation in real time through dedicated Odoo Discuss channels, where your team can send and receive messages along with images, videos, audio, and documents—all automatically stored as attachments. Track sent, delivered, and read statuses for every message while maintaining a complete, timestamped history of all interactions in one place.
Dynamic WhatsApp Templates with No Approval Needed
Create WhatsApp templates using dynamic Odoo model fields, custom message content, categories, and attachments—all directly within Odoo. Send them instantly without requiring WhatsApp approval, making your communication faster and more flexible.
Seamless WhatsApp Messaging from Contacts
Start a WhatsApp conversation directly from the contact form using the “Send WhatsApp” action, or jump into the chat instantly via the WhatsApp stat button in Discuss. Use a simple wizard to send quick messages or choose from ready-made templates for faster communication.
Version History
Version 1.0 Current
Released on 22nd June 2026
Do I need a Meta Business account or the Cloud API?
No. This app works with a normal, personal WhatsApp number that you link by scanning a QR code, just like WhatsApp Web. There is no Business account, no Cloud API, no message templates, and no per-message cost.
Is this against WhatsApp's Terms of Service?
Yes, this relies on unofficial WhatsApp automation, which is against WhatsApp's Terms of Service, and a number can be banned, especially with bulk usage. Please use it for one to one agent conversations only, not for mass messaging or marketing broadcasts.
What are the requirements to run it?
The one prerequisite that cannot be avoided is Node.js 18 or newer installed on the Odoo server, since the WhatsApp Web protocol cannot run in pure Python. You also need the Python packages phonenumbers and qrcode. Everything else is handled by the app.
Do I have to run the Node bridge myself?
No. In the default managed mode, Odoo starts and supervises the bundled bridge for you, generates the secret, picks the port, and keeps it alive. On the first connect Odoo installs the bridge dependencies once, then it starts instantly and a health cron keeps it running.
Can I run the bridge on another server or in Docker?
Yes. Turn off Auto-manage Bridge in Settings and run the bridge yourself on another host or in a container. This is the right choice on platforms that do not allow Odoo to spawn a child process. Just set the Bridge URL and matching secret.
What kinds of media can be sent and received?
Text, images, video, audio notes, and documents work in both directions. Incoming media is saved automatically as an Odoo attachment on the conversation, so your full history stays in one place.
What happens if the server restarts?
Your linked session is saved and resumes automatically after a restart, and the bridge reconnects on its own. A five-minute health cron keeps it alive across reboots, so you rarely need to scan the QR code again.
Is this app compatible with Odoo Enterprise?
Yes. It works with both Odoo Community and Enterprise on self-hosted servers. On hosting that does not allow spawning a child process, use the external bridge mode described above.
If I need customization, how can I contact you?
Please reach out to us at odoo@devintellecs.com. We offer customization, integration, and consulting services tailored to your business needs.
Do I get free support and updates?
Yes. You get free support for 90 days from the date of purchase covering doubts, queries, and bug fixes (excluding data recovery). You also get free lifetime updates for this module.
Free 90 Days Support
DevIntelle provides free 90 days support for any doubts, queries, and bug fixing (excluding data recovery) or any issues related to this app. This is applicable from the date of purchase.
odoo@devintellecs.comWhy Us?
DevIntelle Consulting Services Pvt Ltd is an India/USA based Odoo service provider with 12+ years of experience. We offer implementation, customization, migration, support, and training, helping you get the most out of your Odoo system.
Apps You May Like
Bring all of your Meta and WhatsApp conversations and sales channels into Odoo. Explore the rest of our connector family.
Devintelle Odoo Services
Odoo Implementation
Get Odoo set up and running for your business the right way.
Odoo Customization
Tailor Odoo to fit exactly how your team likes to work.
Odoo Integration
Connect Odoo with the tools and platforms you rely on.
Odoo Migration
Move to a newer Odoo version smoothly, with your data intact.
Odoo Training
Help your team get confident and productive in Odoo.
Odoo Support
Reliable help whenever you have questions or run into issues.
Connect Us
DevIntelle Consulting Services
Your Odoo implementation, customization, and integration partner. Reach out anytime, we are happy to help.
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Contacts (contacts)
• Discuss (mail) |
| Lines of code | 4323 |
| Technical Name |
dev_whatsapp_web_integration |
| License | LGPL-3 |
| Website | https://www.devintellecs.com |
Please log in to comment on this module