메시지 인사이트 API

이 문서에서는 비즈니스가 보내거나 받은 메시지에 대한 지표를 프로그래밍 방식으로 가져오는 방법을 설명합니다. 메시지 인사이트 API는 페이지 인사이트 API를 확장한 것으로, 이를 사용하면 Facebook 페이지의 '페이지 인사이트' 탭에 표시되는 것과 동일한 정보를 가져올 수 있습니다.

시작하기 전에

소유하거나 ANALYZE 작업을 수행할 수 있는 Facebook 페이지에 대한 지표를 보려면 앱에 다음이 필요합니다.

• 지표를 보려는 Facebook 페이지의 페이지 ID

  • Instagram 메시지의 경우 Instagram 프로페셔널 계정에 연결된 Facebook 페이지
• 페이지 액세스 토큰
• 다음 권한이 필요합니다.

  • pages_messaging
  • pages_read_engagement
  • pages_show_list
  • read_insights
• Standard Access

소유하지 않거나 페이지에서 ANALYZE 작업을 수행할 수 없는 Facebook 페이지에 대한 지표를 보려면 앱에 다음이 필요합니다.

• 지표를 보려는 Facebook 페이지의 페이지 ID

  • Instagram 메시지의 경우 Instagram 프로페셔널 계정에 연결된 Facebook 페이지
• 페이지에서 ANALYZE 작업을 수행할 수 있는 사용자가 요청한 페이지 액세스 토큰
• Facebook 로그인을 통한 다음 권한:

  • pages_messaging
  • pages_read_engagement
  • pages_show_list
  • read_insights
• Advanced Access

제한 사항

• 새로운 대화가 집계되려면 사용자가 비즈니스에 답장을 보내는 것과 같은 행동을 해야 합니다. 사용자가 행동을 할 때까지 대화는 사용자에게만 표시되고 집계되지는 않습니다.

인사이트 지표 읽기

지표 하나 이상에 대한 정보를 읽으려면 보려는 지표를 쉼표로 구분한 리스트로 metric 매개변수를 설정하여 /PAGE-ID/insights 엔드포인트에 GET 요청을 보내세요.

요청 샘플

curl -X GET "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/insights
    ?metric=page_messages_new_conversations_unique,page_messages_blocked_conversations_unique 
    &access_token=PAGE-ACCESS-TOKEN"

성공 시 앱은 다음과 같은 JSON 응답을 받습니다.

{ 
  "data": [ 
    { 
      "name": "page_messages_new_conversations_unique", 
      "period": "day", 
      "values": [ 
        { 
          "value": "42", 
          "end_time": "1665175977" 
        }, 
      ]
    },
    { 
      "name": "page_messages_blocked_conversations_unique", 
      "period": "day", 
      "values": [ 
        { 
          "value": "0", 
          "end_time": "1665175977" 
        }, 
      ]
    } 
  ],
}

특정 범위의 합계 요청 샘플

다음 예에서는 API 호출 시 total_over_range로 설정한 period 매개변수를 포함하고 시간 범위를 since 및 until 매개변수로 정의하여 특정 기간 동안의 새롭고 고유한 총 대화 수를 찾습니다.

curl -i -X GET "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/insights/
    ?metric=page_messages_new_conversations_unique
    &since=UNIX-TIMESTAMP-START
    &until=UNIX-TIMESTAMP-STOP
    &period=total_over_range
    &access_token=PAGE-ACCESS-TOKEN"

성공할 경우 앱은 새롭고 고유한 대화 수 및 시간 범위가 끝나는 시점과 함께 다음과 같은 JSON 응답을 받습니다.

{
  "data": [
    {
      "name": "page_messages_new_conversations_unique",
      "period": "total_over_range",
      "values": [
        {
          "value": 27
          "end_time": "1665175977"
        }
      ],
    }
  ]
}

분석 데이터 요청 샘플

다음 예에서는 특정 기간 동안 주제와 빈도별로 그룹화된 총 정기 알림 토큰 수를 찾습니다.

curl -i -X GET "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/insights/
    ?metric=recurring_notifications_tokens   
    &since=UNIX-TIMESTAMP-START
    &until=UNIX-TIMESTAMP-STOP
    &period=total_over_range
    &breakdown=recurring_notifications_topic,recurring_notifications_frequency 
    &access_token=PAGE-ACCESS-TOKEN"

성공할 경우 앱은 다음과 같은 JSON 응답을 받습니다. 이때 토큰은 주제('newproducts' 및 '10percentsale')와 각 주제에 사용 가능한 메시지 빈도('newproducts'의 경우 'daily', 'weekly', 'monthly', '10percentsale'의 경우 'daily' 및 'weekly')별로 그룹화됩니다.

{
  "data": [
    {
      "name": "recurring_notifications_tokens",
      "period": "total_over_range",
      "values": [ 
        {
          "value": 3,
          "end_time": "1665175977",
          "recurring_notifications_topic": "newproducts",
          "recurring_notifications_frequency": "daily"
        },
        {
          "value": 15,
          "end_time": "1665175977",
          "recurring_notifications_topic": "newproducts",
          "recurring_notifications_frequency": "weekly"
        },
        {
          "value": 8,
          "end_time": "1665175977",
          "recurring_notifications_topic": "newproducts",
          "recurring_notifications_frequency": "monthly"
        },
        {
          "value": 17,
          "end_time": "1665175977",
          "recurring_notifications_topic": "10percentsale",
          "recurring_notifications_frequency": "daily"
        },
        {
          "value": 14,
          "end_time": "1665175977",
          "recurring_notifications_topic": "10percentsale",
          "recurring_notifications_frequency": "weekly"
        },
      ]
    }
  ]
}

인사이트 매개변수

사용 가능한 지표

메시지 인사이트 API를 통해 다음과 같은 지표를 사용할 수 있습니다.

개발 중인 지표에 대해 자세히 알아보세요.

응답 속성

인사이트 API 호출 시 다음과 같은 정보가 반환될 수 있습니다.

기타 참고 자료

• 페이지 인사이트에 대해 더 알아보기
• 인사이트 개체 참고 자료에 대해 더 알아보기