Messaging Troubleshooting
Messaging
Common situations with the likely cause and the recommended resolution. The related guide is named on the left.
Five Checks to Make First
- Is the module on? Email and Messaging each have a switch under Configuration, System, Modules.
- Is the provider on and saved? A green tick beside the plugin means it is on.
- Is the right provider chosen in the module? Each module sends through one provider at a time.
- Does the role have Send Message? Check the Messaging group of the role.
- Is the contact detail correct? Check the address or number on the record.
Symptoms, Causes and Resolutions
| Topic | Symptom | Likely Cause | Resolution |
|---|---|---|---|
| Channel Configuration | No provider is offered in the module. | The plugin is not installed or switched on. | Open Plugins and switch it on. See Channel Configuration. |
| Channel Configuration | Sending stops after some days on WhatsApp. | A temporary access token expired. | Enter a permanent access token and save. |
| Channel Configuration | Replies and delivery updates do not arrive. | The Webhook URL is not registered with the provider. | Copy the Webhook URL from the plugin into the provider account. |
| Channel Configuration | The SMTP form shows This field is required. | The host, the port or a sender address is empty. | Fill in the marked fields and save. |
| Message Templates | A template is not offered when sending. | It belongs to another module or channel. | Check the Module of the template. See Message Templates. |
| Message Templates | The message shows text such as {{customerName}}. | The placeholder name does not match a field value. | Correct the placeholder and check the preview. |
| Message Templates | The page says Please enter your SMS message. | The SMS text is empty. | Type the message or choose a template. |
| Message Templates | A WhatsApp template cannot be edited. | Name, language, module and category are locked. | Create a new template. |
| Sending Messages | No send option is available on a record. | The role lacks Send Message, or the channel is not connected. | Check Permissions and Channel Configuration. See Sending Messages. |
| Sending Messages | The message Error sending WhatsApp message appears. | The template is not approved, or the token is not valid. | Check the template in WhatsApp Templates and the token in the plugin. |
| Sending Messages | The message Failed to upload attachment appears. | The file is too large or the upload was interrupted. | Try a smaller file. |
| Conversations | A sent message is missing. | The View Sent Message scope hides it. | Ask for a wider scope, or search by the customer's address. See Conversations. |
| Delivery and Logs | A message has no second tick. | The provider has not reported delivery yet, or the webhook is missing. | Check the provider dashboard and the webhook. See Message Delivery and Logs. |
| Permissions | Message Templates is missing from the menu. | The role lacks a template permission. | Grant Manage Message Templates or Manage Email Templates. See Permissions. |