nvíe por WhatsApp cuando el destinatario haya dado su consentimiento para recibir comunicaciones por ese medio y tenga una cuenta WhatsApp activa; en cualquier otro caso, envíe por SMS o active el fallback a SMS. En la pasarela Cloud API de WhatsApp, un mensaje a un número que no puede recibirlo fallará con el error 131026, y solo podrá saberlo a través del webhook de estado, no de la respuesta de envío. El patrón fiable consiste en registrar el consentimiento de canal de cada cliente al momento del opt-in, verificar lo que legalmente sea posible antes de enviar y permitir que un estado de WhatsApp fallido active un SMS. BroadNet gestiona ambos canales bajo una única pasarela omnicanal API con reglas de fallback explícitas.
Conclusiones clave
- El error 131026 significa que Meta no pudo entregar el mensaje. Meta enumera tres posibles motivos: el número no es un número WhatsApp, el destinatario no ha aceptado los últimos términos o el destinatario utiliza una versión antigua de WhatsApp.
- Una respuesta API exitosa solo significa que la solicitud fue aceptada. La entrega se informa más tarde mediante el webhook de estado: enviado, entregado, leído o fallido, con un array de errores en caso de fallo.
- Tener una cuenta WhatsApp no es un permiso para enviar mensajes a alguien: la política de Meta requiere el número de la persona y su consentimiento para recibir comunicaciones suyas.
- Fuera de la ventana de 24 horas de atención al cliente, WhatsApp solo acepta mensajes de plantilla (de lo contrario, error 131047).
- El tipo de línea es el primer filtro: un SMS a un número de línea fija o gratuito suele fallar y, aun así, genera el coste del mensaje.
- El fallback funciona mejor como una regla en la plataforma de envío: WhatsApp primero si el cliente lo eligió, SMS ante un estado de fallo o si no hay consentimiento de WhatsApp.
¿Qué significa el error 131026 de WhatsApp?
En la referencia de errores de la API de Cloud de Meta, 131026 es "No se pudo entregar el mensaje". Meta indica tres posibles motivos: "El número de teléfono del destinatario no es un número WhatsApp", el destinatario "no ha aceptado las nuevas Condiciones de servicio y la Política de privacidad", o el destinatario "está utilizando una versión antigua de WhatsApp". La solución sugerida por Meta es pedir a la persona, "utilizando un método de comunicación que no sea WhatsApp", que confirme que puede enviar mensajes a su número de empresa, que acepte los términos más recientes o que actualice la aplicación.
En otras palabras, 131026 es una señal de enrutamiento, no un error en su código. Para una contraseña de un solo uso, un aviso de entrega o un recordatorio de cita, el método ajeno a WhatsApp al que se refiere Meta suele ser SMS, y debería enviarse automáticamente en lugar de tras abrir un ticket de soporte.
¿Por qué un ID de mensaje no significa que el mensaje haya sido entregado?
El envío es asíncrono. La API acepta la solicitud y devuelve un ID de mensaje; lo que sucede después llega a través de su webhook. El webhook de estado de mensaje de Meta informa estos valores:
| Estado | Descripción de Meta | Qué hacer |
|---|---|---|
| enviado | El mensaje se envió correctamente desde los servidores de Meta | Esperar a que se entregue o falle |
| entregado | El mensaje se entregó correctamente al dispositivo del usuario WhatsApp | Sin necesidad de ruta de respaldo |
| leído | El mensaje se mostró en un hilo de chat abierto en el dispositivo del usuario | Sin necesidad de ruta de respaldo |
| fallido | Error al enviar o entregar el mensaje al dispositivo del usuario | Leído errors[].code; recurrir a SMS para mensajes con tiempo limitado |
Un estado de error incluye un array de errores con un código numérico, un título, un campo de detalles y un enlace a la referencia del error. Registre el código con el mensaje: este le indicará si debe reintentar, cambiar de canal o corregir una plantilla. La misma lógica se aplica a SMS, donde la confirmación de entrega (DLR) del operador actúa como el webhook de estado.
¿Puede enviar mensajes a alguien en WhatsApp solo porque tiene una cuenta?
No. La Política de Mensajería de WhatsApp Business establece que "solo puede contactar a las personas en WhatsApp si: (a) le han proporcionado su número de teléfono móvil o nombre de usuario; y (b) ha recibido el consentimiento del destinatario confirmando que desea recibir mensajes o llamadas posteriores de su parte". También debe respetar cualquier solicitud, dentro o fuera de WhatsApp, para darse de baja.
Por tanto, la elección del canal comienza con el consentimiento, no en el momento del envío. Pregunte a los clientes qué canales aceptan, guarde esa elección con una marca de tiempo y envíe mensajes únicamente por los canales que hayan aceptado. La legislación local añade sus propias reglas: consulte nuestra guía sobre el PDPL de los EAU para marketing de SMS y WhatsApp para ver un ejemplo.
¿Qué ocurre con la ventana de 24 horas y el error 131047?
Un mensaje WhatsApp de formato libre solo se permite dentro de las 24 horas posteriores al último mensaje del cliente hacia usted. Fuera de ese plazo, la API de Cloud devuelve 131047, "Han pasado más de 24 horas desde la última respuesta del destinatario al número del remitente", y la solución de Meta es "enviar al destinatario un mensaje de plantilla en su lugar". Consulte qué es la ventana de 24 horas de la WhatsApp.
Para el diseño de contingencia (fallback), esto significa dos fallos distintos: el 131047 se resuelve cambiando a una plantilla aprobada en WhatsApp, mientras que el 131026 se resuelve cambiando de canal. Trátelos de forma diferente en su lógica de reintento.
¿Qué canal debería utilizar primero?
No hay una única respuesta por mercado; depende del mensaje y de lo que cada cliente haya aceptado. Un conjunto de reglas por destinatario cubre la mayoría de los casos:
| Situación | Primer canal | Alternativa |
|---|---|---|
| El cliente dio su consentimiento para WhatsApp y le ha enviado mensajes anteriormente | WhatsApp (plantilla fuera del periodo de 24 horas) | SMS en caso de error en el estado |
| El cliente dio su consentimiento para WhatsApp, sin historial previo | Plantilla de WhatsApp | SMS en caso de error en el estado o sin estado dentro de su límite de tiempo |
| No se registró el consentimiento para WhatsApp | SMS | Voz para OTP cuando esté disponible |
| El mensaje WhatsApp anterior falló con 131026 | SMS | Pida al cliente que confirme su WhatsApp en el próximo contacto |
| El número es de línea fija o gratuito | No es SMS: suele fallar | Llamada de voz o solicitar un número móvil |
| El cliente dio su consentimiento para RCS, Telegram o Viber | Ese canal a través del cual puede realizar el envío | SMS |
Para la vista por mercado (donde predominan WhatsApp, RCS o SMS), consulte nuestra guía de canales SMS vs WhatsApp vs RCS.
¿Qué puede verificar antes de realizar el envío?
La primera comprobación no tiene que ver con las aplicaciones: es el tipo de línea. Un SMS a un número fijo o gratuito suele fallar y, aun así, genera el coste del mensaje. MobileValidate, una marca BroadNet en vista previa privada, devuelve el tipo de línea, el operador actual y, en caso de portabilidad, el operador original; la búsqueda HLR de BroadNet añade el estado de la red en tiempo real, indicándole si la línea está alcanzable en este momento.
Para los clientes que han dado su consentimiento para otros canales, MobileValidate también puede verificar en tiempo real si su número está registrado en Telegram, Viber o Zalo, y en procesos por lotes en Signal, iMessage, RCS, LINE o Botim; la comprobación RCS informa de la plataforma del terminal cuando está disponible. Su política de uso aceptable limita estas comprobaciones a la prevención de fraude y a la selección de canales para contactos que han dado su consentimiento. La lista completa de comprobaciones se encuentra en mobilevalidate.com. MobileValidate es un servicio independiente, no afiliado, respaldado ni patrocinado por las plataformas que consulta; sus nombres se utilizan únicamente para describir qué abarca cada comprobación.
Para WhatsApp en sí, las señales fiables son las que le proporciona Meta: el propio consentimiento del cliente, sus respuestas y el estado de entrega o fallo de su último mensaje. Almacene el último resultado de WhatsApp por cliente y deje que este guíe el siguiente envío.
¿Cómo gestiona BroadNet la alternativa de respaldo (fallback)?
BroadNet es un proveedor oficial de soluciones empresariales de Meta y gestiona WhatsApp Business API, SMS, RCS y voz en una sola plataforma. La API omnicanal recibe una única solicitud con reglas de fallback explícitas a través de SMS, WhatsApp, RCS y voz, y devuelve recibos unificados, de modo que un estado de fallo en WhatsApp se convierte en un SMS sin necesidad de código adicional en su aplicación.
- Para contraseñas de un solo uso, la API de OTP realiza envíos con fallback automático a través de SMS, WhatsApp, voz y Flash Call; MyOTP.App cubre SMS, WhatsApp y Telegram desde una sola cuenta.
- Establezca un límite de tiempo para mensajes urgentes: si no se recibe ni la confirmación de entrega ni la de fallo a tiempo, envíe el mensaje de respaldo (fallback).
- Mantenga plantillas aprobadas para cada tipo de mensaje que pueda necesitar fuera de la ventana de 24 horas.
- Suprima un canal para un cliente tras 131026 hasta que lo confirme de nuevo, para evitar pagar por fallos repetidos.
Para conocer más patrones, lea nuestra estrategia de conmutación por error multicanal.
¿Cómo es una lista de verificación de enrutamiento por destinatario?
- Al realizar el opt-in, registre qué canales acepta el cliente, junto con la fecha y el texto exacto con el que aceptó.
- Compruebe el tipo de línea de los nuevos números y solicite un número móvil cuando se trate de una línea fija o gratuita.
- Seleccione el primer canal basado en el consentimiento y el historial del cliente, no solo por el valor predeterminado del país.
- Fuera de la ventana de 24 horas, envíe únicamente plantillas WhatsApp.
- Escuche los webhooks de estado y las confirmaciones de entrega; trate los fallos y los tiempos de espera agotados como activadores de respaldo.
- Utilice SMS como respaldo para mensajes con tiempo limitado y registre el código de error WhatsApp junto con el mensaje.
- Revise los fallos semanalmente: un aumento de 131026 en un segmento suele indicar números obsoletos o falta de consentimiento.
Preguntas frecuentes
¿Qué significa el error WhatsApp 131026?
"No se pudo entregar el mensaje". Meta indica tres posibles motivos: el número no es un número WhatsApp, el destinatario no ha aceptado las últimas Condiciones del servicio y la Política de privacidad, o el destinatario utiliza una versión antigua de WhatsApp.
¿Debo reintentar el envío de un mensaje que falló con 131026?
No lo haga en WhatsApp de inmediato. En su lugar, envíe el contenido urgente a través de SMS y solicite al cliente que confirme su número de WhatsApp mediante otro canal.
¿Una respuesta 200 de la API de WhatsApp significa que el mensaje se entregó?
No. Significa que la solicitud fue aceptada. El webhook de estado informará la entrega como enviada, entregada, leída o fallida.
¿Puedo enviar mensajes a un cliente por WhatsApp si sé que tiene una cuenta?
No. La política de Meta exige que la persona le haya facilitado su número y haya dado su consentimiento para recibir mensajes de su empresa a través de WhatsApp.
¿Qué es el error 131047?
Han pasado más de 24 horas desde la última respuesta del cliente. Envíe un mensaje de plantilla aprobado en lugar de un mensaje de texto libre.
¿Qué canal debe ser el de respaldo para WhatsApp?
SMS en la mayoría de los casos, ya que llega a cualquier número móvil. Para contraseñas de un solo uso, la voz es un respaldo adicional donde la plataforma lo permita.
¿Puedo verificar un número antes de realizar el envío?
Sí, siempre que se cumpla su base legal. Primero verifique el tipo de línea; para clientes que han dado su consentimiento, MobileValidate puede verificar el registro en aplicaciones como Telegram, Viber y RCS, y el HLR Lookup de BroadNet proporciona el estado de la red en tiempo real.
¿Cómo envía BroadNet el respaldo de SMS?
La API Omnicanal aplica sus reglas de respaldo en una sola solicitud, y la API OTP realiza el cambio automático entre SMS, WhatsApp, voz y Flash Call.
Consultamos todas las fuentes a continuación el 27 de septiembre de 2026. Consulte nuestros estándares editoriales.
Fuentes
- Meta para desarrolladores — códigos de error API de WhatsApp Cloud (131026, 131047), consultado el 27 de septiembre de 2026: developers.facebook.com.
- Meta para desarrolladores — referencia de webhook de estado de mensajes, consultado el 27 de septiembre de 2026: developers.facebook.com.
- Política de mensajería de WhatsApp Business — requisitos de consentimiento y baja, consultado el 27 de septiembre de 2026: whatsappbusiness.com/policy.
- MobileValidate — referencia de servicios y búsqueda de operador, última actualización el 25 de septiembre de 2026: mobilevalidate.com/docs/services, mobilevalidate.com/services/carrier-lookup.
- MobileValidate — política de uso aceptable, consultado el 27 de septiembre de 2026: mobilevalidate.com/legal/acceptable-use.