Version API du graphe

Conversation /{conversation-id}

Conversation Messenger entre une personne et une Page Facebook ou un compte professionnel Instagram.

Lecture

Explorateur de l’API Graph
GET /v19.0/{conversation-id} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{conversation-id}',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "/{conversation-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{conversation-id}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{conversation-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Autorisations

Pour les messages Instagram, vous aurez aussi besoin des éléments suivants :

Limites

  • En interrogeant ce point de terminaison pour obtenir les messages Instagram, tous les messages de la conversation seront renvoyés. Or, vous ne pourrez interroger que les données des 20 derniers messages de la conversation. Si un message ne figure pas parmi les 20 derniers, une erreur sera renvoyée indiquant qu’il a été supprimé.

Champs

Nom Description

id

chaîne

ID de la conversation

messages

chaîne

Messages dans la conversation

participants

objet

id


email

Messages Page uniquement

name

Messages Page uniquement

username

Messages Instagram uniquement

Participants à la conversation


ID spécifique d’Instagram ou ID spécifique de Page pour une personne ou ID Instagram pour votre compte professionnel Instagram ou l’ID Page.

Adresse e-mail de la personne ou Page


Nom de la personne ou de la Page


Nom d’utilisateur Instagram pour une personne ou votre compte professionnel Instagram

updated_time

date/heure

Heure à laquelle le dernier message a été ajouté à la conversation

Pour obtenir des informations sur un message spécifique au sein d’une conversation, envoyez une demande au point de terminaison Message.

Publication

Vous ne pouvez pas effectuer de publication à l’aide de cette arête.

Utilisez la plateforme Messenger pour envoyer des modèles, des réponses rapides, etc.

Suppression

Vous ne pouvez pas effectuer de suppression à l’aide de cette arête.

Mise à jour

Vous ne pouvez pas effectuer de mise à jour à l’aide de cette arête.

Arêtes

Nom Description Utilisé pour publier

/messages

Liste de tous les messages de la conversation

Réponses (par Page uniquement)