Índice
¿Qué son las fallas en el envío?
¿Dónde encuentro las fallas en el envío?
¿Qué significan los errores presentados en el informe?
¿Qué son las fallas en el envío?
Son errores informados por Meta que impidieron la entrega de mensajes a los contactos.
¿Dónde encuentro las fallas en el envío?
Para acceder al detalle, sigue los pasos a continuación:
Cómo acceder:
Accede al portal;
Luego selecciona el chatbot;
Después accede a la pestaña “Análisis”;
Dentro de Análisis, haz clic en el menú “Mensajes Activos”.
Al final del informe, existe una sección específica con el detalle de los errores: “Fallas en el envío”.
¿Qué significan los errores presentados en el informe?
A continuación, se detallan los posibles errores:Abaixo serão detalhados os possíveis erros:
|
Grupo de Error
|
Código | Mensaje | Detalle | Posibles Soluciones |
| Errores de autorización | 0 | Hubo un problema de autenticación. Esto generalmente significa que tu token de acceso ha expirado o no es válido. Intenta generar un nuevo token de acceso. | No fue posible autenticar al usuario de la aplicación. | Normalmente, esto significa que el token de acceso incluido ha expirado, fue invalidado o el usuario de la aplicación cambió una configuración para impedir que todas las aplicaciones accedan a sus datos. Recomendamos que obtengas un nuevo token de acceso. |
| Errores de autorización | 3 | Tu aplicación no tiene permiso para realizar esta acción. Verifica que los permisos necesarios para enviar mensajes vía WhatsApp estén activos para tu aplicación | Problema de capacidad o permisos | Utiliza el depurador de token de acceso para verificar si tu aplicación recibió los permisos necesarios para el endpoint. Aprende cómo hacer la depuración aquí. |
| Errores de autorización | 10 | Permiso denegado. El permiso para ejecutar esta acción no fue concedido o fue removido. Verifica las configuraciones de permisos de tu aplicación. | El permiso no fue concedido o fue removido |
Utiliza el depurador de token de acceso para verificar si tu aplicación recibió los permisos necesarios para el endpoint. Si es necesario, consulta la información sobre errores de autenticación y autorización aquí. El número de teléfono usado para definir la clave pública de la empresa debe estar en la lista de permisos. |
| Errores de autorización | 190 | Su token de acceso ha expirado. Necesita generar un nuevo token para continuar. | Su token de acceso ha expirado. | Obtenga un nuevo token de acceso. |
| Errores de autorización | 200-299 | Error de permiso de la API. El permiso necesario no fue concedido o fue revocado. Verifique los permisos de su aplicación. | El permiso no fue concedido o fue eliminado. | Utilice el depurador de token de acceso para verificar si su aplicación ha recibido los permisos necesarios a través del endpoint. Si es necesario, consulte aquí la información sobre errores de autenticación y autorización. |
| Errores de integridad | 368 | Su cuenta ha sido bloqueada temporalmente por violar las políticas de WhatsApp. Verifique las políticas de la plataforma para entender el motivo y cómo resolverlo. | La Cuenta Comercial de WhatsApp asociada a la aplicación fue restringida o desactivada por violar una política de la plataforma. | Consulte el documento de Aplicación de Políticas para saber más sobre violaciones de políticas y cómo resolverlas. |
| Errores de integridad. | 130497 | Su cuenta comercial no tiene permiso para enviar mensajes a usuarios en este país. Consulte los países permitidos para su categoría de negocio en las políticas de Meta. | La Cuenta Comercial de WhatsApp está restringida para enviar mensajes a usuarios en determinados países. | Consulte en las Políticas de Meta aquí los detalles sobre el permiso y la restricción para enviar mensajes a determinados países en su categoría de negocio. |
| Errores de integridad. | 131031 | La cuenta fue bloqueada por violación de política o fallo en la verificación de datos (como un PIN de dos pasos incorrecto). Verifique las políticas de WhatsApp y el estado de su cuenta para más detalles. | La Cuenta Comercial de WhatsApp asociada a la aplicación fue restringida o desactivada por violar una política de la plataforma, o no pudimos verificar los datos incluidos en la solicitud con los datos establecidos en la Cuenta Comercial de WhatsApp (por ejemplo, el PIN de dos pasos incluido en la solicitud es incorrecto). | Consulte el documento de Aplicación de Políticas para saber más sobre violaciones de políticas y cómo resolverlas. También puede consultar aquí el documento sobre el estado de integridad del envío de mensajes para obtener información adicional sobre el motivo del bloqueo de la cuenta. |
| Otros errores | 1 | Error desconocido. Puede ser un problema temporal en el servidor de WhatsApp o un error en su solicitud. Verifique el estado de la API y confirme que su solicitud sea correcta. | Solicitud inválida o posible error del servidor. | Consulte aquí la información sobre el estado de la API. Si no hay interrupciones en el servidor, verifique la referencia del endpoint y asegúrese de que su solicitud esté correctamente formateada y cumpla con todos los requisitos del endpoint. |
| Otros errores | 2 | Servicio de API no disponible. El servicio puede estar temporalmente fuera de línea o sobrecargado. Verifique el estado de la API y vuelva a intentarlo más tarde | Temporal debido a tiempo de inactividad o sobrecarga. | Consulte aquí la información sobre el estado de la API antes de intentarlo nuevamente. |
| Otros errores | 33 | Su número de teléfono comercial fue eliminado o es inválido. Verifique que el número de teléfono proporcionado sea correcto. | El número de teléfono comercial fue eliminado. | Verifique que el número de teléfono comercial sea correcto. |
| Otros errores | 100 | Parámetro inválido. Su solicitud contiene parámetros (información enviada) que no son compatibles o tienen errores tipográficos. Verifique la documentación para corregir posibles errores. | La solicitud incluyó uno o más parámetros no compatibles o con errores ortográficos. | Consulte la referencia del endpoint para determinar qué parámetros son compatibles y cómo se escriben. Al definir la clave pública de la empresa, debe seguir las instrucciones descritas aquí. Verifique que no haya incompatibilidad entre el ID del número de teléfono que está registrando y un ID de número de teléfono almacenado anteriormente. Asegúrese de que su parámetro cumpla con las restricciones de longitud para el tipo." |
| Otros errores | 130472 | El número del usuario forma parte de un experimento. El mensaje no fue enviado porque el número de destino está participando en una prueba de WhatsApp. | El mensaje no fue enviado como parte de un experimento. | Consulte Experimento de Mensaje de Marketing. |
| Otros errores | 131000 | Algo salió mal. El mensaje no pudo ser enviado debido a un error desconocido. Inténtelo de nuevo. Si el error persiste, póngase en contacto con el soporte. | El mensaje no se pudo enviar debido a un error desconocido. Al definir una clave pública de negocios, hubo una falla en el cálculo de la firma, en la llamada al endpoint de GraphQL o el endpoint de GraphQL devolvió un error. | Inténtelo de nuevo. Si el error persiste, abra un ticket aquí. |
| Otros errores | 131005 | Acceso denegado. Su aplicación no tiene permiso para ejecutar esta acción. Verifique los permisos concedidos. | El permiso no fue concedido o fue eliminado. | Utilice el depurador de token de acceso para verificar si su aplicación ha recibido los permisos necesarios a través del endpoint. Consulte la información sobre errores de autenticación y autorización aquí. |
| Otros errores | 131008 | Falta un parámetro obligatorio. Su solicitud no incluyó una información necesaria para el envío. Verifique la documentación para descubrir qué falta. | Falta algún parámetro obligatorio en la solicitud. | Consulte la referencia del endpoint para determinar qué parámetros son necesarios. |
| Otros errores | 131009 | El valor de un parámetro es inválido. Una o más informaciones enviadas en su solicitud no son válidas. Verifique la documentación para obtener los valores correctos. | Uno o más valores de parámetro son inválidos. | Consulte la referencia del endpoint para determinar qué valores son compatibles para cada parámetro y consulte Números de Teléfono para saber cómo agregar un número de teléfono a una Cuenta Comercial de WhatsApp. |
| Otros errores | 131016 | Servicio no disponible. Un servicio de WhatsApp está temporalmente no disponible. Verifique el estado de la API y vuelva a intentarlo más tarde. | Un servicio está temporalmente no disponible. | Consulte aquí la información sobre el estado de la API antes de intentarlo nuevamente." |
| Otros errores | 131021 | El destinatario no puede ser el remitente. Está intentando enviar un mensaje al mismo número que lo envía. Cambie el número del destinatario. | El número de teléfono del remitente y del destinatario es el mismo. | Envíe un mensaje a un número de teléfono diferente al del remitente. |
| Otros errores | 131026 | El mensaje no pudo ser entregado. Esto puede ocurrir porque el número del destinatario no es un número de WhatsApp, no aceptó los nuevos términos de servicio o está usando una versión desactualizada de la aplicación. Pida al usuario que verifique estos puntos." |
No fue posible entregar el mensaje. Los motivos pueden incluir: El número de teléfono del destinatario no es un número de WhatsApp. El destinatario no aceptó nuestros nuevos Términos de Servicio y Política de Privacidad. El destinatario está usando una versión antigua de WhatsApp; debe usar la siguiente versión de WhatsApp o superior: Android: 2.21.15.15 + SMBA: 2.21.15.15 + iOS: 2.21.170.4 + SMBI: 2.21.170.4 + KaiOS: 2.2130.10 + Web: 2.2132.6 |
Usando un método de comunicación que no sea WhatsApp, pida al usuario de WhatsApp que: Confirme que realmente puede enviar un mensaje al número de teléfono de su empresa en WhatsApp. Confirme que aceptó nuestros Términos de Servicio más recientes (Configuración > Ayuda o Configuración > Información de la aplicación solicitará que acepte los términos/políticas más recientes, si aún no lo ha hecho). Actualice a la versión más reciente del cliente de WhatsApp. |
| Otros errores | 131037 | El nombre para mostrar de su número de prueba (que comienza con 555) debe ser aprobado antes de que pueda enviar mensajes. Cambie el nombre para mostrar por uno aprobado. | El número de teléfono comercial 555 utilizado para enviar la solicitud no tiene un nombre para mostrar aprobado. | Cambie el nombre para mostrar del número de teléfono comercial 555. Consulte nuestro artículo en el Centro de Ayuda (aquí) para saber cómo hacer el cambio. |
| Otros errores | 131042 | Problema de pago. Ocurrió un error con su método de pago. Verifique que su cuenta de pago esté configurada correctamente, activa y sin problemas pendientes. | Hubo un error relacionado con su método de pago. |
Consulte la información sobre facturación aquí y verifique si realizó las configuraciones correctamente. Problemas comunes: La cuenta de pago no está vinculada a una Cuenta Comercial de WhatsApp La línea de crédito está por encima del límite La línea de crédito (Cuenta de Pago) no está definida o activa La Cuenta Comercial de WhatsApp fue eliminada La Cuenta Comercial de WhatsApp está suspendida Zona horaria no definida Moneda no definida La solicitud de Mensajes (En nombre de) está pendiente o fue rechazada Excedió el límite del nivel gratuito de conversaciones sin un método de pa
|
| Otros errores | 131045 | Certificado incorrecto. Hubo una falla en el envío del mensaje debido a un error en el registro del número de teléfono. Intente registrar el número nuevamente. | Hubo una falla en el envío del mensaje debido a un error en el registro del número de teléfono. | Acceda a la información de registro aquí antes de intentar nuevamente. |
| Otros errores | 131047 | Espero que este mensaje te encuentre bien. Han pasado más de 24 horas desde nuestra última conversación y solo quería verificar si tienes alguna pregunta o si hay algo más en lo que pueda ayudarte. | Han pasado más de 24 horas desde que el destinatario respondió por última vez al número del remitente. | Envíe al destinatario un mensaje iniciado por la empresa usando una plantilla de mensaje. |
| Otros errores | 131049 | Meta (la empresa matriz de WhatsApp) decidió no entregar este mensaje para mantener la calidad del servicio. No lo intentes de nuevo inmediatamente. | Meta entiende que este mensaje no promueve una interacción saludable en el ecosistema. Por este motivo no fue entregado. | No intentes de nuevo inmediatamente si recibes este código de error. En su lugar, intenta esperar intervalos de tiempo cada vez mayores para enviar el mensaje nuevamente, hasta que sea entregado. El límite puede estar en vigor por períodos de tiempo diferentes. Consulta más información sobre límites de plantillas de mensajes aquí. |
| Otros errores | 131050 | El usuario dejó de recibir mensajes de marketing. El destinatario optó por no recibir más mensajes de marketing de su empresa. No envíe nuevos mensajes a este usuario. | No se pudo entregar el mensaje. Este destinatario optó por dejar de recibir mensajes de marketing de su empresa en WhatsApp. | No intentes enviar mensajes a este usuario de nuevo. Para recibir notificaciones cada vez que un usuario de WhatsApp solicite pausar o reanudar la entrega de mensajes de plantilla de marketing de tu empresa, suscríbete al webhook user_preferences. |
| Otros errores | 131051 | Tipo de mensaje no compatible. El tipo de mensaje que intentas enviar (por ejemplo, texto, imagen, audio) no es compatible. Verifica los tipos de mensaje permitidos. | Tipo de mensaje no compatible | Consulta los tipos de mensaje compatibles en Mensajes. Después de eso, intenta de nuevo usando un tipo de mensaje compatible. |
| Otros errores | 131052 | Error al descargar el contenido multimedia. No se pudo descargar el archivo multimedia enviado por el usuario. Pídele al usuario que envíe el archivo por otro medio. | No se pudo descargar el contenido multimedia enviado por el usuario. | No se pudo descargar el contenido multimedia incluido en el mensaje del usuario de WhatsApp. Para más información, consulta el valor error.error_data.details en cualquier webhook de mensajes activado cuando se recibió este mensaje. Pide al usuario de WhatsApp que envíe el archivo multimedia usando un método que no sea WhatsApp. |
| Otros errores | 131053 | Error al cargar el contenido multimedia. No se pudo cargar el archivo multimedia. Verifica si el formato del archivo (por ejemplo, JPG, PNG, MP4) es compatible. | No se pudo cargar el contenido multimedia utilizado en el mensaje. | No se pudo cargar el contenido multimedia por uno o más motivos, como un tipo de contenido no compatible. Para más información, consulta el valor error.error_data.details en cualquier webhook de mensajes activado cuando este mensaje no se envía. Recomendamos que verifiques los archivos multimedia que están causando errores y confirmes si realmente son compatibles. En UNIX, por ejemplo, puedes usar la línea de comandos file -I rejected-file.mov para determinar el tipo MIME. Luego puedes confirmar si el tipo MIME es compatible. Consulta la documentación sobre la API de la nube de WhatsApp aquí. |
| Otros errores | 131057 | Cuenta en modo de mantenimiento. Tu cuenta de WhatsApp Business está en mantenimiento, como una actualización de capacidad de rendimiento. Intenta de nuevo más tarde. | La cuenta comercial está en modo de mantenimiento. | La cuenta comercial de WhatsApp está en modo de mantenimiento. Una razón para esto puede ser que la cuenta esté experimentando una actualización de la tasa de transferencia de datos. |
| Otros errores | 132000 | Incompatibilidad en el recuento de parámetros de la plantilla. El número de variables en tu plantilla de mensaje no coincide con lo que se envió. Debes rellenar todos los campos variables de tu plantilla. | El número de valores de parámetros variables incluidos en la solicitud no coincidió con el número de parámetros variables definidos en la plantilla. | Consulta las Directrices para plantillas de mensajes aquí y asegúrate de que la solicitud incluya todos los valores de parámetros variables que se definieron en la plantilla. |
| Otros errores | 132001 | La plantilla no existe. Verifica si el nombre de la plantilla y el idioma son correctos y si ha sido aprobada por WhatsApp. | La plantilla no existe en el idioma especificado o la plantilla no ha sido aprobada. | Verifica si la plantilla ha sido aprobada y si el nombre de la plantilla y la configuración regional del idioma son correctos. Debes seguir las directrices de la plantilla de mensaje. |
| Otros errores | 132005 | Texto hidratado de la plantilla demasiado largo. El texto traducido de tu plantilla de mensaje es demasiado largo. Verifica las traducciones de tu plantilla en el Administrador de WhatsApp. | El texto traducido es demasiado largo | Consulta el Administrador de WhatsApp para verificar si tu plantilla ha sido traducida. Debes seguir las directrices de la plantilla de mensaje aquí. |
| Otros errores | 132007 | El contenido de tu plantilla de mensaje infringe una política de WhatsApp. Consulta las directrices para entender el motivo de la infracción. | El contenido de la plantilla infringe una política de WhatsApp. | Consulta las directrices de la plantilla de mensaje aquí para determinar los posibles motivos de la infracción. |
| Otros errores | 132012 | Incompatibilidad de formato de parámetro de la plantilla. El formato de las variables en tu plantilla de mensaje es incorrecto. Verifica que el formato de la información que estás enviando coincida con lo que se definió en la plantilla. | Valores de parámetros variables formateados incorrectamente | Los valores de los parámetros variables incluidos en la solicitud no están utilizando el formato especificado en la plantilla. Consulta las directrices de la plantilla de mensaje aquí. |
| Otros errores | 132015 | La plantilla está en pausa debido a la baja calidad y no se puede enviar. Edita la plantilla para mejorar su calidad e inténtalo de nuevo después de la aprobación. | La plantilla está en pausa debido a la [baja calidad] (https://developers.facebook.com/docs/whatsapp/message-templates/guidelines#quality-rating), por eso no se puede enviar en un mensaje de plantilla. | [Edite o modelo] Siga as orientações para melhorar a qualidade do modelo e tente novamente assim que for aprovado. |
| Otros errores | 132016 | La plantilla fue deshabilitada permanentemente después de haber sido pausada muchas veces por baja calidad. Crea una nueva plantilla con contenido diferente. | La plantilla fue pausada muchas veces debido a la [baja calidad] (https://developers.facebook.com/docs/whatsapp/message-templates/guidelines#quality-rating)y a hora está permanentemente deshabilitado | Crea una nueva plantilla con contenido diferente |
| Otros errores | 132068 | El flujo está bloqueado. Corrige el flujo para continuar | El flujo está en estado de bloqueo | Corrige el Flujo |
| Otros errores | 132069 | El flujo está limitado. Ya se enviaron 10 mensajes usando este flujo en la última hora. Corrige el flujo. | El flujo está en estado de limitación y 10 mensajes usando este flujo ya fueron enviados en la última hora. | Corrige el Flujo |
| Otros errores | 133000 | Cancelación de registro incompleta. Un intento anterior de cancelar el registro del número falló. Intenta cancelar el registro de nuevo antes de registrar. | Un intento anterior de cancelación de registro falló. |
Siga los siguientes pasos antes de registrar: |
| Otros errores | 133004 | Servidor temporalmente no disponible. Verifica la página de estado de la API de WhatsApp e inténtalo de nuevo. | El servidor está temporalmente no disponible. | Consulta la información en la página de estado de la API de WhatsApp Business aquí y verifica el valor de detalles de la respuesta antes de intentar de nuevo. |
| Otros errores | 133005 | El PIN de verificación en dos pasos es incorrecto. Verifica si el PIN es correcto o restablécelo. | PIN de verificación en dos pasos incorrecto. | Verifica si el PIN de verificación en dos pasos incluido en la solicitud es correcto. Para restablecer el PIN de verificación en dos pasos: 1. Sigue estos pasos descritos aqui e aqui. 2. Envía una solicitud POST que incluya el nuevo PIN al endpoint [Número de Teléfono]. Detalles aqui. |
| Otros errores | 133006 | Necesaria nueva verificación del número de teléfono. Verifica el número de teléfono antes de intentar registrarlo. | El número de teléfono debe ser verificado antes del registro. | Verifica el número de teléfono antes de registrarlo. |
| Otros errores | 133008 | Demasiados intentos de adivinar el PIN de la verificación en dos pasos. Espera el tiempo especificado e inténtalo de nuevo | Demasiados intentos de adivinar el PIN de verificación en dos pasos para este número de teléfono. | Intenta de nuevo después del tiempo especificado en el valor de la respuesta details. |
| Otros errores | 133009 | El PIN de verificación en dos pasos fue adivinado muy rápido. Verifica la respuesta para saber cuándo puedes intentar de nuevo. | El PIN de verificación en dos pasos fue ingresado demasiado rápido | Verifica el valor de la respuesta details antes de intentar de nuevo. |
| Otros errores | 133010 | El número de teléfono no está registrado. Registra el número de teléfono en la Plataforma de WhatsApp Business antes de intentar de nuevo. | Número de teléfono no registrado en la Plataforma de WhatsApp Business. |
Verifica los siguientes enlaces antes de intentar de nuevo: |
| Otros errores | 133015 | Espera unos minutos antes de registrar este número. El número fue eliminado recientemente y el proceso no ha sido completado. Espera 5 minutos e inténtalo de nuevo. | El número de teléfono que intentas registrar fue eliminado recientemente y la eliminación aún no ha sido completada. | Espera 5 minutos antes de intentar de nuevo la solicitud. |
| Otros errores | 135000 | Error genérico del usuario. Hubo un fallo de envío del mensaje debido a un error desconocido en los parámetros de tu solicitud. Verifica la sintaxis de tu solicitud o ponte en contacto con el soporte. | Hubo un fallo de envío del mensaje debido a un error desconocido con los parámetros de tu solicitud. | Consulta la referencia del endpoint para determinar si estás consultando el endpoint usando la sintaxis correcta. Ponte en contacto con el soporte al cliente si sigues recibiendo este código de error en respuesta. |
| Errores de sincronización | 2593107 | Límite de solicitudes de sincronización excedido. Solo puedes sincronizar contactos e historial de mensajes una vez. Desintegra y luego reintegra el cliente para intentarlo de nuevo. | Has excedido el número máximo de veces para llamar a la API de sincronización para este número de teléfono. | Solo puedes llamar a este endpoint una vez para sincronizar los contactos del número de teléfono comercial y una vez para sincronizar tu historial de mensajes. Consulta "Integración de usuarios de aplicaciones de negocios". Desintegra al cliente comercial y reintegra.lo. |
| Errores de sincronización | 2593108 | Solicitud de sincronización realizada fuera de la ventana de tiempo permitida. La sincronización solo puede realizarse dentro de las 24 horas posteriores a la integración del usuario. Desintegra y luego reintegra al usuario para intentarlo de nuevo. | La solicitud de sincronización solo puede realizarse dentro de las 24 horas posteriores a la integración. | Solo puedes iniciar la sincronización de contactos y el historial de mensajes de un usuario de la aplicación de WhatsApp Business integrado dentro de las 24 horas posteriores a la integración del usuario. Consulta 'Integración de usuarios de aplicaciones de negocios'. Desintegra al usuario y luego vuelve a integrarlo. |
Para más información, accede a la discusión sobre el tema en nuestra comunidad o a los videos en nuestro canal. 😃