versión API Graph

Conversación /{thread-id}

Una conversación de mensajes de Facebook Messenger A este extremo solo pueden acceder los usuarios que desarrollan la aplicación y que realizan la solicitud.

Las páginas deberían utilizar el extremo de conversación.

Lectura

Obtén 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 esta conversación.

Profile[]

unread

La cantidad de mensajes que el perfil de la sesión no ha leído.

integer

unseen

La cantidad de mensajes que el perfil de la sesión no ha visto.

integer

updated_time

Cuándo se ha actualizado la conversación por última vez.

datetime

can_reply

Si la página puede responder en la conversación.

boolean

linked_group

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

string

Perímetros

Nombre Descripción

messages

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

Filtración de mensajes

La conexión messages se puede filtrar para evitar extraer texto que forma parte de las advertencias de las conversaciones con las aplicaciones de Messenger. Esto se realiza a través del filtro source, donde solo se pueden seleccionar participantes.

Si este filtro no se aplica, el texto del administrador (texto gris que aparece en la conversación de Messenger) también se recuperará.

Ejemplo

Esta llamada recuperará los 3 últimos mensajes que realizaron únicamente los participantes.

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 puedes realizar esta operación en este extremo.

Eliminar

No puedes realizar esta operación en este extremo.

Actualizar

No puedes realizar esta operación en este extremo.