API Graph versión

Conversación /{conversation-id}

Una 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

En el caso de los mensajes de Instagram, también necesitarás lo siguiente:

Limitaciones

  • Cuando consultes este punto de conexión en relación con los mensajes de Instagram, se devolverán todos los mensajes de la conversación. Sin embargo, solo podrás consultar datos de los 20 mensajes más recientes de la conversación. Si un mensaje no se encuentra dentro de los 20 más recientes, se devolverá un error indicando que el mensaje se borró.

Campos

Nombre Descripción

id

Cadena

El identificador de la conversación

messages

Cadena

Mensajes dentro de la conversación

participants

Objeto

id


email

Solo mensajes de la página

name

Solo mensajes de la página

username

Solo mensajes de Instagram

Participantes en la conversación


Identificador específico de Instagram o identificador específico de la página en el caso de una persona, o identificador de Instagram en el caso de tu cuenta profesional de Instagram o el identificador de la página.

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 hora en la que se agregó el último mensaje a la conversación

Para obtener información sobre un mensaje específico dentro de una conversación, envía una solicitud al punto de conexión del mensaje.

Publicación

No puedes publicar con este perímetro.

Usa la plataforma de Messenger para enviar plantillas, respuestas rápidas y mucho más.

Eliminación

No puedes eliminar con este perímetro.

Actualización

No puedes actualizar usando este perímetro.

Perímetros

Nombre Descripción Se usa para publicar

/messages

Lista de todos los mensajes de la conversación

Respuestas (solo por páginas)