# Zalo cá nhân (Beta)

Doopage hỗ trợ tích hợp Zalo cá nhân vào hệ thống, hỗ trợ các tính năng chat trực tiếp với khách hàng. Để tích hợp Zalo cá nhân vào Doopage, bạn vui lòng thực hiện theo các bước sau:

## 1. Điều kiện

{% hint style="warning" %}

* **Bạn cần có một máy tính chạy 24/7 để tiếp nhận dữ liệu tin nhắn Zalo cá nhân (hoặc bạn có thể sử dụng dịch vụ cho thuê VPS máy ảo thay thế).**
* **Cấu hình tối thiểu của máy tính hay VPS máy ảo nên là 5 account zalo cá nhân kết nối / 1GB RAM free. Cấu hình đề nghị 3 account  account zalo cá nhân kết nối/ 1GB RAM free để đảm bảo máy đủ resource chạy và không làm gián đoạn việc gửi nhận tin zalo cá nhân trên phần mềm. Người dùng có thể dựa vào khuyến nghị để lựa chọn cấu hình máy tính hoặc VPS máy ảo phù hợp với số lượng zalo cá nhân cần quản lý kết nối với phần mềm**
  {% endhint %}

## 2. Các bước tích hợp

### **Bước 1: Tải và cài đặt phần mềm HBRC (Đây là một phần mềm miễn phí mã nguồn mở) trên máy tính tiếp nhận dữ liệu tin nhắn Zalo cá nhân trong phần điều kiện tại đường dẫn bên dưới:** 

[`https://github.com/EagleNerdd/HBRC/releases`](https://github.com/EagleNerdd/HBRC/releases) 

**`Tải bản *-ia32-setup.exe nếu bạn sử dụng win32bit`**

**`Tải bản *-x64-setup.exe nếu bạn sử dụng win64bit`**

Sau khi  tải file .exe thì cài đặt bình thường

### **Bước 2: Đăng nhập vào my.doopage.com và** [**tạo agent (Quản lý -> agent -> thêm agent)**](https://how.doopage.com/thao-tac-danh-cho-quan-ly/quan-ly/agent) 

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcxZfEBc1cFNNvt9Iljc0_CdmhJbD0klOdcUg39ktVZ9_4Tw-0Homn5Q9O0USTgFuEpCF72IJpd05iXAcRa-Qfn8PswLUw15fFf3Df41lnWAgCFQkn5pTz9jx8_IfcUnwjElj5Jsg?key=Y5KI8M7yNHJZ71KNaxAJapIO" alt=""><figcaption><p>Agent được tạo thành công trên phần mềm DooPage</p></figcaption></figure>

\
Nhấn vào nút xem mã kết nối (Nút màu xanh lá) và copy mã kết nối

### **Bước 3: Kết nối HBRC với DooPage**

Mở phần mềm HBRC lên và nhập mã kết nối vừa tạo ở bước 2 vào và click “Connect”

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcFWH_6tnOoF1p9szSjuvuV4hqvcnhh_x9K2C1X1krmqDtdjTCSeRWbiTnqpkHu9nX059fR38avoK-k5U9nQSiHKA1jUQTK8Fr-paHt79IIKW0bCHVhisl0L9c-m7XNBvJBNQz1?key=Y5KI8M7yNHJZ71KNaxAJapIO" alt=""><figcaption></figcaption></figure>

### **Bước 4: Đăng nhập vào Zalo cá nhân trên phần mềm HBRC**

Trên phần mềm HBRC: click vào menu: manage -> add instance sau đó:&#x20;

* **Name:** nhập tên tùy ý theo nhu cầu ghi nhớ của bạn
* **Type:** bạn cần chọn một trong ba loại&#x20;
  * **Integrated**: Chế độ chạy trực tiếp trong HBRC, mức sử dụng tài nguyên trung bình
    . Khuyến khích sử dụng khi máy tính cài HBRC [**đáp ứng cấu hình đề nghị**](#id-1.-dieu-kien) ở trên, chạy với ít zalo cá nhân.
  * **Isolate**: Chế độ chạy trong một trình duyệt Chrome độc lập bên ngoài, mức sử dụng tài nguyên cao, nhưng có thể tách HBRC và chạy độc lập bằng Chrome
    . Khuyến khích sử dụng khi máy tính cài HBRC có cấu hình [**cao hơn cấu hình đề nghị**](#id-1.-dieu-kien) ở trên, đáp ứng với zalo cá nhân quan trọng có lượng dữ liệu lưu trữ lớn và đảm bảo tính bảo toàn dữ liệu.
  * **Lightweight**: Chế độ chạy trong một trình duyệt Chrome độc lập bên ngoài, mức sử dụng tài nguyên thấp, có thể chạy nhiều zalo cá nhân trên máy tính cài đặt HBRC có cấu hình [**thấp hơn cấu hình đề nghị**](#id-1.-dieu-kien)**.** Nhưng do cơ chế hoạt động sử dụng mức tài nguyên thấp, mỗi lần khởi động lại HBRC sẽ yêu cầu thao tác đăng nhập lại Zalo trên web, nên cần đảm bảo HBRC phải được mở 24/24 nhằm tránh rủi ro Zalo không lưu trữ dữ liệu như lịch sử chat/tin nhắn/... trên web.
* **Url** là: [https://chat.zalo.me](about:blank)

<figure><img src="https://408401242-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L_lMBbRU2HXBnCnDHJ-%2Fuploads%2FxPjTjt8erreE278nKO6w%2Fimage.png?alt=media&#x26;token=0b026b72-2be6-445e-b204-8f82609be09f" alt=""><figcaption></figcaption></figure>

Sau đó sẽ hiển thị cửa sổ quét mã QR để đăng nhập Zalo -> Sau khi quét mã và đăng nhập thành công thì có thể đóng cửa sổ lại

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXf9lftgSSmAbd7lWwpAYCY-_8SYc7-f_haANHBWecae0ZoKLYEOc4QHZddcnWfaF-q5HC_1cuhgfGftpz6padB0UNPs3Ma0Hvy8aPl2CHViM4m5pda6GsDtV_Aj8zakMqh9sSBQ5Q?key=Y5KI8M7yNHJZ71KNaxAJapIO" alt=""><figcaption></figcaption></figure>

### **Bước 5: Thêm kênh Zalo cá nhân trên my.doopage.com**

Trên [my.doopage.com](https://my.doopage.com/dashboard/channel), chọn Kênh và thao tác thêm Kênh Zalo → Chọn **Agent vừa tạo ở Bước 2** trong danh sách Agent → Chọn Instance (**tên Instance đã tạo ở Bước 4**) và Hoàn tất tích hợp

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfD44-dUYRjyPwmEjNFbnAn-9Pii6Hl-4bwpUzCnxL8RojSYY5MBqDpahYxeyUkTtZFO1b7YgbEGoUO0BzrgZwBj_70hr80jE1y6rc0ZDPabDMcP1jwJ_x7oa9xrYwySzLXWr35HA?key=Y5KI8M7yNHJZ71KNaxAJapIO" alt=""><figcaption><p>Thêm Kênh Zalo cá nhân tại mục Kênh trên my.doopage.com</p></figcaption></figure>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdFWP2OTSS3xvOmMlimXMLQNblKSr03K33EKSLlGTfYNDisIe_MKHFMRDX72bNU5MEQOjY9gH4HjxJG3lThR1VdxNGt8t-jtIUzTwCCClBdfBNZ2flc2YjPSeGG7lsmcyTORAuC?key=Y5KI8M7yNHJZ71KNaxAJapIO" alt=""><figcaption><p>Thêm thông tin Agent được tạo ở Bước 2 và Instance được tạo ở Bước 4</p></figcaption></figure>

## 3. Hoàn tất tích hợp

Sau khi tích hợp thành công, tin nhắn từ Zalo cá nhân sẽ được load về DooPage để quản lý tập trung.&#x20;

*Bạn có thể sử dụng Center DooPage* [*(https://center.doopage.com/1.16.0-beta/home)*](https://center.doopage.com/1.16.0-beta/home) *để trả lời khách hàng nhắn tin qua Zalo cá nhân đã tích hợp*

## Lưu ý

{% hint style="danger" %}

* Sau khi tích hợp Zalo cá nhân vào phần mềm DooPage, vì cơ chế của Zalo, nếu bạn đang sử dụng Zalo cá nhân này trên phiên bản web, Zalo cá nhân này sẽ tự động đăng xuất khỏi phiên bản web. Bạn chỉ có thể sử dụng một trong hai tùy chọn: sử dụng Zalo cá nhân trên phần mềm DooPage hoặc trên phiên bản web (đối với Zalo cá nhân phiên bản app thì vẫn sử dụng bình thường)
* **Nếu bạn xóa kênh zalo cá nhân tại mục Kênh trên my.doopage.com thì các dữ liệu trước đó của kênh zalo cá nhân này đã được lưu trên center.doopage.com sẽ có thể bị mất**
* Hiện tại Zalo cá nhân đang beta thử nghiệm. Nếu gặp vấn đề trong quá trình sử dụng, bạn vui lòng liên hệ với DooPage thông qua [Fanpage](http://m.me/doopagecrm) hoặc [Zalo OA](https://zalo.me/1357058467586222863) DooPage để thông báo vấn đề cho chúng tôi. Đội ngũ kỹ thuật DooPage sẽ cố gắng update trong thời gian sớm nhất có thể để hỗ trợ người dùng.
  {% endhint %}

### Hướng dẫn xử lý vấn đề khi cập nhật lại Zalo cá nhân hiển thị thông báo:

{% hint style="warning" %}
HBRC Browser Instance is already used by other channel
{% endhint %}

**Trong trường hợp bạn không thể thao tác cập nhật kênh Zalo cá nhân trên  Dashboard (my.doopage.com), bạn hãy vào HBRC, tại Instance tương ứng với Zalo cá nhân đó --> click icon Stop** <img src="https://408401242-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L_lMBbRU2HXBnCnDHJ-%2Fuploads%2FutNK2cfZba3fqUhPoPgt%2Fimage.png?alt=media&#x26;token=159a5f17-5f5e-4c92-a678-a3e092e78ab1" alt="" data-size="original">**--> click icon Delete** <img src="https://408401242-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L_lMBbRU2HXBnCnDHJ-%2Fuploads%2Fn6YqO7ukVn3U5Y08FEBv%2Fimage.png?alt=media&#x26;token=53196a22-1517-4f3d-85ba-0bbc5e494345" alt="" data-size="original">

**Sau đó thao tác lại** [**Bước 4**](#buoc-4-dang-nhap-vao-zalo-ca-nhan-tren-phan-mem-hbrc) **ở trên bằng cách thêm Instance và đăng nhập Zalo cá nhân trên HBRC**

**Cuối cùng bạn vào lại my.doopage.com, tìm đến kênh Zalo cá nhân không cập nhật được --> click chọn icon Update** <img src="https://408401242-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L_lMBbRU2HXBnCnDHJ-%2Fuploads%2FRnVWBdLJrbu6vSlNxDuJ%2Fimage.png?alt=media&#x26;token=316d857f-43b5-4232-851c-9cf92be3367a" alt="" data-size="original">**--> Chọn lại Instance mới đã thao tác thêm --> Click nút Complete.**

{% hint style="info" %}
DooPage khuyến nghị bạn ưu tiên thao tác xóa Instance trên HBRC, thêm lại Instance và thao tác cập nhật lại Zalo cá nhân, không nên xóa kênh Zalo cá nhân trên Dashboard my.doopage.com.
{% endhint %}