La API de nube se basa en la API Graph, por lo que si no tienes experiencia con la gestión de las respuestas de error de la API Graph, consulta la documentación sobre gestión de errores de la API Graph.
En general, te recomendamos que desarrolles la lógica de gestión de errores de tu aplicación en torno a los valores de code y las propiedades de la carga útil de details. Estas propiedades y los valores correspondientes indican el error subyacente de forma más precisa.
Los títulos de los códigos, que no tienen una propiedad dedicada en las cargas útiles de las respuestas de error de la API, se incluyen como parte del valor de message. No obstante, te recomendamos que no te bases en los títulos para la lógica de gestión de errores, ya que con el tiempo se retirarán.
Recepción de errores: síncrona y asíncrona
Los errores de la API de nube se devuelven de forma síncrona como respuesta de la API Graph, de forma asíncrona mediante webhooks o, a veces, de ambas formas.
Al trabajar con la API de nube, es aconsejable supervisar tanto la respuesta de la API Graph como el webhook messages para gestionar los errores. Si te has suscrito al campo del webhook messages, recibirás notificaciones de errores conforme se produzcan para los tipos de errores asíncronos admitidos.
Los errores de la API de nube pueden aparecer en los siguientes objetos de webhooks:
entry.changes.value.errorsentry.changes.value.messages.errorsSintaxis de la respuesta de error
{ "error": { "message": "<MESSAGE>", "type": "<TYPE>", "code": <CODE>, "error_data": { "messaging_product": "whatsapp", "details": "<DETAILS>" }, "error_subcode": <ERROR_SUBCODE>, "fbtrace_id": "<FBTRACE_ID>" } } | Propiedad | Tipo de valor | Descripción |
|---|---|---|
| Entero | Código de error. Te recomendamos que desarrolles la gestión de errores de tu aplicación en torno a los códigos de error y no a los subcódigos o los códigos de estado de las respuestas HTTP. |
| Cadena | Descripción del error y descripción del motivo más probable del error. También puede incluir información sobre cómo abordar el error, como el parámetro que no es válido o los valores que se aceptan. |
| Entero | Retirada. No se devolverá en las respuestas de la versión 16.0 y posteriores. Subcódigo de la API Graph. No todas las respuestas incluirán un subcódigo, por lo que te recomendamos que desarrolles la lógica de gestión de errores en torno a los valores de |
| Cadena | Identificador de seguimiento que puedes incluir al ponerte en contacto con el equipo de asistencia directa. Este identificador puede ayudarnos a depurar el error. |
| Cadena | Combinación del código y el título del error. Por ejemplo: |
| Cadena | Producto de mensajes. En el caso de las respuestas de la API de nube, siempre será la cadena |
| Cadena | Tipo de error. |
{
"error": {
"message": "(#130429) Rate limit hit",
"type": "OAuthException",
"code": 130429,
"error_data": {
"messaging_product": "whatsapp",
"details": "Cloud API message throughput has been reached."
},
"error_subcode": 2494055,
"fbtrace_id": "Az8or2yhqkZfEZ-_4Qn_Bam"
}
}
| Código | Detalles | Razones posibles y soluciones | Código de estado HTTP |
|---|---|---|---|
AuthException | No se puede autenticar al usuario de la aplicación. | Normalmente, significa que el identificador de acceso incluido ha caducado o se ha invalidado, o que el usuario de la aplicación ha cambiado una configuración para evitar que todas las aplicaciones accedan a sus datos. Te recomendamos que obtengas un nuevo identificador de acceso. |
No autorizado |
Método de la API | Problema con una función o permisos. | Utiliza el depurador de identificadores de acceso para verificar que los permisos que necesita el extremo se hayan concedido a la aplicación. Consulta Errores de autenticación y autorización. |
Error interno del servidor |
Permiso denegado | No se ha concedido un permiso o se ha eliminado. | Utiliza el depurador de identificadores de acceso para verificar que los permisos que necesita el extremo se hayan concedido a la aplicación. Consulta Errores de autenticación y autorización. En el caso de WhatsApp Flows con extremo, asegúrate de que el número de teléfono utilizado para establecer la clave pública de la empresa esté incluido en la lista de autorizados. Comprueba los requisitos de la API a la que intentas acceder. Si no cumples los requisitos para acceder a los extremos, recibirás este código de error. |
Prohibido |
El identificador de acceso ha caducado | El identificador de acceso ha caducado. | Obtén un nuevo identificador de acceso. |
No autorizado |
Permiso de la API | No se ha concedido un permiso o se ha eliminado. | Utiliza el depurador de identificadores de acceso para verificar que los permisos que necesita el extremo se hayan concedido a la aplicación. Consulta Errores de autenticación y autorización. |
Prohibido |
| Código | Detalles | Razones posibles y soluciones | Código de estado HTTP |
|---|---|---|---|
Bloqueada temporalmente por incumplimiento de las políticas | La cuenta de WhatsApp Business asociada a la aplicación se ha restringido o desactivado por incumplir una política de la plataforma. | Consulta el documento sobre la aplicación de las políticas para obtener información sobre las infracciones de las políticas y cómo resolverlas. |
Prohibido |
Se ha restringido la capacidad de la cuenta empresarial para enviar mensajes a los usuarios en este país | Se ha restringido la capacidad de la cuenta de WhatsApp Business para enviar mensajes a usuarios en determinados países. | Consulta la Política de mensajes de WhatsApp Business para obtener más información sobre los países a los que se puede enviar mensajes con tu categoría de empresa. |
Prohibido |
La cuenta se ha bloqueado | La cuenta de WhatsApp Business asociada a la aplicación se ha restringido o desactivado por incumplir una política de la plataforma o no se han podido verificar los datos incluidos en la solicitud según los datos definidos en la cuenta de WhatsApp Business (p. ej., el PIN de la verificación en dos pasos incluido en la solicitud es incorrecto). | Consulta el documento sobre el cumplimiento de la política para obtener información sobre las infracciones de las políticas y cómo resolverlas. También puedes usar la API de estado, que puede proporcionar insights adicionales sobre el motivo o motivos del bloqueo de la cuenta. |
Prohibido |
| Error | Descripción | Posible solución |
|---|---|---|
| Un campo de la plantilla ha superado el límite máximo de caracteres permitido. | Consulta el mensaje de error para obtener más información sobre el campo afectado y sus límites de caracteres. |
| El encabezado del mensaje tiene un formato que no es válido. | Consulta el mensaje de error para obtener más información sobre el formato válido. |
| El cuerpo del mensaje tiene un formato que no es válido. | Consulta el mensaje de error para obtener más información sobre el formato válido. |
| La nota al pie del mensaje tiene un formato que no es válido. | Consulta el mensaje de error para obtener más información sobre el formato válido. |
| Esta plantilla tiene demasiadas variables para su longitud. Reduce el número de variables o aumenta la longitud del mensaje. | Consulta el mensaje de error para obtener más información sobre el formato válido. |
| Las variables no pueden encontrarse al principio ni al final de la plantilla. | Consulta el mensaje de error para obtener más información sobre el formato válido. |
| Error | Descripción | Posible solución |
|---|---|---|
| Has superado el número máximo de plantillas de mensajes que puedes tener para esta cuenta de WhatsApp Business. | Cada cuenta de WhatsApp Business puede tener un máximo de 250 plantillas de mensajes. Consulta Límites de plantillas. |
| Error | Description | Possible Solution |
|---|---|---|
| Certificate can be downloaded only after confirming ownership of a phone number that is being migrated. | In order to download the certificate and proceed with registration, register and and verify the number. |
| Two-step authentication must be disabled for this phone number. | In your WhatsApp Business Manager Settings, turn off two-step verification. |
| The phone number you are trying to migrate is already present in your WhatsApp account. | Try again with a phone number that is not already present in your WhatsApp account. |
| Phone ownership verification APIs are not available for this use case. | |
| Webhooks have not been set up for the destination WhatsApp Business account. | Subscribe your app to webhooks on the destination WhatsApp Business account. |
| This phone number is eligible to be added directly, and does not need to use phone migration APIs. | |
| The business phone number must have an approved display name ( | Get your business phone number's display name approved. |
| The source WhatsApp Business Account must be approved, and its "messaging on behalf of" must be approved. | The WhatsApp Business Account may be using the now deprecated On-Behalf-Of ownership model. Contact support. |
| Your WhatsApp account must have an active credit line in order to send messages after migration. | Set up a credit line and share it with the business customer. |
| Something went wrong when trying to migrate your phone number. | Try again after some time. If that doesn’t work, contact support. |
| The source and destination WABAs must represent the same business. | Migrate the phone number into a WhatsApp Business Account that is messaging for the same business as the source WhatsApp Business Account. |
| The destination WhatsApp Business Account must be approved before you can migrate phone numbers. | Ensure business verification is completed, and the WhatsApp Business Account review status is approved. |
| The destination WhatsApp Business Account "Messaging For" request must be approved by the client. | Ask your client to accept your "Messaging For" request in the Meta Business Suite. |
| The business phone number is in maintenance mode. | Try again in a few minutes. |
| Error | Descripción | Posible solución |
|---|---|---|
| Las insights de plantillas todavía no están disponibles para esta cuenta de WhatsApp Business. | Actualmente no puedes activar las insights de plantillas para esta cuenta de WhatsApp Business. |
| Operación no válida. Las insights de plantillas no se pueden desactivar una vez activadas. | Una vez que se activan las insights de plantillas para una cuenta de WhatsApp Business, no es posible desactivarlas. |
| No se han activado las insights de plantillas para esta cuenta de WhatsApp Business. | Para activarlas, consulta Confirmación de los análisis de plantillas. |
| Error | Descripción | Posible solución |
|---|---|---|
Insights de plantillas no disponibles | Esta cuenta de WhatsApp Business ya se ha marcado para la migración a un identificador de solución diferente. | El modelo de propiedad de cuentas en nombre de un tercero (OBO) está obsoleto. Ponte en contacto con el equipo de asistencia. |
Cuenta de WhatsApp Business no válida para la movilidad OBO | La cuenta de WhatsApp Business no cumple los requisitos para la transferencia de propiedad OBO. Puede deberse a los siguientes motivos:
| Ten en cuenta que el modelo de propiedad de cuentas en nombre de un tercero ahora está obsoleto. Ponte en contacto con el equipo de asistencia. |
| Código | Detalles | Razones posibles y soluciones | Código de estado HTTP |
|---|---|---|---|
Se ha superado el límite de solicitudes de sincronización | Has superado 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 extremo una vez para sincronizar los contactos del número de teléfono de la empresa y una vez para sincronizar el historial de mensajes. Consulta Incorporación de usuarios empresariales de la aplicación. Cancela el cliente empresarial y vuelve a incorporarlo. |
Solicitud incorrecta |
Se ha realizado una solicitud de sincronización fuera del intervalo de tiempo permitido | La solicitud de sincronización solo se puede realizar durante las 24 horas siguientes a la incorporación. | Solo puedes iniciar la sincronización de los contactos y el historial de mensajes de un usuario de la aplicación de WhatsApp Business recién incorporado durante las 24 horas siguientes a su incorporación. Consulta Incorporación de usuarios empresariales de la aplicación. Cancela el usuario y vuelve a incorporarlo. |
Solicitud incorrecta |
| Código | Detalles | Razones posibles y soluciones | Código de estado HTTP |
|---|---|---|---|
Demasiadas llamadas a la API | La aplicación ha alcanzado el límite de frecuencia de llamadas a la API. | Carga la aplicación en el panel de aplicaciones y consulta la sección Límite de frecuencia de la aplicación para verificar si ha alcanzado el límite. Si lo ha alcanzado, vuelve a intentarlo más tarde o reduce la frecuencia o la cantidad de consultas a la API que realiza la aplicación. |
Solicitud incorrecta |
Problemas de límite de frecuencia | La cuenta de WhatsApp Business ha alcanzado el límite de frecuencia. | Consulta los límites de frecuencia de la cuenta de WhatsApp Business. Vuelve a intentarlo más tarde o reduce la frecuencia o la cantidad de consultas a la API que realiza la aplicación. |
Solicitud incorrecta |
Se ha alcanzado el límite de frecuencia | Se ha alcanzado el rendimiento de los mensajes de la API de nube. | La aplicación ha alcanzado el límite de rendimiento de la API. Consulta Rendimiento. Vuelve a intentarlo más tarde o reduce la frecuencia con la que la aplicación envía mensajes. |
Solicitud incorrecta |
Se ha alcanzado el límite de frecuencia de spam | El mensaje no se pudo enviar porque hay restricciones respecto a la cantidad de mensajes que se pueden enviar desde este número de teléfono. Esto se puede deber a que muchos mensajes anteriores se bloquearon o se marcaron como spam. | Comprueba el estado de calidad en el Administrador de WhatsApp. Consulta Límites de las plantillas y Calidad de las plantillas. |
Solicitud incorrecta |
Se ha alcanzado el límite de frecuencia del par (cuenta empresarial, cuenta de consumidor) | Se han enviado demasiados mensajes desde el número de teléfono del remitente al mismo número de teléfono del destinatario en un periodo breve de tiempo. | Espera y vuelve a realizar la operación si pretendes enviar mensajes al mismo número de teléfono. No obstante, puedes enviar mensajes a un número de teléfono diferente sin tener que esperar. |
Solicitud incorrecta |
Se ha superado el límite de frecuencia de cancelación del registro de la cuenta | Se ha producido un error durante el registro o la cancelación del registro debido a demasiados intentos de este número de teléfono en un breve periodo de tiempo. | El número de teléfono de empresa se va a bloquear porque ha alcanzado el límite de intentos de registro o cancelación de registro. Inténtalo de nuevo una vez que el número esté desbloqueado. Consulta “Limitaciones” en el documento Registro. |
Solicitud incorrecta |
| Código | Detalles | Razones posibles y soluciones | Código de estado HTTP |
|---|---|---|---|
API desconocida | Solicitud no válida o posible error del servidor. | En la página Estado de la plataforma de WhatsApp Business encontrarás información sobre el estado de la API. Si no hay cortes del servidor, consulta la referencia del extremo para verificar que el formato de la solicitud sea el correcto y cumpla todos los requisitos del extremo. |
Solicitud incorrecta |
Servicio de API | Error temporal por tiempo de inactividad o sobrecarga. | En la página Estado de la plataforma de WhatsApp Business puedes consultar información sobre el estado de la API antes de volver a intentarlo. |
Servicio no disponible |
El valor del parámetro no es válido | El número de teléfono de empresa se ha eliminado. | Verifica que el número de teléfono de empresa sea correcto. |
Solicitud incorrecta |
Parámetro no válido | La solicitud incluía uno o varios parámetros mal escritos o no admitidos. | Consulta la referencia del extremo para determinar qué parámetros se admiten y cómo se escriben. En el caso de WhatsApp Flows con extremo, al establecer la clave pública de la empresa, asegúrate de que sea una clave pública válida RSA de 2048 bits en formato PEM. Comprueba que no haya discrepancias entre el identificador del número de teléfono que vas a registrar y cualquier identificador de número de teléfono que se haya almacenado previamente. Asegúrate de que el parámetro no supera ninguna restricción de longitud del tipo. |
Solicitud incorrecta |
El número del usuario forma parte de un experimento | El mensaje no se ha enviado como parte de un experimento. | Consulta Experimento de mensajes de marketing. |
Solicitud incorrecta |
Se ha producido un error | El mensaje no se pudo enviar debido a un error desconocido. | Vuelve a intentarlo. Si el error continúa, abre una solicitud de asistencia directa. En el caso de WhatsApp Flows con extremo, al establecer la clave pública de una empresa, no se ha podido calcular la firma, no se ha podido llamar al extremo de GraphQL o el extremo de GraphQL ha devuelto un error. |
Error interno del servidor |
Acceso denegado | No se ha concedido un permiso o se ha eliminado. | Utiliza el depurador de identificadores de acceso para verificar que los permisos que necesita el extremo se hayan concedido a la aplicación. Consulta Errores de autenticación y autorización. |
Prohibido |
Falta un parámetro necesario | Falta un parámetro necesario en la solicitud. | Consulta la referencia del extremo para determinar qué parámetros se necesitan. |
Solicitud incorrecta |
El valor del parámetro no es válido | El valor de uno o varios de los parámetros no es válido. | Consulta la referencia del extremo para determinar los valores que se admiten para cada parámetro y echa un vistazo a Números de teléfono para obtener información sobre cómo añadir un número de teléfono a una cuenta de WhatsApp Business. |
Solicitud incorrecta |
Servicio no disponible | Un servicio no está disponible temporalmente. | En la página Estado de la plataforma de WhatsApp Business puedes consultar información sobre el estado de la API antes de volver a intentarlo. |
Error interno del servidor |
El destinatario no puede ser el remitente | El número de teléfono del destinatario y del remitente es el mismo. | Envía un mensaje a un número de teléfono distinto al del remitente. |
Solicitud incorrecta |
El mensaje no se puede entregar | No se puede entregar el mensaje. Los motivos pueden ser algunos de los siguientes:
| Con un método de comunicación que no sea de WhatsApp, pide al usuario de WhatsApp lo siguiente:
|
Solicitud incorrecta |
El número proporcionado por WhatsApp necesita la aprobación del nombre para mostrar antes de poder enviar el mensaje | El número de teléfono de empresa 555 utilizado para enviar la solicitud no tiene un nombre para mostrar aprobado. | Cambia el nombre para mostrar del número de teléfono de empresa 555. También puedes consultar nuestro artículo del Servicio de ayuda Cómo cambiar el nombre para mostrar en WhatsApp Business. |
Solicitud incorrecta |
Problema de pago relacionado con la idoneidad de la empresa | Se ha producido un error relacionado con el método de pago. | Consulta Información sobre la facturación de tu cuenta de WhatsApp Business y verifica que hayas configurado la facturación correctamente. Problemas habituales:
|
Solicitud incorrecta |
Certificado incorrecto | El mensaje no se pudo enviar debido a un error de registro del número de teléfono. | Registra el número de teléfono antes de volver a intentarlo. |
Error interno del servidor |
Mensaje de reactivación | Han transcurrido más de 24 horas desde que el destinatario respondió por última vez al número del remitente. | Envía un mensaje de plantilla al destinatario. |
Solicitud incorrecta |
Meta ha decidido no entregarlo. | Este mensaje no se ha entregado para mantener una buena interacción en el ecosistema. | Si recibes este código de error y sospechas que se debe al límite, espera al menos 24 horas antes de volver a enviar el mensaje de plantilla. Hacerlo únicamente dará como resultado otra respuesta con error, ya que el límite puede estar activo durante diferentes intervalos de tiempo. Consulta Límites de mensajes de plantilla de marketing por usuario para obtener más información. |
Solicitud incorrecta |
El usuario ha detenido la recepción de mensajes de marketing. | No se puede entregar el mensaje. Este destinatario ha optado por dejar de recibir mensajes de marketing de tu empresa en WhatsApp. | No vuelvas a intentar enviar mensajes a este usuario porque no los recibirá. Para recibir una notificación cada vez que un usuario de WhatsApp detenga o reanude la entrega de mensajes de plantilla de marketing de tu empresa, suscríbete al webhook user_preferences. |
Solicitud incorrecta |
Tipo de mensaje no admitido | No se admite el tipo de mensaje. | En Mensajes, puedes consultar los tipos de mensajes admitidos y volver a intentarlo con uno admitido. |
Solicitud incorrecta |
Error de descarga de contenido multimedia | No se puede descargar el contenido multimedia que ha enviado el usuario. | No hemos podido descargar el contenido multimedia incluido en el mensaje del usuario de WhatsApp. Para obtener más información, consulta el valor de Pide al usuario de WhatsApp que te envíe el archivo multimedia con un método que no sea de WhatsApp. |
Solicitud incorrecta |
Error de subida de contenido multimedia | No se puede subir el contenido multimedia utilizado en el mensaje. | No hemos podido subir el contenido multimedia debido a uno o varios motivos, como un tipo de contenido multimedia no admitido. Para obtener más información, consulta el valor de Te recomendamos que revises los archivos multimedia que estén provocando errores y confirmes que efectivamente se admiten. Por ejemplo, en UNIX puedes utilizar la inspección de archivos mediante la línea de comandos para determinar el tipo MIME correspondiente:
Después, puedes confirmar si el tipo MIME se admite. Consulta Tipos de contenido multimedia admitidos. |
Solicitud incorrecta |
Cuenta en modo de mantenimiento | La cuenta empresarial está en modo de mantenimiento | La cuenta de WhatsApp Business está en modo de mantenimiento. Uno de los motivos podría ser que la cuenta se está sometiendo a una actualización de rendimiento. |
Solicitud incorrecta |
Error de coincidencia del recuento de parámetros de la plantilla | El número de valores de parámetros de variable incluidos en la solicitud no coincidía con el número de parámetros de variable definidos en la plantilla. | Consulta nuestro documento sobre plantillas para obtener información sobre los parámetros y asegurarte de que la solicitud incluye valores para todos los parámetros que requiere la plantilla. |
Solicitud incorrecta |
La plantilla no existe | La plantilla no existe en el idioma especificado o no se ha aprobado. | Asegúrate de que la plantilla se haya aprobado y de que la configuración regional de idioma y el nombre sean correctos. Consulta nuestro documento sobre plantillas para obtener más información al respecto. |
No encontrado |
El texto hidratado de la plantilla es demasiado largo | El texto traducido es demasiado largo. | Consulta el Administrador de WhatsApp para verificar que la plantilla se haya traducido. Consulta nuestro documento sobre calidad de las plantillas para obtener información sobre cómo comprobar el estado de la plantilla. |
Solicitud incorrecta |
Se infringió la política de caracteres de formato de la plantilla | El contenido de la plantilla infringe una política de WhatsApp. | Consulta nuestro documento sobre revisión de la plantilla para obtener más información sobre los posibles motivos de la infracción. |
Solicitud incorrecta |
Error de coincidencia del formato del parámetro de la plantilla | Los valores de parámetros de variable tienen un formato incorrecto. | Los valores de parámetros de variable incluidos en la solicitud no usan el formato indicado en la plantilla. Consulta nuestro documento sobre plantillas para obtener más información sobre los formatos y parámetros de las plantillas. |
Solicitud incorrecta |
La plantilla está en pausa | La plantilla está en pausa por baja calidad, por lo que no se puede enviar en un mensaje de plantilla. | Edita la plantilla para mejorar la calidad y vuelve a intentarlo una vez que se haya aprobado. |
Solicitud incorrecta |
La plantilla está desactivada | La plantilla se ha pausado demasiadas veces debido a su baja calidad, por lo que se ha desactivado permanentemente. | Crea una nueva plantilla con contenido diferente. |
Solicitud incorrecta |
El proceso está bloqueado | El proceso se encuentra en un estado bloqueado. | Corrige el proceso. |
Solicitud incorrecta |
El proceso está limitado | El proceso se encuentra en un estado limitado y ya se han enviado diez mensajes con dicho proceso en la última hora. | Corrige el proceso. |
Solicitud incorrecta |
Cancelación incompleta del registro | Se ha producido un error en un intento anterior de cancelación del registro. | Vuelve a cancelar el registro del número antes de registrarlo. |
Error interno del servidor |
Servidor no disponible temporalmente | El servidor no está disponible temporalmente. | En la página Estado de la Plataforma de WhatsApp Business puedes consultar información sobre el estado de la API y comprobar el valor de |
Servicio no disponible |
Error de coincidencia del PIN de verificación en dos pasos | El PIN de verificación en dos pasos es incorrecto. | Comprueba que el PIN de verificación en dos pasos incluido en la solicitud sea el correcto. Para restablecer el PIN, desactiva la verificación en dos pasos y, luego, establece uno nuevo. Consulta Verificación en dos pasos. |
Solicitud incorrecta |
Es necesario volver a verificar el número de teléfono | Hay que verificar el número de teléfono antes de registrarlo. |
Solicitud incorrecta | |
Demasiados intentos de averiguar el PIN de verificación en dos pasos | Se ha intentado averiguar demasiadas veces el PIN de verificación en dos pasos de este número de teléfono. | Vuelve a intentarlo una vez transcurrido el periodo de tiempo indicado en el valor de la respuesta de |
Solicitud incorrecta |
El PIN de verificación en dos pasos se ha intentado averiguar demasiado rápido | El PIN de verificación en dos pasos se ha introducido demasiado rápido. | Comprueba el valor de la respuesta de |
Solicitud incorrecta |
Número de teléfono no registrado | El número de teléfono no está registrado en la Plataforma de WhatsApp Business. | Registra el número de teléfono antes de volver a intentarlo. |
Solicitud incorrecta |
Espera unos minutos antes de intentar registrar este número de teléfono | El número de teléfono que intentas registrar se ha eliminado recientemente y la eliminación todavía no se ha completado. | Espera cinco minutos antes de volver a intentar la solicitud. |
Solicitud incorrecta |
No se han aceptado las condiciones del servicio de pagos de WhatsApp | No se ha podido enviar el mensaje porque esta cuenta de WhatsApp Business todavía no ha aceptado las condiciones del servicio de pagos de WhatsApp. | Antes de volver a intentarlo, usa el enlace del mensaje de error para aceptar las condiciones del servicio de pagos de WhatsApp. |
Solicitud incorrecta |
Error genérico de usuario | El mensaje no se pudo enviar debido a un error desconocido en los parámetros de la solicitud. | Consulta la referencia del extremo para determinar si estás consultando el extremo con la sintaxis correcta. Ponte en contacto con el servicio de atención al cliente si sigues recibiendo este código de error en la respuesta. |
Solicitud incorrecta |
La API de mensajes de marketing para WhatsApp utiliza los mismos códigos de error que la API de nube, con algunas adiciones que se indican a continuación.
{
"error": {
"message": "(#100) Invalid parameter",
"type": "OAuthException",
"code": 100,
"error_data": {
"messaging_product": "whatsapp",
"details": "Message must be a template message."
},
"fbtrace_id": "Ak6nxJSySLEJz32Ps-QiZ1t"
}
}
| Código | Mensaje | Detalles | Razones posibles y soluciones |
Código de estado HTTP |
|---|---|---|---|---|
|
|
| Estás intentando enviar un mensaje que no pertenece a una plantilla. El tipo de mensaje debe ser | 400 Solicitud incorrecta |
|
|
| Es posible que estés usando un parámetro no válido. Verifica que estás usando un parámetro válido e inténtalo de nuevo. Es posible que la sincronización de anuncios esté incompleta. Espera 10 minutos y vuelve a intentarlo. Si el problema continúa, ponte en contacto con el equipo de asistencia. | 400 Solicitud incorrecta |
|
|
| Es posible que hayas intentado enviar un mensaje que no pertenece a una plantilla, o bien una plantilla de autenticación o de utilidad. Intenta volver a enviar el mensaje con una plantilla de marketing. | 400 Solicitud incorrecta |
|
|
| Disponible a partir de la versión 23.0 de la API Graph. Estás intentando enviar una plantilla de utilidad o autenticación. Solo se admiten las plantillas categorizadas como | 400 Solicitud incorrecta |
|
|
| Disponible a partir de la versión 23.0 de la API Graph. Estás intentando enviar una plantilla recién creada antes de que se haya completado la sincronización de anuncios. La sincronización de anuncios puede tardar hasta 10 minutos. Espera 10 minutos y vuelve a intentarlo. | 400 Solicitud incorrecta |
|
|
| Disponible a partir de la versión 23.0 de la API Graph. No hemos podido completar la sincronización de anuncios para la plantilla que intentas enviar o es posible que no cumplas los requisitos para utilizar la API de mensajes de marketing para WhatsApp. Comprueba si cumples los requisitos. Si el valor | 500 Error interno del servidor |
|
|
| Las solicitudes de incorporación están limitadas a una por cliente empresarial y solo el primer socio que llame a la API de intent podrá enviar la solicitud correctamente. Cuando un cliente se incorpora, todas sus cuentas de WhatsApp Business que cumplan los requisitos se incluyen automáticamente en el proceso. Si recibes un error que indica que ya se ha realizado la solicitud de incorporación, no es necesario que hagas nada más, ya que todas las cuentas WABA que cumplan los requisitos de ese cliente se incorporarán sin tener que seguir pasos adicionales. | 400 Solicitud incorrecta |