Errores comunes del canal de WhatsApp
ninguno
Error: "Media upload Error"
Podrías ver el siguiente mensaje de error:
[{"code":131053,"title":"Media upload error","message":"Media upload error","error_data":{"details":"Sticker file could not be processed. Please choose a different file."}}]La razón es:
Puede que la URL que estás usando en el mensaje o en el mensaje de plantilla no sea accesible públicamente.
También puede ser que el formato de archivo que estás usando no sea compatible con WhatsApp.
Solución:
No pudimos subir el archivo multimedia por una o más razones, como un tipo de archivo no compatible. Consulta el valor error.error_data.details para obtener más información sobre por qué no pudimos subir el archivo.
Puedes revisar la URL que estás usando y asegurarte de que la URL del archivo comience con https, termine con la extensión del archivo al final de la URL y que este archivo multimedia siempre sea accesible públicamente.
Blocked by Integrity. Integrity requirements not met
Si ves este mensaje de error, puede activarse cuando intentas usar la función "WhatsApp Flow"; deberás verificar si tu Meta Business Manager está verificado o no.
Para ciertas funciones como WhatsApp Flow, Meta requiere un Business Manager verificado para otorgar acceso.
Error: "Sending payload: 2018062 (#100)"
La solicitud incluyó uno o más parámetros no compatibles o mal escritos.
Podrías ver mensajes de error como estos:
Error sending payload: 2018047 (#100) อัพโหลดไฟล์แนบไม่สำเร็จ
Error sending payload: 2018062 (#100) O URL fornecido não está na lista de liberação de extensões do Messenger
Es posible que estés usando algunas variables de campos personalizados del usuario, pero que algunas de esas variables no tengan un valor asignado.
Puedes agregar una validación condicional para todas las variables que estás a punto de usar y notificar al administrador si hay algún error.
También puedes ir a los registros de errores, ubicar al usuario, revisar el valor de la variable usada en el mensaje y confirmar si todas tienen el valor correcto.
Más información aquí:
https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes
Error: "Message failed to send because there are restrictions on how many messages can be sent from this phone number"
Podrías ver un mensaje de error como este:
[{"code":131048,"title":"Message failed to send because there are restrictions on how many messages can be sent from this phone number.This may be because too many previous messages were blocked or flagged as spam.","href":"https:\/\/developers.facebook.com\/docs\/whatsapp\/cloud-api\/support\/error-codes\/"}]Esto puede deberse a que demasiados mensajes anteriores fueron bloqueados o marcados como spam.
La razón es que has enviado muchos mensajes a otros usuarios, pero muchos de ellos fueron bloqueados o marcados como spam.
Por eso Meta ha aplicado algunas limitaciones a tu número. Necesitas mantener una buena calidad de cuenta; de lo contrario, tu cuenta o número de WABA podría ser bloqueado.
Error: "The message could not be sent. You do not have enough funds on your conversation prepaid balance to engage in any paid conversation"
Podrías ver un mensaje de error como este:
The message could not be sent. You do not have enough funds on your conversation prepaid balance to engage in any paid conversation. Please proceed to http://hub.360dialog.com -> 'Insights & Billing' in order to top up your balance and optionally enable auto-renewal, which will prevent you from running out of funds in the future.
La razón es que no tienes fondos suficientes en tu cuenta de 360dialog; necesitarás comprar más crédito en 360dialog. Ve a tu cuenta de 360dialog, a Insights & Billing, y agrega más créditos.
Error: "(#200) Permissions error"
Si ves este error, la razón es: el permiso no fue otorgado o fue eliminado.
Cuando conectas tu cuenta de WhatsApp, necesitas seleccionar todos los permisos requeridos. Aquí hay un video que lo explica en detalle:
TODO_VIDEO[181b05dce6]: reemplazar este video con un recurso oficial de OneChat.
Wc
Error 28: Resolving timed out after 10000 milliseconds
Cuando llamamos a la API de Meta para enviar el mensaje a través de su API, tarda más de 10 segundos. Esa es la configuración de tiempo de espera predeterminada de Meta.
En este escenario, puede que el servidor de Meta esté respondiendo lentamente o que el servidor de OneChat esté teniendo problemas. Primero puedes revisar la página de estado de la API de Meta; si no hay ninguna interrupción, contacta al soporte de OneChat.
Página de estado de la API de Meta:
https://metastatus.com/ ## Error: "Required parameter is missing - Error code 131008"
Podrías ver el código de error:
(#131008) Required parameter is missing Parameter of type text is missing text value
Razón:
A la solicitud le falta un parámetro obligatorio.
Solución:
Es posible que estés usando algunas variables de campos personalizados del usuario, pero algunas de esas variables no tienen un valor asignado.
Puedes agregar una validación condicional para todas las variables que estás a punto de usar y notificar al administrador si hay algún error.
También puedes ir a los registros de errores, ubicar al usuario, revisar el valor de la variable usada en el mensaje y confirmar si todas tienen el valor correcto.
Más información aquí:
https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes
Error: "WhatsApp Message Template not found"
Esto significa que has usado un mensaje de plantilla de WhatsApp, pero no podemos encontrar esa plantilla en tu cuenta de WhatsApp.
Esto puede deberse a que el usuario cambió la plantilla de mensaje o la eliminó del WhatsApp Business Manager y los cambios no se sincronizaron de regreso al chatbot de OneChat.
Error: "Business account has been locked"
Parece que tu cuenta de WhatsApp Business ha sido bloqueada por Meta. Necesitas contactar a Meta para obtener soporte.
Además, puedes ir a tu WhatsApp Manager en Meta Business Manager para ver si hay notificaciones relacionadas con este error.
Error: "Failed to send message because this user's phone number is part of an experiment"
Podrías ver un mensaje de error como este:
[{"code":130472,"title":"Failed to send message because this user's phone number is part of an experiment","href":"https:\/\/developers.facebook.com\/docs\/whatsapp\/cloud-api\/support\/error-codes\/"}]El mensaje no se envió porque forma parte de un experimento. Consulta Marketing Message Experiment.
Más información aquí:
https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes
Error: "Message failed to send because more than 24 hours have passed since the customer last replied to this number"
Podrías ver un mensaje de error como este:
[{"code":131047,"title":"Re-engagement message","message":"Re-engagement message","error_data":{"details":"Message failed to send because more than 24 hours have passed since the customer last replied to this number."},"href":"https:\/\/developers.facebook.com\/docs\/whatsapp\/cloud-api\/support\/error-codes\/"}]
[{"code":470,"href":"https:\/\/developers.facebook.com\/docs\/whatsapp\/api\/errors\/","title":"Message failed to send because more than 24 hours have passed since the customer last replied to this number"}]
Esto sucede porque han pasado más de 24 horas desde la última vez que recibiste un mensaje iniciado por el usuario: la sesión está cerrada y ya no puedes usar mensajes de formato libre. Busca una forma de restringir el envío de mensajes si no hubo ningún mensaje entrante del usuario/número de teléfono dado dentro de las 24 horas. Como alternativa, puedes contactar al usuario usando un mensaje de plantilla.
Error: "Business Account and Consumer Account pair rate limit hit"
Podrías ver un error como este:
(#131056) (Business Account, Consumer Account) pair rate limit hit
La razón de este error:
Se enviaron demasiados mensajes desde el número del remitente al mismo número de destinatario en un período corto de tiempo.
Solución:
Espera y vuelve a intentar la operación si deseas enviar mensajes al mismo número de teléfono. Aún puedes enviar mensajes a un número de teléfono diferente sin esperar.
Más información aquí:
https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes/
Error: "Error validating access token"
Podrías ver un mensaje de error como este:
Error validating access token: The session has been invalidated because the user changed their password or Facebook has changed the session for security reasons.
Los usuarios que conectaron WhatsApp cambiaron la contraseña de su cuenta de Facebook. Como medida de seguridad, Meta cierra sesión en todas las plataformas de terceros, por lo que volver a conectar una vez para establecer nuevamente la conexión resolverá el problema.
La solución es volver a conectar el canal. Como el usuario pudo haber cambiado su contraseña, el token anterior ya no es válido.
Error: "Spam Rate limit hit"
Podrías ver un error como este:
[{"code":131048,"title":"Spam Rate limit hit","message":"Spam Rate limit hit","error_data":{"details":"Message failed to send because there are restrictions on how many messages can be sent from this phone number.This may be because too many previous messages were blocked or flagged as spam."},"href":"https:\/\/developers.facebook.com\/docs\/whatsapp\/cloud-api\/support\/error-codes\/"}]Razón:
No se pudo enviar el mensaje porque existen restricciones sobre cuántos mensajes se pueden enviar desde este número de teléfono. Esto puede deberse a que demasiados mensajes anteriores fueron bloqueados o marcados como spam.
Solución:
Revisa tu estado de calidad en WhatsApp Manager y consulta la documentación de Quality-Based Rate Limits para obtener más información.
Error: "Receiver is incapable of receiving this message"
Normalmente verás un mensaje de error como este:
[{"code":131026,"title":"Receiver is incapable of receiving this message","message":"Receiver is incapable of receiving this message","error_data":{"details":"Message Undeliverable."}}]
Posibles razones:
No se puede entregar un mensaje. Las razones pueden incluir:
· El número de teléfono del destinatario no es un número de WhatsApp.
· El destinatario no ha aceptado nuestros nuevos Términos del servicio y Política de privacidad.
· El destinatario usa una versión antigua de WhatsApp; debe usar la siguiente versión de WhatsApp o una superior:
o Android: 2.21.15.15
o SMBA: 2.21.15.15
o iOS: 2.21.170.4
o SMBI: 2.21.170.4
o KaiOS: 2.2130.10
o Web: 2.2132.6
Solución:
Confirma con el destinatario que acepta ser contactado por ti a través de WhatsApp y que está usando la versión más reciente de WhatsApp.
Más información:
https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes
Error: "#200 permission error - WhatsApp Cloud API"
Este error ocurre porque el usuario no otorgó suficientes permisos. Consulta el video de referencia a continuación para resolver el problema:
TODO_VIDEO[181b05dce6]: reemplazar este video con un recurso oficial de OneChat.
Wc
Error: "Message not sent because outside 24 hours"
Este límite aplica a los canales de Meta (Messenger, Instagram, WhatsApp). Si el usuario no ha interactuado con tu bot en las últimas 24 horas,
no puedes contactarlo directamente. En WhatsApp, tendrás que enviar un mensaje de plantilla; en Messenger, tendrás que enviar una notificación recurrente o una notificación de una sola vez.
No hay buenas opciones para contactar al usuario de Instagram si está fuera de la ventana de 24 horas.
Más información aquí:
https://developers.facebook.com/docs/messenger-platform/policy/policy-overview/
Error: "Message Undeliverable"
El código de error 131026, Message undeliverable
Posibles razones:
No se puede entregar un mensaje. Las razones pueden incluir:
· El número de teléfono del destinatario no es un número de WhatsApp.
· El destinatario no ha aceptado nuestros nuevos Términos del servicio y Política de privacidad.
· El destinatario usa una versión antigua de WhatsApp; debe usar la siguiente versión de WhatsApp o una superior:
o Android: 2.21.15.15
o SMBA: 2.21.15.15
o iOS: 2.21.170.4
o SMBI: 2.21.170.4
o KaiOS: 2.2130.10
o Web: 2.2132.6
Solución:
Confirma con el destinatario que acepta ser contactado por ti a través de WhatsApp y que está usando la versión más reciente de WhatsApp.
Más información:
https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes
Error: "Message undeliverable - Code 131026"
No se puede entregar un mensaje. Las razones pueden incluir:
· El número de teléfono del destinatario no es un número de WhatsApp.
· El destinatario no ha aceptado los nuevos Términos del servicio y Política de privacidad.
· El destinatario usa una versión antigua de WhatsApp; debe usar la siguiente versión de WhatsApp o una superior:
Confirma con el destinatario que acepta ser contactado por ti a través de WhatsApp y que está usando la versión más reciente de WhatsApp.
Error: "Business eligibility payment issue"
El error completo puede verse algo así:
[{"code":131042,"title":"Message failed to send because there were one or more errors related to your payment method.","href":"https:\/\/developers.facebook.com\/docs\/whatsapp\/cloud-api\/support\/error-codes\/"}]
Este error suele ocurrir en Cloud API, canal de WhatsApp.
Necesitarás ir a tu Facebook Business Manager, luego a WhatsApp Manager, y revisar si tienes algún problema de pago con tu facturación. Como Meta cobra por los mensajes de plantilla de WhatsApp, necesitarás configurar una tarjeta de crédito válida en la sección de facturación de tu WhatsApp Manager.
Error: "Invalid Parameter #100"
Podrías ver un mensaje de error como este:
(#100) Unexpected key "index" on param "template['components'][0]['parameters'][0]".
Razón:
La solicitud incluyó uno o más parámetros no compatibles o mal escritos.
Solución:
Consulta la referencia del endpoint para determinar qué parámetros son compatibles y cómo se escriben.
Asegúrate de que, al configurar la clave pública empresarial, sea una clave pública RSA válida de 2048 bits en formato PEM.
Asegúrate de que no haya una discrepancia entre el ID del número de teléfono que estás registrando y un ID de número de teléfono almacenado previamente.
Error: "(#132001) Template name does not exist in the translation"
Este error significa que la plantilla no existe. La plantilla no existe en el idioma especificado o la plantilla no ha sido aprobada.
Asegúrate de que tu plantilla haya sido aprobada y de que el nombre de la plantilla y la configuración regional del idioma sean correctos. Asegúrate también de seguir las pautas para mensajes de plantilla.
Error: "(#131053) Downloading media from weblink failed with https code 401, Unauthorized"
Este error ocurre cuando se integra un almacenamiento de terceros (Cloudinary, S3, etc.) y se comparte un archivo mediante un flujo sin los permisos requeridos, lo que provoca que archivos de ciertos formatos no se entreguen a los usuarios.
Para resolverlo, desconecta la integración de almacenamiento o habilita la configuración que nos permite compartir los archivos.
A continuación se muestra un ejemplo de Cloudinary;
Error: "(#100) "Cannot migrate phone number: The WhatsApp destination account must have webhooks set up."
Este error ocurre cuando un número es transferido/migrado de un proveedor de servicios a Cloud API o viceversa mientras se conecta al mismo bot. Obtendrás este error al intentar registrar el número usando el registro integrado de WhatsApp.
Para resolverlo, pausa y reanuda el bot actual, y luego inténtalo de nuevo.
Problemas al conectar su número de WhatsApp Cloud API a Facebook Ads para la entrega de mensajes
Este problema ocurre cuando los usuarios agregan directamente su número de WhatsApp dentro de Ads Manager. Cuando hacen esto, Facebook muestra la opción de conectar el número con la aplicación WhatsApp Business, lo que genera un conflicto porque el número ya está registrado en WhatsApp Cloud API. Como resultado, el número no logra conectarse correctamente para la entrega de anuncios.
Sigue estos pasos para conectar un número de WhatsApp de Cloud API a Facebook Ads: inicia sesión en Facebook y cambia a tu perfil de Página. Vincula a tu Página el número de WhatsApp que está registrado con Cloud API. Una vez vinculado, ve a Ads Manager. Ahora selecciona este número de WhatsApp al configurar tu campaña para la entrega de mensajes.