Editing Troubleshoot WhatsApp Messaging error messages (section)

== Step-by-Step Instructions ==
Below are the common error messages and their resolutions when using WhatsApp Messaging:

=== 1. Media Upload Error ===
This error arises when the media file you are trying to upload has unsupported encoding, even if the file appears to be in the correct format (e.g., mp4).

*'''Resolution:'''* Convert the video to mp4 format using online converters like '''CloudConvert''' or software like '''Permute''' or '''Handbrake'''.

=== 2. Pair Rate Limit Hit ===
This error indicates that you have sent multiple messages to the same recipient in quick succession. 

*'''Resolution:'''* Wait a few seconds before attempting to send the message again. In automated flows, insert a '''Delay''' step between messages to prevent this error.

=== 3. Unable to Deliver Message: Recipient Phone Number is Not a WhatsApp Phone Number ===
This error occurs when the recipient's phone number is not valid for WhatsApp, or their account does not support the WhatsApp Business API.

*'''Resolution:'''* Send a test message from your personal WhatsApp account to verify the number. If successful, advise the recipient to update their WhatsApp version. If problems persist, reach out to the ActiveCampaign support team.

=== 4. User is Not Valid - Recipient is Not a Valid WhatsApp User ===
This occurs when the recipient’s phone number isn’t a valid WhatsApp account.

*'''Resolution:'''* Ensure the number is correct and in E.264 format (country code + 10 digits). If everything checks out, contact WhatsApp support for assistance.

=== 5. Spam Rate Limit Hit ===
You may receive this error if you exceed the quota of allowed messages. Unverified businesses are limited to 250 outbound messages in a rolling 24-hour period, while verified businesses have a limit of 1000.

*'''Resolution:'''* Wait 24 hours before trying to send the message again. More information about messaging limits can be found in the corresponding Facebook documentation.

=== 6. Message Was Not Sent as the User is Part of a WhatsApp Internal Experiment ===
WhatsApp might have some users engaged in internal experiments affecting message delivery.

*'''Resolution:'''* Try sending a template from the '''Utility''' category instead of Marketing templates, as only Marketing templates may be restricted.

=== 7. Message Failed to Send Because There Are Restrictions on How Many Messages Can Be Sent from This Phone Number ===
Similar to the Spam Rate Limit Hit error, this indicates you have exceeded the message quota or face other account restrictions.

*'''Resolution:'''* Wait 24 hours before attempting to resend. You can check your account's current limits in your WhatsApp manager.

=== 8. Translated Text Too Long ===
This error indicates that the variable text length exceeds WhatsApp’s limits—60 characters for header text and 1024 for the body.

*'''Resolution:'''* Shorten the header text to correct the issue.

=== 9. The Template Does Not Exist in the Specified Language or the Template Has Not Been Approved ===
This error arises when trying to send a template that does not match the recipient's language requirements.

*'''Resolution:'''* If necessary, recreate the template in a compatible language. If issues continue, contact WhatsApp support.

=== 10. In Order to Maintain a Healthy Relationship with the Ecosystem, the Message Was Not Transmitted ===
This indicates that WhatsApp limits the number of marketing messages sent to protect contacts from spam.

*'''Resolution:'''* 
1. Try sending later, ideally waiting until the next day. 
2. Consider creating a utility template, ensuring that "Allow Category Change" is disabled. Adjust the content of rejected templates to avoid terms classified as marketing.