Notification unique (version bêta)

Résumé

L’API One-Time Notification (version bêta) de la plate-forme Messenger permet à une Page de demander à un utilisateur d’envoyer un message de suivi après la fin de la fenêtre d’envoi de 24 heures. L’utilisateur se verra proposer de recevoir une notification plus tard. Lorsque l’utilisateur demande à être notifié, la Page reçoit un token qui équivaut à une autorisation d’envoyer un message unique à l’utilisateur. Ce token ne peut être utilisé qu’une seule fois et expire dans l’année de sa création.

Autorisations

Pour utiliser cette API, les Pages doivent demander l’autorisation Notification unique dans la section Messagerie avancée des paramètres de la Page. L’autorisation est accordée si les conditions générales de la version bêta sont acceptées et si la Page remplit nos critères.

Table des matières

• Utilisation
• Envoi d’une demande de notification unique
• Envoi d’un message de suivi
• Évènements webhook
• Restrictions et limitations

Utilisation

• N’induisez pas en erreur les utilisateurs et utilisatrices, ne les escroquez pas, ne les trompez pas, ne leur envoyez pas du spam et ne les surprenez pas d’une manière négative. Veillez à ce que la relation entre l’invite et le contenu du message soit claire et évidente. Le contenu de la demande de notification unique et le message doivent respecter les standards de la communauté.
• Les Pages qui reçoivent un volume élevé de commentaires utilisateur négatifs, ou qui trompent, induisent en erreur ou surprennent de manière négative les utilisateur·ices perdront leur accès à l’API.

Envoi d’une demande de notification unique

Grâce à l’API Send, la Page peut envoyer une demande de notification sous forme de modèle. Le modèle doit être associé au type one_time_notif_req. Le corps de la demande doit respecter le format standard appliqué à tous les types de modèles, avec la propriété message.attachment.payload contenant les informations sur le type et le contenu spécifiques de chaque type de modèle. Seuls le titre et la charge utile de la demande peuvent être personnalisés. Le champ title ne peut pas contenir plus de 65 caractères.

{
  "recipient": {
    "id":"

Après l’affichage du modèle de demande de notification unique, lorsque l’utilisateur·ice clique sur le bouton Notify Me (M’avertir), un webhook message_optins est transmis à votre backend, et le token one_time_notif_token peut être utilisé pour envoyer un message de suivi unique à l’utilisateur ou l’utilisatrice en dehors de la fenêtre d’envoi de 24 heures.

Envoi d’un message de suivi

Pour envoyer un message de suivi, soumettez une demande POST à l’API Send, en y joignant le token one_time_notif_token obtenu par le biais du webhook et en définissant message.text dans le corps de la demande :

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient": {
    "one_time_notif_token":"<ONE_TIME_TOKEN>"
  },
  "message": {
    "text":"<MESSAGE_CONTENT>"
  }
}' "https://graph.facebook.com/v21.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

Pour envoyer un message enrichi, remplacez le texte par le contenu correspondant. Consultez la référence de l’API Send pour obtenir la liste complète des types de messages pris en charge. Le token one_time_notif_token ne peut être utilisé qu’une seule fois et expire une fois le message correctement envoyé.

Évènements webhook

Lorsque l’utilisateur·ice accepte de recevoir une notification spécifique, vous recevez un évènement webhook contenant la charge utile payload et le token one_time_notif_token. Vous devrez stocker la charge utile et le token pour pouvoir envoyer le message de suivi lorsque l’information deviendra disponible. Notez qu’aucune API distincte n’interrogera la liste de tokens one_time_notif_token. Il est donc important que vous traitiez et stockiez les informations de webhook dès leur réception. Chaque token ne peut être utilisé qu’une seule fois et expire dans un délai d’un an à compter de sa création.

{
   "sender": {
     "id":"<PSID>"
   },
   "recipient": {
     "id":"<PAGE_ID>"
   },
   "timestamp":1458692752478,
   "optin": {
     "type": "one_time_notif_req",
     "payload": "<USER_DEFINED_PAYLOAD>",
     "one_time_notif_token":"<ONE_TIME_TOKEN>",
   }
}

Restrictions et limitations

• N’utilisez pas le champ de charge utile pour envoyer des mots de passe, des identifiants utilisateur, des informations permettant d’identifier les utilisateur·ices (par exemple, le nom ou l’adresse e-mail susceptible de permettre d’entrer en contact avec la personne ou de connaître son identité) ou toute autre information de nature sensible (telle que des données sur la santé, les finances, le paiement ou le titulaire de la carte, ou toute autre catégorie d’informations définie comme sensible en vertu des lois applicables).
• Le nombre de demandes de notification unique qu’il est possible de faire est limité afin de ne pas nuire à l’expérience d'utilisation.

Questions/réponses

Vous trouverez plus d’informations sur la page des questions fréquemment posées.