Plateforme Messenger

Réponses privées

Ce document explique comment ajouter par programmation des réponses privées à votre expérience de messagerie.

Fonctionnement

Les réponses privées permettent à un compte professionnel Instagram d’envoyer un message unique à une personne qui a commenté sa publication professionnelle Instagram, sa publication de publicités, son reel ou sa story en direct.

Lorsque vous recevez une notification des webhooks comments ou live_comments, via l’API Graph pour Instagram, indiquant qu’une personne a commenté votre publication professionnelle Instagram, votre publication de publicités, votre reel ou votre story en direct, vous pouvez utiliser l’ID du commentaire pour envoyer une réponse privée directement à cette personne. Cette réponse sera distribuée dans le dossier Boîte de réception de la personne, si la personne est abonnée au compte professionnel Instagram de l’entreprise, ou dans le dossier Demande de la personne, si la personne n’est pas abonnée au compte.

Vous pouvez envoyer cette réponse privée dans les 7 jours suivant l’heure de création du commentaire, à l’exception d’Instagram Live pour lequel vous ne pouvez envoyer une réponse privée que pendant la diffusion en direct. Ce message contiendra un lien vers la publication que la personne a commentée.

Webhooks

  • Lorsque vous hébergez une story Instagram Live, assurez-vous que votre serveur peut gérer la charge accrue de notifications déclenchées par les évènements des webhooks live_comments, via l’API Instagram, et que votre système peut différencier les notifications live_comments et comments.
  • Les notifications des webhooks comments de l’API Graph pour Instagram pour les publications de publicités comprendront l’ID et le titre de la publicité. Vous devrez peut-être mettre à jour votre serveur de webhooks pour gérer ces nouveaux champs.

    Les valeurs ad_id et ad_title seront retournées dans l’objet multimédia lorsqu’une personne commente une publication Instagram boostée ou une publication de publicités Instagram. Cela peut avoir pour résultat des notifications de webhook en double.

Limites

  • On ne peut envoyer qu’un seul message à la personne qui a fait le commentaire.
  • Pour les commentaires sur une publication, une publication de publicités ou un reel, ce message doit être envoyé dans un délai de 7 jours à compter de la date de leur création.
  • En raison de la nature éphémère des stories Instagram Live, les réponses privées à leurs commentaires ne peuvent être envoyées que pendant la diffusion en direct. Dès que la diffusion en direct est terminée, il n’est plus possible d’envoyer des réponses privées.
  • Ce n’est que lorsque la personne répond au message privé que vous pouvez poursuivre la conversation dans la fenêtre de messagerie de 24 heures.
  • Les applications à accès standard ne peuvent accéder aux données que pour les personnes qui ont un rôle dans l’application.
  • Les réponses privées pour les commentaires IGTV ne sont pas prises en charge.
  • Les API v7.0 ou plus anciennes ont besoin de la fonctionnalité Agent humain et de l’indicateur de message Agent humain pour les réponses privées.

Avant de commencer

Ce tutoriel suppose que vous avez lu la Présentation de la plateforme Messenger et la Présentation d’Instagram Messaging et que vous avez implémenté les composants nécessaires.

Vous aurez besoin des éléments suivants :

  • ID de la Page Facebook associée à votre compte professionnel Instagram.
  • ID du commentaire laissé par la personne à qui vous envoyez la réponse privée. Cet ID peut être obtenu à partir des webhooks Instagram comments pour les publications, les publications de publicités et les reels, et des webhooks Instagram live_comments pour les stories en direct (recommandé pour éviter d’atteindre le plafond) ou via un appel d’API au point de terminaison /page/feed.
  • Les autorisations instagram_manage_comments et pages_messaging, obtenues via Facebook Login.
  • Un token d’accès de Page demandé par une personne qui peut effectuer la tâche MESSAGING sur la Page Facebook liée à votre compte professionnel Instagram.
  • La fonctionnalité Agent humain.
  • Accès Avancé.

Envoyer une réponse privée

Pour envoyer une réponse privée à une personne qui a commenté votre publication, votre reel ou votre story en direct, envoyez une requête POST au point de terminaison /PAGE-ID/messages où le paramètre recipient contient l’ID du commentaire et le paramètre message contient le texte que vous souhaitez envoyer.

Formatage pour plus de lisibilité.
curl -i -X POST "https://graph.facebook.com/PAGE-ID/messages
  ?recipient: { comment_id: COMMENT-ID }
  &message: { "text": "Thanks for reaching out, how can I help?" }
  &access_token=PAGE-ACCESS-TOKEN"
GraphRequest request = GraphRequest.newPostRequest(
  accessToken,
  "/1353269864728879/messages",
  new JSONObject("{\"recipient\":\"{comment_id: 18000158536435933}\",\"message\":\"{\\\"text\\\": \\\"It is cool\\\"}\"}"),
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});
request.executeAsync();
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/1353269864728879/messages"
           parameters:@{ @"recipient": @"{comment_id: 18000158536435933}",@"message": @"{"text": "It is cool"}",}
           HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];
FB.api(
  '/1353269864728879/messages',
  'POST',
  {"recipient":"{comment_id: 18000158536435933}","message":"{\"text\": \"It is cool\"}"},
  function(response) {
      // Insert your code here
  }
);

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

{
  "recipient_id": "526...",   // The Instagram-scoped ID 
  "message_id": "aWdfZ..."    // The message ID for your private reply
}

Voir aussi

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