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.
Sau khi click “tại đây” sẽ được chuyển vào liên kết như trên hình
Bấm để tạo Official Account mới
Chọn loại hình tài khoản tương ứng với mục đích sử dụng
Nhấn chọn để chọn loại tài khoản tương ứng
Nhấn Đăng ký tài khoản
Hệ thống hiển thị màn hình Khai báo thông tin
Điền các thông tin cơ bản cần thiết
Nhấn chọn đồng ý Điều khoản sử dụng -> nhấn Tạo tài khoản QA
Nhấn Xác nhận để đăng ký tài khoản
Thông báo thành công hay thất bại sẽ được trả về, việc tiếp theo là Bắt đầu xác thực
Ở đây sẽ có 3 loại xác thực, tải lên loại giấy tờ cần thiết
Sau khi đăng tải các giấy tờ cần thiết, OA sẽ ở trạng thái “Đang chờ duyệt”
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.
Sau khi được chuyển ở liên kết trên, bấm “Thêm ứng dụng mới”
Sau khi bấm ‘Thêm ứng dụng mới” sẽ được chuyển vào liên kết như trên hình, điền thông tin thích hợp rồi bấm “Tạo ID ứng dụng”
Nhập Điện thoại liên hệ và Email liên hệ -> nhấn Lưu thay đổi
Nhấn vào toggle để kích hoạt ứng dụng
Nhấn Đồng ý để kích hoạt ứng dụng
Ứng dụng đã được kích hoạt thành công
Lấy Zalo App ID
Nhấn để sao chép ID ứng dụng
Tại pop-up Tích hợp Zalo, dán đoạn text vừa sao chép vào trường Zalo App ID
Lấy App Secret Key
Nhấn vào biểu tượng eye để hiển thị khóa bí mật của ứng dụng
Nhấn để sao chép khóa bí mật của ứng dụng
Tại pop-up Tích hợp Zalo, dán đoạn text vừa sao chép vào trường App Secret Key
Nhấn vào Danh sách OA của tôi để hiển thị danh sách OA
Sao chép OA ID cần tích hợp Chatbot
Tại pop-up Tích hợp Zalo, dán đoạn text sao chép vào trường OA ID
Lấy Access Token
Nhấn vào Quản lý Ứng dụng
Tại mục Công cụ -> Nhấn chọn API Explorer
Nhấn và chọn đúng ứng dụng cần tích hợp
Chọn loại Access Token là OA Access Token
Nhấn Lấy Access Token -> chọn đúng tài khoản OA của bạn
Tick vào Đồng ý cho phép ứng dụng quản lý Offcial Account -> nhấn Cho phép
Nhấn để sao chép Access Token
Tại pop-up Tích hợp Zalo, dán đoạn text vừa sao chép vào OA Access Token
Lấy OA Refresh Token
Nhấn để sao chép Refresh Token
Tại pop-up Tích hợp Zalo, dán đoạn text vừa sao chép vào 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ụ.
Nhấn vào profile -> chọn ứng dụng phù hợp
Nhấn vào Xác thực Domain trên menu side-bar
Tại pop-up Tích hợp Zalo, nhấn sao chép Callback URL
Dán đoạn URL vừa sao chép vào Domain, xóa các đoạn text phía sau, chỉ giữ lại domain như hình -> nhấn Xác thực
Hệ thống hiện thị pop-up Chưa được xác thực -> nhấn vào Xác thực ngay
Hệ thống hiển thị pop-up Xác thực quyền sở hữu -> tại mục Tải tệp HTML lên trang web của bạn -> nhấn vào tải tệp xuống
Tại pop-up Tích hợp Zalo, nhấn chọn Thư mục -> chọn tệp vừa tải xuống
Dán đoạn URL vừa sao chép vào trường Webhook URL -> nhấn Cập nhật
Giao diện hiển thị sau khi cập nhật Webhook URL -> kích hoạt những mục cần hiển thị
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
Có thể tìm kiếm các lệnh trong Webhook
Trạng thái sau khi kích hoạt các danh mục cần thiết
Kích hoạt Tích hợp Zalo
Hoàn thành các bước trên thì đã đầy đủ yêu cầu để Tích hợp Zalo -> nhấn Lưu để hoàn tất tích hợp
