Tích hợp Zalo OA
I. ĐIỀU KIỆN TÍCH HỢP
Để tích hợp được CRM với Zalo thì cần phải đáp ứng các yêu cầu sau:
1. Đã tạo sẵn Zalo Official Account (Zalo OA) và tài khoản Zalo OA đã được duyệt
(Để tạo tài khoản Zalo OA bạn tham khảo tại đây : https://oa.zalo.me/home/blog/huong-dan-dang-ky-tai-khoan-zalo-official-account-doanh-nghiep-article61)
2. Tài khoản Zalo OA tích hợp đã đăng ký gói trả phí với Zalo.
2. Người thực hiện cấu hình tích hợp Zalo – CRM, phải có quyền quản trị (Admin) trên kênh OA tích hợp.
4. Đã có link hệ thống CRM và người thực hiện cấu hình tích hợp phải có quyền quản trị (Admin) trên CRM
II. CẤU HÌNH TÍCH HỢP
1. Cấu hình phía Zalo
Các bước thực hiện cấu hình phía Zalo bao gồm:
a. Tạo ứng dụng
Ứng dụng Zalo là một nền tảng để các hệ thống khác (trong đó có CRM) có thể tích hợp được với Zalo. Ứng dụng này sẽ cung cấp các cơ chế để CRM tương tác với các API của Zalo, cũng như chuyển tiếp các sự kiện xảy ra ở phía Zalo cho CRM biết thông qua cơ chế Webhook notify.
Lưu ý: Nếu bạn đã tạo sẵn ứng dụng Zalo phục vụ cho việc tích hợp CRM thì không cần thực hiện bước này.
Để tạo ứng dụng Zalo, bạn làm như sau:
Bước 1: User thực hiện cấu hình đăng nhập trang Zalo Developer, click vào biểu tượng Avatar, chọn “Thêm ứng dụng mới”
Link: https://developers.zalo.me/
Để tạo ứng dụng Zalo, bạn làm như sau:
Bước 2: Trong popup tạo ứng dụng, bạn nhập thông tin cơ bản của ứng dụng cần tạo, tick vào captchar rồi click nút “Tạo ID ứng dụng”
- Tên hiển thị: Đặt tên cho ứng dụng, bạn có thể đặt tên theo tên Công ty của bạn
- Danh mục: Chọn 1 danh mục, ví dụ như “Công cụ phát triển”
- Mô tả: Mô tả thêm cho ứng dụng, ví dụ như “Ứng dụng dùng để liên kết với các kênh qua API”
Bước 3: Màn hình tiếp tục hiện lên popup thứ 2 để bạn nhập thông tin chi tiết liên quan đến ứng dụng như hình ảnh đại diện cho ứng dụng, miền ứng dụng và các thông tin khác.
Lưu ý: Chọn ảnh đại diện trước khi nhập các thông tin khác để không bị mất các thông tin đã nhập.
- Icon ứng dụng (512 x 512): Là 1 ảnh đại diện cho Ứng dụng bạn đang tạo, ảnh này có kích thước 512 x 512 px
- Điện thoại liên hệ: Bạn nhập điện thoại liên hệ của doanh nghiệp bạn hoặc điện thoại liên hệ của người quản lý Ứng dụng này.
- Email liên hệ: : Bạn nhập email liên hệ của doanh nghiệp bạn hoặc email liên hệ của người quản lý Ứng dụng này.
- Miền ứng dụng: Nhập domain được phép truy cập ứng dụng (ở đây chính là domain của CRM của bạn), tại bước này bạn để trống, sau khi xác thực domain xong thì quay lại cập nhật sau.
- ID ứng dụng + Khóa bí mật của ứng dụng: Dùng để tích hợp vào CRM.
Màn hình thông báo sau khi nhấn “Lưu thay đổi”
b. Xác thực domain
Đây là chính sách mới của Zalo, yêu cầu bạn trước khi cấu hình Zalo OA với 1 domain bạn cần phải thực hiện xác thực domain này.
Các bước thực hiện như sau:
Bước 1: Truy cập vào menu “Xác thực domain”
Bước 2: Nhập thông tin domain bạn muốn kết nối với ứng dụng sau đó nhấn “Xác thực”
Lưu ý: Thông tin domain chỉ nhập tên không nhập phương thức “http” hay “www”
Ví dụ link CRM của bạn là https://demo.cloudgo.vn/ => Domain là demo.cloudgo.vn
Bước 3: Nhấn vào “Xác thực ngay” để tiến hành xác thực domain
Bước 4: Bạn hãy chọn cách thứ 2 “Tải tệp HTML lên trang web của bạn” để tiến hành xác thực domain
Bước 5: Tiến hành tải tệp html về máy của bạn
Bước 6: Tiếp theo bạn hãy deploy tệp tin bạn vừa tải về vào thư mục root của dự án
(Bước này bạn gửi file đã tải về nhờ team CRM hỗ trợ thực hiện cấu hình vào CRM để xác thực)
Ví dụ minh hoạ ở đây đang thực hiện xác thực domain: demo.cloudpro.vn/public_html
Bước 7: Sau khi team CRM hỗ trợ xong bước cấu hình trên CRM để “Xác thực”, cuối cùng bạn nhấn “Xác thực” trên màn hình là hoàn thiện bước Xác thực domain
Bước 8: Kết quả sau khi bạn xác thực thành công
c. Cập nhật lại domain trong ứng dụng
Bạn truy cập vào “Cài đặt” nhấn “Kích hoạt” và thực hiện nhập domain vừa được xác thực vào “Miền ứng dụng” nhấn “Lưu thay đổi”
d. Đăng ký sử dụng API
Tại màn hình này, bạn click vào menu “Đăng ký sử dụng API” chọn tiếp mục “Official Account API” tick chọn tất cả các API trong danh sách rồi click nút Nộp xét duyệt để yêu cầu Zalo cấp quyền sử dụng
Thực hiện tương tự cho mục Article API
Và cả Shop API nữa
e. Cấu hình Webhook Notify
Cơ chế Webhook notifiy giúp CRM lắng nghe được các sự kiện đang xảy ra trên Zalo để có những xử lý tương ứng theo từng sự kiện.
Các bước cấu hình Webhook notify như sau:
Bước 1. Trong menu Official Account, bạn click chọn “Webhook” rồi chọn “Thay đổi”
Bước 2. Màn hình cập nhật webhook url hiện lên, bạn nhập vào Webhook URL của CRM rồi bấm nút “Cập nhật”
Thông tin Webhook bạn lấy từ CRM.
Lưu ý: Bạn cần có tài khoản quản trị (Admin) CRM mới lấy đc thông tin này.
Bước 3. Sau khi cập nhật Webhook URL, bảng danh mục các sự kiện sẽ hiện ra, bạn click từng trang để chắc chắn rằng tất cả các sự kiện đều được bật. Nếu sự kiên nào chưa bật thì bạn click vào button bật/tắt để bật nó lên.
Bạn bật lần lượt từ trang số 1 – trang số 8. Mỗi lần bật được 10 nút, sau đó chờ thêm 1 phút nữa để tiếp tục bật cho đến hết số trang.
f. Cấu hình Callback URL
Để có thể cấp quyền cho CRM thực hiện các thao tác gọi API của Zalo thì Callback URL của CRM cần phải được đăng ký với ứng dụng Zalo tương ứng.
Các bước thực hiện như sau:
Bước 1. Click vào menu “Official Account” rồi chọn “Thiết lập chung” để cập nhật Callback Url