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 message texte 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 le message texte.

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/v25.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/v25.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 son, 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.

Envoi de plusieurs pièces jointes de contenu multimédia

Pour envoyer un message avec plusieurs images, ajoutez le contenu à la requête d’API dans un tableau de pièces jointes JSON. Seules les images sont acceptées comme type de contenu multimédia, dans la limite de 30 images en une fois.

Pour envoyer un message contenant plusieurs images à 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 le paramètre message contenant un tableau attachments, dans lequel chaque clé type d’objet est définie sur image et la clé url de l’objet payload est 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": {
    "attachments": [
      {
        "type": "image",
        "payload": {
          "url": "http://www.messenger-rocks.com/image.jpg"
        }
      },
      {
        "type": "image",
        "payload": {
          "url": "http://www.messenger-rocks.com/image.jpg"
        }
      }
    ]
  }
}' "https://graph.facebook.com/v25.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..."
} 

Réponse à un message

Pour répondre à un ancien message d’une conversation, envoyez une requête POST à /PAGE-ID/messages contenant :

• clé littérale id de l’objet recipient définie sur l’ID spécifique de page (PSID) de la personne
• message_type défini sur RESPONSE
• les détails du message dans l’objet de paramètre du message
• clé littérale mid de l’objet reply_to définie sur l’ID du message de chat auquel vous souhaitez répondre

Le message peut avoir été envoyé par votre Page ou par l’utilisateur·ice.

Exemple de requête

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient": {
    "id": "<PSID>",
  }
  "messaging_type": "RESPONSE"
  "message": {
    "text": "Hello, world!"      
  },
  "reply_to": {
    "mid": "{MESSAGE_ID}"
  }
}' "https://graph.facebook.com/v23.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…"
} 

Recommandations

Messages texte

• Restez concis. Prenez en compte la taille de l’écran et le comportement de défilement. Les messages compacts sont plus faciles à suivre. Essayez d’envoyer plusieurs messages distincts plutôt qu’un seul long message.
• N’utilisez pas de texte pour remplacer les images, les tableaux et les graphiques. Des messages structurés, voire une webview, répondront mieux à vos besoins.
• Ne vous lancez pas dans de longs échanges. Si vous devez communiquer sur plusieurs points, essayez d’envoyer plusieurs messages distincts plutôt qu’un seul long message.

Pièces jointes

• Faites attention à la qualité. Utilisez des images colorées haute résolution pour faire ressortir vos messages.
• Prenez en compte les proportions. Examinez comment rogner votre image lorsqu’elle apparaît dans la bulle de message.
• Ne placez pas de grandes quantités de texte dans votre image. Préférez les messages texte ou combinez des images et du texte grâce à un modèle générique.

Autres types de message

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.

Envoi d’actualités par message (en cours de développement)

La messagerie d’actualités est réservée aux éditeurs d’actualités enregistrés dans l’Index des pages d’actualités Facebook (NPI). La messagerie d’actualités permet aux éditeurs de presse d’envoyer des messages d’actualités non promotionnels aux personnes qui se sont abonnées pour recevoir ces messages.

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 sponsorisés

Les messages sponsorisés vous permettent d’envoyer du contenu promotionnel ou non après l’expiration de la fenêtre de message standard à une personne qui a déjà envoyé un message à votre Page ou 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.

Messages utilitaires

Les messages utilitaires permettent d’envoyer un message issu d’un modèle pré-approuvé incluant des commandes, des mises à jour de compte et des rendez-vous. Ces messages comportent de nombreux éléments personnalisés comme des numéros de compte, des ID de commande, des numéros de suivi de livraison, des dates et heures de rendez-vous, ainsi que des call-to-action permettant d’annuler une commande, de reprogrammer un rendez-vous et d’autres actions pour faciliter les interactions avec l’entreprise.

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