# 39) Tích Hợp Chatbot Vào Zalo OA

## HƯỚNG DẪN TÍCH HỢP ZALO OA VÀO HỆ THỐNG CRMONLINE AI CHATBOT

<figure><img src="https://3971044875-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVPPvtkVmjRvNZvoU53%2Fuploads%2FPW4zqiP1o0JppIimjl7v%2FHuong-dan-cau-hinh-chatbot-ai-crmonline-vao-zalo-oa.png?alt=media&#x26;token=1dab3c60-50b5-4e47-a2ef-8aa735ba4038" alt=""><figcaption></figcaption></figure>

Tài liệu này hướng dẫn chi tiết quy trình kết nối Zalo Official Account (OA) với hệ thống AI Chatbot của CRMOnline.

***

### PHẦN 1: CHUẨN BỊ TÀI NGUYÊN TỪ ZALO OA

Để sử dụng API, Zalo yêu cầu OA phải có gói dịch vụ hoạt động.

#### Bước 1: Đăng ký gói dịch vụ

Đăng nhập vào tài khoản OA và truy cập đường dẫn sau để mua gói dịch vụ (**có thể mua gói dùng thử 10k để test** ): 👉 <https://oa.zalo.me/manage/subscription>

<figure><img src="https://3971044875-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVPPvtkVmjRvNZvoU53%2Fuploads%2FtPrIhUH7uEp8eEhGYjlM%2Fimage.png?alt=media&#x26;token=4e68dfa1-b82d-4509-96fb-17b572816064" alt=""><figcaption></figcaption></figure>

#### Bước 2: Lấy thông tin OA ID

Truy cập đường dẫn bên dưới và sao chép mã số tại mục **Official Account ID**: 👉 <https://oa.zalo.me/manage/account>

<figure><img src="https://3971044875-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVPPvtkVmjRvNZvoU53%2Fuploads%2FLUYGkqNKFGkIKjYR1GyW%2Fimage.png?alt=media&#x26;token=8850f3f6-e241-4dd7-a3f3-75974f4907f6" alt=""><figcaption></figcaption></figure>

#### Bước 3: Lấy thông tin Ứng dụng (App Credentials)

Truy cập trang quản lý ứng dụng để lấy **"ID ứng dụng"** và **"Khóa bí mật của ứng dụng"**: 👉 <https://developers.zalo.me/apps>

<figure><img src="https://3971044875-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVPPvtkVmjRvNZvoU53%2Fuploads%2Fce55W6ATfuVUHixIiJv8%2Fimage.png?alt=media&#x26;token=f78389e5-0898-41fd-b7cd-0e99b70dddb1" alt=""><figcaption></figcaption></figure>

#### Bước 4: Lấy Access Token

1. Truy cập lại trang ứng dụng: <https://developers.zalo.me/apps>
2. Chọn menu **"Công cụ"** -> chọn **"API Explorer"**.
3. Thiết lập cấu hình:
   * **Loại access token:** Chọn `OA Access Token`.
   * **Mục "Lấy Access Token":** Chọn Ứng dụng OA của mình (góc phải).
4. Nhấn nút **"Lấy Access Token"** -> Chọn **"Tôi đã hiểu và tiếp tục"**.
5. Sao chép mã **Refresh token** hiện ra.

<figure><img src="https://3971044875-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVPPvtkVmjRvNZvoU53%2Fuploads%2FVUlWq4S19EgZxLUZ2EQJ%2Fimage.png?alt=media&#x26;token=b09a35c2-3a9a-4ea2-9c95-b9994776a6bc" alt=""><figcaption></figcaption></figure>

> **Tổng kết 4 tham số cần có:**
>
> 1. Official Account ID
> 2. ID ứng dụng
> 3. Khóa bí mật của ứng dụng
> 4. Access token (Refresh token)

***

### PHẦN 2: CẤU HÌNH TRÊN CRMONLINE

#### Bước 5: Đăng nhập quản trị

Đăng nhập vào hệ thống quản trị huấn luyện Chatbot AI của CRMOnline (sử dụng Tên tenant, tên người dùng và pass được cung cấp): 👉 <https://crmai.crmonline.vn/trainer.html?>

<figure><img src="https://3971044875-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVPPvtkVmjRvNZvoU53%2Fuploads%2Fk71ti0i9Tdcgsjiqz9uG%2Fimage.png?alt=media&#x26;token=5918c0c7-c0d1-4e8f-9afb-5e43ad1dcb2e" alt=""><figcaption></figcaption></figure>

#### Bước 5.1: Nhập thông tin cấu hình

1\) Tại màn hình quản trị, chọn mục **Cấu hình**.

<figure><img src="https://3971044875-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVPPvtkVmjRvNZvoU53%2Fuploads%2FJHBwAkb1V4f7FG3QF1O9%2Fimage.png?alt=media&#x26;token=b305b845-5103-47ed-88b1-ee023d22a73b" alt=""><figcaption></figcaption></figure>

2\)Tìm đến phần **Zalo OA** và nhập đầy đủ các thông tin đã lấy ở Phần 1:

* **Tên OA:** (Đặt tên gợi nhớ)
* **OA ID:** (Dán Official Account ID)
* **App ID:** (Dán ID ứng dụng)
* **Khóa bí mật ứng dụng:** (Dán secret key)
* **Access token:** (Dán Refresh token)

1. Nhấn **Lưu** để hoàn tất.

<figure><img src="https://3971044875-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVPPvtkVmjRvNZvoU53%2Fuploads%2F02E2qFBqbcTvztvS4rRh%2Fimage.png?alt=media&#x26;token=329cbfbe-335b-468b-9226-e71841a26a4d" alt=""><figcaption></figcaption></figure>

> *Lưu ý: Nếu có nhiều OA thì nhấn nút **Thêm** để thêm và lưu thông tin.*

***

### PHẦN 3: KIỂM TRA KẾT QUẢ

**Bước 6:** Dùng tài khoản Zalo cá nhân tìm Zalo OA vừa tích hợp và chat thử để trải nghiệm thành quả.

<figure><img src="https://3971044875-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVPPvtkVmjRvNZvoU53%2Fuploads%2FkcplGXSHICikNtZCdsgl%2Fimage.png?alt=media&#x26;token=1ce1ced5-addc-45a2-b90a-e47301c4914a" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.crmonline.vn/39-tich-hop-chatbot-vao-zalo-oa.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.