Ce document contient le changelog pour les versions actuelles de la plateforme Messenger. La plateforme Messenger suit la gestion de versions de l’API Graph.
Dernière version : v21.0
response_feedback
MessengerLe nouvel évènement webhook response_feedback
vous avertit lorsqu’un·e utilisateur·ice commente un message que vous avez envoyé en cliquant sur l’un des boutons « pouce levé », « pouce vers le bas », « Bonne réponse » ou « Mauvaise réponse ». En savoir plus sur le webhook.
Votre application peut désormais passer 300 (au lieu des 100 précédemment) appels par seconde et par compte professionnel Instagram pour les messages qui contiennent du texte, des liens, des réactions et des stickers. En savoir plus.
Composants de cette nouvelle API Instagram :
graph.instagram.com
.instagram_business_basic
instagram_business_content_publishing
instagram_business_manage_comments
instagram_business_manage_messages
Consultez régulièrement le changelog de la plateforme Instagram pour connaître les changements apportés, notamment les bugs corrigés et les fonctionnalités ajoutées.
Le type de pièce jointe ig_reel
est désormais pris en charge pour le webhook des messages. Les pièces jointes de reel Instagram auront le type ig_reel
et leur charge utile comprendra le titre, l’URL et l’ID de la vidéo du reel.
Les types de pièce jointe ig_reel
et reel
sont désormais pris en charge dans le webhook des messages. Les pièces jointes de reel Instagram auront le type ig_reel
et leur charge utile comprendra le titre, l’URL et l’ID de la vidéo du reel. Les pièces jointes de reel Facebook auront le type reel
et leur charge utile comprendra le titre, l’URL et l’ID de la vidéo du reel.
Les entreprises qui utilisent le routage des conversations Messenger peuvent désormais configurer la fonctionnalité de reprise de contrôle de conversation au niveau de chaque application. La configuration de reprise initiale, associée à l’application par défaut, est désormais obsolète et toutes les valeurs migrées. En savoir plus.
S’applique à toutes les versions
En plus des valeurs ad_id
et ad_title
, la valeur original_media_id
est renvoyée dans l’objet media
de l’objet value
du champ comments
lorsqu’une personne commente une publication Instagram boostée ou une publication de publicités Instagram. Pour plus d’informations, consultez Configurer des webhooks pour Instagram.
message_edits
Le nouvel évènement webhook message_edits
vous avertit lorsqu’un utilisateur ou une utilisatrice modifie un message précédemment envoyé. En savoir plus sur cet évènement webhook.
Vous pouvez désormais configurer des flux de messages de bienvenue pour les publicités de messagerie à l’aide de l’API. En savoir plus sur les publicités clic vers Messenger et sur les publicités clic vers Instagram.
Le type de pièce jointe « Reel » est désormais pris en charge pour les webhooks des messages échangés dans des conversations Messenger. Ces pièces jointes auront le type reel
et leur charge utile comprendra le titre, l’URL et l’ID de la vidéo du reel.
Les commandes sont des mots-clés que les utilisateur·ices peuvent saisir sur leur clavier à tout moment pour effectuer des actions spécifiques dans leurs conversations Messenger. Les commandes intègrent la commande elle-même et un indice, qui explique aux utilisateur·ices quel sera son effet. Par exemple, lorsque les utilisateur·ices saisissent « aide-moi à réserver des vols et des hôtels au Mexique pour la dernière semaine de décembre », Messenger invoque les commandes de vols et d’hôtels configurées par l’agence de voyages. En savoir plus.
Nous inaugurons un menu de commandes qui apparaîtra automatiquement quand vous aurez configuré les commandes. Si vous avez déjà configuré un menu fixe dans votre expérience Messenger, le menu de commandes le remplacera. En savoir plus.
Il est désormais possible de partager votre expérience de conversation à partir de la page de profil de l’entreprise sur Messenger. Cette fonctionnalité favorise la promotion de votre expérience de conversation par le bouche-à-oreille. En savoir plus.
Les commandes apparaîtront sur le profil d’entreprise une fois que vous aurez configuré les commandes pour votre expérience de conversation. Les utilisateur·ices pourront accéder à votre profil d’entreprise en sélectionnant le nom de la page en haut de l’écran, puis afficher les commandes disponibles dans vos discussions sur Messenger.
La page d’accueil affiche la liste des commandes prises en charge par l’expérience de conversation afin que les utilisateur·ices comprennent les actions possibles dans Messenger. En savoir plus.
Si vous développez votre application pour envoyer et recevoir des messages pour votre propre page, vous n’avez pas besoin de la soumettre au Contrôle app. Notez que si vous prévoyez de récupérer des informations de profil utilisateur·ice avec votre application, vous devez tout de même la soumettre au Contrôle app en raison des autorisations requises pour accéder à l’API User Profile.
Le routage des conversations est maintenant disponible sur Instagram. Le routage des conversations permet à Meta de router les conversations engagées entre votre entreprise et sa clientèle actuelle ou potentielle vers l’application que vous avez choisie pour répondre dans la conversation. Ainsi, votre entreprise engage des conversations enrichies et réduit le nombre d’appels d’API envoyés aux serveurs Meta.
L’accès aux API Custom Labels et Personas a été rétabli pour les entreprises opérant en Europe et pour les utilisateur·ices européen·nes et japonais·es qui se connectent à des entreprises à l’international.
Les entreprises et les agences peuvent à présent connecter facilement leurs publicités clic vers Messenger ou clic vers Instagram Direct à un message de bienvenue créé dans une application partenaire sans avoir à utiliser un extrait de code JSON. Le message de bienvenue apparaît sous la forme d’un menu déroulant dans le gestionnaire de publicités lors de la création d’une publicité clic vers Messenger ou clic vers Instagram Direct. Cliquez ici pour en savoir plus.
Les réponses privées sont désormais disponibles pour les commentaires sur Facebook Reels.
Mises à jour des réponses privées pour les groupes, des nouveaux champs prenant en charge les informations des commentateur·ices dans le champ from
et contexte parent via parent_id
introduits dans le webhook group_feed
. Vous devrez peut-être mettre à jour votre serveur de webhooks pour gérer ces nouveaux champs.
En tant qu’entreprise, vous pouvez utiliser plusieurs fournisseurs de messagerie tiers pour différentes conversations avec votre clientèle, comme la génération de prospects, les offres marketing concernant vos produits ou les questions de service clientèle. Le routage des conversations vous permet de définir les partenaires qui contrôlent les conversations avec la clientèle à un moment donné, pour que les client·es obtiennent les informations dont ils et elles ont besoin. Vous pouvez créer et gérer des règles de routage des messages dans les paramètres de votre Page.
Le modèle de bouton envoie un texto contenant jusqu’à trois boutons. Ce modèle permet d’offrir des options au ou à la destinataire du message, comme des réponses prédéterminées à une question ou des actions à mener. Les types de boutons postback
et web_url
sont pris en charge.
En tant qu’entreprise, vous pouvez utiliser plusieurs fournisseurs de messagerie tiers pour différentes conversations avec votre clientèle, comme la génération de prospects, les offres marketing concernant vos produits ou les questions de service clientèle. Le routage des conversations vous permet de définir les partenaires qui contrôlent les conversations avec la clientèle à un moment donné, pour que les client·es obtiennent les informations dont ils et elles ont besoin. Vous pouvez créer et gérer des règles de routage des messages dans les paramètres de votre Page.
Le modèle de bouton envoie un texto contenant jusqu’à trois boutons. Ce modèle permet d’offrir des options au ou à la destinataire du message, comme des réponses prédéterminées à une question ou des actions à mener. Les types de boutons postback
et web_url
sont pris en charge.
Instagram Messaging est désormais disponible pour tous les comptes professionnels Instagram d’une entreprise ou d’un·e créateur·ice.
Vous pouvez maintenant ajouter une invite d’appel pour permettre aux client·es ou personnes intéressées par votre entreprise de l’appeler.
Vous pouvez maintenant créer des publicités incluant un processus « cliquer pour s’abonner » qui vous permet de demander aux client·es ou aux personnes intéressées par votre entreprise si ils ou elles souhaitent recevoir des messages marketing de sa part.
Le routage entre plusieurs applications est désormais disponible pour Instagram Direct et Messenger.
Réponses privées
Votre entreprise peut maintenant envoyer des Réponses privées à une personne qui a commenté une publication de groupe Facebook.
Notifications récurrentes
Les Notifications récurrentes sont désormais appelées Messages marketing.
Modèles
Un Modèle structuré est maintenant disponible pour recueillir des informations d’expédition auprès d’un·e client·e.
API Messaging Insights
De nouveaux indicateurs et paramètres sont disponibles pour l’API Messaging Insights.
Notifications récurrentes pour la plateforme Messenger
La propriété title
pour les demandes d’inscription aux notifications récurrentesn’est plus nécessaire. Si title
n’est pas défini, la valeur par défaut est « Mises à jour et promotions ». Cette modification s’applique aux demandes d’inscription envoyées à partir d’une Page Facebook ou d’un compte professionnel Instagram.
Notifications récurrentes pour la plateforme Messenger
La propriété notification_messages_frequency
des requêtes d’inscription aux notifications récurrentes est obsolète et ne sera plus renvoyée dans les requêtes GET
ou les notifications de webhook. Cependant, les tokens de messages de notification créés avant le 2 février 2023 pour les notifications récurrentes hebdomadaires ou mensuelles seront pris en charge et le paramètre notification_message_frequency
sera renvoyé dans les notifications de webhook.
Vous pouvez maintenant envoyer jusqu’à trois messages de suivi à une personne qui s’est inscrite pour recevoir des notifications récurrentes. Ces trois messages doivent être envoyés dans les deux minutes suivant le premier message de suivi.
Le point de terminaison GET /PAGE-ID/notification_message_tokens
est à présent disponible pour les messages Instagram.
La propriété next_eligible_time
pour les points de terminaison des tokens de message de notification est maintenant disponible. Ce champ renvoie l’heure à laquelle vous pouvez envoyer la prochaine notification récurrente à l’aide de ce token de message de notification.
Messenger API for Instagram
Vous pouvez maintenant envoyer des GIF dans les messages envoyés depuis un compte professionnel Instagram à l’aide de Messenger API for Instagram.
L’API Attachment Upload prend dorénavant en charge l’importation de contenu multimédia pour les messages envoyés depuis un compte professionnel Instagram.
Les informations de référence pour les publicités qui redirigent vers une conversation Instagram (CTD) sont à présent renvoyées dans les notifications de webhooks de messages.
À partir du 31 mars 2023, vous ne pourrez plus télécharger un fichier CVS depuis le tableau de bord Analyses de Messenger. Consultez l’API Messaging Insights pour découvrir comment obtenir ces statistiques.
Business Login pour Instagram vous permet d’intégrer plus facilement les utilisateurs et utilisatrices d’Instagram qui doivent encore configurer leur compte pour accéder à l’API grâce à des fenêtres pop-up modales et à un nombre réduit d’étapes.
Nous avons facilité le suivi des publicités de génération de prospects de type clic vers Messenger grâce aux améliorations suivantes :
L’API Messaging Events prend en charge l’évènement lead_submitted
. Les entreprises peuvent utiliser cet évènement pour signaler les envois de prospects des publicités clic vers Messenger. Ce nouvel évènement de messagerie est proposé en version bêta ouverte. Les rapports seront bientôt disponibles dans le Gestionnaire de publicités.
Le Menu fixe est désormais disponible pour la messagerie Instagram.
La messagerie Instagram prend maintenant en charge les Réponses privées pour les commentaires sur les Stories Instagram Live et les publications publicitaires. Vous devrez peut-être mettre à jour votre serveur webhooks pour gérer ces nouveaux champs.
Vous pouvez maintenant obtenir une liste de tous les tokens de messages de notification valides en utilisant le point de terminaison GET /PAGE-ID/notification_message_tokens
.
Les ID d’application ne seront plus associés aux tokens de messages de notification. Toutes les applications liées à une Page recevront désormais des notifications webhook lorsqu’un utilisateur ou une utilisatrice a choisi de recevoir des notifications récurrentes.
Les champs de charge utile de pièce jointe à un message suivants ont été ajoutés :
image_aspect_ratio
: définissez une image sur des proportions horizontales ou carrées pour les requêtes d’inscription.elements
: créez un carrousel d’images pour les requêtes d’inscription.notification_message_tokens
: obtenez la liste des tokens de message de notifications actuels. notification_messages_cta_text
: personnalisez le texte des call-to-action pour les requêtes d’inscription.Nous avons ajouté les moyens suivants d’obtenir les inscriptions aux notifications récurrentes :
m.me
Le champ title
a été ajouté à la notification webhooks récurrente.
La réponse privée est désormais disponible pour les commentaires sur les Reels Instagram.
Vous pouvez désormais envoyer des messages Instagram avec des audios et des vidéos que vous avez soit importés sur un serveur Meta, soit envoyés depuis votre serveur.
L’API User Profile permet de récupérer le champ du nom d’utilisateur·ice Instagram du client sur l’API Graph 14.0 et versions ultérieures.
La fonctionnalité Notifications récurrentes constitue une mise à jour majeure de l’API Messenger. Elles permettent aux entreprises d’automatiser l’envoi de messages de manière proactive afin de favoriser de nouvelles interactions. Elles offrent ainsi une communication personnalisée et axée sur la clientèle à toutes les étapes du parcours d’achat.
Notifications récurrentes pour Messenger API for InstagramLa fonctionnalité Notifications récurrentes pour Messenger API for Instagram est disponible en version bêta. Les spécialistes en développement peuvent s’inscrire au programme bêta pour signaler leur intérêt avant le mois de juillet.
Augmentation de la limite de débit de l’API Send InstagramNous avons augmenté la limite de débit pour l’API Send à 100 appels API par seconde pour chaque compte professionnel Instagram.
Paramètres de référence ig.meLes entreprises peuvent ajouter des liens ig.me dans les sites Web et les e-mails ainsi que sur les emballages des produits afin que les utilisateurs et utilisatrices puissent communiquer avec elles sur Instagram. Les marques peuvent désormais ajouter un paramètre de référence à ces liens ig.me pour créer des expériences de messagerie personnalisées.
Nouveau processus d’intégration de l’API InstagramUn nouveau processus d’intégration de l’API Instagram est disponible en version bêta. Les développeurs peuvent s’inscrire au programme bêta pour signaler leur intérêt avant le 29 juin.
Nous avons ajouté un menu fixe à l’API Messenger pour la prise en charge d’Instagram. Les utilisateurs et utilisatrices peuvent ainsi découvrir les principales fonctionnalités d’une Page et interagir avec elles.
Conformément à l’annonce du 14 septembre 2021, nous avons commencé à migrer toutes les pages Facebook vers le nouveau protocole de transfert. La migration devrait être terminée le 18 mars 2022. Pour en savoir plus, consultez la section Modifications importantes. Voici un récapitulatif des dernières grandes améliorations annoncées précédemment.
Nous apportons des améliorations au protocole de transfert, qui permet aux développeurs et aux entreprises de publier rapidement des expériences (applications) de messagerie, de transférer facilement le contrôle des conversations entre les applications et de garantir la qualité de l’expérience d’utilisation en interdisant aux applications d’intervenir dans des conversations existantes. Parmi les principales améliorations, citons le mode Exclusif, le mode Veille, de nouvelles API permettant de contrôler plus finement la propriété du fil de discussion et la suppression de l’obligation d’attribuer des rôles principaux et secondaires aux applications.
Nous avons lancé une API permettant de personnaliser le point d’entrée du plugin de discussion, ainsi que notre premier outil de configuration interne. Les entreprises peuvent désormais choisir l’icône et l’étiquette du point d’entrée parmi des options prédéfinies, et ainsi les adapter à leurs éléments de marque. Pour en savoir plus, consultez notre documentation pour les développeurs.
Messenger API for Instagram est maintenant disponible pour les comptes Creator Instagram comptant moins de 500 000 abonnés. Pour en savoir plus, consultez la documentation pour les développeurs.
https://ig.me/m/{ig_profile_handle}
sur les sites Web, les e-mails, etc. Veuillez consulter la documentation pour les développeurs pour en savoir plus.Améliorations du protocole de transfert
API Custom Labels : nous enrichissons l’API Custom Labels de nouvelles fonctionnalités utiles qui permettront aux entreprises de créer, modifier et supprimer des étiquettes, mais aussi de synchroniser les étiquettes entre la messagerie de la Page Facebook et tout autre outil qu’elles utilisent pour communiquer avec leur clientèle.
name
de l’API Graph v12.0
et de l’API Custom Labels sera remplacé par page_label_name
. Cette modification prendra effet dans toutes les anciennes versions de l’API Graph à compter du 14 décembre 2021. Les développeurs et développeuses devraient tirer le meilleur parti de page_label_name
dans les différents webhooks et appels d’API relatifs aux opérations CRUD (création, récupération, mise à jour et suppression).Mises à jour concernant l’API Messenger pour l’Europe et le Japon : nous avons restauré le modèle de commentaire clientèle de l’API Messenger qui était inaccessible aux entreprises en Europe, ainsi qu’aux utilisateur·ices d’Europe et du Japon qui échangent avec des entreprises à l’échelle mondiale. Pour plus d’informations, consultez cette page.
Mises à jour de Messenger API for Instagram
Webhook pour les réactions : nous avons remplacé le format Unicode des réactions emoji par un nouveau et ajouté plusieurs réactions emoji. Consultez la documentation pour les développeurs et migrez vers la nouvelle version avant le 14 décembre 2021 pour continuer à prendre en charge les réactions emoji.
API User Profile : nous avons ajouté des champs disponibles pour tous dans l’application Instagram. Pour en savoir plus, consultez la documentation pour les développeurs.
Abandon de l’ID Instagram : l’API Conversation ne renverra plus le champ IGID
et se basera uniquement sur le champ IGSID
. Consultez la documentation pour les développeurs afin de savoir comment migrer vers la nouvelle version avant le 14 décembre 2021.
API Customization du plugin de discussion Facebook : de nouveaux paramètres de personnalisation du plugin de discussion sont disponibles grâce à cette API. Avec cette nouveauté, les développeurs et développeuses pourront modifier des fonctionnalités, notamment les paramètres de position, de couleur, de salutation et du mode invité, comme seuls le permettent actuellement nos outils internes.
Webhook message_echo : dans la v12.0
de l’API Graph, ce webhook comprend désormais l’ID d’application de la messagerie de la Page Facebook. Quand une entreprise répond à une conversation Messenger à partir de cette messagerie, d’autres applications connectées à la Page peuvent recevoir le webhook message_echo, qui contiendra l’ID d’application de la messagerie de la Page Facebook (263902037430900
).
Les modifications suivantes s’appliquent à partir de la version 11.0.
Ajout de <mid>
aux évènements messaging_postback
pour Messenger et Messenger API for Instagram pour l’API Graph 11.0 et versions ultérieures : nous avons ajouté le champ ID de message (<mid>
) dans la charge utile messaging_postback
pour réduire les dépenses d’ingénierie de nos partenaires qui utilisent l’API Conversations pour récupérer l’historique des conversations et le comparer aux évènements webhook. Consultez cette page pour en savoir plus.
Abandon des modèles pour les compagnies aériennes : les modèles pour les compagnies aériennes ne seront plus acceptés à partir de la version 11 de l’API Graph. Ils seront abandonnés dans les versions antérieures de l’API Graph six mois après cette annonce, soit le 6 décembre 2021. Nous recommandons aux compagnies aériennes d’envoyer les modèles Carte d’embarquement et Enregistrement en tant qu’images, comme elles le font souvent dans leurs notifications sur d’autres canaux.
Messenger API for Instagram : cette API est désormais disponible pour l’ensemble des développeurs, afin que les marques puissent proposer des expériences de messagerie sur Instagram à grande échelle. Les développeurs et développeuses peuvent désormais intégrer la messagerie Instagram dans leurs applications et créer des expériences pour cette messagerie. Grâce à eux, les entreprises peuvent utiliser différentes applications afin de tirer le meilleur profit de leurs workflows existants, engager des conversations plus intéressantes, améliorer la satisfaction de la clientèle et augmenter leurs ventes. En savoir plus. L’utilisation de Messenger API for Instagram doit respecter les Politiques développeur, en particulier les dispositions de la section « API de messagerie d’Instagram et de la plateforme Messenger », ainsi que la documentation technique.
Le tag de message Agent humain est désormais disponible pour l’ensemble des développeurs : il permet aux entreprises de répondre manuellement aux messages envoyés par les utilisateur·ices sur Messenger et Instagram au-delà de la fenêtre standard de 24 heures, et ce pendant sept jours. Ce tag est particulièrement utile quand le message est envoyé alors que l’entreprise est fermée (ex. : weekends) ou quand il aborde un problème nécessitant plus de 24 heures de traitement. Les développeurs doivent appliquer l’autorisation du tag Agent humain via Espace App, même si une telle autorisation avait déjà été approuvée pour votre application. Dans Espace App, accédez à la section Autorisations et fonctionnalités et appliquez l’autorisation Agent humain. En savoir plus.
Le modèle de commentaire clientèleest désormais disponible en version bêta : nous inaugurons un modèle natif intégré dans Messenger compatible avec les formats de sondage les plus courants, tels que CSAT (Customer Satisfaction), NPS (Net Promoter Score), CES (Customer Effort Score) et le texte en forme libre. Ce modèle natif est plus facile à intégrer, car il est conçu à partir de l’API Send. Les développeurs n’ont plus à créer de solutions personnalisées de sondage avec Webview et peuvent facilement agréger les scores de même format provenant de différents canaux. En savoir plus.