API Graph
Versione API Graph

Conversazione /{thread-id}

Una conversazione in Facebook Messenger. Questo endpoint è accessibile solo per gli utenti che sono sviluppatori dell'app che esegue la richiesta.

Le Pagine devono usare l'endpoint di conversazione.

Lettura

Ottieni una conversazione di messaggi.

Autorizzazioni

Esempio

Tool di esplorazione per la API Graph
GET /v21.0/{thread-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(
    '/{thread-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(
    "/{thread-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{thread-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:@"/{thread-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Campi

Nome Descrizione Tipo

id

L'ID unico per questa conversazione.

string

comments

I messaggi in questa conversazione.

Message[]

to

I profili che hanno attivato le notifiche per la conversazione.

Profile[]

unread

Il numero di messaggi non letti dal profilo nella sessione.

integer

unseen

Il numero di messaggi non visti dal profilo nella sessione.

integer

updated_time

La data dell'ultimo aggiornamento della conversazione.

datetime

can_reply

Possibilità della pagina di rispondere nella conversazione.

boolean

linked_group

ID del gruppo Workplace a cui la conversazione è associata (solo per Workplace)

string

Segmenti

Nome Descrizione

messages

Lista di singoli messaggi nella conversazione. Vedi Messaggi

Applicazione di filtri ai messaggi

La connessione messages può essere filtrata in modo da evitare che l'app Messenger estragga testo dagli avvisi della conversazione. Questa operazione può essere eseguita tramite il filtro source per cui è possibile selezionare solo i partecipanti.

Se questo filtro non è applicato, sarà recuperato anche il testo amministratore (testo in grigio visualizzato nella conversazione da Messenger).

Esempio

Questa chiamata recupererà gli ultimi 3 messaggi tra quelli inviati solo dai partecipanti.

curl -i -X GET \
 "https://graph.facebook.com/v4.0/t_10155839492600149?fields=id,messages.source(PARTICIPANTS).limit(3)&access_token=<Access Token>"

Pubblicazione

Non puoi eseguire questa operazione su questo endpoint.

Eliminazione

Non puoi eseguire questa operazione su questo endpoint.

Aggiornamento

Non puoi eseguire questa operazione su questo endpoint.