Códigos de error

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.

Webhooks y sintaxis de la respuesta de error

Los errores de la API de nube pueden aparecer en los siguientes objetos de webhooks:

  • entry.changes.value.errors
  • entry.changes.value.messages.errors

Sintaxis 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>" } } 

Contenido de la respuesta de error

Propiedad Tipo de valor Descripción

code

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.

details

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.

error_subcode

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 code y las propiedades de details.

fbtrace_id

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.

message

Cadena

Combinación del código y el título del error. Por ejemplo: (#130429) Rate limit hit.

messaging_product

Cadena

Producto de mensajes. En el caso de las respuestas de la API de nube, siempre será la cadena whatsapp.

type

Cadena

Tipo de error.

Ejemplo de respuesta

{
  "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"
  }
}

Errores de autorización

Código Detalles Razones posibles y soluciones Código de estado HTTP

0

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.

401

No autorizado

3

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.

500

Error interno del servidor

10

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.

403

Prohibido

190

El identificador de acceso ha caducado

El identificador de acceso ha caducado.

Obtén un nuevo identificador de acceso.

401

No autorizado

200-299

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.

403

Prohibido

Errores de integridad

Código Detalles Razones posibles y soluciones Código de estado HTTP

368

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.

403

Prohibido

130497

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.

403

Prohibido

131031

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.

403

Prohibido

Errores de creación de plantillas

ErrorDescripciónPosible solución

2388040: se ha superado el límite de caracteres.

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.

2388047: el formato del encabezado del mensaje es incorrecto.

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.

2388072: el formato del cuerpo del mensaje es incorrecto.

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.

2388073: el formato de la nota al pie del mensaje es incorrecto.

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.

2388293: la proporción de palabras de los parámetros supera el límite.

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.

2388299: no se permiten parámetros iniciales o finales.

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.

Errores al enviar plantillas

ErrorDescripciónPosible solución

2388019: se ha superado el límite de plantillas de mensajes.

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.

Errores de migración del número de teléfono

ErrorDescriptionPossible Solution

2388001 - Please confirm ownership of this phone number.

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.

2388001 - Please ensure two-step authentication is disabled.

Two-step authentication must be disabled for this phone number.

In your WhatsApp Business Manager Settings, turn off two-step verification.

2388012 - This phone number already exists in your list of phone numbers.

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.

2388091, 2388093 - This phone number isn’t eligible to receive/verify a registration code since it is not being migrated.

Phone ownership verification APIs are not available for this use case.

Register and verify the number.

2388103 - Cannot migrate phone number.

Webhooks have not been set up for the destination WhatsApp Business account.

Subscribe your app to webhooks on the destination WhatsApp Business account.

2388103 - Please add this phone number in your WhatsApp account

This phone number is eligible to be added directly, and does not need to use phone migration APIs.

Register and verify the number.

2388103 - Registered name should be present and approved.

The business phone number must have an approved display name (name_status is APPROVED) and cannot have any associated pending display name change requests.

Get your business phone number's display name approved.

2388103 - The WhatsApp account that this phone number is registered with is not set up correctly.

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.

2388103 - Your WhatsApp account does not have a payment account.

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.

2388103 - There was an error migrating this phone number.

Something went wrong when trying to migrate your phone number.

Try again after some time. If that doesn’t work, contact support.

2388103 - This phone number belongs to a different Business Manager account.

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.

2388103 - Your WhatsApp account must be approved

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.

2388103 - Your WhatsApp account’s "Messaging For" request must be 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.

2494100 - Account is in maintenance mode.

The business phone number is in maintenance mode.

Try again in a few minutes.

Errores de insights de plantillas

ErrorDescripciónPosible solución

200005: las insights de plantillas no estás disponibles.

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.

200006: no se pueden desactivar las insights de plantillas.

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.

200007: las insights de plantillas no están activadas.

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.

Errores de la cuenta de WhatsApp Business

ErrorDescripciónPosible solución

2593079

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.

2593085

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:

  • La cuenta de WhatsApp Business ya es propiedad del cliente empresarial (es decir, ya usa el modelo de uso compartido de cuentas de WhatsApp Business).
  • El cliente empresarial todavía no ha aceptado la solicitud OBO en Meta Business Suite.

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.

Errores de sincronización

Código Detalles Razones posibles y soluciones Código de estado HTTP

2593107

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.

400

Solicitud incorrecta

2593108

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.

400

Solicitud incorrecta

Errores de restricción

Código Detalles Razones posibles y soluciones Código de estado HTTP

4

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.

400

Solicitud incorrecta

80007

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.

400

Solicitud incorrecta

130429

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.

400

Solicitud incorrecta

131048

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.

400

Solicitud incorrecta

131056

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.

400

Solicitud incorrecta

133016

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.

400

Solicitud incorrecta

Otros errores

Código Detalles Razones posibles y soluciones Código de estado HTTP

1

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.

400

Solicitud incorrecta

2

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.

503

Servicio no disponible

33

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.

400

Solicitud incorrecta

100

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.

400

Solicitud incorrecta

130472

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.

400

Solicitud incorrecta

131000

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.

500

Error interno del servidor

131005

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.

403

Prohibido

131008

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.

400

Solicitud incorrecta

131009

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.

400

Solicitud incorrecta

131016

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.

500

Error interno del servidor

131021

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.

400

Solicitud incorrecta

131026

El mensaje no se puede entregar

No se puede entregar el mensaje. Los motivos pueden ser algunos de los siguientes:

  • El número de teléfono del destinatario no es un número de teléfono de WhatsApp.
  • El destinatario no ha aceptado nuestras nuevas Condiciones del servicio y Política de privacidad.
  • El destinatario utiliza una versión antigua de WhatsApp; debe usar la siguiente versión de WhatsApp o una posterior:
    • 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

Con un método de comunicación que no sea de WhatsApp, pide al usuario de WhatsApp lo siguiente:

  • Debe confirmar que realmente puede enviar un mensaje a tu número de teléfono de empresa de WhatsApp.
  • Debe confirmar que ha aceptado nuestras Condiciones del servicio más recientes (en Configuración > Ayuda o Configuración > Información de la aplicación, tendrá que aceptar las condiciones o políticas más recientes si todavía no lo ha hecho).
  • Debe actualizar a la versión más reciente del cliente de WhatsApp.

400

Solicitud incorrecta

131037

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.

400

Solicitud incorrecta

131042

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:

  • La cuenta de pago no está vinculada a ninguna cuenta de WhatsApp Business.
  • La línea de crédito es superior al límite.
  • La línea de crédito (cuenta de pago) no está establecida o no está activa.
  • La cuenta de WhatsApp Business se ha eliminado.
  • La cuenta de WhatsApp Business se ha suspendido.
  • La zona horaria no está establecida.
  • La divisa no está establecida.
  • La solicitud MessagingFor (en nombre de) está pendiente o se ha rechazado.

400

Solicitud incorrecta

131045

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.

500

Error interno del servidor

131047

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.

400

Solicitud incorrecta

131049

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.

400

Solicitud incorrecta

131050

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.

400

Solicitud incorrecta

131051

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.

400

Solicitud incorrecta

131052

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 error.error_data.details en los webhooks de mensajes activados al recibir este mensaje.

Pide al usuario de WhatsApp que te envíe el archivo multimedia con un método que no sea de WhatsApp.

400

Solicitud incorrecta

131053

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 error.error_data.details en los webhooks de mensajes activados al no poder enviar el mensaje.

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:

file -I rejected-file.mov

Después, puedes confirmar si el tipo MIME se admite. Consulta Tipos de contenido multimedia admitidos.

400

Solicitud incorrecta

131057

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.

500

Solicitud incorrecta

132000

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.

400

Solicitud incorrecta

132001

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.

404

No encontrado

132005

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.

400

Solicitud incorrecta

132007

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.

400

Solicitud incorrecta

132012

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.

400

Solicitud incorrecta

132015

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.

400

Solicitud incorrecta

132016

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.

400

Solicitud incorrecta

132068

El proceso está bloqueado

El proceso se encuentra en un estado bloqueado.

Corrige el proceso.

400

Solicitud incorrecta

132069

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.

400

Solicitud incorrecta

133000

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.

500

Error interno del servidor

133004

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 details de la respuesta antes de volver a intentarlo.

503

Servicio no disponible

133005

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.

400

Solicitud incorrecta

133006

Es necesario volver a verificar el número de teléfono

Hay que verificar el número de teléfono antes de registrarlo.

Verificar y registrar el número de teléfono.

400

Solicitud incorrecta

133008

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 details.

400

Solicitud incorrecta

133009

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 details antes de volver a intentarlo.

400

Solicitud incorrecta

133010

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.

400

Solicitud incorrecta

133015

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.

400

Solicitud incorrecta

134011

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.

400

Solicitud incorrecta

135000

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.

400

Solicitud incorrecta

Códigos de error de la API de mensajes de marketing para WhatsApp

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.

Ejemplo

{
  "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ódigos

CódigoMensajeDetallesRazones posibles y soluciones Código de estado
HTTP

100

(#100) Invalid parameter

Message must be a template message.

Estás intentando enviar un mensaje que no pertenece a una plantilla. El tipo de mensaje debe ser template. Vuelve a intentarlo con una plantilla de marketing.

400 Solicitud incorrecta

131009

(#131009) Parameter value is not valid

One or more parameter values are invalid.

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

131055

(#131055) Method not allowed

Only marketing template messages are supported

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

134100

(#134100) Only marketing messages supported

You're only able to send marketing messages on this API.

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 MARKETING.

400 Solicitud incorrecta

134101

(#134101) Your template is still syncing

When you send a message from a template, the template syncing process can take up to 10 minutes to complete. Wait a few minutes, and then try sending your message again.

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

134102

(#134102) Template unavailable for use

Please check your eligibility status to ensure you are onboarded (https://developers.facebook.com/docs/whatsapp/marketing-messages-api-for-whatsapp/onboarding#ensure-you-are-eligible-to-onboard) or contact Meta's customer support.

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 marketing_messages_lite_api_status de la cuenta de WhatsApp Business es ONBOARDED y el problema persiste, ponte en contacto con el equipo de asistencia.

500 Error interno del servidor

1752041

(#1752041) Duplicate Request

Duplicate Request is thrown when a client has already been invited to onboard by any partner.

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