Triggers

Check all the triggers carried out by your team!

The messaging environment allows managers to identify and review messages sent via both the timeline and workflows.

There are several references that can be used to locate a specific message, such as the contact’s phone number, the associated ID number, and the agent responsible for the send. These details help streamline the search and filtering of specific message records.

In addition to the filtering options, managers can also track the delivery status and check whether the message was read by the contact.

It’s also possible to view the message and the contact directly in HubSpot through the following actions:

Error Status

There are certain statuses that indicate potential errors when sending a message via the timeline or workflow. In the table below, you can find some of these Meta error statuses along with their respective meanings.

Status
Error
Possible Solutions

User's number is part of an experiment

The contact was selected to be part of a Meta experiment. They select 1% of WhatsApp users worldwide to no longer receive any type of paid message.

In these cases, you can only message the contact if they initiate the conversation first.

(#132001) Template name does not exist in the translation

The template does not exist in the specified language or has not been approved.

Check whether the template has been approved and ensure that both the template name and language locale are correct.

(#100) Invalid parameter

The request included one or more unsupported or incorrectly written parameters.

Refer to the endpoint documentation to verify which parameters are supported and how they should be formatted.

(#131008) Required parameter is missing

A required parameter is missing from the request.

Make sure all template variables have been properly filled in before sending.

Message Undeliverable

The phone number does not have an active WhatsApp account, or the contact is using an outdated version of the app.

Verify the list of contacts used in the campaign and ensure that the contact’s app is updated.

(#131049) This message was not delivered to maintain healthy ecosystem engagement.

This response means that WhatsApp itself chose not to deliver the message in order to preserve the integrity of the sender’s number and ensure a healthy environment for the recipient.

Try resending the message after a few hours or the next day.

Business eligibility payment issue

This error relates to the payment method associated with your WhatsApp Business account through Meta. It may prevent WhatsApp from functioning properly.

Check your WhatsApp Business billing settings and ensure your payment method is up to date. If everything appears correct, we recommend re-registering the payment card.

The most common Meta-related errors are listed above. To view the complete list of Meta error codes, you can visit the following link:

👉 https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes/

In addition, there are some errors that are directly related to your account in spread. Below, we present a table with possible errors that may occur during your message sends, which are not directly linked to Meta.

Status
Error
Possible Solutions

Erro - Sem numero de destino

No number available to send the template.

This error occurs when the contact's "Phone Number", "Mobile Number", or "WhatsApp API" fields are empty.

Erro - Conta atingiu limite de disparo.

The daily message sending limit configured for the account has been reached.

You can update the daily limit in the Management Panel settings.

Erro - Template não encontrado

The template was not found in the Spread.chat database

Please check if the template was created and approved by Meta.

Erro - Contato bloqueio recebimento whatsapp

The message was not sent because the contact has opted out.

The contact chose not to receive messages from this number. If necessary, this setting can be manually removed from the account.

How to Proceed When You Receive the Message: "This message was not delivered to maintain healthy ecosystem engagement."

  1. Check if the contact has already received two marketing messages without responding Review the contact’s message history to confirm if there were two previous attempts without interaction.

  2. Use alternative communication channels (if possible) If the contact is not engaging via WhatsApp, consider sending a re-engagement email, making a phone call, or reaching out through another channel to confirm their interest.

  3. Wait before sending another message Allow a cooling-off period of up to two hours before trying to send a new message to the contact.

In the next section, we’ll share some best practice recommendations for your message sends.

Last updated