Errores de WhatsApp Business API: qué significa cada código y cómo solucionarlo

WhatsApp Business API no funciona: comprueba primero estas cinco cosas

Cuando todos los mensajes dejan de salir a la vez, la causa casi siempre es una de cinco cosas, y puedes comprobarlas todas en unos minutos. Repásalas en este orden, porque las primeras comprobaciones afectan a todos los mensajes y la última afecta a clientes concretos.

1. 1

   Consulta la página de estado de Meta

   Abre la página de estado de la WhatsApp Business API de Meta. Si Meta informa de un problema, espera a que se resuelva antes de cambiar ajustes. Los códigos 1, 2, 131016 y 133004 apuntan a esto.
2. 2

   Comprueba el estado de tu número en Whapi

   En el panel de Whapi dentro de Shopify, tu número de WhatsApp debe mostrar un estado en verde. Meta solo envía y recibe mensajes de números con el estado Connected. Si no está conectado, haz clic en Connect WhatsApp y vuelve a conectarlo.
3. 3

   Comprueba el método de pago en Meta

   Abre WhatsApp Manager y busca un aviso de Add payment method en la página Overview. Sin un método de pago válido, los mensajes de plantilla fallan, a menudo con el error 131042. Sigue la guía del método de pago.
4. 4

   Comprueba el estado de la plantilla

   Cada automatización de Whapi envía una plantilla que Meta debe aprobar. Una plantilla que sigue en revisión, rechazada o en pausa falla con 132001, 132015 o 132016. Consulta por qué se rechazan las plantillas.
5. 5

   Comprueba el número del cliente

   Si solo a algunos clientes no les llegan los mensajes, mira el código del mensaje fallido. 131026 significa que el número no puede recibir mensajes de WhatsApp, 131047 que se cerró la ventana de 24 horas, y 131049 y 131050 afectan a los mensajes de marketing.

Errores de configuración y conexión

Los errores de configuración aparecen dentro de la ventana de registro de Meta después de hacer clic en Connect WhatsApp en Whapi. Proceden del proceso Embedded Signup de Meta, así que el texto de abajo es el de Meta, y la solución se aplica en el lado de Meta o de WhatsApp.

“Your phone number isn’t eligible to connect to the WhatsApp Business Platform”

Este es el código 3441045 de Meta (tu número de teléfono no es elegible para conectarse a la plataforma WhatsApp Business), que aparece al conectar el número de una WhatsApp Business App. La única solución que indica Meta es que hace falta más actividad en la WhatsApp Business App para determinar la elegibilidad, y no publica ningún mínimo. La guía de número de teléfono no elegible explica qué hacer y los errores de verificación relacionados.

“This number is registered to an existing WhatsApp account”

Meta muestra este mensaje (este número está registrado en una cuenta de WhatsApp existente) cuando el número ya se usa en WhatsApp Messenger, en la WhatsApp Business App o en la WhatsApp Business API. Si el número está en la WhatsApp Business App y quieres seguir usando la app, elige en su lugar Connect a WhatsApp Business App en la configuración de Whapi (esto es WhatsApp Coexistence). Para usar el número solo en la API, elimina antes la cuenta de WhatsApp en el teléfono. Meta indica que el número puede tardar hasta 3 minutos en quedar disponible.

“The business is already sharing this WhatsApp Business account with a partner”

Este es el código 2655093 (la empresa ya está compartiendo esta cuenta de WhatsApp Business con un partner). El número de tu WhatsApp Business App sigue conectado a otro proveedor, y Meta no admite cambiar de partner en este proceso. Desconecta al partner actual en la WhatsApp Business App, en Ajustes > Cuenta > Business Platform, espera 15 minutos y vuelve a conectar. La guía para mover tu número a Whapi cubre tanto los números con Coexistence como los de solo API.

La ventana emergente de Meta no se abre o se cierra a mitad

El registro de Meta se ejecuta en una ventana emergente. Haz la configuración de Whapi en un ordenador, permite las ventanas emergentes para tu panel de administración de Shopify en el navegador y recarga la página. Si Meta dice “Your Facebook account is too new to create a business account. Try again in an hour” (tu cuenta de Facebook es demasiado nueva para crear una cuenta de empresa; inténtalo de nuevo dentro de una hora), espera o inicia sesión con una cuenta de Facebook más antigua y activa. Si dice “User does not have permission to create WhatsApp Business Accounts” (el usuario no tiene permiso para crear cuentas de WhatsApp Business), necesitas acceso de administrador al portafolio de empresa que seleccionaste.

Nombre visible rechazado

Meta comprueba tu nombre visible de WhatsApp según sus pautas de nombres visibles. Si el registro dice “Your verified name violates WhatsApp guidelines. Please edit your verified name and try again” (tu nombre verificado infringe las normas de WhatsApp; edítalo e inténtalo de nuevo), revisa las pautas de nombres visibles (en inglés) e introduce un nombre que las cumpla. Puedes cambiar un nombre visible hasta 10 veces en 30 días en WhatsApp Manager, en Account tools > Phone numbers > Profile. El error 131037 solo afecta a los números de empresa 555 facilitados por Meta que no tienen un nombre visible aprobado.

Verificación de empresa y límites de números

Un portafolio de empresa nuevo puede registrar dos números de teléfono de empresa. Meta sube ese tope a 20 cuando la empresa está verificada o alcanza un límite de mensajes de 2.000. Hasta que se completa la verificación, Meta también limita cuántas cuentas de WhatsApp Business puedes crear (código 2388098). Consulta la verificación de empresa de Meta para WhatsApp para ver los documentos y los pasos.

Errores de pago y facturación

El error 131042, “There was an error related to your payment method” (ha habido un error relacionado con tu método de pago), significa que Meta no puede cobrar a la cuenta de Messaging que envía tus mensajes. La propia lista de causas de Meta incluye que no haya una cuenta de pago asociada, que una línea de crédito supere su límite, que se haya eliminado o suspendido la cuenta de WhatsApp Business, y que nunca se haya definido la zona horaria o la moneda.

Desde el 1 de octubre de 2026, la falta de método de pago también detiene los mensajes de servicio una vez agotados los 1.000 gratuitos por número de empresa al mes, y se cobran las plantillas Utility enviadas dentro de una ventana de 24 horas abierta. La entrada sobre el cambio de precios de octubre de 2026 cubre los detalles.

La guía del método de pago explica cómo añadir una tarjeta en WhatsApp Manager y los errores de tarjeta que muestra Meta, como “Couldn’t save payment method” (no se pudo guardar el método de pago). Los precios de los mensajes por país están en la página de precios de WhatsApp API.

Errores de entrega de mensajes

Los errores de entrega afectan a un cliente o a un mensaje cada vez, así que el resto de tus mensajes siguen saliendo. Trátalos como información sobre ese cliente y evita reintentar el mismo mensaje una y otra vez.

131026: mensaje no entregable

Meta da tres motivos: el número no es un número de WhatsApp, el cliente no ha aceptado las últimas Condiciones del servicio de WhatsApp o la app del cliente es anterior a la versión mínima que admite Meta. Si falla una confirmación de pedido, llama o escribe al cliente por otra vía. La guía del error 131026 enumera las comprobaciones.

131047: ventana de 24 horas cerrada

Las respuestas libres solo se permiten dentro de las 24 horas posteriores al último mensaje del cliente. Pasado ese plazo, envía una plantilla aprobada. Más información sobre el error 131047 y la ventana de atención al cliente.

131049 y 131050: mensajes de marketing retenidos

131049 significa que Meta limitó las plantillas de marketing a ese cliente “to maintain healthy ecosystem engagement” (para mantener una interacción saludable en el ecosistema); espera al menos 24 horas antes de volver a enviarlo. 131050 significa que el cliente decidió dejar de recibir mensajes de marketing de tu empresa, así que no lo reintentes. Ambos afectan a las plantillas de marketing. Consulta la guía del error 131049.

130429 y 131056: envío demasiado rápido

130429 significa que se alcanzó el rendimiento de mensajes del número; vuelve a intentarlo más tarde. 131056 significa que llegaron demasiados mensajes al mismo cliente en poco tiempo; espera antes de volver a escribirle, mientras que los demás clientes no se ven afectados.

131021: prueba enviada a tu propio número de empresa

Meta no entrega un mensaje de un número a sí mismo. Cuando uses Send Test Message en Whapi, introduce un número de WhatsApp personal distinto del número de empresa.

Errores de plantillas

Los errores de plantillas significan que Meta no ha aprobado la plantilla, que las variables del mensaje no coinciden con ella o que Meta la pausó porque los clientes la bloquearon o la denunciaron. Whapi envía las plantillas a Meta cuando configuras una automatización, y Meta decide la categoría y la aprobación.

• 132001: la plantilla no existe en ese idioma o no está aprobada. Comprueba su estado en Whapi o en WhatsApp Manager.
• 132000 y 132012: las variables enviadas no coinciden con el número o el formato de la plantilla. Haz que coincidan o envía al soporte de Whapi el nombre de la automatización.
• 132005: una traducción es demasiado larga. Acorta esa versión de idioma.
• 132007: el contenido infringe una política de WhatsApp. Consulta por qué Meta rechaza plantillas.
• 132015 y 132016: en pausa por baja calidad y desactivada de forma permanente tras pausas repetidas. Edita una plantilla en pausa; sustituye una desactivada por contenido nuevo.
• 131064: la cuenta alcanzó un límite de mensajes por infracciones de clasificación de plantillas. Asegúrate de que las novedades de pedidos se redacten como Utility y las promociones como Marketing. La guía de Utility y Marketing explica la diferencia.
• 2388019: la cuenta ya tiene el máximo de 250 plantillas. Elimina las que ya no uses.
• Plantilla recategorizada como Marketing: no hay código de error para esto. Desde el 9 de abril de 2025, una plantilla enviada como Utility que Meta considera de marketing se aprueba como Marketing, y Meta también puede cambiar más adelante la categoría de una plantilla aprobada. El contenido mixto, como una novedad del pedido con un código de descuento, cuenta como Marketing. Puedes solicitar una revisión en los 60 días siguientes al cambio de categoría.

Valoración de calidad, límites de mensajes y restricciones de cuenta

Meta reduce los límites o restringe un número cuando los clientes bloquean o denuncian sus mensajes, o cuando la empresa infringe una política de WhatsApp Business. Whapi usa la WhatsApp Business API oficial de Meta, lo que evita los bloqueos que provocan las herramientas no oficiales basadas en WhatsApp Web, pero Meta aún puede limitar cualquier número que incumpla sus políticas.

Límites de mensajes

Un límite de mensajes fija a cuántos clientes únicos puedes escribir fuera de una ventana de atención al cliente en un periodo móvil de 24 horas. Se establece por portafolio de empresa y lo comparten todos sus números. Los portafolios nuevos empiezan en 250. Para llegar a 2.000, verifica tu empresa o envía 2.000 mensajes entregados fuera de las ventanas de servicio a clientes únicos en 30 días con plantillas de alta calidad. Después, Meta sube el límite automáticamente a 10.000, 100.000 e ilimitado cuando la calidad se mantiene alta y usas al menos la mitad de tu límite actual en 7 días. Consulta el tuyo en WhatsApp Manager, en Account tools > Messaging limits.

131048, 368 y 131031: envío o cuentas restringidos

131048 significa que el envío desde el número está restringido porque demasiados mensajes anteriores fueron bloqueados o marcados como spam; revisa el estado de calidad en WhatsApp Manager. Los códigos 368 y 131031 significan que la cuenta fue restringida o desactivada por una infracción de las políticas. Lee el aviso en Business Support Home y apela allí si crees que es un error. El código 130497 significa que la categoría de tu empresa no puede escribir a clientes de ciertos países.

Mantén sana tu valoración de calidad

• Escribe solo a clientes que te hayan comprado o hayan dado su opt-in.
• Envía las novedades de pedidos, como las confirmaciones de pedido, como plantillas Utility y deja las promociones en plantillas Marketing.
• Mantén el marketing relevante y poco frecuente, y facilita la baja.

Coexistence, llamadas, Flows y nombres de usuario

Estos errores proceden de funciones más recientes de WhatsApp. La mayoría de las tiendas solo se los encuentran al conectar el número de una WhatsApp Business App o al probar una función que Meta todavía está desplegando.

Coexistence: errores de emparejamiento y listas de difusión

Coexistence conecta el número de tu WhatsApp Business App a la API para que puedas seguir chateando desde tu teléfono mientras Whapi envía automatizaciones. Meta desactiva las listas de difusión de la app cuando conectas, y las listas existentes pasan a ser de solo lectura. “Error while pairing Cloud API” (error al emparejar Cloud API) y los demás errores de emparejamiento, el historial de chats que falta y las desconexiones se tratan en Coexistence de WhatsApp no funciona.

“Calling APIs cannot be enabled for this phone number”

El error 138015 de Meta (las API de llamadas no se pueden activar para este número de teléfono) significa que las llamadas de WhatsApp Business todavía no se pueden activar en ese número. La solución de Meta es asegurarse de que el límite de mensajes del número sea de 2.000 o más. Usa los pasos de límites de mensajes de arriba para llegar a ello.

WhatsApp Flows: “Blocked By Integrity”

El error 139000 (bloqueado por integridad) significa que Meta identificó un problema de integridad en la cuenta que impide crear o publicar un Flow. Revisa en Business Support Home las restricciones de la empresa y contacta con el soporte de Meta, que es la única vía que da Meta para este código.

ID de usuario de ámbito empresarial (BSUID)

WhatsApp está añadiendo nombres de usuario opcionales, así que Meta ahora también identifica a los clientes con un ID de usuario de ámbito empresarial (BSUID) único para cada portafolio de empresa. Algunos tipos de mensaje no se pueden dirigir a un BSUID, y Meta devuelve 131062, “Business-scoped User ID (BSUID) recipients are not supported for this message.” (los destinatarios con BSUID no se admiten para este mensaje). Enviar al número de teléfono del cliente lo evita. Los pedidos de Shopify llevan el número de teléfono, que es el que usan las automatizaciones de pedidos.

Caídas de Meta y acceso caducado

Los códigos 2, 131016 y 133004 significan que el servicio de Meta está sobrecargado o no disponible un momento, así que la solución es esperar y reintentar. El código 1 puede ser un error del servidor o una solicitud mal formada, y el consejo de Meta para los cuatro es consultar primero metastatus.com. 131000 es un error desconocido; reintenta una vez y repórtalo si se repite.

Los códigos 0 y 190 significan que el token de acceso que permite a Whapi enviar en nombre de tu cuenta caducó o se invalidó. Meta también indica como causa un ajuste de usuario que impide que cualquier app acceda a sus datos. Los códigos 10 y del 200 al 299 significan que se retiró un permiso. En todos los casos, vuelve a conectar WhatsApp desde el panel de Whapi para que Meta emita un acceso nuevo.

Cómo obtener ayuda con un error de WhatsApp API

Envía primero el código de error, porque le indica al soporte dónde mirar. El soporte de Whapi responde por correo electrónico en info@usewhapi.com y por WhatsApp. Incluye:

• el código de error y el mensaje de Meta, o una captura de pantalla;
• la fecha y la hora a la que ocurrió, con tu zona horaria;
• el número de pedido de Shopify o la automatización que falló;
• si fallan todos los mensajes o solo los de algunos clientes.

Para problemas de cuenta, facturación o políticas que solo Meta puede resolver, abre un ticket en Meta Direct Support. Para problemas con la tarjeta, Meta pide elegir el tema “Dev: Billing, Credit & Pricing” y el tipo de solicitud “Credit Card Billing”. Si no ves ese tema, Meta dice que pidas a tu proveedor que abra el ticket, así que escríbenos y lo abriremos nosotros. También puedes contactarnos desde la página de contacto.