API Thông tin chi tiết nhắn tin

Tài liệu này giải thích cách lấy số liệu theo lập trình về các tin nhắn mà doanh nghiệp bạn đã gửi hoặc nhận. API Thông tin chi tiết nhắn tin là phần mở rộng của API Thông tin chi tiết Trang để bạn xem được thông tin như thông tin hiển thị trong tab Thông tin chi tiết Trang của Trang Facebook.

Trước khi bạn bắt đầu

Để xem số liệu cho Trang Facebook mà bạn sở hữu hoặc có thể thực hiện tác vụ ANALYZE, ứng dụng của bạn sẽ cần:

• ID Trang cho Trang Facebook mà bạn muốn xem số liệu

  • Đối với tin nhắn trên Instagram, đây sẽ là Trang Facebook liên kết với tài khoản Công việc trên Instagram
• Mã truy cập Trang
• Những quyền dưới đây:

  • pages_messaging
  • pages_read_engagement
  • pages_show_list
  • read_insights
• Quyền truy cập tiêu chuẩn

Để xem số liệu cho Trang Facebook mà bạn không sở hữu hoặc không thể thực hiện tác vụ ANALYZE, ứng dụng của bạn sẽ cần:

• ID Trang cho Trang Facebook mà bạn muốn xem số liệu

  • Đối với tin nhắn trên Instagram, đây sẽ là Trang Facebook liên kết với tài khoản Công việc trên Instagram
• Mã truy cập Trang do một người có thể thực hiện tác vụ ANALYZE trên Trang đó yêu cầu
• Các quyền sau thông qua phương thức Đăng nhập bằng Facebook:

  • pages_messaging
  • pages_read_engagement
  • pages_show_list
  • read_insights
• Quyền truy cập nâng cao

Các giới hạn

• Để cuộc trò chuyện mới được tính, người dùng phải thực hiện một hành động, chẳng hạn như trả lời doanh nghiệp bạn. Nếu người dùng chưa thực hiện hành động nào, cuộc trò chuyện đó sẽ chỉ hiển thị với họ và không được tính.

Đọc các số liệu trong Thông tin chi tiết

Để đọc thông tin dành cho một hoặc nhiều số liệu, hãy gửi yêu cầu GET đến điểm cuối /PAGE-ID/insights với thông số metric được đặt là danh sách số liệu bạn muốn xem, được phân tách bằng dấu phẩy.

Yêu cầu mẫu

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"

Nếu thành công, ứng dụng của bạn sẽ nhận được phản hồi JSON sau đây:

{ 
  "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" 
        }, 
      ]
    } 
  ],
}

Yêu cầu mẫu về tổng theo khoảng

Ví dụ sau đây cho biết tổng số lượt chuyển đổi mới, không trùng lặp trong một khoảng thời gian cụ thể bằng cách thêm thông số period được đặt là total_over_range có khoảng thời gian được xác định bằng các thông số since và until trong lệnh gọi API của chúng tôi.

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"

Nếu thành công, ứng dụng của bạn sẽ nhận được phản hồi JSON sau, kèm số lượng cuộc trò chuyện mới, không trùng lặp vào cuối khoảng thời gian:

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

Yêu cầu mẫu về số liệu chia nhỏ

Ví dụ sau đây cho biết tổng số mã thông báo định kỳ trong khoảng thời gian cụ thể, được phân nhóm theo chủ đề và tần suất.

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"

Nếu thành công, ứng dụng của bạn sẽ nhận được phản hồi JSON sau đây, kèm mã được nhóm theo chủ đề - "newproducts" và "10percentsale", cùng với tần suất nhắn tin cho từng chủ đề - "daily", "weekly" và "monthly" dành cho "newproducts" và "daily" và "weekly" dành cho "10percentsale":

{
  "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"
        },
      ]
    }
  ]
}

Thông số Thông tin chi tiết

Số liệu có sẵn

Bạn có thể lấy các số liệu sau qua API Thông tin chi tiết nhắn tin:

Tìm hiểu thêm về số liệu đang phát triển.

Thuộc tính phản hồi

Hệ thống có thể trả về các thông tin sau trong lệnh gọi đến API Thông tin chi tiết.

Xem thêm

• Tìm hiểu thêm về Thông tin chi tiết Trang
• Tìm hiểu thêm về tham chiếu đối tượng Thông tin chi tiết