Presentación de la versión 16.0 de la API Graph y de la API de marketing de Facebook

Hoy lanzamos la versión 16.0 de la API Graph y de la API de marketing de Facebook. Como parte de este lanzamiento, a continuación destacaremos los cambios que consideramos relevantes para nuestra comunidad de desarrolladores. Entre estos cambios, se incluyen avisos, actualizaciones de productos y notificaciones de elementos obsoletos que consideramos relevantes para la integración de tus aplicaciones con nuestra plataforma.

Para obtener una lista completa de todos los cambios y los detalles correspondientes, consulta el registro de cambios.

Actualizaciones y avisos generales

Respuestas de error de la plataforma de WhatsApp Business

Como parte de nuestras continuas iniciativas para mejorar el comportamiento de las respuestas de error de la API, realizamos los siguientes cambios.

• Los subcódigos de error, que se utilizan con muy poca frecuencia y no son confiables, ya no se incluirán en las respuestas de error de las versiones 16.0 y posteriores. En cambio, debes usar "code" y "details".
• El código de error 100 ("code":100) tenía varios títulos únicos que indicaban la naturaleza de un error determinado. Ahora todos los códigos de error 100 tendrán como título "Invalid parameter". Los títulos antiguos que describían la naturaleza de un código de error 100 determinado se trasladaron a la propiedad "details". Este cambio también se refleja en las cargas útiles de webhooks que describen una respuesta de error con el código 100.
• Los objetos "errors" de webhook tienen una nueva propiedad de mensaje que se asigna a la propiedad "message" en las cargas útiles de las respuestas de error de la API.

A partir de ahora, la plataforma para desarrolladores requiere que se verifique el negocio para que cuente con acceso avanzado a cualquier API.

Como se anunció el 1 de febrero de 2023, Meta les solicitará ahora a los desarrolladores que verifiquen sus negocios para obtener acceso avanzado en relación con los permisos de la plataforma para desarrolladores de Meta. Esta medida forma parte de nuestro proceso y permite confirmar la autenticidad y legitimidad de un negocio y organización.

En relación con las apps que se creen desde el 1 de febrero de 2023, comenzaremos a implementar este paso de manera incremental cuando las nuevas apps soliciten el acceso avanzado. Las apps que se hayan creado antes del 1 de febrero de 2023, con acceso avanzado, tendrán que estar vinculadas a un negocio verificado a partir del 1 de mayo de 2023. Consulta esta página para obtener una lista de los permisos que requieren verificar el negocio antes de que se otorgue el acceso avanzado.

Elementos obsoletos y cambios radicales

La consideración de viaje quedará obsoleta

En 2018, lanzamos la consideración de viaje como una opción que los anunciantes de viajes podían activar para priorizar la entrega de anuncios a personas que habían expresado tener la intención de viajar, pero que aún no habían decidido a dónde ir. La consideración de viaje funcionaba junto con opciones de segmentación preexistentes que ayudan a los anunciantes a entregar anuncios a las personas correctas en el momento justo en Facebook, Instagram y Audience Network. En el transcurso de los últimos cuatro años, hemos desarrollado continuamente nuestros sistemas de aprendizaje automático y hemos llevado a cabo pruebas exhaustivas que nos permitieron ayudar a los anunciantes de viajes a llegar a los consumidores que tienen la intención de viajar y alcanzar objetivos de rendimiento similares sin la opción de la consideración del viaje.

A partir del 2 de febrero de 2023, la opción de consideración de viaje dejará de estar disponible en el administrador de anuncios y en la API para las nuevas campañas. Consideramos que esta opción ya no es necesaria y que los anunciantes podrán obtener el mismo rendimiento sin ella. Mientras tanto, activar o desactivar esta opción probablemente no afectará al rendimiento de la campaña de manera significativa.

Gracias a la mejora de los modelos de aprendizaje automático, ahora se pueden conseguir los mismos objetivos y el mismo rendimiento sin tener que activar o desactivar esta opción, por lo que creemos que eliminarla proporcionará una experiencia más optimizada.

Los anuncios de vuelos para captar clientes potenciales quedarán obsoletos

En septiembre de 2018, lanzamos los anuncios de vuelos para captar clientes potenciales de forma exitosa. A mediados de 2021, el producto comenzó a experimentar problemas técnicos y se identificaron errores que impedían que las campañas funcionaran de manera eficiente. Por lo tanto, tomamos la decisión de informar proactivamente a los anunciantes para que cambiaran a otras opciones de generación de clientes potenciales. La capacidad de retargeting aún está disponible y los anunciantes pueden utilizarla.

Si tú o un socio tuyo utilizan en estos momentos los anuncios de vuelos para captar clientes, recomendamos que las campañas actuales se desactiven antes del 1 de mayo de 2023.

La ubicación de los anuncios de artículos instantáneos quedará obsoleta

A partir del 20 de abril de 2023, eliminaremos los artículos instantáneos y la ubicación de anuncios de artículos instantáneos de Facebook. En 2015, lanzamos los artículos instantáneos para que los editores pudieran crear artículos interactivos de contenido multimedia en dispositivos móviles y monetizarlos con anuncios en Facebook. Sin embargo, descubrir noticias es solo una pequeña parte de la experiencia de Facebook para la mayoría de las personas que utilizan la plataforma, y nos manifestaron que les gustaría ver menos contenido de este tipo en sus feeds. Por este motivo, estamos redirigiendo nuestras inversiones para adaptarlas mejor a las preferencias de los usuarios.

A partir del 20 de abril de 2023, la ubicación de anuncios de artículos instantáneos dejará de estar disponible para la creación de nuevas campañas en el administrador de anuncios y la API de marketing. Después del 20 de abril de 2023, los conjuntos de anuncios previos cuya única ubicación sea la de artículos instantáneos se pausarán, y todos los demás conjuntos de anuncios que incluyan la ubicación de artículos instantáneos se actualizarán automáticamente y excluirán dicha ubicación.

Ocultar reacciones, comentarios y etiquetas en el contenido publicado en los perfiles de usuario

En esta versión, implementamos un cambio que hará que se oculten los comentarios, las reacciones y las etiquetas del usuario de la sesión. Los campos "via" y "sharedposts" también devolverán datos vacíos para las publicaciones en los perfiles de usuario. Este cambio solo afectará al contenido publicado en los perfiles de usuario.

La compatibilidad con versiones anteriores a la 1.2 de TLS quedará obsoleta

Para mejorar nuestra capacidad de seguridad, eliminaremos la compatibilidad de las API Graph con versiones de TLS anteriores a la 1.2. Si utilizas la versión 1.2 de TLS, el acceso mediante cifrados RSA estáticos (AES128-GCM-SHA256, AES256-GCM-SHA384, AES128-SHA, AES256-SHA y DES-CBC3-SHA) también quedará obsoleto. Las solicitudes de API realizadas con versiones de TLS anteriores recibirán un error al cabo de 90 días.

Asimismo, rechazaremos el tráfico web a developer.facebook.com después del 1 de mayo de 2023 desde navegadores con versiones de TLS antiguas (anteriores a TLS 1.2 y que utilicen cifrados RSA estáticos [AES128-GCM-SHA256, AES256-GCM-SHA384, AES128-SHA, AES256-SHA y DES-CBC3-SHA] si usan TLS1.2).

Categorías de plantillas de WhatsApp

El año pasado, actualizamos los tipos de categorías de las plantillas en el administrador de WhatsApp y la API para capturar los nuevos casos de uso que se envían en la plataforma de WhatsApp Business. El 2 de febrero de 2023, cambiaremos el nombre de estas categorías de plantillas para que reflejen con mayor precisión estos casos de uso:

• Las plantillas de marketing se seguirán llamando Marketing (sin cambios).
• Las plantillas de transacciones pasarán a llamarse Utilidades.
• Las plantillas de OTP pasarán a llamarse Autenticación.

Las empresas deberán utilizar estas categorías de plantillas actualizadas si crean o editan plantillas con la versión 16 de la API Graph. El 1 de mayo, este cambio se aplicará a todas las versiones, de modo que, si se intenta crear o editar plantillas con cualquier versión, deberán utilizarse estas nuevas categorías. A fin de garantizar que no haya interrupciones en el proceso de creación o edición de plantillas, los negocios y los proveedores de servicios empresariales deben priorizar la actualización de sus llamadas a la API de modo que utilicen los nuevos valores de categoría y plantillas antes del 1 de mayo de 2023.

A continuación, se indican otras fechas y consideraciones clave:

• Migración de plantillas: El 1 de abril, en WhatsApp, se migrarán todas las plantillas actuales a las nuevas categorías de plantillas. Las empresas podrán ver las nuevas categorías de las plantillas en el administrador de WhatsApp y tendrán tiempo para revisarlas hasta el 15 de mayo. Si un negocio no está de acuerdo con las categorías, puede enviar una apelación hasta el 15 de mayo. Todas las plantillas creadas o editadas recientemente que utilicen la versión 15 o anteriores de la API Graph entre el 1 de abril y el 1 de mayo migrarán el 5 de mayo. Por lo tanto, recomendamos empezar a utilizar la versión 16 para crear plantillas a partir del 1 de abril. Desde el 1 de mayo, las plantillas creadas en el administrador de WhatsApp o en cualquier versión de la API Graph reflejarán las nuevas categorías de plantillas.
• Creación de plantillas en las nuevas categorías de plantillas: A partir del 1 de abril, todas las plantillas creadas en la versión 16 de la API Graph y en el administrador de WhatsApp necesitarán la validación de la categoría para su aprobación. Las plantillas creadas recientemente o editadas pueden rechazarse si WhatsApp detecta que la categoría seleccionada es incorrecta. En el motivo del rechazo, se explicará que la categoría seleccionada no coincide con el contenido de la plantilla, según nuestras normas para plantillas. Las empresas pueden optar por modificar la categoría seleccionada y enviarla de nuevo, editar la plantilla o apelar la decisión. A partir del 1 de mayo, será obligatorio incorporar muestras integradas en las plantillas creadas recientemente que incluyan variables. A partir del 1 de junio, se cobrará a los negocios según las nuevas hojas de tarifas por categoría de plantilla.

API de la plataforma de Messenger

Para simplificar las notificaciones recurrentes, a partir de la versión 16, eliminaremos la opción de especificar la frecuencia de los mensajes. Para obtener más información, consulta el registro de cambios de Messenger.

Versiones de la API obsoletas:

Como parte del calendario de versiones de Facebook correspondiente a la API Graph y la API de marketing, ten en cuenta los próximos elementos que quedarán obsoletos:

API Graph

• 23 de febrero de 2023: la versión 9.0 de la API Graph quedará obsoleta y se eliminará de la plataforma
• 8 de junio de 2023: la versión 10.0 de la API Graph quedará obsoleta y se eliminará de la plataforma
• 14 de septiembre de 2023: la versión 11.0 de la API Graph quedará obsoleta y se eliminará de la plataforma

API de marketing

• 25 de abril de 2023: la versión 14.0 de la API de marketing quedará obsoleta y se eliminará de la plataforma

Para evitar interrupciones en tu negocio, te recomendamos migrar todas las llamadas a la última versión de la API que se lanzó hoy.

SDK de la plataforma de Facebook

Como parte de nuestro calendario de obsolescencias de 2 años correspondiente a los SDK de la plataforma, ten en cuenta los próximos elementos que quedarán obsoletos y las próximas desactivaciones:

• Junio de 2023: se desactivarán la versión 9.0 o anteriores del SDK de la plataforma de Facebook
• Octubre de 2023: se desactivarán la versión 11.0 o anteriores del SDK de la plataforma de Facebook
• Febrero de 2024: se desactivarán la versión 12.0 o anteriores del SDK de la plataforma de Facebook