Hướng dẫn tích hợp nhanh.vn vào BeeIQ CRM



Hướng dẫn tích hợp Nhanh.vn

I. Giới thiệu về tính năng tích hợp nhanh.vn

  • Nếu bạn có một tập khách hàng trên nhanh.vn. Bạn muốn quản lý và lưu trữ thông tin khách hàng này trên phần mềm BeeIQ thì giải pháp chính là tính năng tích hợp nhanh.vn vào BeeIQ CRM.

  • Không chỉ khách hàng mà các thông tin liên quan trực tiếp đến khách hàng như bill, order đều được đồng bộ và hiển thị ngay trong trang chi tiết của  lead/contact sau khi đồng bộ thành công.

  • Các thao tác với khách hàng trên nhanh.vn được xử lí realtime và cập nhập liên tục trên BeeIQ.

  • Nhân viên chăm sóc khách hàng sẽ nắm được chi tiết các lịch sử mua hàng hay đơn hàng trong khi thực hiện gọi ra hoặc nhận cuộc gọi hỗ trợ từ phía khách hàng của nhanh.vn ngay trên giao diện cuộc gọi của BeeIQ


II. Hướng dẫn cấu hình tài khoản tích hợp và đồng bộ dữ liệu (dành cho Owner)

Lưu ý: Trước khi tiến hành tích hợp tài khoản, quản trị viên hệ thống phải liên hệ nhà cung cấp nhanh.vn để có tài khoản API. 

1. Tích hợp tài khoản API

Bước 1: Mở trang tích hợp nhanh.vn

Vào Thiết lập → Chọn Module tích hợp → Chọn Tích hợp nhanh.vn


Bước 2: Thêm tài khoản API

Nhấp chọn vào Thêm tài khoản API → Điền thông tin vào form Thêm tài khoản API

(Owner của hệ thống liên hệ bộ phận kĩ thuật của nhanh.vn để có tài khoản API)

  • Api username(đây là thông tin bắt buộc)

  • Mã bảo mật(đây là thông tin bắt buộc)

  • Nhãn

Nhấn Thêm để hoàn tất việc thêm tài khoản



Nếu tài khoản hợp lệ, thông tin của tài khoản sẽ được hiển thị tại trang Tài khoản API với thông báo Thêm thành công và có trạng thái là Disable


Bước 3: Kích hoạt tài khoản API

Owner phải kích hoạt tài khoản để có thể bắt đầu đồng bộ bằng cách nhấp vào button Trạng thái đến khi nó chuyển thành Enable


Khi đó sẽ hiện link button Đồng bộ dữ liệu ngay cạnh nút Thêm tài khoản API

2. Đồng bộ dữ liệu

Sau khi lưu thông tin tài khoản API thành công, nhấn chọn nút Đồng bộ dữ liệu để bắt đầu thiết lập đồng bộ.


Thông tin đồng bộ gồm:

  • Khách hàng

  • Đơn đặt hàng

  • Hóa đơn

2.1, Đồng bộ khách hàng

Đồng bộ khách hàng từ nhanh.vn là thao tác sao chép các thông tin từ doanh nghiệp của bạn trên nhanh.vn về BeeIQ CRM.

Hệ thống sẽ kiểm tra trùng khách hàng dựa trên số điện thoại và email

Bước 1: Thiết lập thông tin chung

  • Vai trò: có hai lựa chọn là Contact và Account

  • Phụ trách: chọn hoặc tìm kiếm theo tên hoặc email của tất cả nhân viên trong công ty


  • Thẻ: Để dễ dàng lọc và quản lí khách hàng sau khi đồng bộ, có thể gắn thẻ cho khách hàng bằng cách chọn thẻ từ danh sách các thẻ có sẵn


Hoặc tạo mới Thẻ




Bước 2: Tùy chọn xử lý khi trùng thông tin khách hàng

  • Bỏ qua nếu trùng: Nếu số điện thoại hoặc email của Khách hàng bên nhanh.vn đã tồn tại trong hệ thống thì lấy thông tin khách hàng đó từ hệ thống, không tạo mới hay cập nhật

  • Ghi đè nếu trùng: Cập nhập thông tin của contact/account theo các thông tin mới của Khách hàng bên Nhanh.vn

Bước 3: Mapping

Chọn trường thông tin khách hàng trên nhanh.vn chứa giá trị tương ứng với các trường thông tin của khách hàng trên BeeIQ CRM.Mặc định các cột đã được mapping sẵn.

Bước 4: Nhấn Đồng bộ

Sau khi nhất nút để bắt đầu đồng bộ sẽ hiện dòng trạng thái Đang xử lý...

Trường hợp với dữ liệu đồng bộ quá lớn(>5000), thì sẽ có thông báo trên màn hình:

“Số lượng khách hàng quá lớn (> 5000), quá trình đồng bộ có thể kéo dài trong vài phút.

Vui lòng không thực hiện bất kỳ thao tác đồng bộ dữ liệu khác khi đang có một tiến trình đồng độ đang diễn ra.”



Thông báo sau khi quá trình đồng bộ hoàn tất: Popup giữa màn hình,notify ở góc màn hình nếu owner không mở tab chứa trang đồng bộ. 

Đặc biệt hệ thống sẽ gửi email kết quả đồng bộ tới email của Owner sau khi hoàn thành


Thông tin Lịch sử đồng bộ khách hàng sẽ được lưu lại bao gồm:

  • Thời gian

  • Tổng số khách hàng

  • Số lượng khách hàng đã Tạo mới

  • Số lượng khách hàng đã Cập nhập

  • Lỗi

Danh sách khách hàng sau khi đồng bộ thành công sẽ nằm ở trang COntact hoặc Account tùy thuộc vào Vai trò lúc lựa chọn.

Các khách hàng được tạo mới trong quá trình đồng bộ sẽ có thông tin người tạoNHANH.VN


Vào trang chi tiết của các khách hàng này sẽ có thêm 2 tab là Đơn đặt hàngHóa đơn

2.2, Đồng bộ đơn đặt hàng

Bước 1: Vào Đồng bộ dữ liệu → Chuyển qua tab Đơn đặt hàng

Bước 2: Bấm vào nút Đồng bộ để bắt đầu đồng bộ các đơn đặt hàng của khách hàng từ Nhanh.vn sang BeeIQ CRM. 

Dòng trạng thái thông báo cho người dùng tiến trình đồng bộ Đơn đặt hàng đang được diễn ra. Vui lòng không thực hiện bất kỳ thao tác đồng bộ dữ liệu khác khi đang có một tiến trình đồng bộ đang diễn ra.

Khi quá trình hoàn tất sẽ có thông báo Kết quả đồng bộ đơn đặt hàng với các thông tin sau:

  • Thời gian đồng bộ

  • Tổng số đơn đặt hàng

  • Số đơn đặt hàng được tạo mới

  • Số đơn đặt hàng đã cập nhập

  • Lỗi

Thông tin đơn đặt hàng của khách hàng sẽ được hiển thị trong tab [NHANH.VN]Đơn đặt hàng

  • ID

  • Trạng thái

  • Ngày tạo

  • Người tạo

  • Ngày giao

  • Hãng vận chuyển

  • Tiền chiết khấu

  • Tiền đặt cọc

  • Tiền chuyển khoản

  • Phí vận chuyển

  • Phí thu tiền hộ

  • Phí thu của khách

  • Tổng thu

  • Ghi chú của khách hàng

  • Ghi chú của CSKH

  • Sản phẩm


Nhấn chọn vào Xem sản phẩm để xem chi tiết thông tin sản phẩm của đơn hàng:

2.3, Đồng bộ hóa đơn

Bước 1: Vào Đồng bộ dữ liệu → Chuyển qua tab Hóa đơn

Bước 2: Bấm vào nút Đồng bộ để bắt đầu đồng bộ các hóa đơn của khách hàng từ Nhanh.vn sang BeeIQ CRM. 


Dòng trạng thái thông báo cho người dùng tiến trình đồng bộ Hóa đơn đang được diễn ra. Vui lòng không thực hiện bất kỳ thao tác đồng bộ dữ liệu khác khi đang có một tiến trình đồng bộ đang diễn ra.

Khi quá trình hoàn tất sẽ có thông báo Kết quả đồng bộ hóa đơn với các thông tin sau:

  • Thời gian đồng bộ

  • Tổng số đơn đặt hàng

  • Số hóa đơn được tạo mới

  • Số hóa đơn đã cập nhập

  • Lỗi

Thông tin về hóa đơn của khách hàng sẽ được hiển thị trong tab [NHANH.VN]Đơn đặt hàng

  • ID

  • Ngày tạo

  • Loại

  • Kiểu

  • Nhân viên bán hàng

  • Nhân viên thu ngân

  • Chiết khấu

  • Tổng tiền

  • Đã thanh toán

  • Sản phẩm

Nhấn chọn vào Xem sản phẩm để xem chi tiết thông tin sản phẩm của hóa đơn:

3. Cập nhập thông tin liên quan đến đơn hàng sau khi đồng bộ

Để cập nhật dữ liệu tự động khi có khách hàng đặt đơn hàng từ Nhanh.vn hoặc từ website của bạn về BeeIQ CRM, hãy liên hệ bộ phận kỹ thuật của Nhanh.vn để đăng ký Webhook với Listener URL của tài khoản API.


  • Thêm mới: Khi có 1 đơn hàng được thêm mới bên nhanh.vn, hệ thống BeeIQ sẽ kiểm tra xem đơn hàng này đã thuộc về Contact nào trên BeeIQ chưa

  • Nếu đã có contact (số điện thoại/email của khách hàng trùng với số điện thoại/email của contact)=> Tiến hành thêm đơn hàng vào mục Lịch sử mua hàng của Contact


  • Nếu contact chưa tồn tại => Tiến hành lưu Contact mới với Tên sẽ lấy giá trị của Số điện thoại Khách hàng và thêm đơn hàng vào mục Lịch sử mua hàng của Contact mới tạo.

III. Thiết lập popup cuộc gọi

Vào Thiết lập → mở Thiết lập cuộc gọi →chọn Popup cuộc gọi → Chọn các tab hiển thị trên popup cuộc gọi → Nhấn Lưu để hoàn tất thiết lập.

  • Hiện tại sau khi tích hợp với nhanh.vn, nội dung các tab được chọn để hiển thị trên popup cuộc gọi bao gồm:

  • Lịch sử

  • Ghi chú

  • Emai

  • Cuộc gọi

  • SMS

  • Nhiệm vụ

  • Giao dịch

  • Ticket

  • [NHANH.VN] Đơn đặt hàng

  • [NHANH.VN] Hóa đơn

Có thể tick chọn tất cả hoặc không chọn nội dung nào để hiển thị

Popup cuộc gọi hiển thị khi thực hiện các cuộc gọi ra vào từ BeeIQ. Nội dung của popup gồm thông tin Contact và các tab đã được tick chọn ở phần Thiết lập.

Was this article helpful? Votes: 0
Article details:
Published date: 08/09/2020 10:56AM
Last updated: 13/09/2022 9:31AM (thuan.tran@antbuddy.com - thuan.tran@antbuddy.com)
Share article:   
Author:manle (man.le@htklabs.com)
Nhanh.vn | tích hợp | Nhanh |