> ## 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.

# WhatsApp Coexistence

> Hướng dẫn kết nối WhatsApp Coexistence vào ChatbotX để giữ số WhatsApp Business hiện có, đồng bộ contact và tiếp tục chăm sóc khách hàng.

**WhatsApp Coexistence** cho phép bạn giữ số WhatsApp Business hiện có khi kết nối với ChatbotX. Cách thiết lập này hỗ trợ sử dụng đồng thời ứng dụng WhatsApp Business trên điện thoại và WhatsApp API trên cùng một số, đồng thời đồng bộ contact và lịch sử trò chuyện để bạn tiếp tục chăm sóc khách hàng mà không bị ngắt quãng.

## Tổng quan về WhatsApp Coexistence

Khi kết nối theo hình thức này, bạn sẽ có:

* Dùng cùng lúc ứng dụng WhatsApp Business trên điện thoại và WhatsApp API trong ChatbotX
* Đồng bộ contact và lịch sử chat từ ứng dụng lên hệ thống
* Tiếp tục trả lời thủ công trên điện thoại khi cần
* Mở thêm các tính năng của WhatsApp API trong ChatbotX như template message, automation và xử lý hội thoại tập trung

> **Lưu ý:** Tính năng này không áp dụng cho mọi quốc gia và vùng lãnh thổ. Khả năng hỗ trợ phụ thuộc vào country code của số điện thoại và chính sách hiện hành của Meta tại thời điểm thiết lập.

### Tự động hóa

Ứng dụng WhatsApp Business bao gồm các tính năng tự động hóa cơ bản như tin nhắn chúc mừng và tin nhắn vắng mặt. Nếu đã sử dụng các tính năng tự động hóa này trên ứng dụng WhatsApp Business, bạn hãy nhớ tắt chúng trước khi bắt đầu sử dụng ChatbotX.

### Phí gửi tin nhắn

Sau khi doanh nghiệp của bạn được thiết lập trên API đám mây:

* Tin nhắn bạn gửi qua ứng dụng WhatsApp Business trên điện thoại vẫn hoàn toàn miễn phí.
* Tin nhắn được gửi qua ChatbotX sẽ tuân theo biểu phí Cloud API của Meta.

## Trước khi bắt đầu

Hãy chuẩn bị sẵn các thông tin sau:

* Số WhatsApp Business đang dùng
* Tài khoản Meta Business có quyền với số đó
* Tên hiển thị doanh nghiệp
* Website, danh mục ngành và múi giờ

Nếu cần xem hướng dẫn đăng ký tài khoản WhatsApp Business (WABA) theo luồng thông thường, hãy tham khảo bài viết [Connect WhatsApp](/vi/channels/whatsapp/whatsapp-connect).

## Bước 1: Mở phần chọn kênh

1. Vào **Settings** → **Channel**.
2. Nhấn **Add WhatsApp**.

<Frame>
  <img src="https://mintcdn.com/chatbotx/TVQD4ONZaFXjuqvh/images/whatsapp_coexistence_channel_selection.png?fit=max&auto=format&n=TVQD4ONZaFXjuqvh&q=85&s=817846ce524ead546bb60c6de54c445a" alt="Whatsapp Coexistence Channel Selection" width="3126" height="1453" data-path="images/whatsapp_coexistence_channel_selection.png" />
</Frame>

## Bước 2: Chọn kênh WhatsApp trong bảng tạo Workspace

Tại bảng **Create Workspace**, nhấn **Continue** nằm cạnh logo **Whatsapp**.

<Frame>
  <img src="https://mintcdn.com/chatbotx/TVQD4ONZaFXjuqvh/images/whatsapp_coexistence_create_workspace.png?fit=max&auto=format&n=TVQD4ONZaFXjuqvh&q=85&s=926a3271e1ed5408fd134d6f1b4b0d81" alt="Whatsapp Coexistence Create Workspace" width="3130" height="1656" data-path="images/whatsapp_coexistence_create_workspace.png" />
</Frame>

## Bước 3: Chọn kiểu kết nối WhatsApp

1. Bật tính năng **Connect an existing WhatsApp Business Account**.
2. Nhấn **Continue**.

<Frame>
  <img src="https://mintcdn.com/chatbotx/TVQD4ONZaFXjuqvh/images/whatsapp_coexistence_connect_option.png?fit=max&auto=format&n=TVQD4ONZaFXjuqvh&q=85&s=2442af7d9b82487faf2e9a190c308540" alt="Whatsapp Coexistence Connect Option" width="1849" height="1148" data-path="images/whatsapp_coexistence_connect_option.png" />
</Frame>

## Bước 4: Đăng nhập và xác nhận tài khoản Facebook

Đăng nhập vào tài khoản Facebook cá nhân có quyền quản trị tài sản doanh nghiệp của bạn, sau đó nhấn **Continue as \[Tên Facebook]**.

<Frame>
  <img src="https://mintcdn.com/chatbotx/TVQD4ONZaFXjuqvh/images/whatsapp_coexistence_fb_auth.png?fit=max&auto=format&n=TVQD4ONZaFXjuqvh&q=85&s=216532268088a013c1ea3490b51b8f48" alt="Whatsapp Coexistence Fb Auth" width="3098" height="1737" data-path="images/whatsapp_coexistence_fb_auth.png" />
</Frame>

## Bước 5: Xác nhận quyền truy cập

Xem qua thông tin mô tả quyền lợi khi kết nối tại giao diện *"Seamlessly connect your account to..."*, sau đó nhấn **Continue**.

<Frame>
  <img src="https://mintcdn.com/chatbotx/TVQD4ONZaFXjuqvh/images/whatsapp_coexistence_permissions.png?fit=max&auto=format&n=TVQD4ONZaFXjuqvh&q=85&s=df5d30aa443c1ac1ac8571754f3ac19e" alt="Whatsapp Coexistence Permissions" width="3096" height="1750" data-path="images/whatsapp_coexistence_permissions.png" />
</Frame>

## Bước 6: Chọn tài sản doanh nghiệp

1. Tại mục **Business portfolio**: Chọn đúng tài khoản Meta Business sở hữu tài sản của bạn.
2. Tại mục **WhatsApp Business account**: Nhấn vào dropdown và chọn **Connect a WhatsApp Business App**.
3. Nhấn **Next** để tiếp tục.

<Frame>
  <img src="https://mintcdn.com/chatbotx/TVQD4ONZaFXjuqvh/images/whatsapp_coexistence_business_assets.png?fit=max&auto=format&n=TVQD4ONZaFXjuqvh&q=85&s=6506356e6ea931cc071bc66683697b66" alt="Whatsapp Coexistence Business Assets" width="3097" height="1757" data-path="images/whatsapp_coexistence_business_assets.png" />
</Frame>

## Bước 7: Nhập số điện thoại WhatsApp Business

1. Chọn đúng mã quốc gia (ví dụ: `VN +84` cho Việt Nam).
2. Điền số điện thoại WhatsApp Business hiện đang sử dụng trên ứng dụng di động của bạn.
3. Nhấn **Next**.

<Frame>
  <img src="https://mintcdn.com/chatbotx/TVQD4ONZaFXjuqvh/images/whatsapp_coexistence_enter_number.png?fit=max&auto=format&n=TVQD4ONZaFXjuqvh&q=85&s=c9e0ebedafa8e63f0bf1fd358beb8111" alt="Whatsapp Coexistence Enter Number" width="3095" height="1765" data-path="images/whatsapp_coexistence_enter_number.png" />
</Frame>

## Bước 8: Đọc thông tin kết nối ứng dụng hiện có

Xem kỹ các thông tin về quyền chia sẻ dữ liệu (Sharing Access) và bảo mật dữ liệu (Protecting your data), sau đó nhấn **Next** để đi đến bước quét mã kết nối.

<Frame>
  <img src="https://mintcdn.com/chatbotx/TVQD4ONZaFXjuqvh/images/whatsapp_coexistence_connect_details.png?fit=max&auto=format&n=TVQD4ONZaFXjuqvh&q=85&s=93d6e3e34f54b40ba1177fd2551833ea" alt="Whatsapp Coexistence Connect Details" width="3096" height="1759" data-path="images/whatsapp_coexistence_connect_details.png" />
</Frame>

## Bước 9: Quét mã QR đồng bộ trên máy tính

Màn hình máy tính sẽ hiển thị một mã QR Code cùng các hướng dẫn kết nối. Hãy giữ nguyên màn hình này để thực hiện quét mã từ điện thoại di động ở bước tiếp theo.

<Frame>
  <img src="https://mintcdn.com/chatbotx/TVQD4ONZaFXjuqvh/images/whatsapp_coexistence_scan_qr_desktop.png?fit=max&auto=format&n=TVQD4ONZaFXjuqvh&q=85&s=cf1312def1cd3843f0103754805f172e" alt="Whatsapp Coexistence Scan Qr Desktop" width="3094" height="1764" data-path="images/whatsapp_coexistence_scan_qr_desktop.png" />
</Frame>

## Bước 10: Thiết lập liên kết trên ứng dụng di động

Hãy mở điện thoại và thực hiện theo trình tự sau:

<Steps>
  <Step title="Mở thông báo kết nối">
    Tìm cuộc hội thoại gửi từ tài khoản **Facebook Business** chính thức của Meta trên ứng dụng WhatsApp, sau đó nhấn **Connect**.
  </Step>

  <Step title="Chấp nhận kết nối">
    Tại giao diện *"Connect to the Business Platform"*, nhấn chọn nút **Connect to the Business Platform**.
  </Step>

  <Step title="Chọn đồng bộ lịch sử hội thoại">
    Tại hộp thoại *"Share chat history"*, chọn **Share all chats** (hỗ trợ đồng bộ lên đến 6 tháng lịch sử hội thoại 1:1) hoặc *Don't share chats*, rồi bấm **Confirm**.
  </Step>

  <Step title="Quét mã QR">
    Hướng camera điện thoại quét mã QR hiển thị ở Bước 9 trên màn hình máy tính của bạn, sau đó nhấn **OK**.
  </Step>

  <Step title="Hoàn tất liên kết trên điện thoại">
    Đợi một vài giây để điện thoại hoàn tất đồng bộ. Khi màn hình hiển thị thông báo kết nối thành công *"You're connected to AhaChat"*, nhấn **OK**.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/chatbotx/TVQD4ONZaFXjuqvh/images/whatsapp_coexistence_mobile_flow.png?fit=max&auto=format&n=TVQD4ONZaFXjuqvh&q=85&s=b239b92b30f0f51805e377c75842c529" alt="Whatsapp Coexistence Mobile Flow" width="3813" height="1517" data-path="images/whatsapp_coexistence_mobile_flow.png" />
</Frame>

## Bước 11: Xác nhận hoặc chỉnh sửa tài khoản WhatsApp Business

Quay trở lại giao diện máy tính:

1. Xác nhận lại tên hiển thị tại mục **WhatsApp Business account name**.
2. Chọn múi giờ chính xác tại mục **Timezone** (ví dụ: `(GMT-07:00) Etc/GMT+7` hoặc theo khu vực của bạn).
3. Nhấn **Next**.

<Frame>
  <img src="https://mintcdn.com/chatbotx/TVQD4ONZaFXjuqvh/images/whatsapp_coexistence_confirm_account.png?fit=max&auto=format&n=TVQD4ONZaFXjuqvh&q=85&s=8ea92a38a6c4bdc32e632f5eb99b03c0" alt="Whatsapp Coexistence Confirm Account" width="3098" height="1767" data-path="images/whatsapp_coexistence_confirm_account.png" />
</Frame>

## Bước 12: Xem lại thông tin chia sẻ với ChatConnectX

Kiểm tra lại toàn bộ danh sách các quyền hạn được yêu cầu để quản lý tài khoản và gửi tin nhắn, sau đó nhấn **Confirm**.

<Frame>
  <img src="https://mintcdn.com/chatbotx/TVQD4ONZaFXjuqvh/images/whatsapp_coexistence_review_permissions.png?fit=max&auto=format&n=TVQD4ONZaFXjuqvh&q=85&s=e9efbf7981732077d04b730984e4ad57" alt="Whatsapp Coexistence Review Permissions" width="3098" height="1764" data-path="images/whatsapp_coexistence_review_permissions.png" />
</Frame>

## Bước 13: Hoàn tất kết nối tài khoản trên Meta

Màn hình Meta sẽ thông báo tài khoản của bạn đã được kết nối thành công với AhaChat (*"Your account is connected to..."*). Hãy nhấn **Finish** để đóng cửa sổ đăng ký và quay lại ChatbotX.

<Frame>
  <img src="https://mintcdn.com/chatbotx/TVQD4ONZaFXjuqvh/images/whatsapp_coexistence_connected_success.png?fit=max&auto=format&n=TVQD4ONZaFXjuqvh&q=85&s=d3e305c5a99a638d40bc568d493a8816" alt="Whatsapp Coexistence Connected Success" width="3099" height="1763" data-path="images/whatsapp_coexistence_connected_success.png" />
</Frame>

## Bước 14: Đồng bộ danh bạ và lịch sử trò chuyện

1. Ngay khi quay lại ChatbotX, một thông báo yêu cầu đồng bộ sẽ xuất hiện.
2. Nhấp vào **Enable sync** để tiến hành nhập danh bạ và tối đa 6 tháng lịch sử hội thoại từ ứng dụng di động lên ChatbotX.

<Frame>
  <img src="https://mintcdn.com/chatbotx/TVQD4ONZaFXjuqvh/images/whatsapp_coexistence_sync_history.png?fit=max&auto=format&n=TVQD4ONZaFXjuqvh&q=85&s=3ddcff3c2a9d13b2031667784c4dd752" alt="Whatsapp Coexistence Sync History" width="1753" height="1016" data-path="images/whatsapp_coexistence_sync_history.png" />
</Frame>

## Bước 15: Kiểm tra lại trên Dashboard

Sau khi đồng bộ xong, kênh WhatsApp mới kết nối (ví dụ: `May Store`) sẽ hiển thị trên dashboard của bạn kèm theo nút **Test Now** để bạn gửi thử tin nhắn kiểm tra.

<Frame>
  <img src="https://mintcdn.com/chatbotx/TVQD4ONZaFXjuqvh/images/whatsapp_coexistence_dashboard_check.png?fit=max&auto=format&n=TVQD4ONZaFXjuqvh&q=85&s=952b39c72219903a2c441e9e28ee9b17" alt="Whatsapp Coexistence Dashboard Check" width="3088" height="1463" data-path="images/whatsapp_coexistence_dashboard_check.png" />
</Frame>

## FAQ

<AccordionGroup>
  <Accordion title="Tôi có giữ được số WhatsApp Business hiện có không?">
    Có. WhatsApp Coexistence cho phép bạn dùng lại số WhatsApp Business đang hoạt động khi kết nối với ChatbotX.
  </Accordion>

  <Accordion title="Contact và lịch sử chat có được đồng bộ không?">
    Theo luồng tài liệu hiện tại của ChatbotX, hệ thống hỗ trợ đồng bộ contact và lịch sử chat trong quá trình kết nối.
  </Accordion>

  <Accordion title="Vì sao tôi bị giới hạn gửi tin ngay sau khi kết nối?">
    Đây thường là giới hạn tạm thời trong lúc Meta xét duyệt tài khoản và `Display Name`.
  </Accordion>
</AccordionGroup>