Envoi d’un message

Pour envoyer des messages à quelqu’un sur Messenger, la conversation doit être initiée par l’utilisateur·ice. La plateforme Messenger contient plusieurs types de messages que vous pouvez envoyer. Chaque type de message doit respecter différentes politiques et règles en fonction du type de contenu et des conditions dans lesquelles il est envoyé.

Composants d’un message

Toutes les requêtes d’envoi de message adressées par votre application à l’API Send doivent inclure les éléments suivants :

• L’ID de la Page Facebook ou de la Page Facebook liée à votre compte professionnel Instagram qui envoie le message
• L’ID de la personne qui reçoit le message
• Un token d’accès de Page demandé depuis la Page qui envoie le message
• L’autorisation de la personne qui reçoit le message
• Le type de message
• Le contenu du message

Pour plus d’informations sur les composants d’un message, consultez la page Référence sur l’API Send.

Fenêtre de messages standard

La fenêtre de messages standard correspond à la période de 24 heures pendant laquelle vous êtes autorisé·e à envoyer un message à une personne. Lorsqu’une personne envoie un message à votre Page ou votre compte professionnel Instagram ou entame une conversation via un plugin Web, votre application a jusqu’à 24 heures pour envoyer un message.

Les messages envoyés pendant la fenêtre de 24 heures peuvent comprendre du contenu promotionnel.

Actions utilisateur·ice qui ouvrent la fenêtre de messages standard

Lorsqu’un·e utilisateur·ice effectue l’une des actions suivantes, la fenêtre de réponse standard de 24 heures s’ouvre :

• Il ou elle envoie un message à votre Page ou à votre compte professionnel Instagram
• Il ou elle clique sur un bouton call-to-action, comme « Démarrer », dans une conversation
• Il ou elle clique sur une publicité clic vers Messenger, puis envoie un message à votre Page ou votre compte professionnel Instagram
• Il ou elle envoie un message à une Page via un plugin (par exemple Send to Messenger ou Checkbox)
• Il ou elle clique sur un lien m.me qui le ou la conduit vers une conversation existante avec votre Page
• Il ou elle clique sur un lien m.me qui le ou la conduit vers une conversation existante avec votre compte professionnel Instagram
• Il ou elle réagit à un message, tel qu’un message marketing
• Il ou elle commente une publication sur votre Page ou votre compte professionnel Instagram
• Il ou elle effectue une publication visiteur sur votre Page

Nous savons que les utilisateur·ices attendent une réponse rapide. C’est pourquoi nous vous encourageons vivement à répondre dès que possible dans ce délai de 24 heures. Les utilisateur·ices ont la possibilité de bloquer ou de mettre en sourdine une conversation à tout moment.

ID de destinataire

L’ID d’une personne recevant un message est défini dans le paramètre d’objet recipient et peut être de différents types :

• ID spécifique de Page (PSID). Il s’agit d’un ID attribué à une personne la première fois qu’elle envoie un message à votre Page. Cet ID unique représente les interactions entre votre Page et la personne.

• Réf utilisateur. Cet ID est attribué à une personne qui a utilisé un plugin ou un bouton de renvoi pour envoyer un message à votre Page.

• ID de publication ou de commentaire. Il s’agit d’un ID attribué à une personne qui a commenté une publication ou publié sur votre Page. Il est utilisé pour envoyer une réponse privée à la personne concernée.

Veuillez noter que les identifiants utilisateur provenant d’intégrations Facebook Login sont spécifiques d’une application et ne fonctionneront pas avec la plateforme Messenger.

Types de messages

Le type de message que vous envoyez est défini dans le paramètre messaging_type. Ce paramètre est un moyen plus explicite de vous assurer que vos messages respectent les politiques de messages applicables et les préférences du destinataire.

Les types de messages suivants sont pris en charge :

• Réponse. Le message que vous envoyez est une réponse à un message reçu. Le message peut comprendre du contenu promotionnel et non promotionnel et doit être envoyé pendant la fenêtre de messages standard.

• Mises à jour. Le message que vous envoyez est envoyé de manière proactive et non en réponse à un message reçu. Le message peut comprendre du contenu promotionnel et non promotionnel et doit être envoyé pendant la fenêtre de messages standard.

• Message avec tag. Le message que vous envoyez est envoyé en dehors de la fenêtre de messages standard. Ce message doit inclure un tag de message qui correspond au cas d’utilisation autorisé pour le tag et inclut du contenu non promotionnel.

Tags de message

Les tags de message vous permettent d’envoyer un message en dehors de la fenêtre de messages standard. Ces messages sont des mises à jour pertinentes pour la personne concernée. Par exemple, vous pouvez envoyer des informations concernant l’expédition et la livraison d’une commande, une réservation ou un vol à venir, ou encore des alertes concernant le compte d’un·e client·e. Pour les flux de messages qui nécessitent une procédure de remontée, le tag Human Agent permet à un·e représentant·e commercial·e de répondre manuellement aux messages d’une personne sur une période de 7 jours.

Les tags de message ne permettent pas d’envoyer du contenu promotionnel, comme les bons plans, les offres, les bons et les remises. L’utilisation de tags de messages en dehors des cas d’utilisation approuvés peut entraîner des restrictions sur la capacité de la Page ou du compte Instagram à envoyer des messages. Pour en savoir plus, voir la Politique de la plateforme Messenger et de l’API Instagram Messaging.

Les entreprises qui utilisent la plateforme Messenger et souhaitent envoyer des messages promotionnels en dehors de la fenêtre de réponse standard de 24 heures doivent utiliser des messages sponsorisés ou des notifications uniques.

Types de contenus

Le message que vous envoyez peut contenir les types de contenus suivants :

Envoi d’un texto basique

Pour envoyer un texto basique à une personne qui a envoyé un message à votre Page, envoyez une requête POST au point de terminaison /PAGE-ID/messages avec la clé littérale id de l’objet recipient définie sur le PSID de la personne, le paramètre message_type défini sur RESPONSE et l’objet text du paramètre message défini sur texto.

Exemple de requête

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"{PSID}"
  },
  "messaging_type": "RESPONSE",
  "message":{
    "text":"Hello, world!"
  }
}' "https://graph.facebook.com/v21.0/{PAGE-ID}/messages?access_token={PAGE-ACCESS-TOKEN}"
    

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

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U..."
} 

Envoi d’une pièce jointe de contenu multimédia

Pour envoyer un message avec un modèle ou du contenu multimédia, tel qu’un GIF ou une image, ajoutez le contenu à la requête d’API dans un objet message attachment JSON.

Pour envoyer un message contenant une image à une personne qui a envoyé un message à votre Page, envoyez une requête POST au point de terminaison /PAGE-ID/messages avec la clé littérale id de l’objet recipient définie sur le PSID de la personne, le paramètre message_type défini sur RESPONSE, la clé type de l’objet attachment du paramètre message définie sur image et la clé url de l’objet payload définie sur l’URL de l’image.

Exemple de requête

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"1254459154682919"
  },
  "message":{
    "attachment":{
      "type":"image", 
      "payload":{
        "url":"http://www.messenger-rocks.com/image.jpg", 
        "is_reusable":true
      }
    }
  }
}' "https://graph.facebook.com/v21.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"
  

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

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U..."
} 

L’envoi d’un audio, d’une vidéo ou d’un fichier à partir d’une URL utilisera le même format.

Vous pouvez également envoyer du contenu multimédia depuis votre serveur ou depuis du contenu que vous avez préalablement importé sur un serveur Meta. En savoir plus sur l’importation de fichiers à l’aide de l’API Attachment Upload.

Recommandations

Messages texte

Pièces jointes

Autres types de message

Messages d’actualités (en développement)

Les messages d’actualités ne sont disponibles que pour les éditeurs d’actualités qui sont enregistrés sur l’Index des pages d’actualités Facebook (NPI) . Les messages d’actualités permettent aux éditeurs d’actualités d’envoyer des messages non promotionnels aux personnes qui se sont abonnées pour les recevoir.

Les messages d’actualités ne sont pas disponibles pour l’API Instagram Messaging.

Notifications uniques

Une notification unique vous permet de demander l’autorisation à une personne d’envoyer un message de suivi après la fin de la fenêtre de messages standard. Si cette personne accepte, vous pourrez lui envoyer un message urgent et pertinent, tel qu’un rappel de rendez-vous ou une alerte de retour en stock.

Les notifications uniques ne sont pas disponibles pour l’API Instagram Messaging.

Réponses privées

Les réponses privées vous permettent d’envoyer un message à une personne lorsqu’elle publie un commentaire sur l’une de vos publications ou publicités, ou lorsqu’elle effectue une publication visiteur sur votre Page ou compte professionnel Instagram. La réponse privée ne peut être qu’un message unique, qui comprendra automatiquement un lien vers la publication ou le commentaire concerné, et doit être envoyée dans les sept jours suivant la publication du message ou du commentaire par la personne concernée.

Messages marketing

Les messages marketing vous permettent de demander l’autorisation à une personne d’envoyer plusieurs messages marketing après la fin de la fenêtre de messages standard. Si la personne accepte, vous pourrez lui envoyer des messages promotionnels automatisés et récurrents contenant des informations sur les ventes, sorties et mises à jour de produits à venir.

Messages sponsorisés

Les messages sponsorisés vous permettent d’envoyer du contenu promotionnel ou non promotionnel après la fin de la fenêtre de messages standard, à une personne qui a déjà envoyé un message à votre Page ou à votre compte professionnel Instagram. Les messages sponsorisés apparaissent comme des messages normaux dans la conversation, mais sont annotés avec le mot « Sponsorisé » au-dessus du message. Le contenu des messages sponsorisés doit être conforme aux règles publicitaires.

Les messages sponsorisés ne sont pas disponibles pour l’API Instagram Messaging.

Étapes suivantes

Découvrez plus d’informations sur les éléments que vous pouvez ajouter aux messages dans vos conversations.

En savoir plus

En savoir plus sur l’envoi de messages à l’aide de la plateforme Messenger.

• Référence de l’API Attachment Upload – En savoir plus sur l’importation et l’envoi de contenu multimédia.
• Référence de l’API Send – En savoir plus sur les tags, le contenu et les pièces jointes que vous pouvez envoyer.
• Plafonds – En savoir plus sur les plafonds d’envoi de messages sur la plateforme Messenger.