Version API du graphe

/{object-id}/private_replies

L’utilisation des réponses privées existantes est abandonnée à partir de la version 5.0

Le 29 octobre 2019, nous avons annoncé que ce point de terminaison devenait obsolète. Veuillez utiliser les nouvelles Réponses privées.

Dans le cadre des modifications apportées à la version 3.3, l’autorisation read_page_mailboxes est devenue obsolète. Pour accéder à ce point de terminaison, utilisez l’autorisation pages_messaging. L’autorisation read_page_mailboxes cessera de fonctionner après le 30 juin 2020.

Cette arête Réponses privées existantes permet aux Pages de répondre aux Commentaires sur les publications et aux Publications de visiteurs avec un message en texte brut uniquement. Vous pouvez l’utiliser avec les nœuds suivants :

Veuillez noter qu’un commentaire ou une publication ne peut recevoir qu’une seule réponse.

Lecture

Cette arête ne vous permet pas la lecture.

Publication

Répondre avec un Message privé :

POST /v19.0/{object-id}/private_replies HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->post(
    '/{object-id}/private_replies',
    array (),
    '{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(
    "/{object-id}/private_replies",
    "POST",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{object-id}/private_replies",
    null,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{object-id}/private_replies"
                                      parameters:params
                                      HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Les réponses privées aux publications ou commentaires sont autorisées dans un délai de 7 jours à compter de la date de création de la publication ou du commentaire de l’utilisateur.

Autorisations

Cette arête nécessite un token d’accès de Page avec les autorisations suivantes :

  • pages_messaging

Les applications en mode développement sont réservées à l’envoi de messages aux personnes qui ont un rôle dans l’app. En outre, les Pages ayant le statut unpublished ne seront autorisées à envoyer des messages qu’aux personnes ayant un rôle sur la Page.

Champs

Paramètre Description Type

id

L’ID de la page du commentaire ou de la publication du visiteur auquel vous répondez.

string

message

Le texte de la réponse. Ce champ est obligatoire.

string

Réponse

En cas de réussite, vous recevez une réponse avec les champs suivants : De plus, ce point de terminaison prend en charge la lecture après écriture et peut immédiatement lire le nœud représenté par id dans le type de retour.

Champ Description Type

id

L’ID du Message nouvellement créé.

string

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.