Skip to main content

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​

TopicSymptomLikely CauseResolution
Channel ConfigurationNo provider is offered in the module.The plugin is not installed or switched on.Open Plugins and switch it on. See Channel Configuration.
Channel ConfigurationSending stops after some days on WhatsApp.A temporary access token expired.Enter a permanent access token and save.
Channel ConfigurationReplies 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 ConfigurationThe 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 TemplatesA template is not offered when sending.It belongs to another module or channel.Check the Module of the template. See Message Templates.
Message TemplatesThe message shows text such as {{customerName}}.The placeholder name does not match a field value.Correct the placeholder and check the preview.
Message TemplatesThe page says Please enter your SMS message.The SMS text is empty.Type the message or choose a template.
Message TemplatesA WhatsApp template cannot be edited.Name, language, module and category are locked.Create a new template.
Sending MessagesNo 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 MessagesThe 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 MessagesThe message Failed to upload attachment appears.The file is too large or the upload was interrupted.Try a smaller file.
ConversationsA 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 LogsA 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.
PermissionsMessage Templates is missing from the menu.The role lacks a template permission.Grant Manage Message Templates or Manage Email Templates. See Permissions.