Volver a las novedades para desarrolladores

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

12 de septiembre de 2023DeNaveen Santhanavel

Hoy lanzamos la API Graph 18.0 y la API de marketing 18.0 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 generales

Consolidación de las opciones de estado de la ubicación del público para la segmentación por lugar

Como ya anunciamos en mayo de 2023, consolidamos el estado de la ubicación del público en la opción predeterminada actual "Personas que viven o que estuvieron hace poco en este lugar" cuando los anunciantes elijan el tipo de público al que se dirigen dentro de su segmentación por lugar. Este cambio refleja la consolidación de otras opciones disponibles previamente y la eliminación de la opción "Personas de visita en este lugar".

La actualización forma parte de nuestra iniciativa continua de brindar más valor a las empresas, simplificar nuestro sistema de anuncios y agilizar las opciones de segmentación a fin de aumentar la eficiencia del rendimiento y eliminar las opciones que tienen poco uso.

La actualización se aplicará a las campañas nuevas o duplicadas. Las campañas creadas antes del lanzamiento no se incluirán en esta nueva experiencia a menos que estén en modo de borrador o duplicadas.

Incorporación de "add_security_recommendation" y "code_expiration_minutes" a la API de plantillas de mensajes de WhatsApp

A principios de este año, lanzamos la solución de autenticación de WhatsApp, que hizo posible crear y enviar plantillas de autenticación con botones nativos y mensajes de autenticación predefinidos. El lanzamiento de la API Graph versión 18 incluye mejoras en la recuperación de plantillas de autenticación, por lo que el proceso completo de creación de plantillas de autenticación resulta más sencillo para los BSP y las empresas.

Con la API Graph versión 18, los BSP y las empresas tienen más visibilidad del contenido de las plantillas de mensajes de autenticación predefinidas después de crearlas. Específicamente, las cargas devolverán opciones de configuración de contenido predefinidas, además del texto que utiliza WhatsApp. Esta mejora puede permitir a los BSP y a las empresas crear interfaces de usuario de "edición" de plantillas de autenticación que pueden desarrollarse partir de la API.

Ten en cuenta que pueden producirse errores al actualizar a la API Graph versión 18 si los BSP o las empresas toman la respuesta completa de la solicitud GET y la devuelven a la solicitud POST para actualizar las plantillas. Para resolverlo, los campos de texto "body", "header" y "footer" deben eliminarse antes de pasarlos a la API.

Relanzamiento de la documentación para desarrolladores y de los registros de cambios para crear anuncios con el destino "Llamada telefónica"

  • Ubicación de Facebook Reels para los anuncios con el destino "Llamada telefónica"
    Meta lanzará la posibilidad de entregar anuncios con el destino "Llamada telefónica" a través de la plataforma Facebook Reels. Los anuncios con el destino "Llamada telefónica" permiten a los usuarios llamar a las empresas en el momento de consideración cuando ven un anuncio, y ayudan a las empresas a mantener conversaciones más complejas con los usuarios interesados. Esta es una oportunidad para que las empresas hagan publicidad con anuncios con el destino "Llamada telefónica" en función del comportamiento de las personas en tiempo real en Facebook. En el nivel del conjunto de anuncios del administrador de anuncios, las empresas tienen la opción de agregar "Facebook Reels" en la sección "Ubicaciones"
  • .
  • Relanzamiento de los anuncios con el destino "Llamada telefónica" a través de la API
    El 12 de septiembre de 2023, proporcionaremos asesoramiento actualizado sobre cómo crear anuncios con el destino "Llamada telefónica" a través de la API. Incorporaremos documentación exclusiva para los anuncios con el destino "Llamada telefónica", de modo que los desarrolladores de terceros puedan crear campañas de anuncios de este tipo con mayor facilidad y sepan cómo ver la información sobre dichas campañas, incluidas las métricas relacionadas con las llamadas. A futuro, también tenemos previsto admitir complementos de llamada a través de la plataforma de nuestra API. Los desarrolladores deben tener acceso a los permisos generales necesarios para crear anuncios generales a fin de poder crear anuncios con el destino "Llamada telefónica" a través de la plataforma de la API.

    Para obtener más información, consulta la documentación para desarrolladores.

Elementos obsoletos y cambios radicales

Cambios en la API Graph relacionados con la función de permisos detallados de usuario

Actualizamos dos puntos de conexión de la API Graph correspondientes a "WhatsAppBusinessAccount". Los puntos de conexión son los siguientes:

  • Recuperar plantillas de mensajes asociadas a "WhatsAppBusinessAccount"
  • Recuperar números de teléfono asociados a "WhatsAppBusinessAccount"

Con la versión 18, implementamos una nueva función: "permisos detallados de usuario". Los usuarios actuales que ya fueron agregados a "WhatsAppBusinessAccount" se incluirán y seguirán teniendo acceso (en otras palabras, no se verán afectados).

El administrador tiene la flexibilidad de cambiar estos permisos. Si el administrador cambia el permiso y elimina el acceso de uno de sus usuarios para ver plantillas de mensajes o números de teléfono, ese usuario empezará a recibir un mensaje de error que le indicará que no tiene permiso para ver plantillas de mensajes ni números de teléfono en todas las versiones anteriores a la versión 18.

Las métricas anteriores de estadísticas multimedia y de usuarios de Instagram quedarán obsoletas

A partir del 12 de septiembre, Instagram eliminará las métricas de estadísticas duplicadas y anteriores de la API Graph de Instagram para proporcionar una única fuente de métricas a nuestros desarrolladores.

Esta nueva actualización evita confusiones y aumenta la confiabilidad y calidad de nuestros informes.

Transcurridos 90 días de este lanzamiento (es decir, el 11 de diciembre de 2023), eliminaremos todas estas métricas de estadísticas duplicadas y anteriores de la API Graph de Instagram en todas las versiones para mantener la coherencia con la app de Instagram.

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

Para obtener más información, consulta la documentación para desarrolladores sobre las estadísticas multimedia y las estadísticas de usuarios.

Todos los puntos de conexión de Facebook Wi-Fi versión 1 y Facebook Wi-Fi versión 2 quedaron obsoletos

Facebook Wi-Fi se diseñó para mejorar la experiencia de conexión a zonas wifi en los negocios. Permitía a los clientes de un comerciante obtener wifi gratis con solo registrarse en Facebook. También permitía a los comerciantes controlar quién podía utilizar su wifi y durante cuánto tiempo, y se integraba con los anuncios para habilitar la posibilidad de dirigirse a los clientes que habían utilizado el wifi del comerciante. Este producto dejó de estar disponible el 12 de junio de 2023. Ya que finalizó el periodo de notificación a los socios, todos los puntos de conexión que utilizaba Facebook Wi-Fi versión 1 y Facebook Wi-Fi versión 2 quedaron obsoletos y se eliminaron.

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

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

API de marketing

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

  • Octubre de 2023: se desactivará la versión 11.0 y las versiones anteriores del SDK de la plataforma de Facebook.
  • Febrero de 2024: se desactivará la versión 12.0 y las versiones anteriores del SDK de la plataforma de Facebook.