> ## Documentation Index
> Fetch the complete documentation index at: https://chatbotx.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Cách kết nối Zalo OA vào ChatbotX

> Hướng dẫn kết nối Zalo Official Account với ChatbotX để kích hoạt tự động hóa tin nhắn và chăm sóc khách hàng.

Zalo Official Account (Zalo OA) là một kênh thiết yếu để các doanh nghiệp tương tác với khách hàng tại Việt Nam. Bằng cách tích hợp Zalo OA của bạn với **ChatbotX**, bạn có thể tận dụng AI Agents để tự động hóa chăm sóc khách hàng, gửi tin nhắn hàng loạt và quản lý tất cả các cuộc trò chuyện của bạn trong một trung tâm quản lý duy nhất.

## Prerequisites

Để đảm bảo quá trình tích hợp diễn ra suôn sẻ, vui lòng đảm bảo bạn đáp ứng các yêu cầu sau:

1. **Zalo OA đã xác thực:** Tài khoản Zalo Official Account của bạn phải được Zalo xác thực (hiển thị tích vàng).
2. **Quyền Admin:** Tài khoản cá nhân Zalo của bạn phải có quyền **Admin** đối với trang Official Account mà bạn muốn kết nối.

## Kết nối Zalo OA

Bạn có thể bắt đầu kết nối Zalo OA theo một trong hai cách sau:

### Cách 1: Từ luồng tạo Inbox mới

<Steps>
  <Step title="Đăng nhập vào ChatbotX">
    Đăng nhập vào tài khoản **ChatbotX** của bạn.
  </Step>

  <Step title="Vào mục Analytics">
    Từ menu trái, chọn **Analytics**.
  </Step>

  <Step title="Mở luồng tạo Inbox">
    Nhấn **Create Inbox** để bắt đầu thêm kênh mới.
  </Step>

  <Step title="Chọn Zalo OA">
    Chọn **Zalo OA** trong danh sách kênh.
  </Step>

  <Step title="Tiếp tục kết nối">
    Nhấn **Continue**, sau đó nhấp vào nút **Connect** để bắt đầu kết nối.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/chatbotx/bk1D42eDWTivbgT_/images/image-188.png?fit=max&auto=format&n=bk1D42eDWTivbgT_&q=85&s=e1f8e754527c2f75c89f026c93a14194" alt="zalo_oa_navigate_to_analytics" width="2972" height="1807" data-path="images/image-188.png" />
</Frame>

### Cách 2: Từ phần quản lý Channels

<Steps>
  <Step title="Vào mục Settings">
    Từ menu trái, chọn **Settings**.
  </Step>

  <Step title="Mở tab Channels">
    Chọn tab **Channels** để xem danh sách kênh đang hỗ trợ.
  </Step>

  <Step title="Tìm Zalo OA">
    Tìm mục **Zalo OA** trong danh sách kênh.
  </Step>

  <Step title="Bắt đầu kết nối">
    Nhấp vào nút **Connect** để bắt đầu kết nối.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/chatbotx/bk1D42eDWTivbgT_/images/image-187.png?fit=max&auto=format&n=bk1D42eDWTivbgT_&q=85&s=7be8ca742d24fcd1b9c66af199f3d9af" alt="zalo_oa_navigate_to_channel_setup" width="2965" height="1091" data-path="images/image-187.png" />
</Frame>

## Authenticate with Zalo

Hệ thống sẽ chuyển hướng bạn đến giao diện xác thực của Zalo.

<Steps>
  <Step title="Chọn Official Account">
    Chọn trang Zalo Official Account mà bạn muốn tích hợp.
  </Step>

  <Step title="Kiểm tra quyền truy cập">
    Xem lại danh sách quyền truy cập mà ChatbotX yêu cầu đối với Official Account của bạn.
  </Step>

  <Step title="Xác nhận trên Zalo">
    Nhấn nút xác nhận trên Zalo để cấp quyền truy cập và tiếp tục.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/chatbotx/bk1D42eDWTivbgT_/images/image-189.png?fit=max&auto=format&n=bk1D42eDWTivbgT_&q=85&s=3ac25528f6147391b43cf8c20924a14e" alt="zalo_oa_authorization_popup" width="2972" height="1807" data-path="images/image-189.png" />
</Frame>

## Return to ChatbotX

Sau khi xác thực thành công, bạn sẽ được chuyển hướng trở lại giao diện ChatbotX, nơi danh sách các trang Zalo OA đã được cấp quyền của bạn sẽ xuất hiện.

Kiểm tra lại Zalo OA mà bạn vừa cấp quyền và xác nhận rằng kênh đã xuất hiện trong ChatbotX sau khi kết nối hoàn tất.

<Frame>
  <img src="https://mintcdn.com/chatbotx/BCpXmuL5zx15tIog/images/connect_zalo_dashboard_check.png?fit=max&auto=format&n=BCpXmuL5zx15tIog&q=85&s=54873a0814dbd316ccb77e55d72a648e" alt="Connect Zalo Dashboard Check" width="3084" height="1522" data-path="images/connect_zalo_dashboard_check.png" />
</Frame>

## Finalize and Check

Khi thiết lập hoàn tất, trang Zalo OA của bạn sẽ hoạt động trên bảng điều khiển ChatbotX.

Điều hướng đến **Channels** hoặc **Inbox** để xác nhận Zalo OA của bạn đã được kết nối. Sau đó, gửi một tin nhắn thử từ tài khoản Zalo cá nhân để kiểm tra hội thoại có đổ về ChatbotX hay không.

Giao diện và các tính năng tự động hóa khả dụng cho Zalo tương đối giống với các kênh khác như Messenger. Tuy nhiên, xin lưu ý rằng API của nền tảng Zalo hiện tại không hỗ trợ một số yếu tố chức năng hiển thị UI, chẳng hạn như Buttons bên trong Card hoặc Quick Replies.

## Test your Automation

Bây giờ Zalo OA của bạn đã được kết nối, bạn có thể bắt đầu tự động hóa các cuộc trò chuyện.

* **Option 1: Tạo một luồng Kịch bản (Create a Flow)**
  * Điều hướng đến phần **Flows** trên thanh bên.
  * Xây dựng một tin nhắn "Welcome" đơn giản.
  * Gửi tin nhắn đến Zalo OA của bạn từ tài khoản Zalo cá nhân để kiểm tra phản hồi.
* **Option 2: Setup AI Agent**
  * Chuyển đến tab **AI Agent** và định cấu hình giọng điệu cũng như cơ sở kiến thức cho trợ lý của bạn.
  * Chỉ định AI Agent vào kênh Zalo OA của bạn để xử lý các câu hỏi đến một cách tự động.