versión API Graph

Conversación /{conversation-id}

Conversación de Messenger entre una persona y una página de Facebook o una cuenta profesional de Instagram.

Lectura

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

Permisos

Para los mensajes de Instagram, también necesitarás lo siguiente:

Limitaciones

  • Al consultar este extremo para los mensajes de Instagram, se devolverán todos los mensajes de esta conversación. Sin embargo, solo podrás consultar los datos de los 20 mensajes más recientes de la conversación. Si un mensaje no se encuentra entre los 20 más recientes, se devolverá un error que indica que el mensaje se ha eliminado.

Campos

Nombre Descripción

id

cadena

Identificador de la conversación

messages

cadena

Mensajes de una conversación

participants

objeto

id


email

Solo mensajes entre páginas

name

Solo mensajes entre páginas

username

Solo mensajes de Instagram

Participantes en la conversación


Identificador específico de Instagram o de la página para una persona o identificador de la página o de la cuenta profesional de Instagram.

Correo electrónico de la persona o la página


Nombre de la persona o la página


Nombre de usuario de Instagram de una persona o tu cuenta profesional de Instagram

updated_time

fecha y hora

La fecha y hora en que se añadió el último mensaje a la conversación.

Para obtener información sobre un mensaje concreto dentro de una conversación, envía una solicitud al extremo message.

Publicación

No puedes realizar la publicación mediante este perímetro.

Usa la plataforma de Messenger para enviar plantillas y respuestas rápidas, entre muchas otras cosas.

Eliminación

No puedes realizar la eliminación mediante este perímetro.

Actualización

No puedes realizar la actualización mediante este perímetro.

Perímetros

Nombre Descripción Se utiliza para publicar

/messages

Lista de todos los mensajes de la conversación.

Respuestas (solo lo utilizan las páginas)