API Graph versión

Conversación /{thread-id}

Una conversación con mensajes de Facebook. Solo los usuarios que son desarrolladores de la app que realiza la solicitud pueden acceder a este punto de conexión.

Las páginas deberían usar el punto de conexión de conversación.

Lectura

Recibe una conversación de mensajes.

Permisos

Ejemplo:

Explorador de 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
}];

Campos

Nombre Descripción Tipo

id

El identificador único de esta conversación de mensajes.

string

comments

Los mensajes de esta conversación.

Message[]

to

Los perfiles que están suscritos a la conversación.

Profile[]

unread

La cantidad de mensajes no leídos por el perfil de la sesión.

integer

unseen

La cantidad de mensajes no vistos por el perfil de la sesión.

integer

updated_time

La fecha y la hora de la última actualización de la conversación.

datetime

can_reply

Determina si la página puede responder en la conversación.

boolean

linked_group

El identificador del grupo de Workplace al cual está vinculada la conversación (solo Workplace).

string

Perímetros

Nombre Descripción

messages

Lista de mensajes individuales de la conversación. Consulta Mensajes.

Filtrado de mensajes

La conexión de messages se puede filtrar con el objetivo de evitar obtener texto que es parte de las advertencias de la conversación que realizó la app de Messenger. Puedes hacerlo usando el filtro source, en el que solo puedes seleccionar participantes.

Si no se aplica este filtro, también se obtendrá texto de administración (texto gris que aparece en la conversación como enviado por Messenger).

Ejemplo:

Esta llamada recuperará los últimos tres mensajes que crearon los participantes únicamente.

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

Publicación

No es posible realizar esta operación en este punto de conexión.

Eliminación

No es posible realizar esta operación en este punto de conexión.

Actualización

No es posible realizar esta operación en este punto de conexión.