Troubleshooting
What goes wrong with TechnoVision WhatsApp Core, how to recognise it, and what to do.
There is no WhatsApp menu
You are not in the WhatsApp User group. The administrator who installs the module is added to WhatsApp Manager automatically; anyone else needs the group granting under Settings -> Users.
"No WhatsApp account is configured"
Create one under WhatsApp -> Configuration -> Accounts. Leave the provider as Simulated if you have no credentials yet - everything else works.
Messages stay Queued
- Check the scheduled action WhatsApp: send queued messages is active.
- Open the message and look at Next try. A retry delay is running.
- If the delay is long, the message has already failed several times - the reason is on the record.
Every message fails immediately with a configuration error
The account is on the Meta provider without a Phone Number ID or a token. The status line on the account form lists exactly what is missing. This failure is deliberately not retried.
"Message undeliverable" from Meta
The number is not a WhatsApp account. Check the contact. This is not retried, because it cannot succeed.
Messages fail outside business hours only
Meta's 24-hour customer service window. A free-text message can only be sent within 24 hours of the customer's last message; outside it, a pre-approved template is required. The rejection carries Meta's own error text.
The number is wrong
Look at To on the message - that is what was actually used. The channel reads Mobile first, then Phone, and applies the contact's country dialling code when the number is written nationally. If the contact has no country and the number has no international prefix, the send is refused rather than guessed at.
Nothing is sent, and every message says Sent
The account is on the Simulated provider. That is what it does. The account form says so in its status line.
A template renders as an error
A template with {{ }} placeholders needs a record to render against, and the record has to be of the model named in Applies to. Use Preview on the template form to see what it produces.
Where to look in the logs
Server log entries are under odoo.addons.technovision_whatsapp_core. A provider that raises rather than returning a failure is logged with its full traceback, and the message is treated as a retryable failure.