Common WhatsApp API Errors

Message: "Message failed to send because more than 24 hours have passed since the customer last replied to this number"

🟢 Why it happens: You are trying to send a free-form text or media message, but the customer hasn't replied to you in the last 24 hours. The "session" is closed.
🟢 Solution: You must send a Template Message (approved by Meta) to start a new conversation. Once they reply, the 24-hour timer resets.

Message: "Message Undeliverable"

🟢 Why it happens: The message could not be delivered to the user's phone. This is usually because:
- The phone number is not a valid WhatsApp number.
- The user has blocked your business.
- The user is using a very old version of WhatsApp.
🟢 Solution: Verify the phone number is correct and active on WhatsApp. If the number is valid, the user likely blocked the business or has no internet connection for a long period.

Message: "Message failed to send because there were one or more errors related to your payment method"

🟢 Why it happens: Meta could not charge your account for the conversation. This happens if your credit card expired, was declined, or if you hit your credit line limit.
🟢 Solution: Go to your WhatsApp Business Manager (Meta) settings and update your payment method immediately to resume sending messages.

Message: "Message failed to send because there are restrictions on how many messages can be sent from this phone number"

🟢 Why it happens: Your phone number has been flagged for sending too many messages that users reported as spam or blocked. Your quality score has dropped.
🟢 Solution: Stop sending marketing messages immediately. Wait for your quality score to improve. Review your message content to ensure it is relevant and not spammy.

Message: "Message blocked for ecosystem protection"

🟢 Why it happens: The user has already received too many marketing messages from various businesses recently. Meta limits how many marketing templates a user sees to protect their experience.
🟢 Solution: Try sending the message again later (e.g., in 24-48 hours). This is not an error with your system, but a restriction on the user's side.

🇪🇸 Español: Errores Comunes de WhatsApp API

Mensaje: "Message failed to send because more than 24 hours have passed..."

🟢 Por qué sucede: Estás intentando enviar un mensaje de texto libre, pero el cliente no te ha respondido en las últimas 24 horas. La "sesión" se ha cerrado.
🟢 Solución: Debes enviar un Mensaje de Plantilla (aprobado por Meta) para iniciar una nueva conversación. Una vez que respondan, el temporizador de 24 horas se reinicia.

Mensaje: "Message Undeliverable"

🟢 Por qué sucede: El mensaje no pudo ser entregado al teléfono del usuario. Generalmente porque:
- El número no es un número de WhatsApp válido.
- El usuario ha bloqueado tu negocio.
- El usuario tiene una versión muy antigua de WhatsApp.
🟢 Solución: Verifica que el número sea correcto y tenga WhatsApp. Si es válido, es probable que el usuario te haya bloqueado o no tenga conexión a internet.

Mensaje: "Message failed to send because there were one or more errors related to your payment method"

🟢 Por qué sucede: Meta no pudo cobrar la conversación a tu cuenta. Ocurre si tu tarjeta de crédito expiró, fue rechazada o alcanzaste tu límite de crédito.
🟢 Solución: Ve a la configuración de tu WhatsApp Business Manager (Meta) y actualiza tu método de pago inmediatamente.

Mensaje: "Message failed to send because there are restrictions on how many messages can be sent..."

🟢 Por qué sucede: Tu número ha sido marcado por enviar demasiados mensajes que los usuarios reportaron como spam o bloquearon. Tu "calidad" ha bajado.
🟢 Solución: Detén los envíos de marketing. Espera a que tu puntaje de calidad mejore y revisa el contenido de tus mensajes para que sean más relevantes.

Сообщение: "Message failed to send because more than 24 hours have passed..."

🟢 Почему это происходит: Вы пытаетесь отправить свободное сообщение, но клиент не отвечал вам в последние 24 часа. Сессия закрыта.
🟢 Решение: Вы должны отправить Шаблонное сообщение (Template), утвержденное Meta, чтобы начать новую беседу. Как только клиент ответит, 24-часовой таймер сбросится.

Сообщение: "Message Undeliverable"

🟢 Почему это происходит: Сообщение не удалось доставить на телефон пользователя. Обычно это значит:
- Номер телефона не зарегистрирован в WhatsApp.
- Пользователь заблокировал ваш бизнес-аккаунт.
- У пользователя установлена очень старая версия WhatsApp.
🟢 Решение: Проверьте правильность номера. Если номер верный, скорее всего, пользователь вас заблокировал или у него долго нет интернета.

Сообщение: "Message failed to send because there were one or more errors related to your payment method"

🟢 Почему это происходит: Meta не смогла списать средства за переписку. Ваша карта истекла, была отклонена или достигнут лимит кредитной линии.
🟢 Решение: Зайдите в настройки WhatsApp Business Manager (Meta) и обновите способ оплаты, чтобы возобновить отправку.

Сообщение: "Message failed to send because there are restrictions on how many messages can be sent..."

🟢 Почему это происходит: Ваш номер был помечен системой, так как пользователи часто жаловались на спам или блокировали вас. Рейтинг качества вашего номера упал.
🟢 Решение: Немедленно остановите рассылки. Подождите, пока рейтинг качества восстановится, и пересмотрите контент сообщений, чтобы они были полезны клиентам.