En este documento se incluye el registro de cambios de las versiones actuales de la plataforma de Messenger. La plataforma de Messenger sigue el control de versiones de la API Graph.
Versión más reciente: v21.0
response_feedback
de MessengerEl nuevo evento de webhook response_feedback
te notifica cuando un usuario proporciona comentarios sobre un mensaje que has enviado haciendo clic uno de los botones siguientes: pulgar hacia arriba, pulgar hacia abajo, buena respuesta o mala respuesta. Obtén más información sobre el webhook aquí.
Las aplicaciones ahora pueden realizar 300 llamadas (antes solo se podían 100) por segundo por cuenta profesional de Instagram para mensajes que incluyan texto, enlaces, reacciones y stickers. Más información.
Componentes de esta nueva API de Instagram:
graph.instagram.com
.instagram_business_basic
instagram_business_content_publishing
instagram_business_manage_comments
instagram_business_manage_messages
Consulta el registro de cambios de la plataforma de Instagram para ver los cambios, incluidas las correcciones de errores y las nuevas funciones.
ig_reel
ahora se admitirá como tipo de archivo adjunto para el webhook de mensajes. Los archivos adjuntos de reels de Instagram tendrán el tipo ig_reel
y la carga útil del archivo adjunto incluirá el título, la URL y el identificador del vídeo del reel.
ig_reel
y reel
ahora se admitirán como tipos de archivo adjunto en el webhook de mensajes. Los archivos adjuntos de reels de Instagram tendrán el tipo ig_reel
y la carga útil del archivo adjunto incluirá el título, la URL y el identificador del vídeo del reel. Los archivos adjuntos de reels de Facebook tendrán el tipo reel
y la carga útil del archivo adjunto incluirá el título, la URL y el identificador del vídeo del reel.
Las empresas que utilizan el enrutamiento de conversaciones de Messenger ahora pueden configurar la capacidad de toma de control de las conversaciones a nivel individual de la aplicación. La configuración de toma de control original que va junto con la aplicación predeterminada está obsoleta y todos los valores se han migrado. Obtén más información aquí.
Se aplica a todas las versiones.
Además de los valores de ad_id
y ad_title
, también se devolverá el valor de original_media_id
en el objeto media
del objeto value
del campo comments
cuando una persona comente en una publicación de Instagram promocionada o en una publicación de anuncios de Instagram. Para obtener más información, consulta Configurar webhooks para Instagram.
message_edits
El nuevo evento del webhook message_edits
te notifica cuando un usuario edita un mensaje enviado previamente. Obtén más información sobre este evento del webhook aquí.
Ahora “Reel” será un tipo de archivo adjunto admitido para los webhooks de mensajes enviados para las conversaciones de Messenger. Los archivos adjuntos de reels se clasificarán con el tipo reel
y la carga útil del archivo adjunto incluirá el título, la URL y el identificador del vídeo del reel.
Los comandos son palabras clave que se pueden tocar y que el usuario puede invocar en cualquier momento para realizar acciones concretas en la experiencia de Messenger. Los comandos se componen del comando en sí y una pista que informa al usuario de lo que hace. Por ejemplo, cuando un usuario escribe “ayúdame a reservar vuelos a México y hoteles para la última semana de diciembre”, invoca los comandos de vuelos y hoteles que haya configurado la empresa de viajes. Obtén más información aquí.
El menú de comandos es un nuevo menú que presentamos y que aparecerá automáticamente cuando configures los comandos. Si ya tienes un menú persistente para la experiencia de Messenger, el menú de comandos lo anulará. Obtén más información aquí.
Los usuarios ahora pueden compartir su experiencia de mensajes desde la página de perfil de la empresa en Messenger. Esto ayuda a impulsar el descubrimiento de boca en boca de la experiencia de Messenger. Obtén más información aquí.
Los comandos aparecerán en el perfil de la empresa al configurar los comandos para la experiencia de Messenger. Para acceder al perfil de la empresa, los usuarios pueden tocar el nombre de la página en la parte superior y obtener información sobre los comandos que has puesto a su disposición en la experiencia de Messenger.
En la pantalla de bienvenida se muestra la lista de comandos que admite la experiencia de mensajes, lo que hace más fácil para los usuarios entender qué acciones puede realizar la experiencia de Messenger. Obtén más información aquí.
Si estás desarrollando la aplicación para enviar y recibir mensajes para tu propia página, no es necesario que se someta al proceso de revisión. Ten en cuenta que, si tienes pensado obtener información del perfil de los usuarios, la aplicación deberá someterse a revisión para obtener los permisos necesarios para acceder a la API de perfiles de usuario.
El enrutamiento de conversaciones ya está disponible para Instagram. El enrutamiento de conversaciones permite a Meta enrutar conversaciones entre las empresas y los clientes, o los clientes potenciales, a la aplicación que se ha especificado para que responda en la conversación. Este enrutamiento permite al negocio crear conversaciones enriquecidas con los usuarios y minimizar las llamadas a la API a los servidores de Meta.
El acceso a la API de etiquetas personalizadas y la API de perfiles se ha restaurado para las empresas que operan en Europa y para los usuarios de Europa y Japón que se ponen en contacto con empresas de todo el mundo.
Las empresas y agencias ahora pueden conectar fácilmente sus anuncios de clic a Messenger y clic a Instagram Direct a un mensaje de bienvenida creado en una aplicación de socio sin tener que utilizar un fragmento de código JSON. El mensaje de bienvenida aparecerá como una opción desplegable en el Administrador de anuncios al crear el anuncio de clic a Messenger y clic a Instagram Direct. Obtén más información al respecto aquí.
La respuesta privada ya está disponible para los comentarios en Facebook Reels.
Se han introducido actualizaciones de las respuestas privadas para grupos, campos nuevos que admiten información del usuario que comenta mediante el campo from
y contexto principal mediante parent_id
en el webhook group_feed
. Es posible que tengas que actualizar el servidor de webhooks para que gestione estos nuevos campos.
Como empresa, es posible que utilices varios proveedores de mensajes de terceros para diferentes conversaciones con tus clientes, por ejemplo, destinados a la generación de clientes potenciales, a ofertas de marketing sobre tus productos o a preguntas de asistencia de los clientes. El enrutamiento de conversaciones te permite definir qué socios controlan las conversaciones con los clientes en un momento determinado, con el fin de que estos consigan la información que necesitan. Puedes crear y administrar las reglas para el enrutamiento de mensajes en la configuración de tu página.
La plantilla de botones permite enviar un mensaje de texto con un máximo de tres botones adjuntos. Esta plantilla resulta útil para ofrecer varias opciones entre las que elegir al destinatario del mensaje, como posibles acciones que realizar o respuestas predeterminadas a una pregunta. Los tipos de botones admitidos son postback
y web_url
.
Como empresa, es posible que utilices varios proveedores de mensajes de terceros para diferentes conversaciones con tus clientes, por ejemplo, destinados a la generación de clientes potenciales, a ofertas de marketing sobre tus productos o a preguntas de asistencia de los clientes. El enrutamiento de conversaciones te permite definir qué socios controlan las conversaciones con los clientes en un momento determinado, con el fin de que estos consigan la información que necesitan. Puedes crear y administrar las reglas para el enrutamiento de mensajes en la configuración de tu página.
La plantilla de botones permite enviar un mensaje de texto con un máximo de tres botones adjuntos. Esta plantilla resulta útil para ofrecer varias opciones entre las que elegir al destinatario del mensaje, como posibles acciones que realizar o respuestas predeterminadas a una pregunta. Los tipos de botones admitidos son postback
y web_url
.
Los mensajes de Instagram ya están disponibles para todas las cuentas profesionales de Instagram de empresa o de creador.
Ahora puedes añadir una invitación de llamada para permitir que tus clientes o las personas interesadas en tu empresa te llamen.
Ahora puedes crear anuncios que incluyan un proceso de clic para suscribirse que permita preguntar a los clientes o a las personas interesadas en tu empresa si quieren activar los mensajes de marketing de tu empresa.
El enrutamiento multiaplicación ya está disponible para Instagram Direct y Messenger.
Respuestas privadas
Tu empresa ahora puede enviar respuestas privadas a un usuario que haya comentado en una publicación de un grupo de Facebook.
Notificaciones recurrentes
Las notificaciones recurrentes ahora se conocen como “mensajes de marketing”.
Plantillas
Ahora se puede usar una plantilla estructurada para obtener información sobre el envío de un cliente.
API de insights de mensajes
Hay disponibles nuevas métricas y parámetros para la API de insights de mensajes.
Notificaciones recurrentes de la plataforma de Messenger
La propiedad title
de las solicitudes de suscripción voluntaria a notificaciones recurrentes ya no se requiere. Si no se establece title
, el valor predeterminado es “Actualizaciones y promociones”. Este cambio se aplica a las solicitudes de suscripción voluntaria enviadas desde una página de Facebook o cuentas profesionales de Instagram.
Notificaciones recurrentes de la plataforma de Messenger
La propiedad notification_messages_frequency
de las solicitudes de suscripción voluntaria a notificaciones recurrentes se ha retirado y ya no se devolverá en las solicitudes GET
ni las notificaciones de webhooks. No obstante, se admitirán los identificadores de mensajes de notificación creados antes del 2 de febrero de 2023 para notificaciones recurrentes semanales o mensuales y notification_message_frequency
se devolverá en las notificaciones de webhooks.
Ahora puedes enviar hasta tres mensajes de seguimiento a los usuarios que hayan aceptado recibir notificaciones recurrentes. Los tres mensajes de seguimiento deben enviarse durante los dos minutos posteriores al primer mensaje de seguimiento.
El extremo GET /PAGE-ID/notification_message_tokens
ahora está disponible para los mensajes de Instagram.
La propiedad next_eligible_time
para los extremos de identificadores de mensajes de notificación ahora está disponible. Este campo devuelve la hora a la que puedes enviar la siguiente notificación recurrente mediante ese identificador de mensaje de notificación.
Messenger API for Instagram
Ahora puedes enviar GIF en mensajes enviados desde una cuenta profesional de Instagram con la Messenger API for Instagram.
La API de subida de archivos adjuntos ahora admite la subida de contenido multimedia para mensajes enviados desde una cuenta profesional de Instagram.
La información de referencia de los anuncios de clic a una conversación de Instagram (CTD) ahora se devuelve en las notificaciones de webhooks de mensajes.
A partir del 31 de marzo de 2023, no podrás descargar un archivo CSV del panel de análisis de Messenger. Si quieres saber cómo obtener estos insights, visita la API de insights de mensajes.
El inicio de sesión empresarial para Instagram te facilita la incorporación de usuarios de Instagram que todavía tienen que configurar su cuenta para acceder a la API mediante ventanas emergentes con cuadros de diálogo y menos pasos.
Hemos simplificado el seguimiento de los anuncios de generación de clientes potenciales de clic a Messenger con las siguientes mejoras:
La API de eventos de mensajes admite el evento lead_submitted
. Las empresas pueden usar este evento para informar de las solicitudes de los clientes potenciales de los anuncios de clic a Messenger. Este nuevo evento de mensajes se va a lanzar como una función en versión beta abierta. Próximamente se lanzará la función de informar en el Administrador de anuncios.
El menú persistente ahora está disponible para los mensajes de Instagram.
Los mensajes de Instagram ahora admiten las respuestas privadas para los comentarios de publicaciones de anuncios e historias de Instagram Live. Es posible que tengas que actualizar el servidor de webhooks para que gestione estos nuevos campos.
Ahora puedes obtener una lista de todos los identificadores válidos de mensajes de notificaciones mediante el extremo GET /PAGE-ID/notification_message_tokens
.
Los identificadores de aplicaciones ya no se asociarán a los identificadores de mensajes de notificaciones. Todas las aplicaciones vinculadas a una página ahora recibirán notificaciones del webhook de activación cuando un usuario haya activado la recepción de notificaciones recurrentes.
Se han añadido los siguientes campos de carga útil de archivos adjuntos de mensajes:
image_aspect_ratio
: establece una imagen con una relación de aspecto horizontal o cuadrada para las solicitudes de activación.elements
: crea una secuencia de imágenes para las solicitudes de activación.notification_message_tokens
: obtén una lista de los identificadores actuales de mensajes de notificaciones. notification_messages_cta_text
: personaliza el texto de las llamadas a la acción para las solicitudes de activación.Se han añadido los siguientes métodos para recibir las activaciones de las notificaciones recurrentes:
Se ha añadido el campo title
a la notificación de webhooks de notificaciones recurrentes.
La respuesta privada ya está disponible para los comentarios en los reels de Instagram.
Ahora puedes enviar mensajes de Instagram con audio y vídeos que se hayan subido a un servidor de Meta o enviado desde tu servidor.
La API de perfiles de usuario admite la recuperación del campo de nombre de usuario de Instagram del cliente en la versión 14.0 y posteriores de la API Graph.
Las notificaciones recurrentes suponen una actualización importante para la API de Messenger a fin de permitir a las empresas enviar mensajes proactivos y automatizados que inciten a los usuarios a volver a interactuar. Las notificaciones recurrentes ayudan a las empresas a entregar mensajes personalizados y centrados en los clientes en cada fase del recorrido del cliente.
Notificaciones recurrentes para la API de Messenger para InstagramAnunciamos las notificaciones recurrentes para la API de Messenger para Instagram como función en versión beta. Los desarrolladores pueden suscribirse a nuestra lista de intereses beta antes de julio.
Aumento del límite de frecuencia de la API de envío de InstagramHemos aumentado el límite de frecuencia de la API de envío a 100 llamadas a la API por segundo para cada cuenta profesional de Instagram.
Parámetro de referencia de ig.meLas empresas pueden añadir enlaces ig.me en sitios web, mensajes de correo electrónico y embalajes de productos para permitir a los usuarios iniciar una conversación con una empresa en Instagram de forma sencilla. Incorporamos la posibilidad de que las marcas añadan un parámetro de referencia a estos enlaces ig.me para crear experiencias de mensajes personalizadas.
Nuevo proceso de incorporación para la API de InstagramAnunciamos un nuevo proceso de incorporación para la API de Instagram como versión beta. Los desarrolladores pueden registrarse en nuestra lista de intereses de la versión beta antes del 29 de junio.
Hemos lanzado el menú persistente para la compatibilidad de la API de Messenger con Instagram. Este menú permite a los usuarios descubrir las principales funciones de una página e interactuar con ellas.
Según el aviso del 14 de septiembre de 2021, ahora todas las páginas de Facebook se migrarán para admitir el nuevo comportamiento del protocolo de traspaso. Esperamos que todas las páginas se hayan migrado antes del 18 de marzo de 2022. Consulta la sección de cambios de última hora para obtener más detalles. A continuación, se incluye un resumen de las principales mejoras que se anunciaron previamente.
Estamos realizando mejoras en el protocolo de traspaso, que permite a los desarrolladores y las empresas lanzar experiencias de mensajes (p. ej., aplicaciones) rápidamente, facilita la transmisión del control de la conversación entre aplicaciones e impide que las aplicaciones interrumpan las conversaciones actuales a fin de garantizar una excelente experiencia de usuario. Entre las principales mejoras se incluyen el modo exclusivo, el modo inactivo, las nuevas API para realizar un control más exhaustivo de la propiedad del hilo y la eliminación del requisito para asignar roles primarios o secundarios para aplicaciones
Hemos lanzado la configuración de personalización del punto de acceso del plugin de chat a través de la API, así como nuestra propia herramienta de configuración. De esta forma, las empresas pueden elegir el icono y la etiqueta del punto de acceso que mejor se adapten a su marca de entre un conjunto de valores predefinidos. Para obtener más información, consulta nuestra documentación para desarrolladores.
La Messenger API for Instagram ahora está disponible para las cuentas de creador de Instagram con menos de 500 000 seguidores. Consulta los detalles en la documentación para desarrolladores.
https://ig.me/m/{ig_profile_handle}
en el sitio web, el correo electrónico, etc. Consulta la documentación para desarrolladores a fin de obtener más detalles.Mejoras en el protocolo de traspaso
API de etiquetas personalizadas: estamos realizando increíbles actualizaciones en la API de etiquetas personalizadas que permitirán a las empresas crear, actualizar y eliminar etiquetas, así como sincronizar dichas etiquetas entre la bandeja de entrada de la página de Facebook y cualquier otra herramienta que la empresa pueda estar usando para comunicarse con sus clientes.
name
de la API de etiquetas personalizadas de la versión v12.0
o posteriores de la API Graph se reemplazará por page_label_name
. Este cambio se aplicará a todas las versiones de la API Graph anteriores a partir del 14 de diciembre de 2021. El desarrollador debe utilizar page_label_name
en varios webhooks y llamadas a la API de tipo CRUD (crear, recuperar, actualizar y eliminar).Actualizaciones de la Messenger API para Europa y Japón: hemos restaurado la plantilla de comentarios del cliente en la Messenger API que no estaba disponible para las empresas de Europa, así como para los usuarios de Europa y Japón que tienen contacto con empresas de todo el mundo. Puedes obtener detalles aquí.
Actualizaciones de la API de Messenger para Instagram
Webhook de reacciones: hemos actualizado las reacciones con emoticonos para que devuelvan un nuevo formato Unicode y admitan varias reacciones con emoticonos. Consulta la documentación para desarrolladores y realiza la migración a la nueva versión antes del 14 de diciembre de 2021 a fin de seguir admitiendo las reacciones con emoticonos.
API de perfiles de usuario: hemos actualizado la API de perfiles de usuario para que incluya campos adicionales que están disponibles públicamente en la aplicación de Instagram. Consulta la documentación para desarrolladores a fin de obtener detalles.
Retirada de IGID: la API de conversaciones ya no devolverá el campo IGID
y se basará por completo en el campo IGSID
. Consulta la documentación para desarrolladores a fin de obtener detalles y realizar la migración antes del 14 de diciembre de 2021.
API de personalización del plugin de chat de Facebook: lanzaremos la configuración de personalización del plugin de chat a través de la API. Con esta nueva versión, los desarrolladores podrán editar funciones como la posición, el color, los saludos, la configuración del modo de invitado, etc., que actualmente solo están disponibles con el uso de nuestras herramientas.
El webhook de eco de mensajes ahora incluirá el identificador de la aplicación para la bandeja de entrada de la página de Facebook como parte de la versión v12.0
de la API Graph: cuando una empresa responda a una conversación de Messenger desde la bandeja de entrada de la página de Facebook, otras aplicaciones conectadas a la página podrán escuchar el webhook de eco de mensajes. Estas aplicaciones recibirán un webhook de eco con el identificador de la aplicación de la bandeja de entrada de la página de Facebook (263902037430900
).
Los cambios siguientes se aplican en la versión 11.0 y posteriores.
Adición <mid>
de los eventos messaging_postback
de Messenger y Messenger API for Instagram para la versión 11.0 y posteriores de la API Graph: hemos añadido el campo de identificador del mensaje (<mid>
) como parte de la carga útil de messaging_postback
para reducir los gastos de ingeniería de nuestros socios que han tenido que confiar en la API de conversaciones a fin de recuperar el historial de conversaciones y, luego, compararlo con los eventos del webhook. Puedes consultar más detalles aquí.
Se han retirado las plantillas de aerolíneas: estas plantillas ya no se admitirán a partir de la versión 11 de la API Graph. La retirada de las versiones anteriores de la API Graph tendrá lugar seis meses después del anuncio de este cambio el día 6 de diciembre de 2021. Recomendamos a las aerolíneas que envíen las plantillas de tarjeta de embarque y facturación como imágenes que sean coherentes con la forma habitual de enviar estas notificaciones en otros canales.
Messenger API for Instagram: hemos puesto la Messenger API for Instagram a disposición de todos los desarrolladores que permiten que las marcas ofrezcan experiencias de mensajes en Instagram a gran escala. Ahora, los desarrolladores pueden añadir mensajes de Instagram a sus aplicaciones y crear experiencias para mensajes de Instagram. Los desarrolladores pueden ayudar a las empresas a utilizar distintas aplicaciones para aprovechar los procesos de trabajo existentes, impulsar conversaciones significativas, mejorar la satisfacción del cliente e incrementar las ventas. Puedes obtener más información aquí. El uso de la Messenger API for Instagram debe cumplir con las Políticas para desarrolladores y, en especial, con las que se enumeran en la sección “API de mensajes de Messenger e Instagram”, así como en la documentación técnica.
La etiqueta de mensajes de agente humano ahora está disponible para todos los desarrolladores: esta etiqueta permite que las empresas respondan a los mensajes del usuario en Messenger e Instagram manualmente fuera del intervalo de mensajes estándar de 24 horas durante un máximo de siete días. Resulta útil especialmente para casos de uso, como cierres de fin de semana o consultas que tardan más de 24 horas en resolverse. Los desarrolladores deben solicitar el permiso de la etiqueta de agente humano a través del panel de aplicaciones aunque tu aplicación se haya aprobado para dicha etiqueta. Ve a la sección "Permisos y funciones" del panel de aplicaciones y solicita el permiso "Agente humano". Obtén más información aquí.
La plantilla de comentarios del clienteya está disponible en versión beta: hemos lanzado una plantilla nativa en Messenger que admite formatos de encuesta comunes, como CSAT (satisfacción del cliente), NPS (puntuación neta del promotor), CES (puntuación del esfuerzo del cliente) y texto de formato libre. La plantilla nativa es más fácil de integrar porque se basa en la API de envío, elimina la necesidad de crear soluciones de encuestas personalizadas con la vista web y permite a los desarrolladores agregar puntuaciones fácilmente en canales que usan formatos de encuesta similares. Obtén más información aquí.