> ## 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 WhatsApp Embedded Signup

> Hướng dẫn thiết lập ứng dụng Facebook Login for Business, cấu hình System User và kết nối WhatsApp Business Cloud API thông qua luồng đăng ký nhúng (Embedded Signup) trên portal của bạn.

Tích hợp giải pháp đăng ký nhúng (WhatsApp Embedded Signup) của Meta lên portal giúp khách hàng của bạn có thể tự kết nối tài khoản WhatsApp Business của họ bằng quy trình hướng dẫn từng bước trực quan ngay trên trình duyệt.

## Đ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 tài khoản WhatsApp Business (hoặc khả năng đăng ký khởi tạo tài khoản mới trong quá trình thiết lập).
* Một portal được cấu hình tên miền riêng chạy giao thức bảo mật HTTPS và truy cập được công khai.
* 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 đã có ứng dụng Facebook (ví dụ: từ phần cấu hình [kênh Messenger](./facebook-messenger)), bạn có thể tái sử dụng ứng dụng đó và chuyển nhanh tới [Bước 2](#buoc-2-cau-hinh-credentials-tren-portal-quan-tri).

<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**. Nhấn nút **Show** và nhập mật khẩu Facebook để hiển thị 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à WhatsApp vào Portal quản trị dưới tư cách Super Admin trước khi tích hợp có thể hoạt độ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 **WhatsApp**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/FAZvdFXI0s4AXKUI/images/image-324.png?fit=max&auto=format&n=FAZvdFXI0s4AXKUI&q=85&s=0471241e688176267f8cf109e251d6b6" alt="chatbotx_super_admin_integrations_whatsapp" width="2830" height="1665" data-path="images/image-324.png" />
    </Frame>
  </Step>

  <Step title="Mở cấu hình WhatsApp">
    Tìm thẻ cấu hình **WhatsApp** và nhấn nút **Edit** để mở cửa sổ cấu hình.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/FAZvdFXI0s4AXKUI/images/image-325.png?fit=max&auto=format&n=FAZvdFXI0s4AXKUI&q=85&s=706cef1b1dc38a7e1155146702137b89" alt="chatbotx_super_admin_whatsapp_edit_modal" width="2867" height="1805" data-path="images/image-325.png" />
    </Frame>
  </Step>

  <Step title="Nhập thông tin Credentials">
    Tại cửa sổ **Edit WhatsApp**, điền đầy đủ thông tin vào các trường:

    | Trường                        | Mô tả                                             | Nơi lấy thông tin                                                                                                                                     | Ví dụ              |
    | ----------------------------- | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
    | **Client ID**                 | Mã ID ứng dụng Facebook                           | [Meta Developer Portal](https://developers.facebook.com/apps/) → Ứng dụng → **Settings → Basic**                                                      | `1974877133429651` |
    | **Client Secret**             | Mã khóa bảo mật của ứng dụng                      | Cùng trang cơ bản → nhấn **Show**                                                                                                                     | `●●●●●●●●●●`       |
    | **API Version**               | Phiên bản API của Graph API                       | Ứng dụng → **Settings → Advanced → API Version**                                                                                                      | `v20.0`            |
    | **Webhook Verify Token**      | Chuỗi ký tự bảo mật xác thực webhook              | Bạn tự tạo một chuỗi ngẫu nhiên (chữ và số)                                                                                                           | `i7CTHYSF66uEHS3B` |
    | **App Config ID**             | Mã ID cấu hình từ trình tạo Facebook Login        | **Facebook Login for Business → Configurations**. Xem hướng dẫn tại [Bước 4](#buoc-4-lay-ma-configuration-id)                                         | `783655134328535`  |
    | **System User ID**            | Mã ID của System User, lấy qua Graph API Explorer | [Graph API Explorer](https://developers.facebook.com/tools/explorer/). Xem hướng dẫn tại [Bước 5](#buoc-5-tao-system-user-id-va-access-token)         | `110835055179851`  |
    | **System User Token**         | Mã Access token vô hạn của System User            | [Meta Business Settings](https://business.facebook.com/settings/system-users). Xem hướng dẫn tại [Bước 5](#buoc-5-tao-system-user-id-va-access-token) | `EAACanps...`      |
    | **Business ID**\*(tùy chọn)\* | Mã Portfolio doanh nghiệp của bạn                 | [Meta Business Settings](https://business.facebook.com/settings/) → **Business Info**                                                                 | `627055339164xxx`  |
    | **Business Name**             | Tên doanh nghiệp hiển thị trên hệ thống           | Nhập tên thương hiệu của bạn                                                                                                                          | `chatconnectx`     |

    <Warning>
      Mã **Client ID** và **Client Secret** phải khớp hoàn toàn với ứng dụng Facebook của bạn. Nếu nhập sai, quy trình đăng ký Embedded Signup sẽ báo lỗi hoặc không thể hoàn tất.
    </Warning>
  </Step>

  <Step title="Lưu cấu hình">
    Nhấn **Save** để lưu cài đặt. Thẻ WhatsApp lúc này sẽ hiển thị thông tin Client ID và tên doanh nghiệp của bạn. Cổng kết nối WhatsApp Embedded Signup đã được kích hoạt.
  </Step>
</Steps>

## Bước 3: Cấu hình sản phẩm WhatsApp trên ứng dụng Facebook

<Steps>
  <Step title="Thêm sản phẩm WhatsApp">
    Tại trang quản trị ứng dụng Facebook của bạn, chọn mục **Add Product** ở menu bên trái. Tìm sản phẩm **WhatsApp** và nhấn **Set Up**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/wunzjY8x_ggxMSs2/images/image-243.png?fit=max&auto=format&n=wunzjY8x_ggxMSs2&q=85&s=50197bee717da07cd1c0e038fb824da9" alt="Adding WhatsApp product" width="2797" height="1406" data-path="images/image-243.png" />
    </Frame>
  </Step>

  <Step title="Xác nhận trang tổng quan WhatsApp Quickstart">
    Hệ thống sẽ chuyển hướng bạn đến giao diện **WhatsApp Quickstart**. Điều này xác nhận sản phẩm WhatsApp đã được thêm vào ứng dụng thành công.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/wunzjY8x_ggxMSs2/images/image-244.png?fit=max&auto=format&n=wunzjY8x_ggxMSs2&q=85&s=2cd541497dd8532f8a2bab2e24e9db00" alt="whatsapp_quickstart_dashboard" width="2959" height="1558" data-path="images/image-244.png" />
    </Frame>

    <Warning>
      Nếu có thông báo cảnh báo **"Missing valid payment method"** (Thiếu phương thức thanh toán), hãy nhấn **Add payment method** để thiết lập thông tin thanh toán cho tài khoản doanh nghiệp Meta của bạn. Nếu thiếu bước này, bạn sẽ không thể gửi tin nhắn ra ngoài môi trường thử nghiệm (free test tier).
    </Warning>

    <Note>
      **KHÔNG nhấn vào nút "Start using the API!"**. Nút này dùng để thiết lập Cloud API trực tiếp theo phương thức thủ công. Hệ thống của bạn sử dụng luồng **Embedded Signup** để tự động cấu hình toàn bộ quy trình, nên bạn có thể bỏ qua phần thiết lập thủ công đó.
    </Note>
  </Step>

  <Step title="Thêm sản phẩm Facebook Login for Business">
    Đăng ký Embedded Signup yêu cầu ứng dụng phải tích hợp sản phẩm **Facebook Login for Business**. Quay lại trang Dashboard ứng dụng của bạn, chọn **Add Product**, tìm sản phẩm **Facebook Login for Business** và nhấn **Settings**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/wunzjY8x_ggxMSs2/images/image-245.png?fit=max&auto=format&n=wunzjY8x_ggxMSs2&q=85&s=0f1cd5fcf3285d573a3de7d8af0946f9" alt="facebook_app_login" width="2858" height="1502" data-path="images/image-245.png" />
    </Frame>

    <Note>
      Nếu ứng dụng của bạn đã được thêm sản phẩm này trước đó (ví dụ: khi cấu hình [Messenger](./facebook-messenger) hoặc [Instagram](./instagram-channel-setup)), bạn có thể bỏ qua bước này và đi đến Bước 4.
    </Note>
  </Step>
</Steps>

## Bước 4: Lấy mã Configuration ID

Mã **Configuration ID** là khóa cấu hình quan trọng dùng để kích hoạt giao diện đăng ký Embedded Signup của WhatsApp trên portal của bạn. Mã này được tạo từ phần thiết lập **Facebook Login for Business**.

<Steps>
  <Step title="Truy cập mục Cấu hình Facebook Login for Business">
    Tại menu bên trái ứng dụng Facebook, mở rộng mục **Facebook Login for Business** và chọn **Configurations**. Nhấn nút **Create configuration** để bắt đầu.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/wunzjY8x_ggxMSs2/images/facebook_login_for_business_configuration_menu.png?fit=max&auto=format&n=wunzjY8x_ggxMSs2&q=85&s=9d02c1395f789e44729c08a9c7700633" alt="Facebook Login For Business Configuration Menu" width="2952" height="1648" data-path="images/facebook_login_for_business_configuration_menu.png" />
    </Frame>
  </Step>

  <Step title="Đặt tên cấu hình">
    Nhập tên gợi nhớ cho cấu hình (ví dụ: `ChatconnectX`), sau đó nhấn **Next**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/wunzjY8x_ggxMSs2/images/facebook_create_configuration_step_name.png?fit=max&auto=format&n=wunzjY8x_ggxMSs2&q=85&s=771add6700f99d5e47139395d1ac5b2c" alt="Facebook Create Configuration Step Name" width="2952" height="795" data-path="images/facebook_create_configuration_step_name.png" />
    </Frame>
  </Step>

  <Step title="Chọn kiểu Login (Login variation)">
    Chọn kiểu đăng nhập là **WhatsApp Embedded Signup**, sau đó nhấn **Next**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/wunzjY8x_ggxMSs2/images/facebook_create_configuration_step_login_variation.png?fit=max&auto=format&n=wunzjY8x_ggxMSs2&q=85&s=6911f3fcc0ad8d05e86a8a1226f85f98" alt="Facebook Create Configuration Step Login Variation" width="2947" height="1068" data-path="images/facebook_create_configuration_step_login_variation.png" />
    </Frame>

    <Warning>
      Cài đặt này **không thể thay đổi sau khi tạo**. Đảm bảo bạn đã chọn chính xác **WhatsApp Embedded Signup** trước khi tiếp tục.
    </Warning>
  </Step>

  <Step title="Chọn sản phẩm tích hợp (Products)">
    Tích chọn sản phẩm **WhatsApp Cloud API** ở bước này, sau đó nhấn **Next**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/wunzjY8x_ggxMSs2/images/facebook_create_configuration_step_products.png?fit=max&auto=format&n=wunzjY8x_ggxMSs2&q=85&s=7a6665a06312bc5e9ec99101d6c3870c" alt="Facebook Create Configuration Step Products" width="2952" height="1287" data-path="images/facebook_create_configuration_step_products.png" />
    </Frame>

    <Warning>
      Cài đặt này **không thể thay đổi sau khi tạo**. Đảm bảo bạn đã tích chọn sản phẩm **WhatsApp Cloud API** trước khi tiếp tục.
    </Warning>
  </Step>

  <Step title="Cấu hình Token (Access token)">
    Thiết lập thời hạn hết hạn token (**Token expiration**) là **Never** (Không bao giờ hết hạn) để đảm bảo kết nối của người dùng không bị gián đoạn, sau đó nhấn **Next**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/wunzjY8x_ggxMSs2/images/facebook_create_configuration_step_access_token.png?fit=max&auto=format&n=wunzjY8x_ggxMSs2&q=85&s=5c59c06e7eda7051acb406774368f73d" alt="Facebook Create Configuration Step Access Token" width="2954" height="1038" data-path="images/facebook_create_configuration_step_access_token.png" />
    </Frame>
  </Step>

  <Step title="Cấu hình tài sản (Assets)">
    Giữ các lựa chọn tài sản mặc định theo hệ thống và nhấn **Next**. Trình thuật sĩ đã tự động chọn các tài sản cần thiết theo sản phẩm bạn đăng ký ở các bước trước.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/wunzjY8x_ggxMSs2/images/facebook_create_configuration_step_assets.png?fit=max&auto=format&n=wunzjY8x_ggxMSs2&q=85&s=8b7a92561a0b9e746f0766ca6ca870a8" alt="Facebook Create Configuration Step Assets" width="2952" height="1411" data-path="images/facebook_create_configuration_step_assets.png" />
    </Frame>
  </Step>

  <Step title="Kiểm tra các quyền truy cập (Permissions)">
    Kiểm tra lại danh sách quyền. Đảm bảo ứng dụng được cấp tối thiểu 3 quyền sau của WhatsApp:

    | Quyền                             | Mục đích sử dụng                                                |
    | --------------------------------- | --------------------------------------------------------------- |
    | `whatsapp_business_management`    | Đọc và quản lý tài sản WhatsApp Business (số điện thoại, hồ sơ) |
    | `whatsapp_business_messaging`     | Gửi và nhận tin nhắn, cuộc gọi qua WhatsApp                     |
    | `whatsapp_business_manage_events` | Quản lý các sự kiện của tài khoản WhatsApp                      |

    <Frame>
      <img src="https://mintcdn.com/chatbotx/wunzjY8x_ggxMSs2/images/facebook_create_configuration_step_permissions.png?fit=max&auto=format&n=wunzjY8x_ggxMSs2&q=85&s=b546d62bb17b66cce1106cf2a7ae4324" alt="Facebook Create Configuration Step Permissions" width="2964" height="1831" data-path="images/facebook_create_configuration_step_permissions.png" />
    </Frame>

    Nhấn **Create** để hoàn tất khởi tạo.
  </Step>

  <Step title="Sao chép mã Configuration ID">
    Màn hình thành công sẽ hiển thị. Hãy sao chép mã **Configuration ID** được hiển thị để điền vào biểu mẫu cấu hình tại Bước 2.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/wunzjY8x_ggxMSs2/images/facebook_configuration_id_generated_copy.png?fit=max&auto=format&n=wunzjY8x_ggxMSs2&q=85&s=9db1c6bf2bc971d79efe1b1ba16edb12" alt="Facebook Configuration Id Generated Copy" width="2954" height="976" data-path="images/facebook_configuration_id_generated_copy.png" />
    </Frame>
  </Step>
</Steps>

<Warning>
  Trước khi ghi đè đường dẫn Callback URL, ứng dụng Facebook của bạn phải được đăng ký nhận sự kiện tin nhắn cho WhatsApp Business Account nhằm tránh gặp lỗi (#100) khi cấu hình webhook. Đảm bảo trường webhook `messages` đã được đăng ký (Subscribed) tại phần cấu hình Webhooks của sản phẩm WhatsApp trên ứng dụng Facebook.
</Warning>

## Bước 5: Tạo System User ID và Access Token

<Steps>
  <Step title="Truy cập mục System Users">
    Truy cập trang [Meta Business Settings](https://business.facebook.com/settings/system-users), chọn mục **Users → System Users** ở menu bên trái. Nếu chưa có System User, hãy nhấn **Add**, đặt tên gợi nhớ và chọn vai trò là **Admin**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/sLgO8A9xEHP_0Ast/images/image-251.png?fit=max&auto=format&n=sLgO8A9xEHP_0Ast&q=85&s=2bcdad3dba07fd3981da1a4db37ab576" alt="meta_business_system_users" width="3035" height="1821" data-path="images/image-251.png" />
    </Frame>
  </Step>

  <Step title="Tạo mã Access Token mới">
    Chọn System User vừa tạo, nhấn nút **Generate New Token**. Cấu hình các thông số sau:

    1. **Select App**: Chọn đúng ứng dụng Facebook bạn đã khởi tạo.
    2. **Token Expiration**: Chọn **Never** để tránh gián đoạn kết nối do hết hạn token.
    3. **Select Permissions**: Tích chọn 3 quyền truy cập bắt buộc:

    | Quyền                          | Mục đích sử dụng                                  |
    | ------------------------------ | ------------------------------------------------- |
    | `business_management`          | Quản lý thông tin cài đặt và tài sản doanh nghiệp |
    | `whatsapp_business_management` | Đọc và quản lý các tài sản WhatsApp Business      |
    | `whatsapp_business_messaging`  | Thực hiện gửi và nhận tin nhắn WhatsApp           |

    <Frame>
      <img src="https://mintcdn.com/chatbotx/sLgO8A9xEHP_0Ast/images/image-252.png?fit=max&auto=format&n=sLgO8A9xEHP_0Ast&q=85&s=3b614fa3128c76ee9a6b92390240f110" alt="meta_system_user_generate_token" width="3035" height="1821" data-path="images/image-252.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/chatbotx/sLgO8A9xEHP_0Ast/images/image-253.png?fit=max&auto=format&n=sLgO8A9xEHP_0Ast&q=85&s=4f2e5b5b2d8f139966e4b6aa48fa5eee" alt="meta_system_user_assign_permissions" width="2989" height="1807" data-path="images/image-253.png" />
    </Frame>

    Nhấn **Generate Token**. Hãy sao chép mã token hiển thị trên màn hình, đây chính là **System User Token** bạn cần nhập ở Bước 2.

    <Warning>
      Sao chép và lưu trữ mã này ngay lập tức. Sau khi đóng cửa sổ thông báo, bạn sẽ không thể xem lại mã token này.
    </Warning>
  </Step>

  <Step title="Lấy System User ID qua Graph API Explorer">
    Truy cập [Meta Graph API Explorer](https://developers.facebook.com/tools/explorer/), dán mã **System User Token** vừa tạo vào ô **Access Token**, cấu hình truy vấn `GET /me` và nhấn **Submit**. Sao chép giá trị `id` nhận được từ phản hồi JSON, đây chính là **System User ID** của bạn.

    ```json theme={null}
    {
      "name": "Tên System User của bạn",
      "id": "110835055179851"
    }
    ```
  </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 WhatsApp Business của họ qua luồng Embedded Signup.

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

## Tuân thủ chính sách thương mại (Commerce Policy)

Meta sẽ thực hiện đánh giá hồ sơ doanh nghiệp của bạn để đảm bảo tuân thủ đầy đủ Chính sách thương mại của WhatsApp và sẽ gửi thông báo trong vòng 24 giờ nếu có bất kỳ vấn đề nào phát sinh.

## Xử lý sự cố thường gặp

<AccordionGroup>
  <Accordion title="Không hiển thị nút kết nối WhatsApp Embedded Signup">
    Lỗi này xảy ra do cấu hình Credentials trên portal quản trị Super Admin chưa đầy đủ hoặc không chính xác.

    **Cách khắc phục:**

    * Kiểm tra xem Super Admin đã nhập đầy đủ các thông số bắt buộc (App ID, App Secret, Configuration ID) tại đường dẫn `/manage/integrations` chưa.
  </Accordion>

  <Accordion title="Gặp lỗi (#100) khi cấu hình webhook">
    Ứng dụng Facebook của bạn phải được đăng ký nhận sự kiện tin nhắn trước khi thực hiện thiết lập Callback URL.

    **Các bước sửa lỗi:**

    1. Truy cập trang quản lý ứng dụng trên [Meta Developer Portal](https://developers.facebook.com/apps/).
    2. Chọn **WhatsApp → Configuration** ở menu bên trái.
    3. Tại mục **Webhooks**, nhấn đăng ký (Subscribe) cho trường `messages` của tài khoản WhatsApp Business.
    4. Tiến hành chạy lại luồng Embedded Signup.
  </Accordion>

  <Accordion title="Lỗi xác thực thông tin khi chạy Embedded Signup">
    **Checklist kiểm tra:**

    * Đảm bảo tài khoản Facebook bạn đang đăng nhập để thực hiện kết nối giữ quyền **quản trị viên (Admin)** đối với Meta Business Portfolio.
    * Kiểm tra ứng dụng Facebook đã được cấp đủ 3 quyền: `whatsapp_business_management`, `whatsapp_business_messaging`, `whatsapp_business_manage_events`.
    * Xác minh mã **App ID** và **App Secret** cấu hình tại trang Portal quản trị khớp hoàn toàn với thông tin ứng dụng trong mục **Settings → Basic** của Meta Developer Portal.
  </Accordion>

  <Accordion title="Hồ sơ xác minh doanh nghiệp hiển thị trạng thái chờ duyệt hoặc bị từ chối">
    **Hướng xử lý:**

    * Kiểm tra lại các thông tin của doanh nghiệp đảm bảo tính chính xác và khớp với giấy tờ pháp lý (tên doanh nghiệp, địa chỉ, trang web chính thức).
    * Đảm bảo lĩnh vực kinh doanh của bạn tuân thủ đúng [Chính sách thương mại của WhatsApp](https://www.whatsapp.com/legal/commerce-policy/).
    * Trong thời gian chờ xác minh, các tài khoản mới sẽ có một giới hạn gửi tin nhắn tạm thời (messaging limit) nhỏ hơn mức thông thường.
    * Quá trình xác minh doanh nghiệp thường diễn ra trong vòng **1 ngày làm việc**.
  </Accordion>

  <Accordion title="Hồ sơ gửi xét duyệt ứng dụng (App Review) bị từ chối">
    **Các bước xử lý:**

    1. Mở xem chi tiết hồ sơ bị từ chối tại giao diện [Meta Developer Dashboard](https://developers.facebook.com/apps/).
    2. Đọc kỹ lý do từ chối và phản hồi của đội ngũ kiểm duyệt Meta.
    3. Bạn có thể sử dụng biểu tượng hỗ trợ của Messenger ở góc dưới bên phải màn hình để liên hệ trao đổi trực tiếp với Meta để được làm rõ.
    4. Cung cấp đầy đủ các tài liệu hướng dẫn sử dụng, tài khoản thử nghiệm và video ghi lại quá trình thao tác rõ ràng để người kiểm duyệt thực hiện.
    5. Gửi lại hồ sơ xét duyệt mới sau khi đã điều chỉnh theo phản hồi.
  </Accordion>

  <Accordion title="Làm thế nào để nhận hỗ trợ nếu sự cố vẫn chưa được khắc phục?">
    1. **Kiểm tra Logs máy chủ**: Xem lịch sử lỗi trong log dịch vụ của cả `rails` và `sidekiq`.
    2. **Kiểm tra trạng thái tài khoản**: Đảm bảo tất cả điều kiện ban đầu (xác minh doanh nghiệp, quyền truy cập tài sản, thanh toán hóa đơn) của Meta/WhatsApp đều hoạt động bình thường.
    3. **Liên hệ hỗ trợ cộng đồng**: Tham gia gửi câu hỏi tại trang [Cộng đồng hỗ trợ ChatbotX](https://discord.chatbotx.io) kèm theo ảnh chụp lỗi cụ thể của bạn.
  </Accordion>
</AccordionGroup>

## Tài liệu tham khảo

Để biết thêm thông tin chi tiết về mặt kỹ thuật, bạn có thể tham khảo tài liệu chính thức từ Meta: [WhatsApp Embedded Signup - Meta for Developers](https://developers.facebook.com/docs/whatsapp/embedded-signup/).