Pasar al contenido principal
osky
WhatsApp ya te deja apagar las llamadas sin permiso: así funciona call_permission_mode (y por qué importa en México)
Tema WhatsApp Cloud API

Meta agregó el 12 de noviembre de 2026 un ajuste nuevo a la Calling API de WhatsApp: call_permission_mode. Sirve para una sola cosa, pero importante: decidir si tu número de negocio puede llamar a usuarios sin que antes te hayan dado permiso, o si se queda en el modelo clásico donde solo marcas a quien lo aprobó. Hace una semana Meta empezó a inscribir solos a los números elegibles en ese modelo "basado en calidad", y la documentación nueva confirma lo que entonces no se veía: por ahora aplica a números con código de país de México y Colombia. Si operas un bot o un call center con números mexicanos, este interruptor es tuyo y conviene que sepas en qué posición está.

El contexto: de "pide permiso" a "llama, salvo que te digan que no"

En osky.dj ya contamos el cambio del 6 de noviembre. Según el changelog de Meta, los números elegibles de "países específicos" quedan inscritos automáticamente en las llamadas iniciadas por el negocio basadas en calidad al activar la Calling API, y los que ya la tenían activa se migraron solos. En ese modelo puedes llamar sin aprobación previa, a menos que el usuario haya rechazado el permiso permanente o revocado uno que ya había dado.

Cuando escribimos esa nota, la guía pública todavía no mostraba el detalle. Hoy sí. La sección de llamadas basadas en calidad aparece marcada como "disponibilidad limitada" y dice que aplica a números elegibles con códigos de país de Colombia y México. También aclara tres cosas que cambian la lógica de cualquier integración:

  • Los permisos que ya tenías siguen valiendo después de la migración: puedes seguir llamando a quien te aprobó.
  • Solo cuenta el permiso permanente. El modelo de calidad no usa los permisos temporales (los de 7 días) ni los que se generan con el callback cuando el usuario te llama. La guía de permisos de llamada lo repite: los permisos de callback_permission_status no aplican en este modelo.
  • Hay límites por nivel, contados en una ventana móvil de 24 horas por número.

Qué hace call_permission_mode

El ajuste vive en el mismo endpoint de configuración de llamadas, POST /<PHONE_NUMBER_ID>/settings, dentro del objeto calling. Según la documentación de Configure Call Settings, acepta dos valores:

  • ALLOW_APPROVED_PERMISSION_ONLY: te sales del modelo de calidad y vuelves a exigir permiso aprobado para llamar. Meta dice que lo puedes poner en cualquier número, que no desactiva la Calling API y que no revoca los permisos que ya te habían aprobado.
  • ALLOW_UNLESS_PERMISSION_REVOKED: entras al modelo de calidad. Para eso tu número tiene que cumplir los requisitos de elegibilidad, tener la Calling API activa y tener disponibles las llamadas iniciadas por el negocio.

El campo es opcional. Si lo omites, se conserva el modo que ya tenías. Si nunca configuraste uno, al activar la Calling API los números elegibles quedan en ALLOW_UNLESS_PERMISSION_REVOKED y los demás en ALLOW_APPROVED_PERMISSION_ONLY (salvo que ya estuvieran configurados para llamar sin aprobación previa). Dicho de otro modo: si tu número mexicano es elegible y no tocaste nada, lo más probable es que ya esté en el modo sin permiso. No lo supongas; la forma de confirmarlo está más abajo.

Para activar llamadas y entrar al modelo en una sola petición, Meta indica mandar juntos "status": "ENABLED" y "call_permission_mode": "ALLOW_UNLESS_PERMISSION_REVOKED". El cuerpo mínimo para salirte es este:

{
  "calling": {
    "call_permission_mode": "ALLOW_APPROVED_PERMISSION_ONLY"
  }
}

Diagrama comparativo de los dos valores de call_permission_mode: ALLOW_APPROVED_PERMISSION_ONLY, el modelo clásico con permiso obligatorio, y ALLOW_UNLESS_PERMISSION_REVOKED, el modelo basado en calidad con límites por nivel

Un error nuevo y un webhook nuevo

Si intentas entrar al modelo de calidad con un número que no es elegible, o al que le restringieron hace poco las llamadas salientes por mala calidad, la API responde con el código 138039, y el motivo viene en error_data.details. Los demás errores de disponibilidad de llamadas siguen aplicando si la Calling API o las llamadas iniciadas por el negocio no están disponibles en ese número.

Para saber en qué modo estás, GET /<PHONE_NUMBER_ID>/settings ahora devuelve call_permission_mode dentro de calling. Y para enterarte cuando cambia, existe el webhook account_settings_update. Según Meta, avisa de cambios en status, call_icon_visibility, callback_permission_status, call_permission_mode, sip.status y srtp_key_exchange_protocol, incluso cuando el cambio lo hiciste tú. Para recibirlo, la app tiene que estar suscrita a ese campo y a la cuenta de mensajería del número, y tener el permiso whatsapp_business_management. La propia documentación da una prueba rápida: si con el token de esa app puedes leer los settings, puede recibir el webhook.

Los límites del modelo de calidad

La guía de llamadas iniciadas por el negocio define cuatro niveles por número, medidos en 24 horas móviles:

Nivel Intentos de llamada sin permiso aprobado
CALLING_TIER_NO_ACCESS El modelo no está disponible
CALLING_TIER_1K Hasta 1,000
CALLING_TIER_15K Hasta 15,000
CALLING_TIER_UNLIMITED Sin tope por nivel (los demás límites de la Calling API siguen)

Los detalles que importan:

  • Solo cuentan los intentos a usuarios sin permiso aprobado. Las llamadas a quien ya te dio permiso no gastan cupo.
  • Los números elegibles arrancan en 1K. Meta sube de nivel de forma automática según el uso sostenido, la calidad de las llamadas, el estado de la cuenta y las restricciones activas, entre otros factores. No se pide.
  • Cuando cambia tu nivel llega un evento CALLING_TIER_UPDATE por el webhook account_update.
  • Si te pasas del tope, la API responde 138037 y toca esperar a que los intentos viejos salgan de la ventana de 24 horas.
  • La mala calidad puede restringir temporalmente tus llamadas salientes. La página de configuración describe que, si las quejas y los bloqueos pasan un umbral, Meta pausa las llamadas iniciadas por el negocio durante 7 días.

Mi lectura: por qué alguien querría apagarlo

Que Meta te deje llamar sin pedir permiso no quiere decir que te convenga. Lo que esto significa en la práctica, según yo:

  • Tu reputación se vuelve un recurso que se gasta. En el modelo clásico, la persona ya dijo "sí, llámame" antes de que sonara el teléfono. En el de calidad, cada llamada en frío es una oportunidad de que te bloqueen o te reporten, y eso es justo lo que Meta usa para decidir tu nivel o castigarte con la pausa de 7 días. Un bot de cobranza o de ventas que marca en automático puede quemar un número en una tarde.
  • El código viejo puede tomar decisiones con datos que ya no aplican. Si tu integración revisaba "¿tengo permiso temporal o de callback?" antes de marcar, en el modelo de calidad esos permisos no cuentan. Y si tu lógica asumía que sin permiso la llamada falla con 138006, ahora puede que sí salga.
  • Hay negocios que no deben llamar sin permiso, aunque puedan. Pienso en clínicas, despachos o cualquier operación donde una llamada no solicitada se vea invasiva o choque con sus avisos de privacidad. Para ellos, poner ALLOW_APPROVED_PERMISSION_ONLY es la forma explícita y auditable de decir "aquí solo llamamos a quien lo pidió".
  • Para quien sí lo aprovecha, el atractivo es claro: confirmar citas, avisar de una entrega o dar seguimiento a una compra sin mandar antes la plantilla de "¿me dejas llamarte?", que además se cobra como mensaje.

Qué revisar si tienes números con Calling API

No lo probé; esta lista sale de la documentación oficial de Meta.

Lista de seis pasos para revisar un número de WhatsApp con Calling API en México o Colombia: leer el modo, decidir, suscribirse al webhook, vigilar el nivel, manejar el error 138039 y revisar la lógica de permisos

  1. Lee el modo efectivo de cada número con GET /<PHONE_NUMBER_ID>/settings. Si tienes varios clientes, hazlo número por número: el ajuste es por número de negocio, no por cuenta.
  2. Decide con el cliente si se queda en el modelo de calidad o se sale. Si se sale, manda ALLOW_APPROVED_PERMISSION_ONLY.
  3. Suscríbete a account_settings_update para que un cambio hecho desde WhatsApp Manager o por otro integrador no te agarre en curva.
  4. Escucha CALLING_TIER_UPDATE en account_update y frena tus campañas antes de topar con el 138037.
  5. Maneja el 138039 al hacer opt-in y guarda error_data.details en tus logs.
  6. Revisa tu lógica de permisos. Si dependías de permisos temporales o del callback, en el modelo de calidad ya no te sirven.

Lo que todavía no se sabe

La documentación habla de "requisitos de elegibilidad" pero no los lista uno por uno en las páginas que revisamos, y tampoco dice cuándo llegará el modelo a otros países. Tampoco publica los umbrales exactos de calidad que mueven a un número entre niveles. Mientras eso no aparezca, lo prudente es tratar el cupo de 1,000 intentos como el techo real y medir bloqueos y reportes desde el primer día.

Fuentes