Número bloqueado en la API de WhatsApp: cómo evitarlo y qué hacer si te restringen

Actualizado el 29/10/2026

En la API oficial de WhatsApp, Meta rara vez da de baja un número sin pasos previos: el proceso descrito en la documentación empieza con una advertencia, pasa por bloqueos temporales de envío (de 1 a 30 días), llega al bloqueo por tiempo indefinido y solo al final a la desactivación, salvo en casos graves, como estafas, explotación infantil y venta de drogas ilegales, que se eliminan de inmediato. Para evitarlo, recoge un opt-in claro con el nombre de la empresa, envía solo lo que el usuario espera, respeta las solicitudes para dejar de recibir mensajes y sigue la calidad. Si la cuenta es restringida, revisa el motivo en el Business Support Home y pide una revisión cuando corresponda.

Esta guía muestra cómo Meta aplica las medidas, las señales que llevan a ellas, cómo monitorearlas por API y qué hacer en cada situación.

Bloqueo, restricción y límite no son lo mismo

Cuando alguien dice «me bloquearon el número», puede estar hablando de cosas muy distintas:

Situación	Qué pasa	Cómo lo notas
Plantilla pausada	Una plantilla de baja calidad queda fuera de servicio 3 h, luego 6 h; la tercera vez se desactiva	Error 132015 o 132016; webhook message_template_status_update
Límite de mensajes alcanzado	El portafolio llegó al tope de usuarios únicos en 24 horas	Los envíos fuera de la ventana se detienen hasta que se libere el período
Restricción de envío del número	Meta restringe cuántos mensajes puede enviar el número, por ejemplo porque demasiados mensajes anteriores fueron bloqueados o marcados como spam	Error 131048
Restricción de cuenta	Bloqueo temporal de plantillas o de cualquier mensaje, por infracción de la política	Webhook account_update con ACCOUNT_RESTRICTION; error 368
Bloqueo indefinido o desactivación	Cuenta impedida de enviar hasta una apelación, o eliminada de la plataforma	Webhook account_update con DISABLED_UPDATE; aviso en el Business Support Home
El usuario bloqueó a la empresa	Solo ese contacto deja de recibir	Señal negativa que pesa en la calidad

La restricción de cuenta y la desactivación son medidas de aplicación de la política. La pausa de plantilla, el límite de mensajes y la restricción de envío del número suelen resolverse ajustando público, volumen y contenido; el artículo sobre límite de mensajes de la API de WhatsApp trata de ellos.

Cómo aplica Meta las medidas

La documentación de aplicación de políticas describe una escala. En la primera infracción, la cuenta recibe una advertencia con la política infringida. Si las infracciones se repiten (spam, plantillas en la categoría equivocada, sectores de alto riesgo), llegan restricciones que aumentan gradualmente de duración:

1. Bloqueo de 1 o 3 días para enviar plantillas de marketing, utilidad y autenticación y para agregar números.
2. Bloqueo de 5, 7 o 30 días para enviar cualquier mensaje y para agregar números.
3. Bloqueo de la cuenta por tiempo indefinido, que solo se levanta con una apelación.
4. Desactivación permanente de la plataforma, si nada cambia después de varias advertencias.

Las infracciones que causan daño grave a los usuarios, como explotación infantil, estafas, terrorismo o venta de drogas ilegales, llevan a la eliminación inmediata. Meta también indica que puede limitar o eliminar empresas por exceso de comentarios negativos.

¿Quieres probar mientras lees? Crea tu cuenta en Vectalk y envía el primer mensaje por la API oficial. Crear cuenta gratis →

Opt-in: la base para no ser bloqueado

La Política de Mensajería de WhatsApp Business exige permiso antes del contacto. El opt-in puede ser general y no necesita mencionar WhatsApp, siempre que cumpla la ley local. Puedes contactar a alguien cuando (a) te compartió su número de celular o su nombre de usuario de WhatsApp y (b) confirmó que quiere recibir mensajes de tu empresa. Los nombres de usuario se explican en nombres de usuario de WhatsApp y BSUID.

Meta pide tres requisitos:

• dejar claro que la persona está aceptando recibir comunicaciones;
• dejar claro el nombre de la empresa que enviará los mensajes;
• cumplir la legislación aplicable, que en Brasil incluye la LGPD, la ley general de protección de datos del país (en otros países, la norma local equivalente).

El método lo eliges tú: formulario en el sitio, SMS, llamada con IVR, papel firmado en el mostrador. Un ejemplo de texto de casilla en un formulario de registro:

[ ] Quiero recibir de Tienda Ejemplo, por WhatsApp, avisos sobre mis pedidos
    y, si marco la casilla de abajo, ofertas y novedades.
[ ] Quiero recibir ofertas y novedades de Tienda Ejemplo por WhatsApp.

Separar avisos y ofertas sigue la recomendación de Meta de pedir consentimiento por categoría. Quien aceptó solo avisos y empieza a recibir promociones tiende a bloquear.

Guarda la prueba: fecha, hora, origen (página, tienda, agente), texto exacto aceptado y el número. Si hay una denuncia o un reclamo, sabes de dónde vino el contacto. Para armar y mantener la lista, consulta cómo armar una lista opt-in para WhatsApp; para el lado legal brasileño, LGPD y WhatsApp (explicación general, no asesoría legal).

Opt-out: respeta las solicitudes dentro y fuera de WhatsApp

La política exige respetar todas las solicitudes para dejar de recibir mensajes, hechas dentro o fuera de WhatsApp. En la práctica:

• Ten un botón de respuesta rápida «Dejar de recibir» en las plantillas de marketing y maneja la respuesta en el webhook, marcando el contacto al instante.
• Maneja palabras como «salir», «basta» y «no quiero» en mensajes libres.
• Sincroniza las bajas hechas por correo, sitio web o atención al cliente con la base de WhatsApp.

El propio WhatsApp le da al usuario la opción de dejar de recibir los mensajes de marketing de una empresa. Si envías de todos modos, el envío falla con el error 131050, y Meta recomienda suscribirse al webhook user_preferences para saber cuándo el usuario se da de baja o vuelve a aceptar. Usa ese evento para actualizar la base en lugar de insistir.

Calidad: las señales que pesan

La calidad se calcula sobre los últimos 7 días, con más peso para lo más reciente, a partir de bloqueos, denuncias, silenciamientos, archivados y los motivos que el usuario indica al bloquear. Las recomendaciones de Meta para mantener alta la calificación:

• seguir la Política de Mensajería de WhatsApp Business;
• enviar solo a quien dio opt-in;
• personalizar y entregar algo útil;
• evitar mensajes de bienvenida o presentación abiertos;
• no enviar demasiados mensajes por día;
• ajustar contenido y extensión.

Al lanzar una nueva forma de recoger opt-in, Meta recomienda seguir la calidad de cerca. Lo mismo vale para campañas nuevas: empieza con una muestra de la base y amplía solo si la calificación se mantiene.

Sectores y contenidos que generan infracciones

La Política de Comercio de WhatsApp prohíbe transaccionar algunos productos y servicios. Los códigos de infracción que Meta puede aplicar incluyen, entre otros:

Código de infracción	Ejemplos
ALCOHOL	Bebidas alcohólicas y kits para producirlas
GAMBLING	Apuestas, casinos en línea, casas de apuestas deportivas, loterías y juegos de habilidad pagos
DRUGS	Drogas ilegales, recreativas o con receta (se permiten fabricantes y servicios de salud sin venta directa)
TOBACCO	Cigarrillos, cigarrillos electrónicos y vapeadores, narguiles
SUPPLEMENTS	Suplementos considerados inseguros, como esteroides anabólicos
MISLEADING	Marketing multinivel, opciones binarias, préstamos de corto plazo, cobranza de deudas
DIGITAL_SERVICES_PRODUCTS	Venta de contenido, suscripciones y cuentas digitales
THIRD_PARTY_INFRINGEMENTS	Falsificaciones y copias no autorizadas

Antes de integrar a un cliente, revisa si su modelo de negocio cabe en la política. Ninguna configuración técnica protege un número usado para algo prohibido.

Las plantillas también se evalúan por su contenido. Pedir el número completo de tarjeta o de documento, amenazar al cliente o clasificar promociones como utilidad de forma recurrente lleva a rechazos y, en el último caso, a restricciones propias. Consulta los detalles en la guía de plantillas de la API de WhatsApp.

Monitoreo por API

Tres recursos de la Cloud API avisan antes de que un problema se convierta en bloqueo. En Vectalk, los webhooks llegan en el mismo formato de Meta a las URL que registraste.

Webhook account_update. Informa infracciones (ACCOUNT_VIOLATION, con el código de la infracción), restricciones (ACCOUNT_RESTRICTION, con tipo, fecha de vencimiento y, cuando existen, pasos para resolverlas) y cambios de estado de bloqueo (DISABLED_UPDATE). Un ejemplo de restricción:

{
  "field": "account_update",
  "value": {
    "event": "ACCOUNT_RESTRICTION",
    "restriction_info": [
      { "restriction_type": "RESTRICTED_BIZ_INITIATED_MESSAGING", "expiration": 1767225600 },
      { "restriction_type": "RESTRICTED_ADD_PHONE_NUMBER_ACTION", "expiration": 1767225600 }
    ]
  }
}

RESTRICTED_BIZ_INITIATED_MESSAGING impide iniciar conversaciones; RESTRICTED_CUSTOMER_INITIATED_MESSAGING impide incluso responder a los clientes. Al recibir este evento, suspende las campañas automáticamente y alerta al equipo.

Campo health_status. En la Graph API, consultar GET /{id}?fields=health_status en un número, cuenta o plantilla devuelve AVAILABLE, LIMITED o BLOCKED para cada nodo que interviene en el envío (app, portafolio comercial, cuenta de WhatsApp Business, número y plantilla), con la descripción del error y una sugerencia de solución cuando hay bloqueo.

Calidad del número. El campo quality_rating (GREEN, YELLOW, RED) aparece en la consulta del número. En Vectalk:

curl 'https://apis.vectalk.com.br/api/phone-numbers?fields=id,display_phone_number,quality_rating' \
  -H 'Authorization: Bearer TU_TOKEN_DE_INSTANCIA'

Me restringieron: qué hacer

1. Detén los envíos automáticos. Las campañas y los flujos de cobranza siguen llamando a la API y generando errores.
2. Lee la infracción en el Business Support Home. En Meta Business Suite, entra a Todas las herramientas, luego a Business Support Home, y selecciona la cuenta de mensajes afectada. La notificación muestra la política infringida, ejemplos de lo que está o no permitido, las restricciones activas y qué pasa si reincides.
3. Decide entre aceptar y apelar. Si la empresa estaba dentro de la política, haz clic en Solicitar revisión en la infracción, explica el caso y envía. Meta indica que la decisión suele tardar de 24 a 48 horas y la infracción queda «Sin cambios» o «Revertida». No todas las infracciones de spam admiten apelación; en esos casos hay que esperar a que termine la restricción.
4. Corrige la causa antes de volver. Revisa el origen de la lista, la frecuencia, las plantillas que más bloqueos generaron y el manejo del opt-out.
5. Vuelve de a poco. Retoma con el público más comprometido y sigue la calidad y los webhooks antes de ampliar.

Mantén actualizados los datos de los administradores del portafolio: las notificaciones de infracción les llegan por correo, además de los webhooks y del banner en el WhatsApp Manager. Si lo restringido es todo el Business Manager, consulta Business Manager restringido o desactivado; para abrir un caso con Meta, soporte de Meta para WhatsApp Business.

Números bloqueados en la app común

Un bloqueo en la app común de WhatsApp se resuelve por el proceso de apelación del propio WhatsApp, no por el Business Support Home. Esto aparece con frecuencia en quienes usaban herramientas no oficiales y deciden pasar a la API; los riesgos se comparan en API oficial vs. API no oficial de WhatsApp, y la guía sobre cómo migrar a la API oficial de WhatsApp cubre este escenario.

Bloquear usuarios abusivos

La API también permite que la empresa bloquee contactos que envían spam u ofensas. En Vectalk, la llamada es POST /api/block-users:

curl -X POST https://apis.vectalk.com.br/api/block-users \
  -H "Authorization: Bearer TU_TOKEN_DE_INSTANCIA" \
  -H "Content-Type: application/json" \
  -d '{ "users": ["5584988887777"] }'

Según la documentación de Meta, solo puedes bloquear a quien te escribió en las últimas 24 horas, hasta 1.000 usuarios por solicitud, con una lista de bloqueo de hasta 64.000 usuarios.

Preguntas frecuentes

¿Usar la API oficial garantiza que mi número no será bloqueado?

No. La API oficial elimina el riesgo de bloqueo por usar una herramienta no autorizada, pero Meta sigue aplicando la política a quien envía spam, envía sin opt-in o trabaja en sectores prohibidos.

¿Cuántos bloqueos de usuarios hacen caer un número?

La documentación consultada no da una cifra. La calidad considera bloqueos, denuncias, silenciamientos y archivados de los últimos 7 días, con más peso para los más recientes.

¿Cuánto tarda una apelación?

La documentación indica que la revisión suele tardar de 24 a 48 horas.

Si un número es restringido, ¿los demás números del portafolio siguen funcionando?

Depende del nivel de la medida. Las restricciones pueden afectar al número, a la cuenta de WhatsApp Business o al portafolio. El health_status muestra qué nodo está limitado o bloqueado.

Opera con seguridad con Vectalk

Vectalk usa la API oficial de Meta y reenvía los webhooks de la documentación, incluidos los de calidad y restricción, para que automatices la respuesta a cada evento. Usas un token para todas tus cuentas, tienes coexistencia con la app WhatsApp Business y pagas con una mensualidad más saldo prepago: Vectalk coloca su propia línea de crédito en tu número y cada mensaje entregado se descuenta del saldo, sin tarjeta registrada en Meta. Crea tu cuenta en apps.vectalk.com.br/register, consulta los endpoints en docs.vectalk.com.br o habla con el equipo en la página de contacto.

---

Fuentes oficiales consultadas el 29/10/2026: Aplicación de políticas y spam, Infracciones de la política, Webhook account_update, Estado de salud, Cómo obtener el opt-in, Bloquear usuarios, Códigos de error, Política de Mensajería de WhatsApp Business (actualizada el 23/09/2026).