Messages marketing

(également appelés « notifications récurrentes »)

Ce document explique comment demander à une personne l’autorisation d’envoyer des messages marketing (également appelés « notifications récurrentes »), 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.

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 notre clientèle 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.

Délai d’attente avant l’envoi d’un message

Le délai d’attente est de 24 heures pour l’envoi de messages subscription_token. Cela signifie que les messages marketing envoyés à l’aide du même subscription_token nécessitent un intervalle de 24 heures entre chaque envoi.

À compter du 1er septembre 2025, le délai d’attente pour l’envoi de messages subscription_token passera d’un envoi toutes les 24 heures à un envoi toutes les 48 heures par abonné.

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 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.

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"
    }
}

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

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

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

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

• Vous ne pouvez envoyer qu’un seul message par jour et par token de message de notification. Si vous en envoyez plusieurs, assurez-vous de les espacer de 24 heures, faute de quoi vous recevrez un message d’erreur. (Ne s’applique pas aux messages de suivi pour les inscriptions.)

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

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

• Notification de webhooks d’abonnement aux messages
• Consultez l’aperçu des types de messages pour connaître les différents types de messages que vous pouvez envoyer.

Voir aussi

• Référence des messages de Page pour plus d’informations sur les champs disponibles pour les messages récurrents.
• Liste des fuseaux horaires disponibles
• Codes d’erreur pour la plateforme Messenger