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

# Tích hợp Zalo

### Tích hợp Zalo

Trước tiên, người dùng cần có một tài khoản Zalo chính thức cho doanh nghiệp của mình.

**Bước 1**: Vào trang `https://oa.zalo.me/` để tạo Official Account nếu chưa có.

<img src="https://mintcdn.com/fpt-62e894b4/34cYAT85AD9la3e8/images/image353.png?fit=max&auto=format&n=34cYAT85AD9la3e8&q=85&s=165d8d59d7798b055d5346addd7db460" alt="Image353" width="975" height="308" data-path="images/image353.png" />

**Bước 2**: Thực hiện tạo ứng dụng cho developer để lấy API kết nối với Agent.

* Vào trang `https://developers.zalo.me/` để tạo Ứng dụng theo hướng dẫn tại `https://developers.zalo.me/docs/official-account/bat-dau/khoi-tao-ung-dung`.
* Nếu đã có ứng dụng, nhấn vào avatar tài khoản và chọn ứng dụng cần kết nối.

<img src="https://mintcdn.com/fpt-62e894b4/34cYAT85AD9la3e8/images/image354.png?fit=max&auto=format&n=34cYAT85AD9la3e8&q=85&s=beedc2284523cdcd5d5b3f877ad101b2" alt="Image354" width="975" height="384" data-path="images/image354.png" />

**Bước 3**: Vào FPT AI Agent để điền các thông tin kết nối.

Vào trang `https://agents.fpt.ai/bots` > Chọn Bot cần kết nối > Chọn tab **"Triển khai"** > Chọn menu **"Tích hợp kênh chat"** > Chọn kênh **"Zalo"**.

<img src="https://mintcdn.com/fpt-62e894b4/34cYAT85AD9la3e8/images/image355.png?fit=max&auto=format&n=34cYAT85AD9la3e8&q=85&s=6e1f2b891a01d8c1420f5d3d98439927" alt="Image355" width="1278" height="296" data-path="images/image355.png" />

Sau khi truy cập ứng dụng trên Zalo, copy **App ID** và **Secret Key** vào cấu hình Zalo trên AI Agents.

<img src="https://mintcdn.com/fpt-62e894b4/34cYAT85AD9la3e8/images/image356.png?fit=max&auto=format&n=34cYAT85AD9la3e8&q=85&s=3b7dc33be37f903902409fec71b048ca" alt="Image356" width="941" height="803" data-path="images/image356.png" />

**Bước 4**: Xác thực domain.

Sao chép **Webhook URL** ở phần Zalo configuration trên Bot > Dán vào ô **"Tiền tố URL"** trong menu **"Xác thực domain"** trên web `developers.zalo.me`.

<img src="https://mintcdn.com/fpt-62e894b4/34cYAT85AD9la3e8/images/image357.png?fit=max&auto=format&n=34cYAT85AD9la3e8&q=85&s=23e83dcb1a34480d5332bbffbbf09ed7" alt="Image357" width="975" height="756" data-path="images/image357.png" />

**Bước 5**: Đăng ký Webhook của Bot cho ứng dụng.

Sao chép URL vừa được xác thực `https://agents.fpt.ai/indirect-channels/webhook/zalo` sau đó dán vào **Webhook URL** > Nhấn **"Kiểm tra"** > **"Cập nhật"**.

<img src="https://mintcdn.com/fpt-62e894b4/34cYAT85AD9la3e8/images/image358.png?fit=max&auto=format&n=34cYAT85AD9la3e8&q=85&s=3f197a91c4849ded0ec4c65cfab32c6e" alt="Image358" width="996" height="250" data-path="images/image358.png" />

**Bước 6**: Lấy Refresh Token của Ứng dụng.

* Vào **API Explorer** tại mục **"Công cụ"** trên trang Zalo for Developers.

<img src="https://mintcdn.com/fpt-62e894b4/34cYAT85AD9la3e8/images/image359.png?fit=max&auto=format&n=34cYAT85AD9la3e8&q=85&s=50920d34923b12e10861cf3e97bd2b8d" alt="Image359" width="1030" height="244" data-path="images/image359.png" />

* Chọn **"Version 4"**.
* Chọn ứng dụng vừa tạo.
* **Loại access token**: "OA Access Token".
* **Lấy access token**: Chọn Official Account vừa tạo.

<img src="https://mintcdn.com/fpt-62e894b4/34cYAT85AD9la3e8/images/image360.png?fit=max&auto=format&n=34cYAT85AD9la3e8&q=85&s=ec049163c9c355749060b929989d2746" alt="Image360" width="1058" height="252" data-path="images/image360.png" />

* Xác nhận quyền.

<img src="https://mintcdn.com/fpt-62e894b4/34cYAT85AD9la3e8/images/image361.png?fit=max&auto=format&n=34cYAT85AD9la3e8&q=85&s=e7194ac38945b26419ce9302fa0eb403" alt="Image361" width="1007" height="256" data-path="images/image361.png" />

<img src="https://mintcdn.com/fpt-62e894b4/34cYAT85AD9la3e8/images/image362.png?fit=max&auto=format&n=34cYAT85AD9la3e8&q=85&s=fc37e47740cbfd3718f95031723b7438" alt="Image362" width="748" height="1061" data-path="images/image362.png" />

**Bước 7**: Copy **refresh token** vào setting của Zalo trên Bot.

<img src="https://mintcdn.com/fpt-62e894b4/34cYAT85AD9la3e8/images/image363.png?fit=max&auto=format&n=34cYAT85AD9la3e8&q=85&s=9099669b30a60672f43aa5b16ad86c54" alt="Image363" width="975" height="424" data-path="images/image363.png" />

Nhấn **"Kết nối"**.

<img src="https://mintcdn.com/fpt-62e894b4/34cYAT85AD9la3e8/images/image364.png?fit=max&auto=format&n=34cYAT85AD9la3e8&q=85&s=6d3946c0f73ae61a23dd6a982d7331f3" alt="Image364" width="770" height="731" data-path="images/image364.png" />

Giao diện hiển thị thông báo **"Kết nối thành công"**.