Plateforme Messenger

Messages marketing

Ce document vous montre comment demander à une personne l’autorisation d’envoyer des messages marketing, quelles sont les exigences et les limites spécifiques à l’envoi de demandes, et comment créer et envoyer des demandes d’autorisation de messages marketing.

Fréquence des messages

À compter du 31 janvier 2023, le paramètre notification_messages_frequency sera obsolète et la fréquence des messages ne sera plus requise lors de l’envoi des demandes d’inscription aux messages marketing.

  • Les tokens de notification créés avant le 31 janvier 2023 pour les fréquences hebdomadaires et mensuelles sont toujours pris en charge. La fréquence des messages de ces tokens ne changera pas et notification_messages_frequency sera retourné dans la notification Webhook d’inscription aux messages.

Expiration du token et réinscription

À partir du 10 août 2023, les tokens de notification n’expireront plus. Les demandes de réinscription et les rappels de désinscription ne seront plus envoyés.

Présentation

Les messages marketing permettent à une Page Facebook ou à un compte Instagram professionnel d’envoyer des messages en dehors de la fenêtre de message standard pour les personnes qui y ont consenti. Grâce aux messages marketing, vous pouvez nouer des relations avec des personnes qui s’intéressent à vous ou à votre entreprise.

Les messages marketing sont une nouvelle fonctionnalité facultative Premium qui deviendra payante par la suite. Nous facturons actuellement les entreprises qui envoient des messages depuis l’API WhatsApp Business et nous prenons en compte les commentaires de nos client·es pour établir et ajuster notre modèle de tarification. Nous informerons nos client·es et partenaires longtemps à l’avance si les modalités de l’essai gratuit devaient être modifiées.

Conditions requises

  • Vous devez vous conformer à toutes les Politiques de développement applicables lorsque vous utilisez les messages marketing ou d’autres fonctionnalités de la plateforme Messenger.

  • Vous ne pouvez envoyer qu’une demande d’inscription aux messages marketing par utilisateur·ice dans la fenêtre de message standard. Si un·e utilisateur·ice accepte les messages marketing, cela ne déclenche pas la fenêtre de message standard.

  • Votre application et/ou expérience de messages ne doit pas recevoir trop d’avis négatifs de la part des utilisateur·ices. Les fonctionnalités de messages peuvent être restreintes ou supprimées si nous déterminons que l’expérience de messages de votre application a reçu un trop grand nombre d’avis négatifs.

  • Vous ne devez pas utiliser les messages marketing ni les demandes d’inscription pour importuner les utilisateur·ices, c’est-à-dire que vous ne devez pas envoyer de manière répétée des demandes d’inscription aux mêmes utilisateur·ices, et vous devez vous abstenir d’envoyer tout autre type de spam, conformément à nos Politiques de développement.

  • Vous devez respecter les limites mises en place concernant la fonctionnalité de la plateforme Messenger et les messages marketing afin de rester dans le cadre du service que nous vous fournissons.

Limites

  • Vous ne pouvez pas envoyer plus d’une demande d’inscription par personne et par semaine pour le même sujet. Cela inclut la valeur par défaut de « Updates and promotions » (Mises à jour et promotions).
  • N’envoyez pas de demandes d’inscription en double à une même personne. Une demande d’inscription en double est une demande dotée du même paramètre title pour les notifications issues d’une Page Facebook, ou des mêmes paramètres title et image_url pour les notifications issues d’un compte professionnel Instagram
  • Vous ne pouvez envoyer des demandes d’inscription que durant la fenêtre de message standard.
  • Si une personne s’inscrit aux messages marketing, cela ne déclenche pas la fenêtre de message standard.
  • Vous pouvez voir si une personne a accepté de recevoir des messages marketing, mais pas le statut des demandes en attente.
  • Si une personne a choisi de ne plus recevoir de messages marketing, vos notifications ne lui seront plus envoyées et vous recevrez un message d’erreur.
  • Une personne peut bloquer, mettre en sourdine ou signaler vos messages.
  • Pour les messages marketing envoyés à partir d’un compte professionnel Instagram, en général, jusqu’à 10 demandes d’inscription pour différents sujets peuvent être envoyées par utilisateur·ice sur une période de 7 jours. Une sous-limite autorisant l’envoi de 5 demandes d’inscription maximum par utilisateur ou utilisatrice par jour est également en place. Néanmoins, vous devez vous assurer que les utilisateur·ices seront susceptibles de trouver les demandes d’inscription pertinentes et intéressantes avant de les envoyer.

Ces exigences et ces limites sont susceptibles de changer, car nous nous efforçons de proposer à nos utilisateur·ices et aux entreprises la meilleure expérience possible.

Recommandations

Vous devez envoyer des messages marketing pertinents et intéressants pour créer une expérience d’utilisation de grande qualité en prenant en considération les éléments suivants :

  • Votre demande d’inscription, y compris le titre et l’image, doit comprendre les types de messages marketing que les utilisateur·ices peuvent s’attendre à recevoir, comme les mises à jour de commandes, les recommandations de produits ou certaines offres.

  • Lorsque vous envoyez plusieurs demandes d’inscription à un·e utilisateur·ice, chaque demande doit clairement indiquer les différents types de messages marketing qu’il ou elle pourra recevoir.

Les messages marketing doivent être pertinents et adaptés aux cas d’utilisation qu’un utilisateur ou une utilisatrice est susceptible de trouver intéressants.

Les utilisateur·ices peuvent donner leur avis sur votre expérience de messages, y compris bloquer ces derniers, ce qui peut engendrer des restrictions de votre utilisation des messages marketing. Vous devez régulièrement examiner vos demandes d’inscription et messages marketing pour voir s’ils correspondent aux recommandations ci-dessus.

Fréquence des messages

S’applique aux tokens de message de notification créés avant le 2 février 2023.

  • Une fois qu’une personne s’est inscrite, vous pouvez lui envoyer des messages à une cadence quotidienne, hebdomadaire ou mensuelle selon ce qu’elle aura choisi.

Demander une autorisation d’envoi de messages marketing

Une personne doit autoriser (par son inscription) la réception de messages marketing depuis votre Page Facebook ou votre compte professionnel Instagram. La plateforme Messenger vous offre différentes manières de vous inscrire. Vous pouvez intégrer des demandes d’inscription dans les expériences de messages suivantes :

  • Publicités Clic vers Messenger  : lorsqu’une personne clique sur votre publicité.
  • Plugin de discussion  : lorsqu’une personne lance une conversation en utilisant le plugin de discussion sur votre site web.
  • Plugin Case à cocher  : lorsqu’une personne active une case à cocher dans un formulaire et soumet ce dernier.
  • Liens m.me : lorsqu’une personne clique sur votre lien m.me sur votre site web, dans vos e-mails, dans vos publications sur les réseaux sociaux, etc.
  • Réponses privées  : lorsqu’une personne publie un message ou un commentaire sur la Page Facebook de votre entreprise.
  • Codes QR  : lorsqu’une personne scanne votre code QR sur des supports numériques ou imprimés (pris en charge par des liens m.me).
  • Plugin Envoyer vers Messenger  : lorsqu’une personne lance une conversation en utilisant une liste de boutons ou de texte CTA prédéfinis

Exemple de demande d’inscription

Pour envoyer une demande d’inscription aux messages marketing, envoyez une requête POST au point de terminaison /PAGE-ID/messages en définissant le type de modèle de message sur notification_messages. L’ID de la Page est l’ID de votre Page Facebook ou de la Page Facebook liée à votre compte professionnel Instagram.

Remarque : le paramètre title est requis pour les messages marketing contenant un carrousel issu de votre Page Facebook ou de votre compte professionnel Instagram. 

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"PSID-OR-IGSID"
  },
  "message":{
    "attachment":{
      "type":"template", 
      "payload":{
         "template_type":"notification_messages", 
         "notification_messages_timezone": "UTC",
         "title":"TITLE",
         "image_url":"IMAGE-URL",
         "payload": "ADDITIONAL-WEBHOOK-INFORMATION",
      }
    }
  }
}' "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

En cas de réussite, votre application reçoit la réponse JSON suivante avec l’ID du ou de la destinataire et l’ID du message.

{ 
        "recipient": {
          "id":"PSID-OR-IGSID",
          "message_id":"MESSAGE-ID",
}

Référence de l’objet message attachment

Un objet JSON messageattachment doit être inclus dans la requête POST vers le point de terminaison /PAGE-ID/messages pour toute demande d’inscription aux messages marketing.

PropriétéDescription

type

énumération { template }

Obligatoire. La valeur doit être template

payload

objet

Contenu du message marketing, y compris le type de modèle, le titre, la fréquence des messages, les options de message, etc., pour cette demande d’inscription aux messages marketing

elements
tableau

Obligatoire pour le carrousel. Tableau qui contient des objets éléments décrivant l’inscription. Chaque objet élément doit contenir les paramètres payload et notification_messages_frequency, et peut inclure des paramètres title, image_url et notification_messages_reoptin personnalisés. Un minimum de 1 et un maximum de 5 éléments sont pris en charge.

image_aspect_ratio
énumération { HORIZONTAL, SQUARE }

Proportions pour l’image.

  • SQUARE : rendu de l’image au format carré (1:1). Si besoin, l’image sera recadrée
  • HORIZONTAL : rendu de l’image au format horizontal (1.91:1). Si besoin, l’image sera rognée.
image_url
chaîne

URL de l’image à afficher dans le modèle

notification_messages_frequency
énumération { DAILY, WEEKLY, MONTHLY }

Obsolète pour les tokens créés après le 2 février 2023. Valeur par défaut : DAILY. Fréquence des messages pour cette demande d’inscription aux messages marketing.

  • DAILY : inscription pour recevoir une notification toutes les 24 heures
  • WEEKLY : inscription pour recevoir une notification tous les 7 jours
  • MONTHLY : inscription pour recevoir une notification tous les mois
notification_messages_cta_text
énumération { ALLOW, GET, GET_UPDATES, OPT_IN, SIGN_UP }

Texte qui apparaît sur le bouton call-to-action

  • ALLOW : définit le texte du bouton de message d’inscription sur « Autoriser les messages »
  • ALLOW : définit le texte du bouton de message d’inscription sur « Recevoir des messages »
  • GET : définit le texte du bouton de message d’inscription sur « Recevoir des informations ». Il s’agit de la valeur par défaut si notification_messages_cta_text n’est pas défini
  • OPT_IN : définit le texte du bouton de message d’inscription sur « Activer les messages »
  • SIGN_UP  : définit le texte du bouton de message d’abonnement sur « S’inscrire pour recevoir les messages ».
notification_messages_timezone
chaîne

Fuseau horaire de la personne qui reçoit le message

payload
chaîne

Obligatoire. Type de message marketing (par exemple, un message promotionnel ou un message de sortie de produit) pour cette demande d’inscription aux messages marketing

template_type
énumération { notification_messages }

Obligatoire. La valeur doit être notification_messages

title
chaîne

Le titre à afficher dans le modèle ne peut pas dépasser 65 caractères. Si aucune valeur n’est spécifiée, la valeur par défaut est « Infos et promotions »

Tokens de message de notification

Lorsqu’une personne s’inscrit, votre entreprise reçoit une notification webhooks messaging_optin avec un token de message de notification et des informations telles que le titre des messages et le fuseau horaire de la personne qui s’est inscrite. Le token de message de notification vous permet d’envoyer des messages marketing à cette personne.

Inscription aux notifications Webhook

{
  "sender": {
    "id": "PSID",
  },
  "recipient": {
    "id": "PAGE-ID",
  },
  "timestamp": "TIMESTAMP",
  "optin": {
    "type": "notification_messages", 
      "payload": "ADDITIONAL-WEBHOOK-INFORMATION",
      "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN", 
      "notification_messages_timezone": "TIMEZONE-ID",
      "token_expiry_timestamp": "TIMESTAMP",
      "user_token_status": "TOKEN-STATUS"  
      "notification_messages_status": "MESSAGE-STATUS", 
      "title": "TITLE-FOR-THE-NOTIFICATION"
    }
}

Le contenu suivant s’applique uniquement aux tokens de message de notification associés à une fréquence hebdomadaire ou mensuelle et créés avant le 2 février 2023.

Les tokens de message de notification sont générés selon une fréquence récurrente. Par exemple, si une personne a accepté à la fois des messages marketing quotidiens et hebdomadaires, deux tokens de messages de notification différents sont générés. Si elle a accepté des messages marketing quotidiens, hebdomadaires et mensuels, trois tokens de message de notification différents sont alors générés.

Fréquence des messages marketingDescription

Hebdomadaire

Vous ne pouvez envoyer qu’un seul message une fois par semaine calendaire. Une semaine est définie comme débutant le lundi à minuit et se terminant le dimanche à 23 h 59 dans le fuseau horaire défini par la Page.

Mensuelle

Vous ne pouvez envoyer qu’un seul message une fois par mois calendaire. Un mois est défini comme débutant le premier jour du mois à minuit et se terminant le dernier jour du mois à 23 h 59 dans le fuseau horaire défini par la Page.

Les dates d’expiration des tokens seront prolongées pour les personnes qui choisissent de rester inscrites aux messages marketing. Il est possible de se désinscrire à tout moment.

S’inscrire aux messages de suivi

Une fois qu’une personne a accepté de recevoir des messages marketing, vous pouvez lui envoyer jusqu’à trois messages de suivi. Ces messages doivent être envoyés dans les deux minutes suivant le premier message de suivi. Les deuxième et troisième messages de suivi ne peuvent pas contenir plus de 250 caractères. Ces messages de suivi peuvent être envoyés en dehors de la fenêtre de message standard de 24 heures.

Pour envoyer un message de suivi, envoyez une requête POST au point de terminaison /PAGE-ID/messages avec l’objet recipient contenant le token de message de notification, et l’objet message contenant le texte des messages de suivi. La syntaxe des demandes d’API pour les trois messages de suivi est la même.

Exemple de requête

Formaté pour plus de lisibilité.
curl -X POST -H "Content-Type: application/json" -d 
    '{ 
        "recipient":{ 
            "notification_messages_token":"NOTIFICATION-MESSAGE-TOKEN" 
        }, 
        "message":{ 
            "text":FOLLOWUP-MESSAGE-TEXT-HERE, 
        } 
    }' 
"https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=TOKEN"

Obtenir la liste des tokens

Pour obtenir une liste de tous les tokens de messages de notification valides, envoyez une demande GET au point de terminaison /PAGE-ID/notification_message_tokens.

Exemple de requête

Formaté pour plus de lisibilité.
curl -i -X GET "https://graph.facebook.com/API-VERSION-NUMBER/PAGE-ID/notification_message_tokens
    ?access_token=PAGE-ACCESS-TOKEN"

Une liste de 25 tokens maximum est renvoyée par défaut et commandée par heure de mise à jour. Pour en savoir plus, vous pouvez ajouter le paramètre limit. Actuellement, seuls 100 tokens peuvent être renvoyés. Vous pouvez utiliser le paramètre after pour la pagination. Toutefois, sachez que le paramètre before n’est pas disponible.

En cas de réussite, votre application recevra la réponse JSON suivante, y compris le token, l’ID du ou de la destinataire, l’ID spécifique d’Instagram ou de la Page, l’heure à laquelle le token a été créé, le titre de la notification et le moment auquel vous pouvez envoyer le prochain message marketing à ce ou cette destinataire.

{
  "data":[
    {
      "notification_messages_token":"NOTIFICATION-MESSAGE-TOKEN-ID-1",
      "recipient_id":"PAGE-OR-INSTAGRAM-SCOPED-ID-1",
      "notification_messages_reoptin":"RE-OPT-IN-STATUS",
      "creation_timestamp":TIMESTAMP,
      "token_expiry_timestamp":UNIX-TIMESTAMP-EXPIRATION-DATE,
      "user_token_status":"TOKEN-STATUS",
      "topic_title":"NOTIFICATION-TITLE",
      "notification_messages_timezone":"TIMEZONE-ID",
      "next_eligible_time": TIMESTAMP
    },
...
    {
      "notification_messages_token":"NOTIFICATION-MESSAGE-TOKEN-ID-25",
      "recipient_id":"PAGE-OR-INSTAGRAM-SCOPED-ID-25",
      "notification_messages_reoptin":"RE-OPT-IN-STATUS",
      "creation_timestamp":TIMESTAMP,
      "token_expiry_timestamp":UNIX-TIMESTAMP-EXPIRATION-DATE,
      "user_token_status":"TOKEN-STATUS",
      "topic_title":"NOTIFICATION-TITLE",
      "notification_messages_timezone":"TIMEZONE-ID",
      "next_eligible_time": TIMESTAMP
    }
  ],
  "paging":{"cursors":{"before":"QVFIU...","after":"QVFIU..."},"next":"https:\/\/graph.facebook.com\/LATEST-API-VERSION\/PAGE-ID\/notification_message_tokens?access_token=PAGE-ACCESS-TOKEN"}
}

Obtenir des informations sur le token

Bien que nous recommandions d’utiliser le webhook messaging_optin pour collecter des informations de message marketing, vous pouvez envoyer une requête GET au point de terminaison du token, là où votre token est ajouté à notification_messages_, notification_messages_NOTIFICATION-MESSAGES-TOKEN, et ce afin d’obtenir des informations sur les tokens.

Exemple de requête

Formaté pour plus de lisibilité.
curl -i -X GET "https://graph.facebook.com/LATEST-API-VERSION/notification_messages_NOTIFICATION-MESSAGES-TOKEN
    ?access_token=PAGE-ACCESS-TOKEN"

En cas de réussite, votre application recevra la réponse JSON suivante qui inclut le token de message de notification, l’ID de la personne recevant le message et d’autres informations de token. Vous utiliserez le token de message de notification et l’ID du ou de la destinataire pour envoyer des messages marketing.

{
  "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN",
  "recipient_id": "PAGE-OR-INSTAGRAM-SCOPED-ID",
  "creation_timestamp": "TIMESTAMP",
  "token_expiry_timestamp": "TIMESTAMP",
  "user_token_status": "REFRESHED",
  "notification_messages_reoptin": "ENABLED",
  "notification_messages_timezone": "TIMEZONE-ID"
  "next_eligible_time": TIMESTAMP
}

Ces appels d’API seront comptabilisés dans la limite du plafond de votre application.

Envoi d’un message marketing

Avant de commencer

Vous aurez besoin des éléments suivants :

  • Le token de message de notification de la personne qui a choisi de recevoir des notifications.
  • L’ID de la Page Facebook de votre entreprise
  • Un token d’accès de Page demandé par une personne autorisée à effectuer la tâche MESSAGING sur la Page
  • L’autorisation pages_messaging, en utilisant Facebook Login
  • Les éléments à inclure dans le message marketing
  • L’abonnement au webhook messaging_referrals pour votre application

Pour envoyer un message marketing, envoyez une requête POST au point de terminaison /PAGE-ID/messages avec la valeur NOTIFICATION-MESSAGES-TOKEN du ou de la destinataire ainsi que le contenu du message en pièce jointe.

Limites

Recommandations

  • Nous vous recommandons vivement de vérifier le fuseau horaire de vos destinataires avant de leur envoyer des messages marketing afin de vous assurer qu’ils ou elles les recevront à un moment opportun.

Exemple de requête

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN"
  },
  "message":{
    "attachment":{
      "type":"template",
      "payload":{
        "template_type":"generic",
        "elements":[
           {
            "title":"Welcome!",
            "image_url":"https://raw.githubusercontent.com/fbsamples/original-coast-clothing/main/public/styles/male-work.jpg",
            "subtitle":"We have the right hat for everyone.",
            "default_action": {
              "type": "web_url",
              "url": "https://www.originalcoastclothing.com/",
              "webview_height_ratio": "tall"
            },
            "buttons":[
              {
                "type":"web_url",
                "url":"https://www.originalcoastclothing.com/",
                "title":"View Website"
              },{
                "type":"postback",
                "title":"Start Chatting",
                "payload":"ADDITIONAL-WEBHOOK-INFORMATION"
              }              
            ]      
          }
        ]
      }
    }
  }
}' "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

En cas de réussite, votre application reçoit la réponse suivante :

{ 
  "recipient": "PAGE-OR-INSTAGRAM-SCOPED-ID",
  "message_id": "MESSAGE-ID"      
}

Test des messages marketing

Vous pouvez tester vos messages marketing à tout moment.

Avant de commencer

Vous aurez besoin des éléments suivants :

  • Une personne, le ou la testeur·se, pour recevoir la notification. Cette personne doit avoir un rôle dans l’application.

Test des inscriptions

Vous pouvez tester vos messages marketing à tout moment en suivant les étapes ci-dessous.

  • Étape 1. Envoyez un message à votre testeur ou testeuse avec un modèle d’inscription aux messages marketing.
  • Étape 2. Assurez-vous que le testeur ou la testeuse clique sur le bouton d’abonnement (par exemple, Recevoir des messages sur des remises de 50 %) dans la conversation.
  • Étape 3. Envoyez le premier message marketing à votre testeur ou testeuse.
  • Étape 4. Envoyez un autre message marketing tout de suite après le premier, en définissant le paramètre developer_action sur ENABLE_FOLLOWUP_MESSAGE.
  • Étape 5. Envoyez un autre message marketing au testeur ou à la testeuse. Il s’agit de votre message de test.

Exemple de requête

Formaté pour plus de lisibilité.
curl -X POST "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/notification_messages_dev_support
    ?recipient={
        "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN"
    }
    &developer_action=ENABLE_FOLLOWUP_MESSAGE
    &access_token=PAGE-ACCESS-TOKEN"

En cas de réussite, votre application doit recevoir la réponse JSON suivante, avec le paramètre success défini sur true.

{ "success": true }

Pour tester les renouvellements d’inscription, répétez les étapes en définissant le paramètre developer_action sur SEND_RE_OPTIN à l’étape 4.

Étapes suivantes

Voir aussi

Assistance pour les équipes chargées du développement