Messages Instagram

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 à l’utilisateur·ice de votre application d’envoyer un message unique à une personne qui a commenté sa publication de compte professionnel Instagram, sa publication de publicités, son reel ou sa story en direct.

Lorsque votre serveur webhook reçoit une notification d’évènement comments ou live_comments, vous pouvez utiliser l’ID du commentaire pour envoyer une réponse privée directement à l’utilisateur·ice Instagram qui a publié le commentaire. Cette réponse sera distribuée dans le dossier Boîte de réception de cette personne, si elle est abonnée au compte professionnel Instagram, ou dans son dossier Demande, si elle ne l’est pas.

Il est possible d’envoyer des réponses privées dans les 7 jours suivant la 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 l’utilisateur·ice Instagram 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’un·e utilisateur·ice 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 à l’utilisateur·ice 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 l’utilisateur·ice Instagram 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.

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 un·e utilisateur·ice Instagram 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 à un·e utilisateur·ice Instagram 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/&lt;PAGE_ID>/messages
  ?recipient: { comment_id: &lt;COMMENT_ID> }
  &message: { "text": "Thanks for reaching out, how can I help?" }
  &access_token=&lt;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