Graph API v27.0: tu bot de WhatsApp ya tiene fecha de caducidad si sigue en v21 o v22

Meta publicó el 4 de noviembre de 2026 la versión 27.0 de Graph API y de Marketing API. Trae funciones nuevas, deprecaciones y cambios incompatibles. Y aunque el anuncio habla sobre todo de anuncios y páginas, a quien opera bots de WhatsApp le importa por una razón muy concreta: la plataforma de WhatsApp Business está construida sobre Graph API, así que cada POST a graph.facebook.com/vXX.0/<phone-number-id>/messages vive bajo el mismo calendario de versiones. Con v27.0, Meta también confirmó las fechas de retiro de v21.0 (21 de enero de 2027) y v22.0 (20 de mayo de 2027). Si tu bot tiene una de esas versiones fija en el código, ya tiene fecha de caducidad.

Lo que cambia para quien hace bots

Para un bot de WhatsApp, el anuncio deja cuatro cosas que revisar.

1. Versiones con fecha de retiro. Según el blog de Meta, Graph API v21.0 se retira el 21 de enero de 2027 y v22.0 el 20 de mayo de 2027. La tabla oficial de versiones completa el panorama: v20.0 ya expiró el 24 de septiembre de 2026, v23.0 vence el 8 de octubre de 2027 y v24.0 el 18 de febrero de 2028. La regla de Meta, según su guía de versionado, es que cada versión funciona al menos dos años y deja de servir dos años después de que sale la siguiente.

2. Funciones "legacy" vetadas desde ya. Desde el 4 de noviembre, las apps nuevas no pueden usar seis funciones viejas de Graph API, y las apps existentes no pueden estrenar casos de uso nuevos con ellas. Esto aplica en todas las versiones, no solo en v27.0. Las que ya las usan pueden seguir haciéndolo en las versiones viejas que sigan vigentes, pero en v28.0 dejan de funcionar para todos.

3. Divulgación de contenido generado con IA. Desde v27.0, al editar una publicación de página (POST /{post-id} y POST /{page-post-id}) se puede mandar el booleano opcional is_ai_generated: true agrega la etiqueta de contenido generado con IA, false la quita y, si lo omites, se conserva el valor que tenía. Si tu automatización publica en Facebook además de responder en WhatsApp, esto te sirve para corregir la etiqueta sin borrar el post.

4. Una métrica que se apaga sin reemplazo. total_video_consumption_rate, de GET /{video-id}/video_insights, deja de devolver datos a principios de noviembre de 2026 en todas las versiones. Meta explica que sus insumos (espectadores de 3 segundos y alcance de video) ya se habían deprecado en v26.0, y dice que no hay reemplazo directo. Si tu panel de reportes la consulta, quítala antes de que te truene el parser.

Línea de tiempo de Graph API v27.0: lanzamiento el 4 de noviembre de 2026, retiro de v21.0 el 21 de enero de 2027, cambios de Marketing API en todas las versiones hacia febrero de 2027, retiro de v22.0 el 20 de mayo de 2027 y fin de las funciones legacy en v28.0, con una lista de revisión para bots

Las seis funciones legacy que se van

Meta las enumera en el anuncio con ejemplos:

Función	Parámetro	Qué hace
Peticiones multi-ID	`ids`	Trae varias entidades en una sola llamada, por ejemplo `?ids=[id1,id2]`
Formato de fechas	`date_format`	Cambia cómo vienen las fechas en la respuesta
Sobrescribir método HTTP	`method`	Convierte una petición en otro método, por ejemplo `?method=delete`
Alias de campos	`.as(...)`	Renombra campos en la respuesta
Callbacks JSONP	`callback`	Envuelve la respuesta en una función de JavaScript
Lotes asíncronos	`asyncbatch`	Manda peticiones a procesar en segundo plano

Meta aclara que multi-ID y formato de fechas ya estaban deprecados desde v26.0. Su instrucción es directa: deja de usarlas antes de subir a v28.0. Todavía no hay fecha para v28.0.

En un bot que solo manda y recibe mensajes, lo más probable es que no uses ninguna. Donde sí aparecen es en código heredado: paneles de administración viejos que llaman a Graph desde el navegador con JSONP, librerías que usan ?method=delete porque su cliente HTTP no sabía mandar DELETE, o scripts de reportes que juntan varios objetos con ids. Vale la pena un grep antes de que alguien suba la versión sin revisar.

Lo de Marketing API, por si tu bot vive de anuncios

Muchos bots de WhatsApp reciben tráfico de anuncios de clic a WhatsApp o de formularios, así que estos cambios también pueden caerte encima:

Más dispositivos por defecto. Desde v27.0, los conjuntos de anuncios de ventas nuevos que apuntan a dispositivos o sistemas operativos específicos traen activada la opción de llegar a más gente en otros dispositivos si no mandas targeting.targeting_automation.individual_setting.device. Para mantener tu segmentación, ponlo en 0. Llega a todas las versiones unos 90 días después (Meta calcula febrero de 2027, sin fecha confirmada).
Product showcase automático. Meta puede activar este formato cuando tenga "alta confianza" en que un conjunto de productos de tu catálogo coincide con el anuncio. Se desactiva con product_extensions.enroll_status en OPT_OUT.
Adiós a /{catalog-id}/batch. En v27.0 ya no funciona y hay que migrar a /{catalog-id}/items_batch, con la guía de Meta. En v26.0 y anteriores sigue vivo mientras esas versiones existan. Si tu bot vende con catálogo y lo sincronizas por API, esto es lo más urgente del anuncio.
Lookalikes sin ubicación. lookalike_spec ya no acepta country ni location_spec. Meta dice que nunca tuvieron efecto, porque la entrega sale de la ubicación de los conjuntos de anuncios. Las audiencias existentes siguen igual.
Formularios con OTP. El SDK de Meta Business v27 suma phone_otp_verification_type para pedir verificación del teléfono por código en los formularios de leads: obligatoria, opcional o desactivada. La opcional solo está disponible para cuentas elegibles.

Mi lectura: el riesgo es el upgrade silencioso

Lo que más me llama la atención no está en el anuncio de v27.0 sino en la guía de versionado: cuando una versión deja de servir, Meta no te responde con error. Redirige la llamada a la versión más vieja que siga disponible. Tu bot no se cae el 21 de enero: empieza a correr en otra versión sin que nadie lo decida. Y si de v21.0 lo empujan a v22.0, en mayo le vuelve a pasar.

El otro punto ciego son las llamadas sin versión. La misma guía dice que una petición sin vXX.0 en la ruta usa la versión configurada en el panel de la app (Configuración > Avanzada). Si nadie la ha tocado en años, puede estar tan vieja como el bot.

Y un detalle que me hace gracia: el ejemplo de cURL de la página oficial que presenta la plataforma de WhatsApp todavía usa v17.0, que según la tabla de Meta expiró el 12 de septiembre de 2025. Si copiaste ese ejemplo al arrancar tu bot y nunca lo cambiaste, ya llevas más de un año corriendo en otra versión sin saberlo.

Qué hacer esta semana

Busca la versión fija en código, variables de entorno y configuración: grep -rn "graph.facebook.com/v" .
Revisa las librerías y SDK que usas. Muchos traen la versión fija por dentro y no siempre la anuncian.
Revisa la versión configurada en el panel de cada app de Meta, sobre todo si tienes llamadas sin versión.
Sube a una versión vigente, de preferencia reciente, y prueba en un número de pruebas: envío de texto, plantillas, multimedia y webhooks de estado.
Busca ids, date_format, method=, .as(, callback= y asyncbatch en tus integraciones con Graph.
Si sincronizas catálogo, migra a /items_batch antes de subir a v27.0.
Apunta el 21 de enero y el 20 de mayo de 2027 en el calendario del equipo.

Una aclaración honesta: no probé v27.0 con un bot real. Todo lo anterior sale del anuncio de Meta y de su documentación oficial de versiones. El changelog específico de WhatsApp no cargaba al escribir esto, así que si v27.0 trae cambios propios de la Cloud API, no están reflejados aquí.