Este documento contiene el registro de cambios para 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 enviaste haciendo clic en alguno de los botones "pulgar hacia arriba"/"pulgar hacia abajo"/"Buena respuesta"/"Mala respuesta". Obtén más información sobre el webhook aquí.
Ahora tu app puede hacer 300 (antes podía hacer 100) llamadas por segundo, por cuenta de Instagram profesional, en el caso de los mensajes que contienen 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
Supervisa el Registro de cambios de la plataforma de Instagram para ver los cambios, incluidas las correcciones de errores y nuevas funciones
Ahora, ig_reel
será un tipo de adjunto admitido para el webhook de mensajes. Los adjuntos de reel de IG se categorizarán como tipo ig_reel
y la carga útil del adjunto incluirá el título, la URL y el identificador del video del reel.
ig_reel
y reel
ahora serán tipos de adjunto admitidos en un webhook de mensajes. Los adjuntos de reel de IG se categorizarán como tipo ig_reel
, y la carga útil del adjunto incluirá el título, la URL y el identificador del video del reel. Los adjuntos de reel de FB se categorizarán como tipo reel
y la carga útil del adjunto incluirá el título, la URL y el identificador del video del reel.
Las empresas que usan el enrutamiento de conversaciones de Messenger pueden configurar la capacidad de toma de control de conversaciones en el nivel de cada app individual. La configuración de toma de control original que se combinaba con la app predeterminada quedó obsoleta y se migraron todos los valores. Obtén más información aquí.
Se aplica a todas las versiones.
Además de ad_id
y ad_title
, se devolverá original_media_id
en el objeto media
del campo comments
del objeto value
cuando una persona comente en una publicación promocionada por Instagram o una publicación de anuncios de Instagram. Para obtener más información, consulta Configurar Webhooks para Instagram.
message_edits
El nuevo evento de webhook message_edits
te notifica cuando un usuario edita un mensaje enviado previamente. Obtén más información sobre este evento de webhook aquí.
"Reel" será un tipo de adjunto compatible de webhooks de mensaje que se envía para las conversaciones de Messenger. Los adjuntos de reel se categorizarán como tipo reel
, y la carga útil del adjunto incluirá el título, la URL y el identificador del video del reel.
Los comandos son palabras clave que se pueden tocar y que el usuario puede invocar en cualquier momento para realizar acciones específicas dentro de la experiencia de Messenger. Los comandos se componen del comando en sí mismo y una pista, que informa al usuario sobre la acción que realiza. Por ejemplo, cuando un usuario escribe "ayúdame a reservar vuelos y hoteles en México para la última semana de diciembre," invoca los comandos de vuelos y hoteles que configuró la agencia de viajes. Más información aquí.
El menú de comandos es un nuevo menú que presentaremos y que aparecerá automáticamente cuando se configuren los comandos. Si ya tienes un menú persistente establecido para tu experiencia en Messenger, el menú de comandos lo reemplazará. Más información aquí.
Las personas pueden compartir ahora su experiencia de mensajería desde la página del perfil de la empresa en Messenger. De esta manera, se ayuda a impulsar la publicidad de boca en boca de tu experiencia en Messenger. Más información aquí.
Los comandos aparecerán en el perfil de la empresa una vez que configures los comandos de tu experiencia en Messenger. Las personas pueden ir al perfil del negocio haciendo clic en el nombre de la página ubicado en la parte superior y obtener información sobre los comandos que se pusieron a disposición en relación con la experiencia en Messenger.
La pantalla de bienvenida muestra la lista de comandos que admite la experiencia de mensajería, lo que hace que sea fácil para las personas entender qué acciones puede realizar la experiencia en Messenger. Más información aquí.
Si desarrollas la app para que envíe y reciba mensajes relacionados con tu propia página, no será necesario que la app se someta a la revisión de apps. Ten en cuenta que, si planeas obtener información de usuario, sí será necesario que tu app se someta a la revisión de apps a fin de que se otorguen los permisos necesarios para acceder a la API de perfil de usuario.
La función de enrutamiento de conversaciones ya está disponible en Instagram. El enrutamiento de conversaciones permite a Meta enrutar conversaciones entre tu empresa y los clientes, o los clientes potenciales, a la app que especificaste para que responda en la conversación. Este enrutamiento le permite a tu empresa crear conversaciones interesantes con las personas y minimizar las llamadas de la API a los servidores de Meta.
Se restauró el acceso a la API de etiquetas personalizadas y la API de perfiles para las empresas que operan en Europa y para personas de Europa y Japón que se conectan con empresas de todo el mundo.
Ahora las empresas y agencias pueden conectar fácilmente sus anuncios de clic a Messenger y a Instagram Direct con un mensaje de bienvenida creado en una app de socio sin tener que usar un fragmento de código JSON. El mensaje de bienvenida aparecerá como desplegable en el administrador de anuncios cuando crees un anuncio de clic a Messenger o de clic a Instagram. Obtén más información aquí.
La función de respuesta privada ahora está disponible en los comentarios de Facebook Reels.
Actualizaciones de respuestas privadas para grupos, nuevos campos compatibles con la información del comentador mediante el campo from
y el contexto principal mediante parent_id
, introducido en el webhook group_feed
. Es posible que tengas que actualizar tu servidor de webhooks para poder usar estos nuevos campos.
Los negocios pueden usar varios proveedores externos de mensajes para diferentes conversaciones con clientes, por ejemplo, generación de clientes potenciales, ofertas de marketing relacionadas con los productos o preguntas de atención al cliente. El enrutamiento de conversaciones te permite definir qué socios controlan las conversaciones con clientes en un momento determinado para que estos obtengan la información que necesitan. Puedes crear y administrar reglas de enrutamiento de mensajes en la configuración de la página.
La plantilla de botones envía un mensaje de texto con un máximo de tres botones adjuntos. Esta plantilla es útil para ofrecer al destinatario del mensaje opciones como respuestas predeterminadas a una preguntas o acciones que se deben realizar. Los tipos de botones admitidos son postback
y web_url
.
Los negocios pueden usar varios proveedores externos de mensajes para diferentes conversaciones con clientes, por ejemplo, generación de clientes potenciales, ofertas de marketing relacionadas con los productos o preguntas de atención al cliente. El enrutamiento de conversaciones te permite definir qué socios controlan las conversaciones con clientes en un momento determinado para que estos obtengan la información que necesitan. Puedes crear y administrar reglas de enrutamiento de mensajes en la configuración de la página.
La plantilla de botones envía un mensaje de texto con un máximo de tres botones adjuntos. Esta plantilla es útil para ofrecer al destinatario del mensaje opciones como respuestas predeterminadas a una preguntas o acciones que se deben realizar. Los tipos de botones admitidos son postback
y web_url
.
Los mensajes de Instagram ahora están disponibles en las cuentas profesionales de Instagram de empresas o creadores.
Ahora puedes agregar una plantilla de llamada para permitir que los clientes o las personas que tienen un interés en tu empresa llamen a tu empresa.
Ahora puedes crear anuncios que incluyan un clic a un proceso de suscripción que te permite preguntarles a tus clientes o las personas que tienen un interés en tu empresa si quieren recibir mensajes de marketing.
Ya está disponible el enrutamiento de varias apps para Instagram Direct y Messenger.
Respuestas privadas
Tu negocio ahora puede enviar Respuestas privadas a una persona que haga un comentario en una publicación de un grupo de Facebook.
Notificaciones periódicas
Notificaciones periódicas ahora se conoce como “Mensajes de marketing”.
Plantillas
Ahora se encuentra disponible una plantilla estructurada para reunir información de envíos de un cliente.
API de estadísticas de mensajes
Nuevos parámetros y métricas disponibles para la API de estadísticas de mensajes.
Notificaciones periódicas de la plataforma de Messenger
La propiedad title
de las solicitudes de suscripción voluntaria a notificaciones periódicas dejó de ser obligatoria. Si title
no está configurado, 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 desde cuentas profesionales de Instagram.
Notificaciones periódicas de la plataforma de Messenger
La propiedad notification_messages_frequency
de las solicitudes de suscripción voluntaria de notificaciones periódicas quedó obsoleta y no se devolverá más en las solicitudes GET
o en las notificaciones de webhook. Sin embargo, se admitirán los tokens de mensajes de notificación creados antes del 2 de febrero de 2023 vinculados a las notificaciones periódicas semanales o mensuales, y se devolverá el notification_message_frequency
en las notificaciones de webhook.
Ahora puedes enviar hasta tres mensajes de seguimiento a una persona que se haya suscrito voluntariamente a las notificaciones periódicas. Los tres mensajes de seguimiento se deben enviar dentro de un intervalo de dos minutos desde que se envió el primer mensaje de seguimiento.
El punto de conexión GET /PAGE-ID/notification_message_tokens
ya está disponible para mensajes de Instagram.
Ya está disponible la propiedad next_eligible_time
de los puntos de conexión de los tokens de mensajes de notificación. Este campo devuelve la hora a la que puedes enviar la próxima notificación periódica mediante ese token de mensaje de notificación.
API de Messenger para Instagram
Ahora puedes enviar GIF en los mensajes enviados desde una cuenta profesional de Instagram mediante la API de Messenger para Instagram.
La API de subida de archivos adjuntos admite ahora la subida de contenido multimedia si se trata de 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) se devuelve ahora en las notificaciones de webhook de mensajes.
A partir del 31 de marzo de 2023, ya no podrás descargar un archivo CVS del panel de Messenger Analytics. Visita la API de estadísticas de mensajes para obtener información sobre cómo obtener estas estadísticas.
El inicio de sesión comercial en Instagram te facilita el registro de usuarios de Instagram que todavía no configuraron su cuenta para tener acceso a la API mediante ventanas emergentes modales y realizando menos pasos.
Realizamos un seguimiento en los anuncios de clic a Messenger para la generación de clientes potenciales que funcionan más fácilmente mediante:
La API de eventos de mensajes admite el evento lead_submitted
. Las empresas pueden usar este evento para informar envíos de clientes potenciales de anuncios de clic a Messenger. Este nuevo evento de mensajes se lanzó como versión beta abierta. Pronto, habrá informes en el administrador de anuncios.
Ahora, el menú persistente está disponible para mensajes de Instagram.
Ahora, los mensajes de Instagram admiten respuestas privadas de comentarios en Instagram Live Stories y publicaciones de anuncios. Es posible que tengas que actualizar tu servidor de webhooks para poder usar estos campos nuevos.
Ahora, puedes obtener una lista de tokens de mensajes de notificación válidos con un punto de conexión GET /PAGE-ID/notification_message_tokens
.
Los identificadores de la app ya no se asociarán a los tokens de mensajes de notificación. Todas las apps vinculadas a una página recibirán ahora notificaciones de webhook si una persona optó por recibir notificaciones recurrentes.
Se agregaron los siguientes campos de carga con archivos adjuntos de mensajes:
image_aspect_ratio
: configura una imagen con una relación de aspecto horizontal o cuadrada en el caso de las solicitudes de suscripción voluntaria.elements
: crea una secuencia de imágenes correspondiente a las solicitudes de suscripción voluntaria.notification_message_tokens
: obtiene una lista de tokens de mensajes de notificaciones actuales. notification_messages_cta_text
: personaliza el texto de las llamadas a la acción correspondientes a las solicitudes de suscripción voluntaria.Se agregaron las siguientes maneras de obtener suscripciones voluntarias a las notificaciones recurrentes:
Se agregó el campo title
a la notificación de webhook de notificaciones recurrentes.
La respuesta privada ahora está disponible en los comentarios de Instagram Reels.
Ahora puedes enviar mensajes de Instagram con audios y videos que se subieron al servidor de Meta o se enviaron desde tu servidor.
La API de perfil de usuario permite recuperar el campo del nombre de usuario de Instagram en la API Graph 14.0 y versiones posteriores.
Las notificaciones recurrentes son una actualización importante de la API de Messenger y permiten enviar mensajes automatizados y proactivos que impulsan la recuperación de clientes. Las notificaciones recurrentes ayudan a las empresas a enviar mensajes personalizados y centrados en el cliente en cada etapa del recorrido de este.
Notificaciones recurrentes de la API de Messenger para InstagramPresentamos las notificaciones recurrentes de la API de Messenger para Instagram en modo beta. Los desarrolladores pueden registrarse en nuestra lista de intereses para la versión beta antes de julio.
Aumento del límite de frecuencia de la API de envío de InstagramAumentamos el límite de frecuencia de la API de envío a 100 llamadas de la API por segundo para cada cuenta profesional de Instagram.
Parámetro de referencia ig.meEs posible agregar enlaces ig.me en sitios web, correos electrónicos y paquetes de productos para permitir a los usuarios iniciar fácilmente una conversación con una empresa en Instagram. Las marcas tendrán la capacidad de agregar un parámetro de referencia a estos enlaces ig.me para crear experiencias de mensajes personalizados.
Nuevo proceso de registro para la API de InstagramPresentamos un nuevo proceso de registro de 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.
Lanzamos el menú persistente para brindar compatibilidad de la API de Messenger con Instagram. Esto permite a los usuarios descubrir las funciones principales de una página e interactuar con ellas.
Según el anuncio del 14 de septiembre de 2021, se migrarán ahora todas las páginas de Facebook para que admitan el nuevo comportamiento del protocolo de traspaso. Esperamos que todas las páginas estén migradas antes del 18 de marzo de 2022. Consulta la sección de cambios radicales para obtener más información. A continuación, encontrarás un resumen de las mejoras clave que se anunciaron previamente.
Nos encontramos realizando mejoras en el protocolo de traspaso, que ayuda a los desarrolladores y a las empresas a lanzar experiencias de mensajes (por ejemplo, apps) de manera rápida, facilita pasar el control de las conversaciones entre las apps y asegura una gran experiencia de usuario, ya que evita que las apps intervengan en las conversaciones en curso. Las mejoras clave incluyen el modo exclusivo, el modo de reposo, nuevas API para un control más preciso de la propiedad de la conversación y la eliminación del requisito de asignar roles primarios y secundarios para apps.
Lanzamos la configuración personalizada del punto de entrada del plugin de chat a través de la API y nuestra herramienta de configuración propia. Esto permitirá a las empresas elegir el icono del punto de acceso y la etiqueta que mejor se adapten a su marca de entre un conjunto de valores predefinidos. Si quieres obtener más información, consulta nuestra documentación para desarrolladores.
La API de Messenger para Instagram ya está disponible para el tipo de cuenta de creador de Instagram con menos de 500.000 seguidores. Consulta detalles en la documentación para desarrolladores.
https://ig.me/m/{ig_profile_handle}
en el sitio web, el correo electrónico u otros lugares. Consulta la documentación para desarrolladores si quieres obtener información detallada.Mejoras en el protocolo de traspaso
API de etiquetas personalizadas: nos encontramos incorporando actualizaciones increíbles a la API de etiquetas personalizadas, que les permitirán a las empresas crear, actualizar y eliminar etiquetas, y sincronizar las etiquetas entre la bandeja de entrada de la página de Facebook y cualquier otra herramienta que utilice la empresa para comunicarse con sus clientes.
v12.0
y posterior de la API Graph, el campo name
de la API de etiquetas personalizadas se reemplazará con page_label_name
. Este cambio tendrá efecto en todas las versiones anteriores de la API Graph a partir del 14 de diciembre de 2021. Los desarrolladores deberían aprovechar page_label_name
en varias llamadas CRUD (crear, recuperar, actualizar y eliminar) a la API y en varios webhooks.Actualizaciones de la API de Messenger para Europa y Japón: restauramos las plantillas de comentarios de clientes de la API de Messenger que no estaban disponibles para las empresas en Europa ni para las personas de Europa y Japón que se conectan con empresas de todo el mundo. Obtén más información aquí.
API de Messenger para actualizaciones de Instagram
Webhook de reacciones: actualizamos las reacciones con emojis para devolver un formato unicode único y admitir múltiples reacciones con emojis. Consulta la documentación para desarrolladores y migra a la nueva versión antes del 14 de diciembre de 2021 para poder seguir admitiendo las reacciones con emojis.
API de perfil de usuario: actualizamos la API de perfil de usuario para que incluya campos adicionales que están disponibles para todos los usuarios en la app de Instagram. Consulta la documentación para desarrolladores si quieres obtener información detallada.
Identificador de IG obsoleto: la API de conversaciones dejará de devolver el campo IGID
y se basará completamente en el campo IGSID
. Consulta la documentación para desarrolladores a fin de obtener información detallada sobre cómo realizar la migración antes del 14 de diciembre de 2021.
API de personalización del plugin de chat de Facebook: lanzamos la configuración de personalización del plugin de chat mediante la API. Con este nuevo lanzamiento, los desarrolladores podrán editar las funciones, entre las que se incluyen la posición, el color, los saludos, la configuración del modo de invitado, etc., que en estos momentos solo están disponibles si se usan nuestras herramientas de origen.
El webhook con eco de mensajes incluirá ahora el identificador de la app para la bandeja de entrada de la página de Facebook como parte de la API Graph v12.0
: si una empresa responde a una conversación en Messenger desde la bandeja de entrada de la página de Facebook, las otras apps conectadas a la página pueden escuchar el webhook eco de mensajes. Estas apps recibirán un webhook eco con el identificador de la app de la bandeja de entrada de la página de Facebook (263902037430900
).
Los siguientes cambios se aplican a partir de la versión 11.0.
Se agregó <mid>
a los eventos messaging_postback
de Messenger y de la API de Messenger para la versión 11.0 y posteriores de la API Graph de Instagram: agregamos el campo de identificador de mensaje (<mid>
) como parte de la carga messaging_postback
para ayudar a reducir los gastos de ingeniería de nuestros socios, que deben confiar en la API de conversaciones para obtener el historial de la conversación y compararlo con los eventos del webhook. Puedes obtener más detalles aquí.
Quedaron obsoletas las plantillas para aerolíneas: se dejarán de admitir las plantillas para aerolíneas a partir de la versión 11 de la API Graph. El 6 de diciembre de 2021, es decir, 6 meses después de haberse anunciado este cambio, también quedarán obsoletas para las versiones anteriores de la API Graph. Recomendamos a las aerolíneas enviar las plantillas de tarjeta de embarque y check-in como imágenes, lo que guarda relación con la forma en la que se suelen enviar estas notificaciones en otros canales.
La API de Messenger de Instagram: pusimos la API de Messenger de Instagram a disposición de todos los desarrolladores que hacen posible que las marcas puedan ofrecer experiencias de mensajes a escala en Instagram. Los desarrolladores podrán ahora agregar mensajes de Instagram en sus apps y crear experiencias de mensajes para Instagram. Los desarrolladores pueden ayudar a que las empresas usen las diferentes apps para mejorar los flujos de trabajo existentes, impulsar conversaciones más significativas, aumentar la satisfacción del cliente e incrementar las ventas. Más información aquí. El uso de la API de Messenger para Instagram debe cumplir con las Políticas para desarrolladores, en particular, las políticas que figuran en "API de Messenger y de mensajes de Instagram" y en la documentación técnica.
La etiqueta de mensajes de agente humano ya está disponible para todos los desarrolladores. Esta etiqueta permite a las empresas responder a los mensajes de los usuarios en Messenger e Instagram de forma manual fuera del intervalo de mensajes estándar de 24 horas durante un período de hasta 7 días. Esta etiqueta es especialmente útil para los casos de uso, como cierres durante el fin de semana o consultas que no se puedan resolver dentro de las 24 horas. Los desarrolladores deberían solicitar el permiso de etiqueta de Human Agent a través del panel de apps, incluso si tu app ya obtuvo anteriormente la aprobación para utilizar la etiqueta de mensajes de Human Agent. Ve a la sección "Permisos y funciones" del panel de apps y solicita el permiso "Human Agent". Más información aquí.
La plantilla de comentarios de clientesahora está disponible en versión beta: lanzamos una plantilla nativa dentro de Messenger, que es compatible con los formatos de encuesta comunes como CSAT (Customer Satisfaction), NPS (Net Promoter Score), CES (Customer Effort Score) y texto en formato libre. La plantilla nativa es más fácil de integrar, porque está compilada en una API de envío, elimina la necesidad de crear soluciones de encuestas para clientes usando la vista web y simplifica la tarea de los desarrolladores de totalizar puntajes en todos los canales que usan formatos de encuestas similares. Más información aquí.