WhatsApp Dashboard and Email-Style Composer
by Probuse Consulting Service Pvt. Ltd. https://www.probuse.com$ 110.53
In-App PurchasesWhatsApp Dashboard and Email-Style Composer
Operations Home Screen on Official Odoo Enterprise WhatsApp
Send To Contacts Like Email - Mobile then Phone - Failed Retry - Waiting Chats
Odoo WhatsApp Dashboard
WhatsApp Composer To Contacts
Official Odoo WhatsApp already talks to Meta, sends approved templates and keeps chats in Discuss. What it does not give you is a manager home screen, or a To list like email when a salesperson sends a template from a sales order or invoice.
This application adds both. It does not replace Cloud API, templates, Discuss, the Meta webhook or the official send engine. First outbound messages stay Meta-approved templates. Community-only databases cannot install it.
Purpose of the Application:
Give WhatsApp administrators one screen for sent, delivered, failed, replies, waiting chats and the outgoing queue,
and give sales / billing users an email-style To list on the official composer so they can send the same template to several contacts without leaving Odoo.
Real World Problem It Solves:
After a campaign week, the sales manager asks: how many templates did Meta accept, how many failed, who is waiting for a reply, and which invoice or order those messages belong to.
Opening WhatsApp / Messages and filtering by hand does not answer that in one view.
On the send side, the official composer is built around one number. A salesperson who must notify the customer, the buyer and the accounts contact has to send three times.
This application is that operations layer on official Odoo WhatsApp.
What This Application Does Not Do:
- It does not connect WhatsApp Web or a private phone. It uses the official Odoo Enterprise WhatsApp account.
- It does not send a free-text first message. Meta still requires an approved template to start the conversation.
- It does not replace Discuss chats, template approval or the public HTTPS webhook for delivered / read / inbound.
- Retry on a failed card calls the official Odoo resend. Unrecoverable Meta errors stay failed.
Who Uses This Application
- WhatsApp Administrator - opens WhatsApp / Dashboard, uses filters, clicks tiles, retries failed messages that Meta allows.
- Salesperson / Account manager - sends a template from a sales order, invoice, lead or contact using the To list.
- Billing / Collections - sends an invoice or follow-up template to the customer and an extra accounts contact in one composer.
- Purchasing - sends a purchase-order template to the vendor contact from the PO.
- WhatsApp User - uses composer To and Messages extras. The dashboard menu is hidden.
A Real Week on Official WhatsApp
How dashboard and composer run as one process
The story uses a trading company that already has Odoo Enterprise WhatsApp connected to Meta. Names are illustrative.
Monday - Quote confirmation to two people
Sarah Bennett opens sales order S00042 for Emma Wilson. She clicks Send WhatsApp, picks the approved Hello World / order template. The composer To field already has Emma. Sarah adds the buyer James Carter. Emma has a mobile number, James has only phone. Each gets one official template message on that number. A third contact with no country code is skipped and Sarah sees a warning with the skipped name.
Tuesday - Invoice reminder
Claire Dubois sends the Invoice template from invoice DEMO-WA-DASH to Clara Hoffmann. Meta rejects the template (not approved or quality rating too low). The message lands in error. On WhatsApp / Dashboard, Failed shows Clara, the number, the template name, the Meta reason and the time. If the failure is recoverable, Claire clicks Retry. That is the official Odoo resend, not a second unofficial API.
Wednesday - Manager review
The WhatsApp administrator opens Dashboard, keeps This Week, types Emma in search. Tiles drop to Emma only. Messages by contact shows Emma Wilson and her number. Clicking the Sent tile opens the official message list with the same search still applied. Switching status to Failed keeps Emma and shows only her error rows.
Thursday - Waiting reply
Emma replies on WhatsApp. If the public webhook is live, the message is inbound and Replies increases. If she wrote last and nobody answered, Waiting lists that Discuss WhatsApp channel. Clicking Waiting opens those chats. Delivered, read and inbound need the Meta webhook on a public HTTPS URL.
Friday - Two companies
The group has Probuse Consulting Service Pvt. Ltd. and Demo Other Co. The administrator switches companies in the Odoo header. Dashboard tiles follow WhatsApp accounts allowed for the selected companies. A message with no account still appears (typical of a queue row that never reached Meta). The dashboard itself stays limited to the WhatsApp Administrator group.
Features at a glance
Use this table as a map of the app. Where in Odoo is the menu or screen, and What you do is the action.
| Feature | Where in Odoo | What you do |
|---|---|---|
| Operations dashboard | WhatsApp / Dashboard | See sent, delivered, failed, replies, waiting chats and in-queue on one screen. |
| Rates on tiles | Dashboard KPI cards | Delivery, fail and reply rates as a percent of sent. Zero when nothing was sent. |
| Search | Dashboard filter bar | Contact name, phone, template name or failure reason. Enter or short pause to refresh. |
| Account / sender / status | Dashboard filter bar | Limit to one WhatsApp account, one Odoo sender, or one status group. |
| Period and dates | Header and From-To | Today, this week, this month. Custom dates override the period buttons. |
| Clear | Filter bar | Back to this week, empty search, all accounts, all senders, all statuses. |
| Messages by document | Dashboard table | Contact, CRM, sales, purchase, invoice, WhatsApp chat and no document. |
| Messages by contact | Dashboard table | Top receivers with name and number. Click to open their messages. |
| Messages by sender | Dashboard table | People who sent WhatsApp from Odoo. Replies are counted on numbers they wrote to. |
| Top templates / salespeople | Dashboard panels | Most used templates and outbound users this period. |
| Failed cards and Retry | Dashboard grid | Name, number, template, Meta reason, date. Official resend when allowed. |
| Composer To list | Official WhatsApp composer | Pick contacts. The document customer is filled in by default. |
| Mobile then phone | Composer number | Uses mobile when that field exists, otherwise phone. |
| One message per contact | Composer send | Each selected contact gets one official WhatsApp message. |
| Skip invalid numbers | Composer warning | Contacts without a valid WhatsApp number are skipped with names. |
| Message desk extras | WhatsApp / Messages | Type, template, related document name and Open Document. |
| Multi-company | Company switcher | Tiles follow accounts allowed for the companies in the header. |
1. Operations Dashboard - User Manual
Menu: WhatsApp / Dashboard (WhatsApp Administrator only)
The dashboard is a client action, not a list of records. It reads official WhatsApp message rows and Discuss WhatsApp channels. Changing a filter reloads every tile, table and failed card. Clicking a tile or row keeps the filters you already set.
WhatsApp Dashboard Menu
Menu: WhatsApp / Dashboard (WhatsApp Administrator only)
KPI tiles
- Sent - outbound messages Meta accepted (sent, delivered, read, replied). Hint: Accepted by Meta.
- Delivered - state delivered or read. Hint: percent of sent.
- Failed - state error or bounced. Hint: percent of sent.
- Replies - inbound messages. Hint: reply rate against sent.
- Waiting - Discuss WhatsApp channels whose last message is from the customer.
- In Queue - state outgoing, not sent to Meta yet.
Rates are 0 when sent is 0, so an empty week does not show 100 percent fail. Click a tile to open the official message list (Waiting opens Discuss channels).
Operations Dashboard KPI Tiles
Sent, Delivered, Failed, Replies, Waiting and In Queue on This Week
Filter bar
- Search - contact name, phone, template name, failure reason. Works on Enter and after a short pause while you type.
- All accounts - official WhatsApp accounts on this database.
- All senders - Odoo users who created an outbound WhatsApp message.
- All statuses - All, Sent, Delivered, Failed, Replies, In queue, Waiting. Waiting hides message tiles and shows only waiting chats.
- From / To - custom dates. Using either date switches the period to custom and clears the Today / Week / Month highlight.
- Clear - appears when any extra filter is on. Restores this week and empty filters.
Example: search Emma, status Failed, This Week. You should see only Emma Wilson failed cards and Failed is her error count, not the whole company.
Dashboard Filter Bar
Search, account, sender, status, From-To dates and Clear
Breakdown tables
- Messages by document - groups by the related model (res.partner, sale.order, account.move, crm.lead, purchase.order, discuss.channel, or none).
- Messages by contact - receiver name from the document partner, chatter partners, or the phone. Shows the number under the name.
- Messages by sender - Odoo create user on outbound. Replies are inbound messages to numbers that user wrote.
- Top templates and Top salespeople - most used this period, with fail counts on templates.
Messages by Document
Contact, CRM, sales, purchase, invoice and chats
Messages by Contact
Top receivers this period with name and number
Messages by Sender
People who sent WhatsApp from Odoo
Top Templates and Salespeople
Most used templates and outbound users this period
Failed messages
Up to 18 recent failures as cards: contact name, number, template, Meta reason, date. Retry is shown only when state is error and the failure type is not marked unrecoverable. Retry calls the official Odoo resend and then refreshes the dashboard with the same filters.
Failed Messages and Retry
Contact, number, template, Meta reason and official resend
2. Email-Style Composer To - User Manual
Official WhatsApp composer on sales, invoice, CRM, purchase and contacts
The composer is still the official Odoo wizard. This application adds To (many2many contacts) above the template. Open Send WhatsApp from a document. The customer / partner of that document is filled on To when Odoo can resolve it.
Send WhatsApp on Contacts
Official Send WhatsApp action on the Contacts form
Composer To Contacts
Email-style To list on the official WhatsApp composer
How the number is chosen
- If the contact has a mobile field and a value, that number is used.
- Otherwise the contact phone is used.
- Odoo formats the number for WhatsApp. Invalid or missing country code is skipped.
- With one contact on To you can still edit the Phone field. With several contacts, Phone is hidden and each contact uses their own number.
What happens on Send
- You must select an official WhatsApp template, same as standard Odoo.
- The application creates one official WhatsApp message per selected contact that has a valid number.
- The chatter / mail message stays linked to the document you sent from.
- If some contacts have no valid number, they are skipped and you get a warning with their names.
- If nobody has a valid number, send is blocked with a clear error.
Example: invoice for Meridian Supplies Ltd. To is Meridian and the AP clerk. Template is Invoice. Two official messages are queued. The clerk with a landline that WhatsApp cannot format is skipped; Meridian still receives the template.
Batch send (several documents at once) stays on the official Odoo batch path. To is for the single-document composer.
Several Contacts on To
Phone is hidden. Each contact uses mobile then phone
Send WhatsApp on Contacts
Official composer from Contacts
3. Messages Desk - User Manual
Menu: WhatsApp / Messages
The official message list stays the source of truth. This application adds columns so operations can jump back to the document without opening the chatter first.
- Type - inbound or outbound.
- Template - official WhatsApp template used.
- Related Document - display name of the sales order, invoice, lead, purchase order, contact or chat.
- Failure reason - Meta / Odoo reason on the list (optional column).
- Open Document - opens that record in form view when a related id exists.
The same Open Document button is on the message form. Use it after you click a dashboard tile and land on a failed invoice send.
WhatsApp Messages List
Type, template, related document and Open Document
Message Form Open Document
Jump back to the sales order, invoice, lead or chat
4. Setup and Typical Workflow
- Install Odoo Enterprise WhatsApp. Connect the Meta / WhatsApp Business account. Confirm a test template such as Hello World sends from Contacts.
- Publish a public HTTPS webhook if you need delivered, read and inbound replies. Without it, Sent can rise while Delivered and Replies stay low. That is Meta, not this application.
- Install WhatsApp Dashboard and Email-Style Composer. Give Dashboard to users in WhatsApp / Administrator.
- Open WhatsApp / Dashboard. Start on This Week. Use search, account, sender, status and dates. Click tiles to drill into official lists.
- From a sales order, invoice, lead, purchase order or contact, Send WhatsApp. Add contacts on To. Select an approved template. Send.
- On a recoverable failure, Retry from the dashboard card or resend from the official message form.
Statuses
| Record | Status | Meaning on the dashboard |
|---|---|---|
| WhatsApp message | outgoing | In Queue tile. Not handed to Meta yet. |
| WhatsApp message | sent | Counted in Sent. Meta accepted the template. |
| WhatsApp message | delivered / read | Counted in Sent and Delivered. Needs webhook. |
| WhatsApp message | replied | Counted in Sent. The thread was answered. |
| WhatsApp message | error / bounced | Failed tile and failed cards. |
| WhatsApp message | inbound | Replies tile. Customer wrote in. |
| Discuss channel | Waiting | WhatsApp chat whose last message is from the customer. |
| Dashboard period | today / week / month / custom | Applies to every tile and table. Custom from-to overrides the buttons. |
Buttons and wizards
| Button / Wizard | Where | What it does |
|---|---|---|
| Dashboard tiles and rows | WhatsApp / Dashboard | Open the official message or chat list. Current filters stay applied. |
| Retry | Failed card | Official Odoo resend when state is error and not unrecoverable. |
| Clear | Filter bar | This week, empty search, all accounts, all senders, all statuses, empty dates. |
| To (contacts) | Official composer | Pick contacts. One template message per valid number. |
| Send | Official composer | Creates official WhatsApp message rows. Warns about skipped contacts. |
| Open Document | Message list and form | Opens the related sales order, invoice, lead, PO, contact or chat. |
Access rights
The dashboard is limited to WhatsApp administrators. Composer To uses the same official WhatsApp access as the rest of Odoo WhatsApp.
| Group | What they can do in this app |
|---|---|
| WhatsApp Administrator | Open the dashboard, use all filters, retry recoverable failures, send from the official composer. |
| WhatsApp User | Composer To list and Messages extras. Dashboard menu is hidden. |
| Requires | Odoo Enterprise WhatsApp. Not for Community-only databases. |
Menus Available
- Dashboard (WhatsApp administrators) - operations home, filters, failed Retry
- Messages - extra columns and Open Document
- Templates - official Odoo WhatsApp templates, unchanged
- Configuration - official WhatsApp accounts, unchanged
- Sales / Invoicing / CRM / Purchase / Contacts
- Send WhatsApp (official action) - To contacts, mobile then phone, one message per contact
Notes for Implementation
- Depends on official WhatsApp and Account Follow-up (Odoo 19 follow-up composer mixin). Follow-up is an Enterprise app in the same stack as WhatsApp.
- Delivered, read and inbound replies need a public webhook. A local HTTP database will show Sent and Failed from Meta test sends, and may show 0 delivered.
- Temporary Meta tokens expire. Reconnect the WhatsApp account in Configuration if send starts failing after a test period.
- Do not Retry dummy / demo failures if those rows have no WhatsApp account. They were never meant to call Meta.
Edition Compatibility:
Enterprise Odoo.sh
Related Apps You May Also Need
Clients looking at this app often add these 6 apps next
Suggested for the same client type. Optional add-ons - this app works on its own.
|
01 DIRECT WhatsApp Button on Contact / Customer / Vendor Form Useful add-on for the same whatsapp client. View App |
02 DIRECT WhatsApp Contact Button ERP Solution | Website, Useful add-on for the same whatsapp client. View App |
03 DIRECT Whatsapp Solution | Contact Website Useful add-on for the same whatsapp client. View App |
|
04 DIRECT Send WhatsApp Message using WhatsApp Web Useful add-on for the same whatsapp client. View App |
05 DIRECT Automated Document Expiry Reminder via Email in Odoo Odoo Document Expiry Notification System (Enterprise Edition) - Smart Reminders:. View App |
06 DIRECT Real Estate Universal Dashboard | Property, Rental and Auto-creates Real Estate, Rental and Property Sales dashboards in Universal Dashboard. View App |
NEED INSTALLATION, CUSTOMIZATION, MIGRATION, OR SUPPORT?
Probuse provides professional Odoo services to help you get the most from your Odoo investment.
Trusted by Businesses Worldwide with 1500 Odoo Apps and Solutions
- Odoo Implementation
- Odoo Migration and Upgrades
- Industry Specific Solutions
- Odoo.sh Deployment
- Odoo Customization
- Odoo Integrations
- Mobile Application Development
- AI Solutions and Automation
contact@probuse.com
Website:
https://probuse.com/
+91 96011 19434
+91 78745 43092
Apps and Solutions:
https://probuseappdemo.com/
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
WhatsApp Messaging (whatsapp)
• Discuss (mail) • Invoicing (account) |
| Lines of code | 1770 |
| Technical Name |
whatsapp_dashboard_composer |
| License | See License tab |
| Website | https://www.probuse.com |
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