This document refers to an outdated version of Graph API. Please use the latest version.
Graph API Version

Conversation /{conversation-id}

A Messenger conversation between a person and a Facebook Page or an Instagram Professional Account.

Reading

Graph API Explorer
GET /v15.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
}];

Permissions

For Instagram Messaging, you will also need:

Limitations

  • When querying this endpoint for Instagram Messaging, all messages for the conversation will be returned. However, you will only be able to query data for the 20 most recent messages in the conversation. If a message is not within the 20 most recent, an error will be returned stating that the message has been deleted.

Fields

Name Description

id

string

The ID for the conversation

messages

string

Messages within the conversation

participants

object

id


email

Page messaging only

name

Page messaging only

username

Instagram Messaging only

Participants in the conversation


Instagram-Scoped ID or Page-scoped ID for a person or Instagram ID for your Instagram Professional account or the Page ID.

Email for the person or Page


Name for the person or Page


Instagram username for a person or your Instagram Profession account

updated_time

datetime

The time when the last message was added to the conversation

To get information about a specific message within a conversation, send a request to the Message endpoint.

Publishing

You can't publish using this edge.

Use the Messenger Platform to send Templates, Quick Replies, and more.

Deleting

You can't delete using this edge.

Updating

You can't update using this edge.

Edges

Name Description Used to Publish

/messages

List of all messages in the conversation

Replies (by Pages only)