Webhooks cho Trang

Webhooks cho Trang có thể gửi cho bạn thông báo trong thời gian thực về những thay đổi đối với Trang của bạn. Ví dụ: bạn có thể nhận được thông tin cập nhật trong thời gian thực bất cứ khi nào người dùng đăng lên bảng feed của bạn, bình luận về một bài viết hoặc thích bài viết của bạn.

Cách thiết lập Webhook cho Trang:

1. Thiết lập điểm cuối và đặt cấu hình sản phẩm Webhooks.
2. Cài đặt ứng dụng thông qua trang Facebook.

Thiết lập điểm cuối và sản phẩm Webhook

Hãy làm theo hướng dẫn Bắt đầu của chúng tôi để tạo điểm cuối và đặt cấu hình sản phẩm Webhooks. Khi đặt cấu hình, hãy nhớ chọn đối tượng Trang và đăng ký một hoặc nhiều trường trên Trang như bên dưới.

Cài đặt ứng dụng

Hệ thống sẽ chỉ gửi thông báo webhook nếu Trang của bạn đã cài đặt ứng dụng được đặt cấu hình Webhooks và nếu Trang đó chưa vô hiệu hóa nền tảng Ứng dụng trong phần Cài đặt ứng dụng. Để cài đặt ứng dụng cho Trang, hãy gửi yêu cầu POST từ ứng dụng của bạn đến cạnh subscribed_apps của Trang bằng mã truy cập Trang.

Yêu cầu

• Mã truy cập Trang do một người có thể thực hiện tác vụ CREATE_CONTENT, MANAGE hoặc MODERATE trên Trang được truy vấn yêu cầu
• Quyền pages_manage_metadata và pages_show_list là bắt buộc đối với webhook feed
• Quyền pages_messaging là bắt buộc đối với messages

Chỉ dành cho các trường liên quan đến tin nhắn

• Mã truy cập Trang do một người có thể thực hiện tác vụ MESSAGING trên Trang được truy vấn yêu cầu
• pages_messaging

Yêu cầu mẫu

curl -i -X POST "https://graph.facebook.com/{page-id}/subscribed_apps
  ?subscribed_fields=feed
  &access_token={page-access-token}"

Phản hồi mẫu

{
  "success": "true"
}

Để xem Trang của bạn đã cài đặt ứng dụng nào, hãy gửi yêu cầu GET:

Yêu cầu mẫu

curl -i -X GET "https://graph.facebook.com/{page-id}/subscribed_apps &access_token={page-access-token} 

Phản hồi mẫu

{
  "data": [
    {
      "category": "Business",
      "link": "https://my-clever-domain-name.com/app",
      "name": "My Sample App",
      "id": "{page-id}"
    }
  ]
}

Nếu Trang của bạn chưa cài đặt ứng dụng nào, API sẽ trả về tập dữ liệu trống.

Trình khám phá API Đồ thị

Nếu không muốn cài đặt ứng dụng theo cách lập trình, bạn có thể dễ dàng thực hiện thông qua Trình khám phá API Đồ thị:

1. Chọn ứng dụng của bạn trong menu thả xuống Ứng dụng. Thao tác này sẽ trả về mã truy cập của ứng dụng.
2. Nhấp vào menu thả xuống Lấy mã và chọn Lấy mã truy cập người dùng, sau đó chọn quyền pages_manage_metadata. Khi đó, mã ứng dụng của bạn sẽ được đổi lấy mã truy cập dành cho Người dùng cùng với quyền pages_manage_metadata.
3. Nhấp lại vào Lấy mã rồi chọn Trang của bạn. Khi đó, mã truy cập dành cho Người dùng sẽ được đổi lấy mã truy cập Trang.
4. Nhấp vào menu thả xuống GET rồi chọn POST để thay đổi phương thức thao tác.
5. Thay thế truy vấn me?fields=id,name mặc định bằng ID của Trang rồi đến /subscribed_apps, sau đó gửi truy vấn.

Cách dùng phổ biến

Lấy thông tin chi tiết về bảng feed dành cho Trang

Ứng dụng của bạn có thể đăng ký Bảng feed dành cho Trang và nhận được thông báo mỗi khi có bất kỳ thay đổi nào liên quan đến Bảng feed. Ví dụ: sau đây là thông báo được gửi khi một Người dùng đăng lên Trang.

Phản hồi webhook mẫu

[
  {
    "entry": [
      {
        "changes": [
          {
            "field": "feed",
            "value": {
              "from": {
                "id": "{user-id}",
                "name": "Cinderella Hoover"
              },
              "item": "post",
              "post_id": "{page-post-id}",
              "verb": "add",
              "created_time": 1520544814,
              "is_hidden": false,
              "message": "It's Thursday and I want to eat cake."
            }
          }
        ],
        "id": "{page-id}",
        "time": 1520544816
      }
    ],
    "object": "page"
  }
]

Hãy sử dụng post_id trong thông báo để bình luận về bài viết trên Trang.

Yêu cầu API mẫu

curl -i -X POST   "https://graph.facebook.com/{page-post-id}/comments
  ?message=I%20want%20chocolate%20cake%20!
  &access_token=page-access-token" 

Phản hồi API mẫu

{
  "id": "{comment-id}"
}