Tích hợp Zalo

Bước 1: Tạo tài khoản OA

Bạn cần có tài khoản OA để sử dụng các chức năng trên hệ thống OA API.

Nếu chưa có tài khoản OA, bạn có thể tạo mới tài khoản tại đây.

Lưu ý*: OA sau khi khởi tạo sẽ cần được hệ thống Zalo kích hoạt trước khi có thể sử dụng. Thời gian kích hoạt dự kiến trong vòng 1 – 7 ngày làm việc.

Điều kiện để tích hợp được AI Chatbot với Zalo OA:

Tài khoản Zalo OA cần đăng ký Zalo Cloud Account (xem hướng dẫn tại đây)
Tài khoản Zalo OA cần được nâng cấp lên gói Nâng cao trở lên (xem hướng dẫn tại đây)

Bước 2: Tạo ứng dụng để liên kết với OA

Để sử dụng các chức năng thuộc hệ thống OA API, OA sẽ thực hiện thông qua một ứng dụng tương ứng được ủy quyền đại diện cho OA. Một OA có thể ủy quyền cho nhiều ứng dụng tùy theo mục đích và loại dịch vụ cần sử dụng.

Truy cập tại đây và đăng nhập bằng tài khoản Zalo của bạn để tạo ứng dụng.

Lấy Zalo App ID

Lấy App Secret Key

Lấy OA ID

Truy cập Zalo OA tại đây

Lấy Access Token

Lấy OA Refresh Token

Lấy Domain Authentication
Theo thay đổi từ chính sách thông tin khách hàng của Zalo OA (xem tại đây) Từ ngày 15/03/2024 domain của sever Vagent sẽ thay đổi thành: https://agw.vagent.ai/ *Lưu ý: Khách hàng đã tích hợp Zalo OA trước ngày 15/03/2024 cần tiến hành tích hợp lại với domain trên để dịch vụ không bị gián đoạn dịch vụ.

Cập nhật Webhook

Khi muốn hiển thị các tin nhắn dạng hình ảnh, audio, file đính kèm, sticker từ đoạn hội thoại với người dùng tại Livechat thì khi tích hợp với Zalo cần kích hoạt các quyền Webhook sau:

Để Hiển thị liên kết -> Kích hoạt Sự kiện người dùng gửi tin nhắn liên kết
Để Hiển thị tin nhắn -> Kích hoạt Sự kiện người dùng gửi tin nhắn text
Để Hiển thị sticker -> Kích hoạt Sự kiện người dùng gửi tin nhắn sticker
Để Hiển thị gif -> Kích hoạt Sự kiện người dùng gửi tin nhắn gif
Để Hiển thị tin nhắn âm thanh -> Kích hoạt Sự kiện người dùng gửi tin nhắn voice
Để Hiển thị tệp tin đính kèm -> Kích hoạt Sự kiện người dùng gửi tin nhắn đính kèm file