Volver a las novedades para desarrolladores

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

12 de septiembre de 2023DeNaveen Santhanavel

Hoy lanzamos la versión 18.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.

Actualizaciones generales

Consolidación de las opciones del estado de la ubicación de la audiencia en la segmentación por lugar

Como ya anunciamos en mayo de 2023, hemos consolidado los estados de la ubicación de la audiencia en nuestra opción predeterminada actual Personas que viven o han estado recientemente aquí al elegir el tipo de audiencia al que dirigirse con las opciones de la segmentación por lugar. Esta actualización refleja la consolidación de otras opciones disponibles anteriormente y la supresión de la opción Personas de visita en este lugar.

Este cambio atiende a nuestros esfuerzos continuos por aportar más valor a las empresas, simplificar nuestro sistema de anuncios y optimizar nuestras opciones de segmentación para aumentar la eficacia del rendimiento y suprimir opciones que no se usen con frecuencia.

Esta actualización se aplicará a campañas nuevas o duplicadas. Las campañas actuales que se hayan creado antes del lanzamiento no formarán parte de esta nueva experiencia, a menos que estén duplicadas o en borradores.

Adición de “add_security_recommendation” y “code_expiration_minutes” a la API de plantillas de mensajes de WhatsApp

A principios de año lanzamos la solución de autenticación de WhatsApp, que permitía crear y enviar plantillas de autenticación con botones nativos y mensajes de autenticación predefinidos. Con el lanzamiento de la versión 18.0 de la API Graph, vamos a mejorar la recuperación de plantillas de autenticación con el fin de facilitar el proceso de creación de plantillas de autenticación cifrada de extremo a extremo para los proveedores de soluciones empresariales y las empresas.

Con la versión 18.0 de la API Graph, los proveedores de soluciones empresariales y las empresas tendrán una mejor visibilidad del contenido de las plantillas de mensajes de autenticación predefinidas tras su creación. En concreto, las cargas útiles devolverán opciones de configuración de contenido predefinidas, además del texto que utiliza WhatsApp. Esta mejora permite a los proveedores de soluciones empresariales y las empresas crear botones de interfaz de usuario de edición para las plantillas de autenticación que se pueden construir sobre la API.

Ten en cuenta que pueden producirse errores al actualizar la API Graph a la versión 18.0 si los proveedores de soluciones empresariales o las empresas toman la respuesta entera de la solicitud “GET” y la envían de vuelta a la solicitud “POST” para actualizar las plantillas. Para solucionarlo, los campos del texto del cuerpo, el encabezado y el pie de página deben omitirse antes de devolverse a la API.

Relanzamiento de registros de cambios y documentación para desarrolladores para crear anuncios con llamada

  • Ubicación de Facebook Reels para los anuncios con llamada
    Meta va a introducir la posibilidad de entregar anuncios con llamada en la plataforma de Facebook Reels. Los anuncios con llamada permiten a los usuarios llamar a las empresas en el momento de consideración cuando ven un anuncio, y ayudan a estas últimas a generar conversaciones más complejas con la gente que esté interesada. Se trata de una oportunidad para las empresas de publicitarse mediante anuncios con llamada según el comportamiento en tiempo real de la gente en Facebook. En el nivel de conjunto de anuncios en el Administrador de anuncios, las empresas pueden optar por añadir “Facebook Reels” en la sección “Ubicaciones”.
  • Relanzamiento de los anuncios con llamada mediante la API
    El 12 de septiembre de 2023 ofreceremos instrucciones actualizadas para crear anuncios con llamada mediante la API. Vamos a incorporar documentación exclusiva sobre los anuncios con llamada, de forma que los desarrolladores de terceros puedan crear campañas de anuncios con llamada con más facilidad y saber cómo consultar insights sobre las que tengan en circulación, incluidas las métricas relacionadas con las llamadas. También tenemos planificado admitir complementos de llamada mediante nuestra plataforma de API en el futuro. Los desarrolladores deben tener acceso a los permisos generales necesarios para crear anuncios generales para poder crear anuncios con llamada mediante la plataforma de API.

    Consulta la documentación para desarrolladores para obtener más información.

Retiradas y cambios de última hora

Cambios en la API Graph con respecto a la función de permisos detallados para usuarios

Vamos a actualizar dos extremos de la API Graph para “WhatsAppBusinessAccount” Estos extremos son los siguientes:

  • Recuperar plantillas de mensajes asociadas con “WhatsAppBusiness Account”.
  • Recuperar números de teléfono asociados con “WhatsAppBusiness Account”.

Con la versión 18.0 vamos a implementar una nueva función: los permisos detallados para usuarios. Todos los usuarios existentes que ya se hayan añadido a “WhatsAppBusinessAccount” se rellenarán y seguirán teniendo acceso (sin repercusiones).

El administrador puede cambiar estos permisos. Si el administrador cambia el permiso y retira el acceso para ver plantillas de mensajes o números de teléfono a uno de los usuarios, dicho usuario empezará a recibir un mensaje de error que le indicará que no tiene permiso para ver plantillas de mensajes o números de teléfono en la versión 18.0 o versiones anteriores.

Retirada de nombres de métricas obsoletas para insights de usuarios y contenido multimedia de Instagram

A partir del 12 de septiembre, Instagram suprimirá las métricas de insights obsoletas y duplicadas de la API Graph de Instagram para compartir una sola fuente de métricas con nuestros desarrolladores.

Esta nueva actualización reduce las confusiones y aumenta la fiabilidad y la calidad de nuestros informes.

90 días después de este lanzamiento (es decir, el 11 de diciembre de 2023), suprimiremos estas métricas de insights obsoletas y duplicadas de todas las versiones de la API Graph de Instagram para que sean más coherentes con la aplicación de Instagram.

Agradecemos todos los comentarios que hemos recibido de la comunidad de desarrolladores y esperamos seguir trabajando juntos.

Consulta la documentación para desarrolladores sobre las insights de contenido multimedia y las insights de usuarios para obtener más información.

Retirada de todos los extremos de las versiones 1.0 y 2.0 de Facebook Wi-Fi

Facebook Wi-Fi se diseñó para mejorar la experiencia de conexión a zonas wifi en las empresas. Permitía a los clientes de un comerciante conseguir wifi gratuito solo por registrar una visita en Facebook. También permitía a los comerciantes controlar quién podía utilizar su red wifi y durante cuánto tiempo, y se integraba con los anuncios para permitir la segmentación a clientes que habían utilizado el wifi del comerciante. Este producto se retiró el 12 de junio de 2023. Ya que el periodo de aviso a los partners ha finalizado, todos los extremos que utilizan las versiones 1.0 y 2.0 de Facebook Wi-Fi se han retirado y suprimido.

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

  • 14 de septiembre de 2023: la versión 11.0 de la API Graph se retirará y se suprimirá de la plataforma.
  • 8 de febrero de 2024: la versión 12.0 de la API Graph se retirará y se suprimirá de la plataforma.
  • 28 de mayo de 2024: la versión 13.0 de la API Graph se retirará y se suprimirá de la plataforma.

API de marketing

  • 20 de septiembre de 2023: la versión 14.0 de la API de marketing se retirará y se suprimirá de la plataforma.
  • 20 de septiembre de 2023: la versión 15.0 de la API de marketing se retirará y se suprimirá de la plataforma.
  • 6 de febrero de 2024: la versión 16.0 de la API de marketing se retirará y se suprimirá 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:

  • 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 del SDK de la plataforma de Facebook desaparecerán.