> ## 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 Instagram DM

#### Giới thiệu

Sau khi hoàn thiện xây dựng AI Agent, người dùng có thể muốn đưa Agent lên Instagram DM để người dùng cuối có thể tương tác hỏi đáp với AI Agents trên đó.

Để hỗ trợ nhu cầu này, hệ thống đã bổ sung tính năng tích hợp AI Agent với Instagram DM thông qua Meta Developer, giúp người dùng dễ dàng kết nối và triển khai AI Agent trên nền tảng Instagram DM.

***

#### Kết nối với Instagram DM

Trước khi tích hợp Instagram, người dùng cần phải có:

* **Tài khoản Meta Developer**. Cách tạo tài khoản xem tại: `https://developers.facebook.com/docs/development/register`
* **Tài khoản Instagram**:
  * Chuyển đổi hồ sơ cá nhân của tài khoản Instagram thành **tài khoản doanh nghiệp**. Xem chi tiết tại: `https://www.facebook.com/help/instagram/502981923235522/?helpref=uf_share`
  * Thêm hồ sơ Instagram của bạn vào trang chủ của **Meta Business Suite**: `https://business.facebook.com/latest/home`

Sau khi thỏa mãn các điều kiện trên, thực hiện tích hợp theo các bước sau:

***

#### Bước 1. Tạo ứng dụng trên Meta

<Note>
  Nếu đã có ứng dụng, bỏ qua bước này và đến Bước 2.
</Note>

Truy cập `https://developers.facebook.com/apps` và ấn **"Tạo ứng dụng"**.

<img src="https://mintcdn.com/fpt-62e894b4/ArAE2Tf09bC-y77-/images/image465.png?fit=max&auto=format&n=ArAE2Tf09bC-y77-&q=85&s=7dcebe0255c28cb4763758561fc2a90a" alt="Image465" width="936" height="390" data-path="images/image465.png" />

Điền **Tên** và **Email liên hệ** của ứng dụng.

<img src="https://mintcdn.com/fpt-62e894b4/ArAE2Tf09bC-y77-/images/image466.png?fit=max&auto=format&n=ArAE2Tf09bC-y77-&q=85&s=4d9f78aca6d250b7348ce689133daa77" alt="Image466" width="936" height="454" data-path="images/image466.png" />

Lựa chọn **Trường hợp sử dụng** theo nhu cầu, cho phép lựa chọn nhiều.

<img src="https://mintcdn.com/fpt-62e894b4/ArAE2Tf09bC-y77-/images/image467.png?fit=max&auto=format&n=ArAE2Tf09bC-y77-&q=85&s=7a339ca9731cc02379f487a368b1af96" alt="Image467" width="811" height="694" data-path="images/image467.png" />

**Kết nối với tài khoản doanh nghiệp**: Kết nối với tài khoản doanh nghiệp của bạn. Nếu chưa có hồ sơ doanh nghiệp, người dùng có thể tạo mới bằng cách chọn **"Hãy tạo hồ sơ doanh nghiệp"**.

<img src="https://mintcdn.com/fpt-62e894b4/ArAE2Tf09bC-y77-/images/image468.png?fit=max&auto=format&n=ArAE2Tf09bC-y77-&q=85&s=bfcf41b7b8df7a714076a12cd3e31097" alt="Image468" width="865" height="400" data-path="images/image468.png" />

Kiểm tra các **Yêu cầu về việc phát hành**. Nếu không có yêu cầu nào, vui lòng bỏ qua.

<img src="https://mintcdn.com/fpt-62e894b4/ArAE2Tf09bC-y77-/images/image469.png?fit=max&auto=format&n=ArAE2Tf09bC-y77-&q=85&s=36a066852961877d8b3ee49a13130fbf" alt="Image469" width="936" height="412" data-path="images/image469.png" />

Kiểm tra thông tin ứng dụng và chọn **"Đi đến bảng điều khiển"** để hoàn tất việc tạo ứng dụng.

<img src="https://mintcdn.com/fpt-62e894b4/ArAE2Tf09bC-y77-/images/image470.png?fit=max&auto=format&n=ArAE2Tf09bC-y77-&q=85&s=00ba126c73b2d228389649c30a43a4ed" alt="Image470" width="708" height="595" data-path="images/image470.png" />

***

#### Bước 2. Thêm Messenger vào Sản phẩm

Truy cập ứng dụng vừa tạo, chọn **Thêm Sản phẩm**. Chọn **Messenger** và ấn **Cấu hình**.

<img src="https://mintcdn.com/fpt-62e894b4/ArAE2Tf09bC-y77-/images/image471.png?fit=max&auto=format&n=ArAE2Tf09bC-y77-&q=85&s=b44d8f45ba29a09d6693530294b0b3d9" alt="Image471" width="865" height="355" data-path="images/image471.png" />

***

#### Bước 3. Điền thông tin vào mục Cài đặt Instagram

**Điền Callback URL**

Truy cập **AI Agent > Deploy > Instagram**, sao chép phần **Đường dẫn**.

<img src="https://mintcdn.com/fpt-62e894b4/ArAE2Tf09bC-y77-/images/image472.png?fit=max&auto=format&n=ArAE2Tf09bC-y77-&q=85&s=c5897bb06740e9939a6a5d96c4843ad5" alt="Image472" width="793" height="811" data-path="images/image472.png" />

Truy cập ứng dụng, trong phần **Messenger > Cài đặt Instagram**, điền Đường dẫn vừa sao chép vào mục **URL gọi lại**.

<img src="https://mintcdn.com/fpt-62e894b4/ArAE2Tf09bC-y77-/images/image473.png?fit=max&auto=format&n=ArAE2Tf09bC-y77-&q=85&s=0c8752e9f4e22fe8dd0122164574665a" alt="Image473" width="835" height="378" data-path="images/image473.png" />

**Điền Mã xác minh**

Truy cập **AI Agent > Deploy > Instagram**, sao chép phần **Khóa bí mật**.

<img src="https://mintcdn.com/fpt-62e894b4/ArAE2Tf09bC-y77-/images/image474.png?fit=max&auto=format&n=ArAE2Tf09bC-y77-&q=85&s=8fcb86d15f8fda7df284c3e36d63a558" alt="Image474" width="628" height="676" data-path="images/image474.png" />

Truy cập ứng dụng, trong phần **Messenger > Cài đặt Instagram**, điền mã vừa sao chép vào mục **Mã xác minh**.

<img src="https://mintcdn.com/fpt-62e894b4/ArAE2Tf09bC-y77-/images/image475.png?fit=max&auto=format&n=ArAE2Tf09bC-y77-&q=85&s=b1b6276b4a72b3e8437a646651b96ac4" alt="Image475" width="936" height="423" data-path="images/image475.png" />

***

#### Bước 4. Điền thông tin của Instagram lên AI Agent

Truy cập ứng dụng, truy cập **Instagram > Thiết lập API bằng thông tin đăng nhập trên Instagram**.

**Điền ID ứng dụng trên Instagram**

Sao chép **ID ứng dụng** trên Instagram.

<img src="https://mintcdn.com/fpt-62e894b4/ArAE2Tf09bC-y77-/images/image476.png?fit=max&auto=format&n=ArAE2Tf09bC-y77-&q=85&s=1fff7cf8e58c94624f8e35335cc614f9" alt="Image476" width="936" height="427" data-path="images/image476.png" />

Truy cập **AI Agent > Deploy > Instagram**. Điền ID vừa sao chép vào mục **App ID**.

<img src="https://mintcdn.com/fpt-62e894b4/ArAE2Tf09bC-y77-/images/image477.png?fit=max&auto=format&n=ArAE2Tf09bC-y77-&q=85&s=78658754057b25de4787b006355eed36" alt="Image477" width="787" height="744" data-path="images/image477.png" />

**Điền Khóa bí mật (Secret key) của ứng dụng**

Ấn **Hiển thị Khóa bí mật** của ứng dụng Instagram, sau đó sao chép Khóa ứng dụng.

<img src="https://mintcdn.com/fpt-62e894b4/ArAE2Tf09bC-y77-/images/image478.png?fit=max&auto=format&n=ArAE2Tf09bC-y77-&q=85&s=ae91e8781e48c43a47a26aa5b5bc23be" alt="Image478" width="936" height="427" data-path="images/image478.png" />

Truy cập **AI Agent > Deploy > Instagram**. Điền khóa ứng dụng vào mục **Khóa bí mật ứng dụng**.

<img src="https://mintcdn.com/fpt-62e894b4/ArAE2Tf09bC-y77-/images/image479.png?fit=max&auto=format&n=ArAE2Tf09bC-y77-&q=85&s=870a671a1dee4495e9da02633a34f9e2" alt="Image479" width="792" height="708" data-path="images/image479.png" />

**Điền Access token của ứng dụng**

Truy cập ứng dụng, mục **Messenger > Cài đặt Instagram**. Chọn **"Thêm hoặc gỡ trang"** để chọn trang Instagram muốn tích hợp. Sau khi thêm trang, chọn **Tạo mã** để tạo Access token.

<img src="https://mintcdn.com/fpt-62e894b4/ArAE2Tf09bC-y77-/images/image480.png?fit=max&auto=format&n=ArAE2Tf09bC-y77-&q=85&s=4c9958f67b52efb0b80f718305545e0d" alt="Image480" width="936" height="460" data-path="images/image480.png" />

Truy cập **AI Agent > Deploy > Instagram**. Điền mã vừa sao chép vào mục **Access token**.

<img src="https://mintcdn.com/fpt-62e894b4/ArAE2Tf09bC-y77-/images/image481.png?fit=max&auto=format&n=ArAE2Tf09bC-y77-&q=85&s=f9d046fba8fb66cde747fde740740a97" alt="Image481" width="799" height="871" data-path="images/image481.png" />

***

#### Bước 5. Ấn Kết nối trên AI Agent

Kiểm tra thông tin và ấn **Kết nối** trên AI Agent.

Sau khi kết nối, truy cập cấu hình Instagram và chọn **Chuyển hướng trang** để truy cập đường dẫn chat trên Instagram.

<img src="https://mintcdn.com/fpt-62e894b4/ArAE2Tf09bC-y77-/images/image482.png?fit=max&auto=format&n=ArAE2Tf09bC-y77-&q=85&s=06b819ab9847400395c74b59b54f4cd8" alt="Image482" width="792" height="322" data-path="images/image482.png" />

<Note>
  * Ứng dụng cần ở chế độ **Chính thức** để không hạn chế truy cập.
  * Nếu ứng dụng ở chế độ **Phát triển**, chỉ những tài khoản có vai trò trong ứng dụng được phản hồi khi chat trên Instagram.
</Note>

***

#### Hủy kết nối Instagram

Để hủy kết nối Instagram, truy cập **AI Agent > Deploy**.

Trong mục đã cấu hình, chọn **Instagram**, chọn **Ngắt kết nối**.

<img src="https://mintcdn.com/fpt-62e894b4/ArAE2Tf09bC-y77-/images/image483.png?fit=max&auto=format&n=ArAE2Tf09bC-y77-&q=85&s=fd476f6d8d78d02904333a21217d1933" alt="Image483" width="786" height="316" data-path="images/image483.png" />