Đăng nhập cổng thông tin bằng Zalo¶
Thông tin bài hướng dẫn
Khi nào dùng tính năng này¶
Khách ít truy cập cổng thông tin có thể quên mật khẩu. Đăng nhập bằng Zalo giúp khách truy cập mà không phải nhớ mật khẩu riêng cho cổng thông tin.
Ví dụ xuyên suốt hướng dẫn này: Chị Phạm Thị Mai dùng Đăng nhập bằng Zalo để kiểm tra hóa đơn. Sau khi cấp quyền qua Zalo, chị quay lại cổng thông tin và kiểm tra các hóa đơn cũ có hiển thị không. Nếu thiếu hóa đơn, quản trị viên kiểm tra liên kết Zalo với hồ sơ khách hàng của chị.
Với Đăng nhập bằng Zalo, khách cấp quyền qua Zalo mà không phải tự đăng ký hoặc nhớ mật khẩu riêng cho cổng thông tin. Khi cấu hình cho phép, hệ thống có thể tạo tài khoản người dùng và hồ sơ khách hàng. Để xem chứng từ cũ, định danh Zalo phải được liên kết với đúng hồ sơ khách hàng.
Tính năng này phù hợp khi:
Công ty đã dùng Zalo OA để chăm sóc khách hàng (khách đã từng nhắn tin qua Zalo OA).
Đội ngũ muốn giảm yêu cầu hỗ trợ "quên mật khẩu cổng thông tin" từ bộ phận hỗ trợ.
Khách hàng chủ yếu dùng điện thoại để xem đơn hàng, hóa đơn, theo dõi vận đơn.
Điều kiện trước khi bắt đầu¶
Phải đủ cả ba điều kiện — thiếu một thì nút sẽ không xuất hiện:
Module ``viin_zalo`` đã cài, OA ở trạng thái Đã kết nối — xem Cấu hình Zalo OA.
OA có đủ App ID và App Secret (kiểm tra trong bản ghi OA).
Module ``viin_zalo_auth_oauth`` đã cài đặt.
Cấu hình đăng nhập Zalo cho cổng thông tin¶
(Cổng thông tin Quản trị viên)
Sau khi 3 điều kiện trên đã sẵn sàng, toàn bộ việc kích hoạt chỉ cần 1 bước:
Ghi chú
Nếu công ty có nhiều OA, chọn một OA cho đăng nhập cổng thông tin. Kiểm tra các định danh Zalo đã lưu theo App/OA đó có liên kết với hồ sơ khách hàng cũ không; việc nhận diện dựa vào các liên kết này, không chỉ dựa vào tên hoặc số điện thoại.
Vào , tìm trường Tài khoản OA trong phần cài đặt Zalo.
Chọn đúng OA đang kết nối với công ty hiện tại, sau đó nhấn Lưu.
Sau khi lưu, hệ thống tự tạo kết nối xác thực nội bộ cho công ty — quản trị viên không cần cấu hình thêm gì.
Kiểm tra kết quả — Kiểm tra nút Zalo trên cổng thông tin¶
Mẹo
Dấu hiệu cấu hình thành công:
Nút "Đăng nhập bằng Zalo" xuất hiện trên trang đăng nhập cổng thông tin, cạnh ô nhập email/password.
Nhấn nút → trình duyệt chuyển sang màn hình xác thực của Zalo (không bị báo lỗi, không bị điều hướng vòng lại cổng thông tin).
Sau khi khách đồng ý trên Zalo → cổng thông tin tự đăng nhập, không yêu cầu nhập password.
Để kiểm tra nhanh: mở cửa sổ ẩn danh trình duyệt, truy cập địa chỉ cổng thông tin của công ty, kiểm tra nút Zalo có hiển thị không.
Nếu nút không xuất hiện, xem phần Nút "Đăng nhập bằng Zalo" không xuất hiện bên dưới.
Luồng khách đăng nhập lần đầu¶
(Khách hàng)
Khách mở trang đăng nhập cổng thông tin trên trình duyệt điện thoại hoặc máy tính.
Khách thấy nút "Đăng nhập bằng Zalo" với biểu tượng Zalo, nhấn vào nút đó.
Trình duyệt chuyển sang trang xác thực của Zalo. Nếu khách đã đăng nhập Zalo trên trình duyệt, trang hiển thị yêu cầu xác nhận quyền truy cập thông tin hồ sơ. Nếu chưa, khách cần nhập số điện thoại Zalo trước.
Khách nhấn "Đồng ý" trên màn hình xác nhận của Zalo.
Zalo chuyển khách về cổng thông tin. Viindoo tìm định danh Zalo đã lưu để dùng tài khoản hiện có, hoặc tạo tài khoản khi cấu hình cho phép.
Khách vào cổng thông tin mà không nhập mật khẩu riêng, rồi kiểm tra đơn hàng và hóa đơn có thuộc đúng hồ sơ của mình không.
Ghi chú
Màn hình xác nhận ở bước 3-4 do Zalo hiển thị (không phải Viindoo). Trên đó khách thấy tên ứng dụng, danh sách thông tin hồ sơ mà ứng dụng xin truy cập (tên hiển thị, ảnh đại diện) và hai nút Đồng ý / Từ chối. Nếu khách chưa đăng nhập Zalo trên trình duyệt, Zalo yêu cầu nhập số điện thoại và mã xác thực trước khi tới màn hình này.
Thời gian đăng nhập phụ thuộc vào các bước cấp quyền qua Zalo và kết nối. Sau khi đăng nhập, kiểm tra có xem được đúng chứng từ cần tìm không.
Ghi chú
Nếu đăng nhập xong mà không thấy đơn hàng, hóa đơn cũ — xem Khách đăng nhập xong nhưng không thấy dữ liệu cũ bên dưới.
Lỗi thường gặp và cách xử lý¶
Lỗi xác thực khi chuyển từ Zalo về cổng thông tin¶
Triệu chứng: Khách nhấn "Đồng ý" trên Zalo nhưng bị trả về trang lỗi thay vì vào được cổng thông tin. Trình duyệt có thể hiển thị thông báo "invalid state", "redirect mismatch", hoặc lỗi trắng không rõ nội dung.
Nguyên nhân thường gặp:
Địa chỉ chuyển tiếp khai báo trong Viindoo chưa khớp với địa chỉ đã đăng ký tại Zalo OA Console.
App Secret của OA đã bị đổi trên Zalo nhưng chưa cập nhật lại trong Viindoo.
Cách xử lý:
Vào , mở bản ghi OA đang dùng cho cổng thông tin.
Tìm trường OAuth Callback URL, copy toàn bộ địa chỉ này.
Đăng nhập Zalo OA Console → mở App tương ứng → mục Redirect URI → đảm bảo địa chỉ vừa copy có trong danh sách. Nếu chưa, thêm vào và lưu lại.
Nếu App Secret đã bị đổi: cập nhật trường Mật khẩu ứng dụng trong bản ghi OA → nhấn Lưu → thực hiện lại xác thực kết nối.
Cảnh báo
Địa chỉ chuyển tiếp phải khớp chính xác từng ký tự — kể cả http:// hay https://, có dấu / ở cuối hay không. Sai 1 ký tự là Zalo từ chối toàn bộ luồng xác thực.
Khách đăng nhập xong nhưng không thấy dữ liệu cũ¶
Triệu chứng: Khách đăng nhập thành công bằng Zalo nhưng vào tài khoản trống — không thấy đơn hàng, hóa đơn, hay thông tin đã có trước đó.
Nguyên nhân thường gặp: Tài khoản Zalo của khách chưa được liên kết với hồ sơ khách hàng có sẵn trong Viindoo — hệ thống tạo hồ sơ mới thay vì khớp với hồ sơ cũ.
Cách xử lý (Cổng thông tin Quản trị viên):
Xử lý theo hướng dẫn tại Quản lý liên kết đối tác Zalo.
Sau khi xử lý xong, khách đăng xuất và đăng nhập lại bằng Zalo — lần này hệ thống sẽ nhận diện đúng và vào tài khoản cũ.
Với các khách hàng mới chưa nhắn tin qua Zalo OA, Quản trị viên nên xử lý ngay sau lần đăng nhập đầu tiên — thay vì đợi khách báo lỗi.