Volver a las novedades para desarrolladores

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

2 de febrero de 2023DeAyyad Farah

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 destacamos una serie de cambios que consideramos pertinentes para algunos miembros de nuestra comunidad de desarrolladores. Entre estos cambios se incluyen avisos, actualizaciones de productos y notificaciones de retiradas que creemos que son pertinentes para la integración de tus aplicaciones con nuestra plataforma.

Puedes consultar una lista completa de todos los cambios y los detalles correspondientes en nuestro registro de cambios.

Avisos y actualizaciones generales

Respuestas de error de la Plataforma de WhatsApp Business

Como parte de nuestro constante trabajo para mejorar el comportamiento de las respuestas de error de la API, hemos realizado los siguientes cambios.

  • Los subcódigos de error, que casi nunca se utilizan y en los que no te deberías basar, se dejarán de incluir en las respuestas de error de la versión 16.0 y posteriores. En su lugar, utiliza las propiedades “code” y “details”.
  • El código de error 100 (“code”:100) tenía diversos títulos únicos que indicaban la naturaleza de un error determinado. Todos los códigos de error 100 ahora usarán “Invalid Parameter” como título. Los títulos anteriores que describían la naturaleza de un determinado código de error 100 se han trasladado a la propiedad “details”. Este cambio ahora también se refleja en las cargas útiles de los webhooks que describen la respuesta de un código de error 100.
  • Los objetos “errors” de los webhooks han obtenido una propiedad “new message” que establece una asignación a la propiedad “message” en las cargas útiles de las respuestas de error de la API.

La plataforma para desarrolladores ahora requerirá la verificación del negocio para obtener acceso avanzado a cualquier API

Tal y como se anunció el 1 de febrero de 2023, ahora Meta pedirá a los desarrolladores que verifiquen sus negocios para poder obtener acceso avanzado a cualquier permiso en la plataforma para desarrolladores de Meta. Este requisito forma parte de un proceso mediante el que pretendemos ayudar a confirmar la autenticidad y la legitimidad de una empresa u organización.

En el caso de las aplicaciones creadas después de esa fecha, empezaremos a implementar esta medida de forma gradual cuando las nuevas aplicaciones soliciten el acceso avanzado. Las aplicaciones creadas antes del 1 de febrero de 2023 con acceso avanzado tendrán que vincularse a una empresa verificada a partir del 1 de mayo de 2023. Para consultar una lista de permisos que requieren la verificación del negocio con el fin de poder aprobar el acceso avanzado, consulta esta página.

Retiradas y cambios de última hora

Retirada de la función de consideración del viaje

En 2018, lanzamos la función de consideración del 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 su intención de viajar, pero aún no habían decidido el destino. La consideración del viaje funcionaba junto con opciones de segmentación existentes para ayudar a los anunciantes a entregar sus anuncios a las personas adecuadas en el momento oportuno en Facebook, Instagram y Audience Network. Durante los últimos cuatro años hemos mejorado constantemente nuestros sistemas de aprendizaje automático y hemos llevado a cabo tests exhaustivos, y ahora podemos ayudar a los anunciantes de viajes a llegar a los clientes con intención de viajar y a conseguir objetivos de rendimiento similares sin tener que recurrir a esta función.

A partir del 2 de febrero de 2023, la función de consideración del viaje se eliminará como opción en el Administrador de anuncios y la API para las nuevas campañas. Hemos determinado que esta opción ya no es necesaria, dado que los anunciantes pueden conseguir el mismo rendimiento sin ella. Hasta que la opción se elimine, es probable que no se note ningún impacto significativo en el rendimiento si se activa o no.

Gracias a la mejora continua de los modelos de aprendizaje automático, ahora se pueden conseguir los mismos objetivos y el mismo nivel de rendimiento sin tener que recurrir a esta opción. Por este motivo, pensamos que la experiencia será más sencilla si la eliminamos.

Retirada de los anuncios de vuelos para la captación de clientes potenciales

En septiembre de 2018 lanzamos los anuncios de vuelos para la captación de clientes potenciales con éxito. A mediados de 2021, el producto empezó a experimentar problemas técnicos y se identificaron errores que impedían que las campañas se publicaran de manera eficiente. Por lo tanto, tomamos la decisión de comunicar a los anunciantes de forma proactiva que utilizaran otras opciones para captar clientes potenciales. La función de nueva segmentación todavía está disponible para que los anunciantes la utilicen.

Si tú o uno de tus socios utilizáis los anuncios de vuelos para la captación de clientes potenciales en la actualidad, os recomendamos que desactivéis las campañas actuales antes del 1 de mayo de 2023.

Retirada de la ubicación de anuncios de artículos instantáneos

El 20 de abril de 2023 eliminaremos de Facebook los artículos instantáneos como función y como ubicación de anuncios. En 2015, presentamos por primera vez los artículos instantáneos para permitir a los editores crear artículos interactivos de contenido multimedia en dispositivos móviles y monetizarlos con anuncios en Facebook. No obstante, el descubrimiento de noticias tan solo es una pequeña parte de la experiencia de Facebook para la mayoría de la gente que utiliza la plataforma. Además, nos dicen que quieren ver menos de este tipo de contenido en su sección de noticias. Por este motivo, vamos a ajustar nuestras inversiones para que se alineen mejor con 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. A partir del 20 de abril de 2023, los conjuntos de anuncios anteriores que incluyan únicamente la ubicación de artículos instantáneos se pausarán, y todos los demás que incluyan esta ubicación se actualizarán automáticamente para excluirla.

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

Con este lanzamiento, vamos a implementar un cambio con el que se ocultarán los comentarios, las reacciones y las etiquetas del usuario de la sesión. Además, los campos “via” y “sharedposts” devolverán datos vacíos en lo que respecta a las publicaciones de los perfiles de los usuarios. Este cambio solo afectará al contenido publicado en los perfiles de los usuarios.

Retirada de la compatibilidad con versiones de TLS anteriores a 1.2

Para mejorar nuestro enfoque con respecto a la seguridad, vamos a retirar la compatibilidad de las API Graph con versiones de TLS anteriores a TLS 1.2. Si usas la versión 1.2 de TLS, también se retirará el acceso mediante cifrados estáticos de RSA (AES128-GCM-SHA256, AES256-GCM-SHA384, AES128-SHA, AES256-SHA, DES-CBC3-SHA). Las solicitudes de API que se realicen con versiones anteriores de TLS recibirán un error al cabo de 90 días.

A partir del 1 de mayo de 2023 también rechazaremos el tráfico del sitio web developer.facebook.com que proceda de navegadores que utilicen versiones anteriores a la versión 1.2 de TLS o, en el caso de usar dicha versión, aquellos que utilicen cifrados de RSA estáticos (AES128-GCM-SHA256, AES256-GCM-SHA384, AES128-SHA, AES256-SHA, DES-CBC3-SHA).

Categorías de plantillas de WhatsApp

El año pasado, actualizamos los tipos de categoría de las plantillas en el Administrador de WhatsApp y la API para reflejar los nuevos casos de uso enviados en la Plataforma de WhatsApp Business. El 2 de febrero de 2023, actualizaremos el nombre de las categorías de estas plantillas para que reflejen estos casos de uso con mayor precisión:

  • Las plantillas de marketing mantendrán el mismo nombre: marketing (sin cambios).
  • El nombre de las plantillas transaccionales cambiará a utility.
  • El nombre de las plantillas de OTP cambiará a authentication.

Las empresas deberán usar estas categorías de plantillas actualizadas cuando creen o editen plantillas con la versión 16 de Graph. A partir del 1 de mayo, este cambio se aplicará en todas las versiones, por lo que se deberán utilizar estas nuevas categorías al crear o editar plantillas independientemente de la versión que se utilice. Para garantizar que no se produzcan interrupciones durante los procesos de creación o edición de plantillas, se recomienda a las empresas y los proveedores de soluciones empresariales que prioricen la actualización de las llamadas a la API para utilizar las nuevas plantillas y los nuevos valores de las categorías antes del 1 de mayo de 2023.

A continuación encontrarás otras consideraciones y fechas importantes:

  • Migración de plantillas: a partir del 1 de abril, WhatsApp migrará todas las plantillas actuales a las nuevas categorías de plantillas. Las empresas pueden ver la nueva categorización de sus plantillas en el Administrador de WhatsApp y podrán revisarla hasta el 15 de mayo. Si una empresa no está de acuerdo con la categorización, tendrá hasta el 15 de mayo para enviar una apelación. Todas las plantillas que se creen o editen con la versión 15 de la API Graph o versiones anteriores entre el 1 de abril y el 1 de mayo se migrarán el día 5 de mayo. Por lo tanto, recomendamos actualizar a la versión 16 para crear plantillas a partir del 1 de abril. Desde el 1 de mayo, todas las plantillas creadas en el Administrador de WhatsApp o la API Graph en cualquiera de sus versiones reflejarán las nuevas categorías de plantillas.
  • Creación de plantillas con las nuevas categorías: a partir del 1 de abril, todas las plantillas creadas en la versión 16 de la API Graph o el Administrador de WhatsApp requerirán que se valide la categoría para su aprobación. Las plantillas creadas o editadas recientemente podrían rechazarse si WhatsApp detecta que la categoría seleccionada es incorrecta. El motivo del rechazo será que la categoría seleccionada no coincide con el contenido de la plantilla, de acuerdo con nuestras normas para plantillas. En ese caso, las empresas pueden optar por modificar la categoría seleccionada y enviarla de nuevo, editar la plantilla o bien apelar la decisión. A partir del 1 de mayo, las plantillas creadas recientemente con variables requerirán muestras insertadas. A partir del 1 de junio, se cobrará a las empresas en función de las nuevas tarjetas de tarifas según la categoría de la plantilla.

Plataforma de Messenger API

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

Retiradas de versiones de la API

Como parte de la programación del control de versiones de Facebook de la API Graph y la API de marketing, ten en cuenta las próximas retiradas:

API Graph

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

API de marketing

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

Para evitar cualquier interrupción en tu empresa, te recomendamos que migres todas las llamadas a la versión de la API más reciente que lanzamos hoy.

SDK de la plataforma de Facebook

Como parte de nuestra programación de retiradas en dos años de los SDK de la plataforma, ten en cuenta las próximas retiradas y desapariciones:

  • Junio de 2023: las versiones 9.0 o anteriores del SDK de la plataforma de Facebook desaparecerán.
  • Octubre de 2023: las versiones 11.0 o anteriores del SDK de la plataforma de Facebook desaparecerán.
  • Febrero de 2024: las versiones 12.0 o anteriores del SDK de la plataforma de Facebook desaparecerán.