> ## 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 Instagram vào ChatbotX

> Hướng dẫn kết nối tài khoản Instagram Professional với ChatbotX để tự động hóa DM, Story Mentions và Comment-to-DM.

Bằng cách kết nối tài khoản Instagram Professional của bạn với **ChatbotX**, bạn có thể tận dụng **AI Agents** để tự động hóa Tin nhắn trực tiếp (DM), phản hồi Story Mentions, và chuyển đổi bình luận bài viết thành khách hàng tiềm năng thông qua tự động hóa "Comment-to-DM".

ChatbotX cung cấp **2 phương thức kết nối** Instagram:

* **Login with Instagram** - Kết nối trực tiếp qua xác thực Instagram OAuth. Quy trình đơn giản, không cần liên kết Trang Facebook trước.
* **Login with Facebook** - Kết nối qua xác thực Facebook OAuth. Yêu cầu liên kết Trang Facebook với tài khoản Instagram trước khi bắt đầu. Phù hợp khi bạn muốn quản lý nhiều Trang Facebook và tài khoản Instagram cùng lúc.

Hãy chọn phương thức phù hợp và làm theo hướng dẫn bên dưới.

## Điều kiện cần trước khi kết nối

**Yêu cầu chung (cả hai phương thức):**

1. **Tài khoản Instagram Professional:** Tài khoản Instagram của bạn phải được đặt làm hồ sơ **Business** hoặc **Creator**. Nếu bạn đang sử dụng tài khoản cá nhân, hãy làm theo [hướng dẫn chính thức này](https://help.instagram.com/502981923235522) để chuyển đổi.

**Yêu cầu bổ sung (chỉ cho phương thức "Login with Facebook"):**

2. **Trang Facebook đã liên kết:** Tài khoản Instagram phải được liên kết với một Trang Facebook mà bạn có quyền **Admin**.
3. **Quyền quản trị:** Bạn cần có quyền **"Full Control"** hoặc **Admin** trên Trang Facebook được liên kết.
4. **Tài khoản Facebook cá nhân:** Bạn phải đăng nhập sẵn trên trình duyệt bằng đúng tài khoản Facebook đang quản lý Trang đó.

## Bước 1: Mở phần cấu hình kênh trong ChatbotX

1. Đăng nhập vào bảng điều khiển **ChatbotX**.
2. Vào **Settings** → **Channels**.
3. Tìm biểu tượng Instagram và nhấn nút **"Add Instagram"**.
   <Frame>
     <img src="https://mintcdn.com/chatbotx/nWnG3LWyn0n8W_Dv/images/chatbotx_navigate_to_instagram_channel_setup.png?fit=max&auto=format&n=nWnG3LWyn0n8W_Dv&q=85&s=65e8fedf3eb0a8237480b2ab6088678f" alt="Chatbotx Navigate To Instagram Channel Setup" width="3129" height="1459" data-path="images/chatbotx_navigate_to_instagram_channel_setup.png" />
   </Frame>
4. Cửa sổ **Add Instagram** xuất hiện hiển thị 2 phương thức kết nối. Chọn phương thức phù hợp với bạn:
   <Frame>
     <img src="https://mintcdn.com/chatbotx/nWnG3LWyn0n8W_Dv/images/chatbotx_add_instagram_options.png?fit=max&auto=format&n=nWnG3LWyn0n8W_Dv&q=85&s=175efbbfd7bde62b3552481fae3011de" alt="Chatbotx Add Instagram Options" width="3129" height="1464" data-path="images/chatbotx_add_instagram_options.png" />
   </Frame>

Sau khi chọn phương thức, hãy làm theo hướng dẫn ở **Bước 2** tương ứng bên dưới.

## Bước 2: Xác thực và hoàn tất kết nối

<Tabs>
  <Tab title="Login with Instagram">
    Phương thức này kết nối trực tiếp qua Instagram OAuth. Bạn **không cần** liên kết Trang Facebook trước.

    ### 2.1: Cấp quyền truy cập trên Instagram

    Trình duyệt sẽ hiển thị cửa sổ yêu cầu cấp quyền truy cập từ Instagram:

    1. Kiểm tra và đảm bảo các tùy chọn quyền sau được bật (gạt nút sang màu đen/bật):
       * **Access and manage comments** (Truy cập và quản lý bình luận)
       * **Access and manage messages** (Truy cập và quản lý tin nhắn)
    2. Nhấp nút **Allow** ở góc dưới để cho phép ứng dụng truy cập tài khoản.
           <Frame>
             <img src="https://mintcdn.com/chatbotx/nWnG3LWyn0n8W_Dv/images/chatbotx_add_instagram_oauth.png?fit=max&auto=format&n=nWnG3LWyn0n8W_Dv&q=85&s=8c0350332ea82a2a3b61cd889ff84297" alt="Chatbotx Add Instagram Oauth" width="1913" height="1561" data-path="images/chatbotx_add_instagram_oauth.png" />
           </Frame>

    ### 2.2: Hoàn tất kết nối

    Hệ thống chuyển hướng quay trở lại trang quản trị ChatbotX và hiển thị thông báo **Connect Instagram**. Nhấp nút **Continue** để hoàn tất.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/nWnG3LWyn0n8W_Dv/images/chatbotx_connect_instagram_success.png?fit=max&auto=format&n=nWnG3LWyn0n8W_Dv&q=85&s=77443bae576207dd580758856a259e46" alt="Chatbotx Connect Instagram Success" width="1562" height="986" data-path="images/chatbotx_connect_instagram_success.png" />
    </Frame>
  </Tab>

  <Tab title="Login with Facebook">
    Phương thức này kết nối qua Facebook OAuth. Bạn cần **liên kết Trang Facebook với tài khoản Instagram trước** khi tiến hành.

    ### 2.1: Liên kết Trang Facebook với tài khoản Instagram

    <Note>
      Nếu Trang Facebook của bạn đã được liên kết với tài khoản Instagram, bạn có thể bỏ qua bước này và chuyển sang mục **2.2**.
    </Note>

    <Steps>
      <Step title="Mở cài đặt Trang Facebook">
        Truy cập [Trình quản lý Trang Facebook](https://www.facebook.com/pages/?category=your_pages), chọn Trang cần liên kết và mở **Settings**.
      </Step>

      <Step title="Liên kết tài khoản Instagram">
        Vào mục **Linked Accounts** và kết nối tài khoản Instagram Professional của bạn.

        1. Chọn mục **Instagram**
                   <Frame>
                     <img src="https://mintcdn.com/chatbotx/kDJf1v4d4sQ2ABir/images/image-266.png?fit=max&auto=format&n=kDJf1v4d4sQ2ABir&q=85&s=5affc46065fe6c7018e2aac105ad7918" alt="facebook_linked_accounts_instagram" width="2639" height="1541" data-path="images/image-266.png" />
                   </Frame>
        2. Nhấn **"Connect account"** và làm theo hướng dẫn đăng nhập Instagram
                   <Frame>
                     <img src="https://mintcdn.com/chatbotx/kDJf1v4d4sQ2ABir/images/image-268.png?fit=max&auto=format&n=kDJf1v4d4sQ2ABir&q=85&s=b06be3f265ed718e0f8d281f185805f0" alt="instagram_connect_account" width="2674" height="1079" data-path="images/image-268.png" />
                   </Frame>
      </Step>

      <Step title="Xác nhận kết nối">
        Nếu mọi thứ thành công, bạn sẽ thấy thông báo **"Instagram connected."** trên trang cài đặt.
      </Step>
    </Steps>

    ### 2.2: Quay lại giao diện ChatbotX và tiếp tục sau khi chọn phương thức tích hợp ở bước 1 .

    Hệ thống sẽ chuyển sang giao diện cấp quyền của Meta (Facebook):

    1. **Tiếp tục với tài khoản cá nhân:** Nhấp nút **Continue** để cho phép ChatbotX (trên giao diện Meta có thể hiển thị dưới tên đăng ký là ChatConnectX) truy cập tên và ảnh đại diện của bạn.
           <Frame>
             <img src="https://mintcdn.com/chatbotx/nWnG3LWyn0n8W_Dv/images/facebook_oauth_continue.png?fit=max&auto=format&n=nWnG3LWyn0n8W_Dv&q=85&s=425dfb4877f31d32ef0ab7b8fbf17f53" alt="Facebook Oauth Continue" width="3098" height="1755" data-path="images/facebook_oauth_continue.png" />
           </Frame>
    2. **Chọn Trang Facebook muốn kết nối:**
       * Chọn **Opt in to all current and future Pages** (Đăng ký tất cả các Trang hiện tại và tương lai - Khuyên dùng) hoặc **Opt in to current Pages only** (Chỉ kết nối các Trang hiện tại).
       * Nhấn **Continue**.
           <Frame>
             <img src="https://mintcdn.com/chatbotx/nWnG3LWyn0n8W_Dv/images/facebook_oauth_choose_pages.png?fit=max&auto=format&n=nWnG3LWyn0n8W_Dv&q=85&s=04e22d50847b0f26a282e38596b1d046" alt="Facebook Oauth Choose Pages" width="3097" height="1749" data-path="images/facebook_oauth_choose_pages.png" />
           </Frame>
    3. **Chọn tài khoản Instagram muốn kết nối:**
       * Chọn **Opt in to all current and future Instagram accounts** (Đăng ký tất cả tài khoản Instagram hiện tại và tương lai) hoặc **Opt in to current Instagram accounts only** (Chỉ kết nối các tài khoản Instagram hiện tại).
       * Nhấn **Continue**.
           <Frame>
             <img src="https://mintcdn.com/chatbotx/nWnG3LWyn0n8W_Dv/images/facebook_oauth_choose_instagram_accounts.png?fit=max&auto=format&n=nWnG3LWyn0n8W_Dv&q=85&s=1e8324a31b0abb7960de20c30d9093db" alt="Facebook Oauth Choose Instagram Accounts" width="3097" height="1758" data-path="images/facebook_oauth_choose_instagram_accounts.png" />
           </Frame>
    4. **Xem lại quyền truy cập:** Xem lại toàn bộ danh sách quyền ứng dụng yêu cầu truy cập và nhấn nút **Save** ở dưới cùng.
           <Frame>
             <img src="https://mintcdn.com/chatbotx/nWnG3LWyn0n8W_Dv/images/facebook_oauth_review_permissions.png?fit=max&auto=format&n=nWnG3LWyn0n8W_Dv&q=85&s=6fb9635f7ed872b3f7be05949736ef7b" alt="Facebook Oauth Review Permissions" width="3099" height="1756" data-path="images/facebook_oauth_review_permissions.png" />
           </Frame>

    ### 2.3: Hoàn tất kết nối

    Giao diện hiển thị thông báo kết nối thành công. Nhấn nút **Got it** để hoàn tất và quay trở lại ChatbotX.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/nWnG3LWyn0n8W_Dv/images/instagram_facebook_oauth_connection_success.png?fit=max&auto=format&n=nWnG3LWyn0n8W_Dv&q=85&s=3e42ad5cd8fbd256c2ca4844eb1da5d2" alt="Instagram Facebook Oauth Connection Success" width="3099" height="1753" data-path="images/instagram_facebook_oauth_connection_success.png" />
    </Frame>
  </Tab>
</Tabs>

## Bước 3: Hoàn tất và xác minh

Sau khi được chuyển hướng về lại hệ thống, tài khoản Instagram của bạn sẽ xuất hiện trên dashboard **ChatbotX**.

* **Xác nhận kết nối:** Đảm bảo đúng tài khoản Instagram đã hiển thị cùng biểu tượng Instagram.
* **Kiểm tra tích hợp:** Nhấn **Test Now** để gửi tin nhắn thử và xác nhận AI Agent đang hoạt động.

<Frame>
  <img src="https://mintcdn.com/chatbotx/zrfqJ5O6o0vlaM4Z/images/connect_instagram_dashboard_check.png?fit=max&auto=format&n=zrfqJ5O6o0vlaM4Z&q=85&s=3c7a940f89d5ae84ceab3d40844426a2" alt="Connect Instagram Dashboard Check" width="3089" height="1528" data-path="images/connect_instagram_dashboard_check.png" />
</Frame>

## Bước 4: Kiểm tra tự động hóa

Bây giờ tài khoản Instagram của bạn đã được kết nối. Bạn có thể kiểm tra bằng một trong hai cách sau:

* **Cách 1: Tạo một Flow**
  * Vào mục **Flows** trên thanh bên.
  * Tạo một tin nhắn chào mừng đơn giản hoặc một menu tương tác.
  * Gửi DM đến tài khoản Instagram để kiểm tra phản hồi.
* **Cách 2: Thiết lập AI Agent**
  * Vào tab **AI Agent** để cấu hình tính cách cho agent của bạn.
  * Sau khi lưu, gửi DM đến tài khoản Instagram từ một tài khoản khác để kiểm tra AI phản hồi.

<Note>
  **Bật "Allow Access to Messages":** Trong ứng dụng Instagram trên thiết bị di động, hãy đi tới **Settings and privacy → Messages and story replies → Message controls**, và đảm bảo mục **"Allow Access to Messages"** được bật (**ON**). Đây là yêu cầu bắt buộc để công cụ bên thứ ba nhận được Tin nhắn trực tiếp của bạn.
</Note>

## FAQ

<AccordionGroup>
  <Accordion title="Tại sao tài khoản Instagram của tôi không hiển thị trong danh sách kết nối?">
    Đây là vấn đề phổ biến nhất khi thiết lập. Thông thường là do tài khoản của bạn không đáp ứng các yêu cầu của Meta.

    **Kiểm tra loại tài khoản:** Đảm bảo tài khoản Instagram của bạn được đặt làm **Business** hoặc **Creator**. Các tài khoản cá nhân không được Meta API hỗ trợ cho các tích hợp bên thứ ba.

    **Quyền Quản trị viên:** Bạn phải có quyền **Admin** trên Trang Facebook được liên kết với tài khoản Instagram đó. Nếu nó đã được liên kết nhưng vẫn không hiển thị, hãy đi tới **Cài đặt Trang Facebook → Tài khoản liên kết**, ngắt kết nối và sau đó kết nối lại tài khoản Instagram để làm mới token truy cập.

    **Cách xử lý:** Vào hồ sơ Facebook cá nhân → **Settings & Privacy** → **Settings** → **Business Integrations**. Tìm **ChatbotX**, nhấn **Remove**, sau đó quay lại Bước 1 để thực hiện lại từ đầu.
  </Accordion>

  <Accordion title="Tôi đã kết nối thành công nhưng không nhận được tin nhắn trong ChatbotX?">
    Nếu trạng thái là "Connected" nhưng tin nhắn không xuất hiện, hãy kiểm tra:

    **Bật 'Allow Access to Messages'**

    1. Mở ứng dụng Instagram trên điện thoại của bạn.
    2. Chuyển đến **Settings and privacy** → **Messages and story replies** → **Message controls**.
    3. Cuộn xuống phần **Connected tools** và chuyển đổi **'Allow Access to Messages'** sang trạng thái **ON**.

    **Kiểm tra AI Agent** Đảm bảo bạn đã gán một **AI Agent** cho kênh Instagram này trong phần **AI Agent Settings**.
  </Accordion>

  <Accordion title="ChatbotX có thể tự động phản hồi cho Instagram Stories và Mentions không?">
    **Hoàn toàn có.** ChatbotX hỗ trợ đầy đủ các tính năng tương tác để tăng mức độ tương tác của khách hàng.

    **Phản hồi Story & Mentions:** AI Agent của bạn có thể được cấu hình để tự động gửi thông báo cảm ơn hoặc cung cấp thông tin khi ai đó trả lời Story hoặc gắn thẻ tài khoản của bạn.

    **Quy tắc 24 Giờ:** Giống như Messenger, AI chỉ có thể phản hồi trong khung **24 giờ** tính từ lần tương tác cuối cùng của người dùng.
  </Accordion>

  <Accordion title="Tôi có thể sử dụng tự động hóa 'Comment-to-DM' trên các bài đăng Instagram không?">
    **Có, đây là một tính năng mạnh mẽ để chuyển đổi người theo dõi.**

    **Tự động trả lời bình luận:** Bạn có thể thiết lập AI Agent tự động trả lời bình luận trên các bài đăng và đồng thời gửi DM đến người dùng đó (ví dụ: gửi mã giảm giá khi người dùng bình luận "Quan tâm"). Điều này làm tăng tỷ lệ chuyển đổi mà không cần nỗ lực thủ công.
  </Accordion>

  <Accordion title="Quy tắc 24 giờ của Facebook ảnh hưởng đến bot như thế nào?">
    Theo chính sách của Meta, bot chỉ được phép phản hồi khách hàng **trong vòng 24 giờ kể từ tin nhắn gần nhất của khách**.

    Sau 24 giờ, bạn phải dùng:

    * **Message Tags**, hoặc
    * **Marketing Messages**

    để tiếp tục cuộc trò chuyện.
  </Accordion>

  <Accordion title="Làm sao cập nhật quyền khi tôi thêm tài khoản Instagram mới?">
    Bạn không cần gỡ kết nối hiện tại.

    Chỉ cần lặp lại quy trình **Add Instagram**. Khi cửa sổ Meta hiện ra, hãy chọn **Edit Settings** và tích thêm tài khoản Instagram mới.

    Hệ thống sẽ tự cập nhật danh sách mà không ảnh hưởng đến các kênh đã kết nối trước đó.
  </Accordion>
</AccordionGroup>