Tài liệu tham khảo về sự kiện webhook

Sự kiện webhook là cách Nền tảng Messenger thông báo cho bot khi xảy ra nhiều hoạt động tương tác hoặc sự kiện khác nhau, bao gồm cả khi một người gửi tin nhắn. Sự kiện webhook sẽ được Nền tảng Messenger gửi dưới dạng yêu cầu POST đến webhook của bạn.

Lưu ý: Bạn sẽ cần đăng ký tất cả ứng dụng nhắn tin cho doanh nghiệp của mình với webhook nhắn tin.

Danh sách sự kiện webhook

Dưới đây là danh sách các sự kiện có thể được gửi đến webhook của bạn từ Nền tảng Messenger.

Lưu ý: Bạn nên sử dụng phiên bản API mới nhất để nhận được tất cả thông tin có sẵn cho mỗi webhook.

Sự kiện webhook	Mô tả
`messages`	Đăng ký sự kiện Đã nhận tin nhắn
`messaging_account_linking`	Đăng ký sự kiện Liên kết tài khoản
`messaging_checkout_updates` (beta)	Đăng ký sự kiện Cập nhật thanh toán
`message_deliveries`	Đăng ký sự kiện Đã gửi tin nhắn
`message_echoes`	Đăng ký nhận sự kiện Âm vang tin nhắn
`messaging_game_plays`	Đăng ký sự kiện Trò chơi tức thời
`messaging_handovers` (beta)	Đăng ký sự kiện Giao thức chuyển mạng
`messaging_optins`	Đăng ký nhận sự kiện Chọn tham gia plugin
`messaging_payments` (beta)	Đăng ký sự kiện Thanh toán
`messaging_policy_enforcement`	Đăng ký sự kiện Thi hành chính sách
`messaging_postbacks`	Đăng ký sự kiện Đã nhận yêu cầu đăng lại
`messaging_pre_checkouts` (beta)	Đăng ký sự kiện Trả trước khoản thanh toán
`message_reads`	Đăng ký nhận sự kiện Đã đọc tin nhắn
`messaging_referrals`	Đăng ký nhận sự kiện Tham chiếu
`standby` (beta)	Đăng ký sự kiện Kênh dự phòng giao thức chuyển mạng

Định dạng sự kiện

Tất cả lệnh gọi lại cho Nền tảng Messenger phải có nhóm thuộc tính chung cung cấp thông tin bạn cần để xử lý và phản hồi dữ liệu đầu vào từ mọi người thông qua bot của bạn. Ngoài các thuộc tính bên dưới, mỗi sự kiện cũng có nhóm thuộc tính cụ thể nêu chi tiết về sự kiện.

{
  "object":"page",
  "entry":[
    {
      "id":"<PAGE_ID>",
      "time":1458692752478,
      "messaging":[
        {
          "sender":{
            "id":"<PSID>"
          },
          "recipient":{
            "id":"<PAGE_ID>"
          },

          ...
        }
      ]
    }
  ]
}

Thuộc tính

Thuộc tính	Loại	Mô tả
`object`	Chuỗi	Giá trị sẽ là `page`
`entry`	Mảng `entry`	Mảng chứa dữ liệu sự kiện

`entry`

Thuộc tính	Loại	Mô tả
`id`	Chuỗi	ID Trang của trang
`time`	Số	Thời gian cập nhật (khoảng thời gian tính bằng mili giây)
`messaging`	Mảng<`messaging`>	Mảng chứa một đối tượng `messaging`. Lưu ý rằng mặc dù đây là một mảng nhưng mảng này sẽ chỉ chứa một đối tượng `messaging`.

`entry.messaging`

Thuộc tính	Loại	Mô tả
`sender.id`	Chuỗi	ID người dùng của người gửi
`recipient.id`	Chuỗi	ID người dùng của người nhận

Tìm hiểu thêm

Nếu bạn có nhiều ứng dụng xử lý tin nhắn, ví dụ: một ứng dụng xử lý tin trả lời tự động và một ứng dụng xử lý tin nhắn được chuyển đến nhân viên, bạn sẽ cần triển khai Giao thức chuyển giao để chuyển cuộc trò chuyện từ ứng dụng này sang ứng dụng khác. Giao thức chuyển giao