> ## 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ấu hình Instagram via Facebook Login

> Hướng dẫn kết nối tài khoản Instagram chuyên nghiệp thông qua ứng dụng Facebook và cấu hình Credentials kết nối trên portal của bạn.

Tạo và kết nối tài khoản Instagram chuyên nghiệp với ứng dụng Facebook giúp khách hàng trên portal của bạn có thể tự kết nối kênh Instagram để gửi và nhận tin nhắn Direct Message tự động.

## Điều kiện chuẩn bị

Trước khi bắt đầu, hãy đảm bảo bạn có:

* Một tài khoản Facebook cá nhân hoạt động bình thường.
* Một Fanpage Facebook mà bạn có quyền quản trị (Admin).
* Một tài khoản Instagram chuyên nghiệp (Instagram Professional - Business hoặc Creator) đã được liên kết với Fanpage Facebook đó.
* Quyền quản trị cao nhất (Super Admin) trên Portal của bạn để nhập cấu hình.

<Note>
  Nếu bạn đang phát triển thử nghiệm ở môi trường cục bộ (local), bạn sẽ cần công cụ tạo đường hầm như ngrok để public server của mình ra internet nhằm nhận webhook từ Facebook.
</Note>

## Bước 1: Tạo ứng dụng Facebook (Facebook App)

Nếu bạn đã tạo ứng dụng Facebook cho [kênh Messenger](./facebook-messenger), bạn có thể tái sử dụng ứng dụng đó cho Instagram và bỏ qua Bước 1 này để chuyển thẳng đến Bước 2.

<Steps>
  <Step title="Khởi tạo ứng dụng mới">
    Truy cập vào trang quản trị [Facebook Developer Portal](https://developers.facebook.com/apps/) và nhấn **Create App**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/6419eoAF_uo2OCBi/images/image-1.png?fit=max&auto=format&n=6419eoAF_uo2OCBi&q=85&s=a4312497d6e27a9d63e2c2adc4fd6d12" alt="Create App button in the Facebook Developer Portal" width="2409" height="757" data-path="images/image-1.png" />
    </Frame>
  </Step>

  <Step title="Nhập thông tin ứng dụng">
    Nhập tên ứng dụng hiển thị (**App name**) và email liên hệ (**contact email**), sau đó nhấn **Next**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/bk1D42eDWTivbgT_/images/image-2.png?fit=max&auto=format&n=bk1D42eDWTivbgT_&q=85&s=5249012405fdb92ea7cadc59bbcd09ce" alt="App name and contact email fields" width="2197" height="937" data-path="images/image-2.png" />
    </Frame>
  </Step>

  <Step title="Chọn trường hợp sử dụng (Use case)">
    Khi hệ thống yêu cầu chọn trường hợp sử dụng, tích chọn **Other**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/bk1D42eDWTivbgT_/images/image-3.png?fit=max&auto=format&n=bk1D42eDWTivbgT_&q=85&s=bbd6313775d17a3971de57329c78c56f" alt="Use case selection - Other option highlighted" width="2151" height="1708" data-path="images/image-3.png" />
    </Frame>
  </Step>

  <Step title="Chọn loại ứng dụng (App type)">
    Chọn loại ứng dụng là **Business**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/bk1D42eDWTivbgT_/images/image-4.png?fit=max&auto=format&n=bk1D42eDWTivbgT_&q=85&s=a7bc6f433111bee494f0220d8505799c" alt="App type selection - Business option highlighted" width="2173" height="844" data-path="images/image-4.png" />
    </Frame>
  </Step>

  <Step title="Hoàn tất khởi tạo">
    Kiểm tra lại thông tin và nhấn **Create App** để hoàn tất quá trình tạo ứng dụng.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/bk1D42eDWTivbgT_/images/image-5.png?fit=max&auto=format&n=bk1D42eDWTivbgT_&q=85&s=5d530bddb2eeb78f5d24962a31fcfbb1" alt="Confirmation screen before creating the app" width="2177" height="1104" data-path="images/image-5.png" />
    </Frame>
  </Step>

  <Step title="Lấy thông tin App ID và App Secret">
    Sau khi tạo ứng dụng thành công, đi đến mục **Settings → Basic** để lấy **App ID** và **App Secret**. Bạn sẽ cần hai giá trị này ở bước tiếp theo.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/YBc7vqGEslWm7FIq/images/image-255.png?fit=max&auto=format&n=YBc7vqGEslWm7FIq&q=85&s=de815c709789df3181da74e5f0b51b2f" alt="App ID and App Secret in Basic Settings" width="2837" height="1581" data-path="images/image-255.png" />
    </Frame>
  </Step>
</Steps>

## Bước 2: Cấu hình Credentials trên Portal quản trị

Bạn cần nhập thông tin ứng dụng Facebook vào Portal quản trị để kích hoạt tính năng kết nối Instagram cho khách hàng.

<Steps>
  <Step title="Mở trang cấu hình kết nối">
    Đăng nhập vào Portal quản trị của bạn, truy cập mục:

    ```text theme={null}
    https://app.chatconnectx.com/manage/integrations
    ```

    Sau đó chọn **Instagram**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/rIKY9dgGT5yHSIxP/images/image-326.png?fit=max&auto=format&n=rIKY9dgGT5yHSIxP&q=85&s=87c16f1520ffe5e7184cb70459e58f94" alt="chatbotx_super_admin_integrations_instagram" width="2819" height="1602" data-path="images/image-326.png" />
    </Frame>
  </Step>

  <Step title="Mở cấu hình Instagram">
    Nhấp vào nút **Edit** trên thẻ Instagram để mở cửa sổ cấu hình.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/rIKY9dgGT5yHSIxP/images/image-327.png?fit=max&auto=format&n=rIKY9dgGT5yHSIxP&q=85&s=d6c40af14324f935a1571bfcc5bf336c" alt="chatbotx_super_admin_instagram_edit_modal" width="2821" height="1601" data-path="images/image-327.png" />
    </Frame>
  </Step>

  <Step title="Nhập thông tin ứng dụng">
    Điền đầy đủ các thông số lấy từ Meta Developer Portal vào biểu mẫu:

    | Trường                 | Mô tả                                                               | Nơi lấy thông tin                            |
    | :--------------------- | :------------------------------------------------------------------ | :------------------------------------------- |
    | `Client ID`            | Mã ID ứng dụng Facebook                                             | **Settings → Basic**                         |
    | `Client Secret`        | Mã khóa bảo mật của ứng dụng                                        | **Settings → Basic** → nhấn **Show**         |
    | `API Version`          | Phiên bản API của Facebook (sử dụng `v2.0` hoặc phiên bản hiện tại) | **Settings → Advanced**                      |
    | `Webhook Verify Token` | Chuỗi ký tự bảo mật tự chọn dùng để xác thực webhook                | Bạn tự nhập một chuỗi ngẫu nhiên (chữ và số) |
  </Step>

  <Step title="Lưu cấu hình">
    Nhấn **Save** để lưu lại. Kênh Instagram lúc này sẽ sẵn sàng để khách hàng của bạn kết nối.

    Sau khi lưu, hệ thống sẽ hiển thị một đường dẫn **Webhook URL**. Hãy sao chép đường dẫn này để sử dụng trong Bước 3.
  </Step>
</Steps>

## Bước 3: Cấu hình ứng dụng Instagram (Facebook App)

<Steps>
  <Step title="Thêm App Domain">
    Tại mục **Settings → Basic**, nhập tên miền portal của bạn (ví dụ: `app.chatconnectx.com`) vào ô **App Domains**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/FAZvdFXI0s4AXKUI/images/image-323.png?fit=max&auto=format&n=FAZvdFXI0s4AXKUI&q=85&s=9bc27b198f617cdfcb73c6d9e75ef723" alt="facebook_app_domain" width="2681" height="1466" data-path="images/image-323.png" />
    </Frame>
  </Step>

  <Step title="Thêm sản phẩm Instagram vào ứng dụng">
    Tại trang quản trị ứng dụng Meta, tìm thẻ sản phẩm **Instagram** dưới mục "Add products to your app" và nhấn **Set up**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/kDJf1v4d4sQ2ABir/images/image-261.png?fit=max&auto=format&n=kDJf1v4d4sQ2ABir&q=85&s=78af20e6afd17ccec25c979cc906b82d" alt="app_add_instagram" width="2800" height="1363" data-path="images/image-261.png" />
    </Frame>
  </Step>

  <Step title="Mở trang thiết lập API">
    Sau khi thêm sản phẩm Instagram, hệ thống tự động chuyển hướng đến trang **API setup with Instagram business login**. Trang này tổng hợp cấu hình trong 4 bước chính.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/kDJf1v4d4sQ2ABir/images/image-263.png?fit=max&auto=format&n=kDJf1v4d4sQ2ABir&q=85&s=1eaee93ccbab1737b306664e473006cb" alt="instagram_api_setup_page" width="2786" height="1489" data-path="images/image-263.png" />
    </Frame>
  </Step>

  <Step title="Cấu hình Webhooks">
    Tại **Step 2: Configure webhooks**, điền các thông tin:

    * **Callback URL**: Nhập đường dẫn **Webhook URL** được cấp ở Bước 2 (ví dụ: `https://app.chatconnectx.com/webhooks/instagram`)
    * **Verify Token**: Nhập chuỗi **Webhook Verify Token** bạn đã cấu hình trên Portal quản trị ở Bước 2.

    Nhấn **Verify and save** để hoàn tất xác thực kết nối.

    <Note>
      Để nhận được webhook, ứng dụng Facebook của bạn cần chuyển sang trạng thái hoạt động chính thức (Live) bằng nút gạt ở thanh menu trên cùng.
    </Note>

    <Frame>
      <img src="https://mintcdn.com/chatbotx/rIKY9dgGT5yHSIxP/images/image-329.png?fit=max&auto=format&n=rIKY9dgGT5yHSIxP&q=85&s=5b72292423817c1ab669f8287555d57a" alt="instagram_configure_webhooks" width="2576" height="720" data-path="images/image-329.png" />
    </Frame>
  </Step>
</Steps>

## Bước 4: Liên kết Fanpage Facebook với Instagram chuyên nghiệp

<Steps>
  <Step title="Mở cài đặt trang Fanpage">
    Truy cập [Facebook Pages](https://www.facebook.com/pages/?category=your_pages), chọn trang Fanpage của bạn và mở phần **Settings** (Cài đặt trang mới/Cài đặt chuyên nghiệp).
  </Step>

  <Step title="Liên kết tài khoản Instagram chuyên nghiệp">
    Truy cập mục **Linked Accounts** (Tài khoản liên kết) và kết nối với tài khoản Instagram chuyên nghiệp 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**
           <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 thành công">
    Nếu cấu hình chính xác, màn hình hiển thị thông báo **"Instagram connected."**
  </Step>
</Steps>

## Hướng dẫn kết nối cho người dùng

Sau khi hoàn tất cấu hình ứng dụng trên Meta Developer Portal và nhập Credentials vào Portal quản trị, khách hàng của bạn có thể tự kết nối tài khoản Instagram của họ.

Xem chi tiết tại [Hướng dẫn kết nối Instagram](/vi/channels/instagram/connect-instagram).