그래프 API 버전

/{object-id}/private_replies

v5.0 이상에서 기존 비공개 답장이 사용 중단됩니다.

2019년 10월 29일에 이 엔드포인트의 사용 중단을 발표했습니다. 새로운 비공개 답장을 사용하세요.

V3.3 변경 사항의 일부로 read_page_mailboxes 권한이 사용 중단됩니다. 이 엔드포인트에 액세스하려면 pages_messaging 권한을 사용하세요. 2020년 6월 30일 이후에는 read_page_mailboxes 권한이 사용 중단됩니다.

이 에지는 기존 비공개 답장이며 페이지에서 일반 텍스트로만 구성된 메시지로 게시물 댓글과 방문자 게시물에 답장할 수 있습니다. 이 에지는 다음과 같은 노드와 함께 사용할 수 있습니다.

댓글 또는 게시물에는 한 번만 답장할 수 있습니다.

읽기

이 에지를 사용하여 읽을 수 없습니다.

게시

비공개 메시지로 답장하려면 다음을 실행합니다.

POST /v19.0/{object-id}/private_replies HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->post(
    '/{object-id}/private_replies',
    array (),
    '{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(
    "/{object-id}/private_replies",
    "POST",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{object-id}/private_replies",
    null,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{object-id}/private_replies"
                                      parameters:params
                                      HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

게시물 또는 댓글에 대한 비공개 답장은 사용자 게시물 또는 댓글의 생성 날짜로부터 7일 이내까지 허용됩니다.

권한

이 에지는 다음과 같은 권한이 있는 페이지 액세스 토큰이 필요합니다.

  • pages_messaging

개발 모드의 앱은 앱에서 역할이 부여된 사용자에게만 메시지를 전송하도록 제한됩니다. 또한 unpublished 상태의 페이지는 페이지에서 역할이 부여된 사용자에게만 메시지를 전송하도록 허용합니다.

필드

매개변수 설명 유형

id

답장할 페이지 댓글 또는 방문자 게시물의 ID.

string

message

답장의 텍스트. 이 필드는 필수 필드입니다.

string

응답

성공할 경우 다음과 같은 필드가 포함된 응답을 받게 됩니다. 또한 이 엔드포인트는 쓰기 후 읽기를 지원하고 반환 유형에서 id로 표현되는 노드를 즉시 읽을 수 있습니다.

필드 설명 유형

id

새로 생성된 메시지의 ID.

string

삭제

이 에지를 사용하여 삭제할 수 없습니다.

업데이트

이 에지를 사용하여 업데이트할 수 없습니다.