> ## 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 Facebook Messenger

> Hướng dẫn tạo ứng dụng Facebook và cấu hình Credentials kết nối kênh Messenger trên portal của bạn.

Tạo ứng dụng Facebook Messenger riêng giúp tùy biến màn hình cấp quyền hiển thị thương hiệu và logo của riêng bạn khi khách hàng kết nối Fanpage.

## Đ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.
* Fanpage Facebook mà bạn có quyền quản trị (Admin).
* 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)

<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/bk1D42eDWTivbgT_/images/image-6.png?fit=max&auto=format&n=bk1D42eDWTivbgT_&q=85&s=0d075ac6d3a6ff00f748941fa54aecfa" alt="App ID and App Secret in Basic Settings" width="2529" height="1463" data-path="images/image-6.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 Messenger 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 **Messenger**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/FAZvdFXI0s4AXKUI/images/image-322.png?fit=max&auto=format&n=FAZvdFXI0s4AXKUI&q=85&s=2edc84c2d2a32733331b5db852f8e7f1" alt="chatbotx_super_admin_integrations_messenger" width="2822" height="1045" data-path="images/image-322.png" />
    </Frame>
  </Step>

  <Step title="Nhập thông tin ứng dụng">
    <Frame>
      <img src="https://mintcdn.com/chatbotx/rIKY9dgGT5yHSIxP/images/image-328.png?fit=max&auto=format&n=rIKY9dgGT5yHSIxP&q=85&s=cee094d7a43f806364a77b5ed6440ed3" alt="chatbotx_super_admin_messenger_edit_modal" width="2818" height="1603" data-path="images/image-328.png" />
    </Frame>

    Đ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                            |
    | :--------------------- | :--------------------------------------------------- | :------------------------------------------- |
    | `App ID`               | Mã ID ứng dụng Facebook                              | **Settings → Basic**                         |
    | `App Secret`           | Mã khóa bảo mật của ứng dụng                         | **Settings → Basic** → nhấn **Show**         |
    | `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ố) |
    | `API Version`          | Phiên bản API của Facebook (sử dụng `v25.0`)         | **Settings → Advanced**                      |
  </Step>

  <Step title="Lưu cấu hình">
    Nhấn **Save** để lưu lại. Kênh Messenger 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 4.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/rIKY9dgGT5yHSIxP/images/image-330.png?fit=max&auto=format&n=rIKY9dgGT5yHSIxP&q=85&s=2666e268d36ba3ab2e6c125264324925" alt="chatbotx_super_admin_messenger_overview" width="1063" height="853" data-path="images/image-330.png" />
    </Frame>
  </Step>
</Steps>

## Bước 3: Cấu hình Facebook Login

<Steps>
  <Step title="Thêm sản phẩm Facebook Login">
    Tại trang quản trị ứng dụng của Meta, thêm sản phẩm **Facebook Login**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/bk1D42eDWTivbgT_/images/image-7.png?fit=max&auto=format&n=bk1D42eDWTivbgT_&q=85&s=e5ee48883c0776c04347d3fe6d7507fd" alt="Adding Facebook Login product" width="2696" height="1624" data-path="images/image-7.png" />
    </Frame>
  </Step>

  <Step title="Cấu hình cài đặt Facebook Login">
    Tại mục cấu hình Facebook Login settings:

    * Kích hoạt **Web OAuth Login**
    * Kích hoạt **Login with JavaScript SDK**
    * Thêm tên miền portal của bạn vào ô **Allowed Domains for the JavaScript SDK** (ví dụ: `app.chatconnectx.com`)

    <Frame>
      <img src="https://mintcdn.com/chatbotx/NoN3HsGeD9DrrbW9/images/image-8.png?fit=max&auto=format&n=NoN3HsGeD9DrrbW9&q=85&s=4af3722cd173edcb28ab3d7feb371c87" alt="Facebook Login settings with OAuth and SDK options" width="2669" height="1564" data-path="images/image-8.png" />
    </Frame>
  </Step>
</Steps>

## Bước 4: Cấu hình Webhook trên ứng dụng Facebook

<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="App domain field in Basic Settings" width="2681" height="1466" data-path="images/image-323.png" />
    </Frame>
  </Step>

  <Step title="Thêm sản phẩm Messenger">
    Tại danh mục **Products**, thêm sản phẩm **Messenger** vào ứng dụng.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/6419eoAF_uo2OCBi/images/image-10.png?fit=max&auto=format&n=6419eoAF_uo2OCBi&q=85&s=829b378ce1e22dc809aaef8ee7f09688" alt="Adding Messenger product" width="2658" height="1389" data-path="images/image-10.png" />
    </Frame>
  </Step>

  <Step title="Cấu hình Webhook">
    Tại trang cấu hình của **Messenger**, thiết lập Webhook:

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

    <Frame>
      <img src="https://mintcdn.com/chatbotx/6419eoAF_uo2OCBi/images/image-11.png?fit=max&auto=format&n=6419eoAF_uo2OCBi&q=85&s=094f4deb374d361b7db9aba05945f0aa" alt="Webhook callback URL and verify token fields" width="3496" height="1602" data-path="images/image-11.png" />
    </Frame>
  </Step>
</Steps>

## Bước 5: Thử nghiệm trước khi vận hành chính thức

Meta sẽ không chuyển tiếp tin nhắn từ Fanpage đến webhook của bạn cho đến khi ứng dụng được phê duyệt Live. Bạn cần thêm tài khoản thử nghiệm để kiểm tra trước.

<Steps>
  <Step title="Liên kết Fanpage">
    Tại trang cấu hình Messenger trên ứng dụng Facebook, nhấn **Connect** bên cạnh Fanpage bạn muốn dùng thử nghiệm kết nối.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/6419eoAF_uo2OCBi/images/image-12.png?fit=max&auto=format&n=6419eoAF_uo2OCBi&q=85&s=a2bd96971dbd733dc833c53db936c15f" alt="Connect button for a Facebook Page" width="3493" height="1738" data-path="images/image-12.png" />
    </Frame>
  </Step>

  <Step title="Thêm đăng ký sự kiện (Subscriptions)">
    Tại Fanpage đã liên kết, nhấn **Add subscriptions**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/6419eoAF_uo2OCBi/images/image-13.png?fit=max&auto=format&n=6419eoAF_uo2OCBi&q=85&s=872b34c843aa3e331c8ae96824310a1f" alt="Add subscriptions button" width="3494" height="1667" data-path="images/image-13.png" />
    </Frame>
  </Step>

  <Step title="Chọn các trường dữ liệu đăng ký">
    Tích chọn các trường dữ liệu sau và nhấn lưu:

    ```text theme={null}
    messages
    messaging_postbacks
    message_reads
    message_echoes
    messaging_optins
    messaging_feedback
    messaging_referrals
    ```

    <Frame>
      <img src="https://mintcdn.com/chatbotx/6419eoAF_uo2OCBi/images/image-14.png?fit=max&auto=format&n=6419eoAF_uo2OCBi&q=85&s=6f3ec2731d58c80336346d4299b34951" alt="Subscription fields selection" width="3493" height="1666" data-path="images/image-14.png" />
    </Frame>
  </Step>

  <Step title="Gửi tin nhắn thử nghiệm">
    Dùng tài khoản cá nhân Facebook (đang giữ quyền Admin/Tester của ứng dụng) gửi tin nhắn đến Fanpage. Tin nhắn sẽ được đồng bộ hiển thị trên Portal của bạn.
  </Step>
</Steps>

## Đưa ứng dụng vào hoạt động chính thức (Going to Production)

Để khách hàng có thể kết nối Fanpage của họ và sử dụng bình thường, bạn cần gửi ứng dụng Facebook của mình cho Meta xét duyệt.

<Steps>
  <Step title="Gửi yêu cầu xét duyệt ứng dụng (App Review)">
    Làm theo quy trình [Facebook App Review](https://developers.facebook.com/docs/apps/review/) để Meta xác minh ứng dụng của bạn.
  </Step>

  <Step title="Yêu cầu quyền truy cập nâng cao (Advanced Access)">
    Yêu cầu quyền truy cập nâng cao cho các quyền tối thiểu dưới đây:

    **Các quyền bắt buộc:**

    | Quyền                   | Mục đích sử dụng                           |
    | :---------------------- | :----------------------------------------- |
    | `pages_messaging`       | Gửi tin nhắn thay mặt Fanpage của bạn      |
    | `pages_show_list`       | Hiển thị danh sách Fanpage có thể kết nối  |
    | `pages_manage_metadata` | Đăng ký webhook để nhận sự kiện từ Fanpage |

    **Các quyền tùy chọn:**

    | Quyền                     | Mục đích sử dụng                                       |
    | :------------------------ | :----------------------------------------------------- |
    | `pages_user_gender`       | Lấy thông tin giới tính người dùng từ Fanpage          |
    | `pages_user_locale`       | Lấy ngôn ngữ của người dùng từ Fanpage                 |
    | `pages_user_timezone`     | Lấy múi giờ của người dùng từ Fanpage                  |
    | `pages_utility_messaging` | Gửi tin nhắn tiện ích và quản lý các template tin nhắn |
  </Step>
</Steps>

## Phiên bản API

Hệ thống hỗ trợ **Facebook API v25.0**. Hãy đảm bảo ứng dụng của bạn được cấu hình đúng phiên bản này.

* Cập nhật phiên bản API tại mục **Settings → Advanced** trên ứng dụng Facebook của bạn.
* Đảm bảo phiên bản đăng ký webhook cũng được thiết lập là **v25.0**.

<Frame>
  <img src="https://mintcdn.com/chatbotx/6419eoAF_uo2OCBi/images/image-15.png?fit=max&auto=format&n=6419eoAF_uo2OCBi&q=85&s=c712e3bfdb1ead8872642c65b20c3bef" alt="API version setting in Advanced Settings" width="3567" height="825" data-path="images/image-15.png" />
</Frame>

## 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 Fanpage Facebook của họ.

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