Hướng dẫn kết nối Zalo Cloud

Để sử dụng được các dịch vụ Zalo Cloud trên SenCloud buộc các đối tác/khách hàng phải tiến hành liên kết ứng dụng (app) với cs.sencloud.vn

Bước 1: Truy cập vào trang Zalo developers

Bước 2: Truy cập vào ứng dụng mà trước đó bạn đã tạo

Chọn vào biểu tượng avatar tài khoản Zalo của bạn như hình

Truy cập vào ứng dụng mà bạn muốn kết nối với SenCloud

Lưu ý: Nếu chưa có bạn có thể chọn "Thêm ứng dụng mới"

Nhập các thông tin theo yêu cầu. Chi tiết bạn có thể tham khảo tài liệu này

Bước 3: Tiến hành "Xác thực domain"

Mục đích của việc xác thực domain để bạn có thể cấu hình được link webhook do SenCloud cung cấp

Sau khi truy cập vào ứng dụng -> Xác thực domain

  • Domain: api.sencloud.vnsencloud.vn

Bạn chọn "Xác thực ngay" để tiến hành xác thực.

Bạn copy thông tin ở Bước 2 và gửi lại cho SenCloud sau đó bấm xác thực.

Lưu ý: Quá trình xác thực có thể mất đến 72 giờ để Zalo xét duyệt. Nếu trạng thái domain vẫn là Chưa được xác thực, bạn vui lòng chọn Xác thực lại lần nữa.

Domain được xét duyệt thành công sẽ được hiển thị ở phần "Danh sách domain xác thực".

Bước 4: Cấu hình webhook

Việc cấu hình "Webhook URL" sẽ giúp cho SenCloud có thể nhận được các event Zalo trả về để xây dựng các báo cáo, lịch sử gửi tin, ... một cách chính xác, phục vụ cho nhu cầu của bạn

Sau khi xác thực domain thành công, bạn truy cập vào "Webhook" -> Copy thông tin "OA Secret Key" và gửi cho SenCloud.

SenCloud sẽ tiến hành cập nhật "Secret Key" cho webhook sau đó sẽ thông báo lại với bạn để tiến hành thay đổi thông tin "Webhook URL"

Đối với trường hợp chưa có thông tin "OA Secret Key" thì bạn tiến hành thay đổi "Webhook URL" theo thông tin sau:

Sau khi cập nhật thành công bạn vui lòng cung cấp cho SenCloud thông tin "OA Secrect Key"

Lưu ý: Trong thường hợp bạn "Cập nhật webhook url" không thành công -> hệ thống xuất hiện thông báo như hình thì vui lòng "Tiến hành xác thực domain" cho đến khi domain được hiển thị ở phần "Danh sách domain xác thực"

Lưu ý: Nếu bạn reset hay thao tác dẫn đến "OA Secret Key" thì hãy cung cấp lại cho SenCloud.

Ở mục "Danh sách sự kiện webhook":

  • Nếu bạn sử dụng tính năng ZNS: bạn chỉ cần bật sự kiện "Sự kiện tin nhắn đã được nhận" như hình

  • Nếu bạn sử dụng ZNS Journey: bạn cần bật sự kiện "Thông báo Journey hết hạn" và "Thông báo Journey được tính phí".

  • Nếu bạn sử dụng tính năng ZCC: bạn cần bật sự kiện "Sự kiện OA gửi yêu cầu thực hiện cuộc gọi đến người dùng / yêu cầu đã hết hạn" và "Sự kiện người dùng trả lời yêu cầu thực hiện cuộc gọi từ OA"

  • Để xem được danh sách người quan tâm thì bạn cần bật sự kiện "Sự kiện người dùng quan tâm Official Account" và "Sự kiện người dùng bỏ quan tâm Official Account".

Bước 5: Thiết lập đường dẫn yêu cầu cấp quyền

Mục đích của bước này để SenCloud có thông tin thực hiện liên kết ứng dụng của bạn với hệ thống SenCloud

Lưu ý: Đối với trường hợp khách hàng muốn "Làm mới refresh token" trên cs.sencloud.vn thì cần thiết lập lại đường dẫn yêu cầu cấp quyền ở mục "Official Account Callback Url" theo thông tin sau:

https://api.sencloud.vn/v1/zalo/OAuth

Last updated