Questions/réponses

Les applications sont installées depuis le site web de l’application à l’aide de Facebook Login et accordent l’autorisation pages_messaging à une Page spécifique. Les applications autorisées s’affichent dans les paramètres de la Page, dans Messagerie avancée.

Oui, une app Facebook peut s’abonner à plusieurs Pages. Une fois prête pour le contrôle app, comme l’autorisation pages_messaging, l’app peut s’abonner pour recevoir des webhooks provenant de plus d’une Page. Il vous revient de déterminer le contexte de chaque webhook en fonction de la charge utile.

Oui, il est possible d’associer plusieurs applications à une Page. Lorsque plusieurs applications gèrent la même conversation, le mieux est d’utiliser le protocole de transfert pour répartir le contrôle des conversations entre les bots.

Pour consulter les questions/réponses sur le RGPD et la plate-forme Messenger, consultez la section Plate-forme Messenger et Règlement général sur la protection des données.

Lorsque vous utilisez le plugin « Envoyer vers Messenger », le paramètre data-ref peut être utilisé par vous comme paramètre d’intercommunication pour envoyer des informations sur le contexte du clic.

Les gens peuvent également découvrir votre Page au moyen de la recherche dans Messenger. Dans ce cas, vous n’aurez pas de paramètre d’intercommunication. Vous pouvez utiliser la fonctionnalité d’association de compte pour associer un fil à un compte utilisateur sur votre site.

Lorsqu’une app est en mode développement, le plugin n’est visible que par les administrateurs, les développeurs et les testeurs de l’application. Lorsque l’app a été vérifiée et approuvée, vous pouvez la rendre disponible au grand public dans l’onglet Certification d’app de l’Espace app.

No. Unlike subscriptions where a business can send multiple messages to people on a recurring basis, the one-time notification API limits the business to a single message per user request. If the person engages with the message, the standard messaging window will reopen.

Yes. Pages interested in using the One-time Notification API need to apply for permission. Go to the Advanced Messaging section of your Page Settings and consent to the terms. A Page will be granted permission if the Page meets our criteria.

Common uses of the API include various promotional and non-promotional use cases where the User explicitly requested a follow-up. Examples include:

• Back in stock alerts
• Collection launches
• Concert tickets going on sale
• Price drop alerts
• Train tickets available for purchase
• CSAT surveys

Your Page is not allowed to send a notification on a topic for which the User has not agreed to receive a notification. Please see the Usage and Restrictions and Limitations sections of the One-time Notification guide for more information.

A Page can send multiple requests however, the 24-hour policy will be applied to all the requests being sent. We also have controls in place to prevent spamming users with multiple requests.

The 24 hour standard messaging window will open only if the user interacts with the opt-in message. The behavior is consistent with interactions with other elements in the Messenger experience.

Pages will need to subscribe to message_optins webhook to receive notifications about User consent.

Once a person asks to be notified, the Page will receive a token which is equivalent to a permission to send a single message to the person. The token can be used to send a message to the person outside the 24 hour window. The token can only be used once and unused tokens will expire within 1 year of creation.

Yes. However, while it is possible to send another notification request using an existing token, there is no clear benefit for the business to send these type of requests.

Token is for one-time use only. Once a token is used it can not be used again.

No. The API does not return tokens available to a Page.

Page level. Permissions for the One-time Notification API are given at the Page level.

No. The app does not need to specify any message tags when sending a message outside the 24-hour standard messaging window using this API.

Plusieurs raisons peuvent expliquer cette erreur :

• Vous utilisez un ID de Facebook Login. Les ID utilisateurs de Facebook Login ne sont pas destinés à fonctionner avec l’API Send/Receive. Seuls les ID utilisateurs obtenus au moyen de l’authentification avec la plate-forme Messenger fonctionneront avec cette plate-forme.
• Vous utilisez un ID avec le mauvais token d’accès de Page. Les ID utilisateurs pour la plate-forme Messenger sont spécifiques à une page. Si vous utilisez un ID utilisateur valide, mais avec un token d’accès de Page associé à une autre page, l’appel ne fonctionnera pas. Assurez-vous d’utiliser l’ID utilisateur et le token d’accès de Page associé à la même page.
• Vous faites un envoi à un numéro de téléphone qui n’a pas été vérifié récemment. Lorsque vous utilisez l’API Send avec un numéro de téléphone, nous envoyons uniquement des messages si le numéro de téléphone a été vérifié récemment. Si le numéro de téléphone apparaît comme vérifié, mais s’il n’a pas été vérifié récemment, alors l’envoi peut échouer. Vérifiez à nouveau votre numéro de téléphone et attendez 24 heures avant de réessayer.

La solution de contournement suivante vous permet d’utiliser un utilisateur test de la plate-forme pour votre intégration à la plate-forme Messenger :

1. Depuis la page des rôles de votre application, créez un nouvel utilisateur test en cliquant sur le bouton Ajouter.
2. Activez l’option Autoriser les utilisateurs tests pour cette app ? et accordez les autorisations « manage_pages » et « page_messaging ».
3. Utilisez le bouton Modifier et obtenez un token d’accès pour cet utilisateur (en utilisant la version 2.6). Enregistrez-le pour plus tard.
4. Utilisez le bouton Modifier pour vous connecter en tant qu’utilisateur test.
5. Après votre connexion, créez une page en tant qu’utilisateur test.
6. Utilisez le token d’accès utilisateur pour l’utilisateur test afin d’obtenir le token d’accès de page pour cet utilisateur. Vous pouvez effectuer cette action avec l’appel suivant :

   https://graph.facebook.com/v2.6/me/accounts?access_token=[TOKEN_ACCES_UTILISATEUR_TEST]

   (Documentation)
7. Utilisez ce token d’accès de page afin d’associer votre application Facebook à votre Page :

   https://graph.facebook.com/v2.6/me/subscribed_apps?method=POST&access_token=[TOKEN_ACCES_PAGE_UTILISATEUR_TEST]
           

   (Documentation)
8. Après avoir suivi ces étapes, vous recevrez des mises à jour en temps réel sur votre Page test et pourrez envoyer des messages à votre utilisateur test depuis votre Page test. En plus de ce qui précède, vous pouvez remplacer votre token d’accès par un token de longue durée si vos tokens expirent trop rapidement pour vos tests. N’hésitez pas à suivre la documentation ici :

   GET /oauth/access_token?  
       grant_type=fb_exchange_token&           
       client_id={app-id}&
       client_secret={app-secret}&
       fb_exchange_token={short-lived-token} 
           

Oui, un bot peut inclure les deux types de messagerie. Une personne devra déclencher la messagerie standard grâce à l’un des déclencheurs admissibles et devra demander à recevoir des messages d’abonnement.

Les bots ne peuvent techniquement pas envoyer de messages aux utilisateurs plus d’une fois après la fenêtre de 24 heures (le message n’est pas envoyé). Lors de la période de transition pour les bots existants, ces messages seront envoyés, mais, s’ils sont trouvés, ils seront signalés.

Non, la plate-forme Messenger ne propose pas d’API qui renvoie une liste des PSID de toutes les personnes qui ont accepté de recevoir des messages de votre bot.

Il faut effectuer deux étapes pour recevoir des rappels. Tout d’abord, assurez-vous que votre webhook est configuré correctement (https://developers.facebook.com/docs/messenger-platform/webhook-reference#setup). Un indicateur apparaît lorsque les webhooks sont configurés correctement.

Ensuite, vous devez vous abonner à chaque Page. Toutes les Pages auxquelles vous êtes abonné(e) seront indiquées.

Si les appels vers votre webhook échouent pendant une durée prolongée, votre application ne sera plus inscrite. Vous devrez rajouter votre webhook et vous réinscrire votre Page.

Les appels vers le webhook contiennent un champ dans l’en-tête nommé X-Hub-Signature, qui peut être utilisé afin de vérifier que l’appel vient bien de Facebook.

Assurez-vous que votre webhook répond avec un code de statut de 200. Cela nous indique que le webhook a été reçu avec succès. Si vous ne répondez pas avec un 200, nous tenterons à nouveau l’appel jusqu’à ce qu’il soit réussi. De plus, si un webhook ne renvoie pas de 200 pendant une durée prolongée, nous faisons apparaître des alertes de développeur.

Notez également qu’un code de statut réussi est renvoyé de manière opportune. Un appel webhook expire au bout de 20 secondes. Assurez-vous d’élaborer votre code de façon à ce que les webhooks soient traités de manière asynchrone. Cela permet à un code de statut réussi d’être renvoyé immédiatement et traité séparément.

Nous proposons un outil permettant d’afficher les dernières erreurs des Webhooks. En cas d’échec de distribution des Webhooks, les serveurs de Facebook désactivent l’abonnement de votre URL. L’outil est disponible sous Espace app > Messenger > Paramètres : sur la carte Webhooks, appuyez sur le bouton Montrer les erreurs récentes.