Версия API Graph

Переписка /{conversation-id}

Переписка в Messenger между пользователем и Страницей Facebook или профессиональным аккаунтом Instagram.

Чтение

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

Разрешения

Для обмена сообщениями в Instagram вам также понадобятся:

Ограничения

  • При запросе этой конечной точки для обмена сообщениями в Instagram будут возвращены все сообщения в переписке. Однако вы сможете запросить данные только для 20 последних сообщений в переписке. Если сообщение не находится среди 20 последних, появится ошибка с информацией о его удалении.

Поля

Имя Описание

id

Строка

ID переписки.

messages

Строка

Сообщения в переписке.

participants

Объект

id


email

Только обмен сообщениями на Странице

name

Только обмен сообщениями на Странице

username

Только обмен сообщениями в Instagram

Участники переписки.


ID с областью действия Instagram или ID с областью действия Страницы для пользователя или ID Instagram для вашего профессионального аккаунта Instagram или ID Страницы.

Эл. адрес пользователя или Страницы.


Имя пользователя или Страницы.


Имя пользователя для пользователя Instagram или для вашего профессионального аккаунта Instagram.

updated_time

Дата и время

Время добавления в переписку последнего сообщения.

Чтобы получить информацию об определенном сообщении в переписке, отправьте запрос к конечной точке "Сообщение".

Публикация

Эту границу контекста нельзя использовать для публикации.

Используйте платформу Messenger, чтобы отправлять шаблоны, быстрые ответы и многое другое.

Удаление

Эту границу контекста нельзя использовать для удаления.

Обновление

Эту границу контекста нельзя использовать для обновления.

Границы контекста

Имя Описание Публикуемые объекты

/messages

Список всех сообщений переписки

Ответы (только от Страниц)