Thiết lập Webhooks
Đăng ký Webhooks để nhận thông báo khi tín hiệu chất lượng và chế độ cài đặt Tài khoản WhatsApp Business của bạn có sự thay đổi.
Việc thiết lập Webhooks sẽ không ảnh hưởng đến số điện thoại trên Ứng dụng WhatsApp Business của bạn. Chỉ sau khi chuyển số điện thoại sang Nền tảng WhatsApp Business, bạn mới không dùng được số đó trên Ứng dụng WhatsApp Business nữa.
Tạo điểm cuối
Trước khi có thể bắt đầu nhận thông báo, bạn sẽ cần tạo một điểm cuối trên máy chủ để nhận thông báo.
Điểm cuối của bạn phải có khả năng xử lý 2 loại yêu cầu HTTPS: Yêu cầu xác minh và Thông báo sự kiện. Vì cả hai yêu cầu này đều sử dụng HTTPS nên máy chủ của bạn phải đặt cấu hình và cài đặt chính xác một chứng chỉ TLS hoặc SSL hợp lệ. Chứng chỉ tự ký không được hỗ trợ.
Đăng ký Webhooks
Để đăng ký Webhooks, bạn sẽ cần lấy ID ứng dụng trên Meta và các quyền truy cập. Để thực hiện việc này, hãy truy cập Bảng điều khiển ứng dụng trên Meta. Tại đây, bạn sẽ:
- Tạo một ứng dụng trên Meta trong Bảng điều khiển ứng dụng trên Meta
- Thêm sản phẩm Webhooks vào ứng dụng của bạn trên Meta trong Bảng điều khiển ứng dụng
Hiện tại, mỗi Ứng dụng trên Meta chỉ có thể yêu cầu đặt cấu hình một điểm cuối. Nếu cần gửi bản cập nhật webhook đến nhiều điểm cuối, bạn cần có nhiều Ứng dụng trên Meta.
Khi sẵn sàng mở rộng quy mô nhắn tin cho doanh nghiệp, bạn có thể cần:
- Thêm quyền
whatsapp_business_management trong Bảng điều khiển ứng dụng
- Hoàn tất thành công quy trình Xét duyệt ứng dụng của Meta - Bước này sẽ cần nhiều thời gian, nhưng bạn có thể tiếp tục thử nghiệm trong toàn bộ quy trình xét duyệt.
Các trường đăng ký có sẵn
Các trường đăng ký có sẵn
| Tên trường | Mô tả |
|---|---|
| Hệ thống gửi thông báo cho bạn khi một Tài khoản WhatsApp Business đã được xét duyệt. |
| Hệ thống gửi thông báo cho bạn khi có thay đổi đối với Tài khoản WhatsApp Business của bạn. Thay đổi này có thể bao gồm cập nhật về số điện thoại, lỗi vi phạm chính sách, Tài khoản WhatsApp Business bị cấm, v.v. |
| Hệ thống gửi thông báo cho bạn khi một tính năng được cập nhật. Nội dung thông báo có thể bao gồm thay đổi về số lượng số điện thoại tối đa mà một WABA được phép có hoặc số cuộc trò chuyện trên mỗi số điện thoại. |
| Hệ thống gửi thông báo cho bạn khi mẫu tin nhắn đã được phê duyệt hoặc bị từ chối hay đã bị vô hiệu hóa. |
| Hệ thống gửi thông báo cho bạn khi doanh nghiệp bạn nhận được tin nhắn của khách hàng, khi ban gửi tin nhắn cho khách hàng, khi tin nhắn được gửi thành công cho khách hàng và khi khách hàng đọc tin nhắn của bạn. |
| Hệ thống gửi thông báo cho bạn khi tên liên kết với số điện thoại đã được phê duyệt hoặc bị từ chối. |
| Hệ thống gửi thông báo cho bạn khi có cập nhật về trạng thái liên quan đến chất lượng của một số điện thoại. |
| Hệ thống gửi thông báo cho bạn khi: |
Hãy truy cập Tài liệu tham khảo về Webhooks cho Tài khoản WhatsApp Business để biết thêm thông tin về từng trường phần tải dữ liệu và Tài liệu tham khảo về Webhooks cho API Đám mây của WhatsApp để biết thêm thông tin về các loại thông báo messages khác nhau mà bạn có thể nhận.
Phần tải dữ liệu thông báo
Mọi thông báo đều có định dạng chung sau:
[{
"object": "whatsapp_business_account",
"entry": [{
"id": "{whatsapp-business-account-id}",
"time": {unix-timestamp},
"changes": [{
"field": "{subscribed-field}",
"value": {
# Information that was update
}
}]
}]
}]Mảng ở cấp cao nhất chứa 2 đối tượng chính:
| Thông số | Mô tả |
|---|---|
Đây là đối tượng mà bạn đã đăng ký. | |
Đối tượng này chứa thông tin chi tiết về sự thay đổi đã kích hoạt lệnh gọi webhooks. |
Hãy xem phần Thành phần để biết mọi đối tượng webhooks có sẵn.