Bỏ qua để đến nội dung

Kết nối Quickchat AI Agent với WhatsApp Business, kể cả số bạn đang dùng trong ứng dụng WhatsApp Business. Hướng dẫn này trình bày điều kiện cần có, các bước thiết lập và cách đưa nhắn tin WhatsApp vào hoạt động.

Hướng dẫn này giải thích cách tích hợp Quickchat AI Agent với WhatsApp. Quy trình gồm 2 bước đơn giản:

  • Bước 0 - Điều kiện cần có
  • Bước 1 - Kết nối WhatsApp

Nếu gặp vấn đề tích hợp hoặc cần hỗ trợ, xem Khắc phục sự cố & Câu hỏi thường gặp hoặc liên hệ với chúng tôi.

  • Kiểm tra điều kiện thiết lập WhatsApp. Đối chiếu thông tin số điện thoại và nhà cung cấp bạn khai báo với yêu cầu trong tài liệu. Công cụ không truy cập hay kết nối tài khoản WhatsApp.

  • Kiểm tra khung thời gian phục vụ WhatsApp. Kiểm tra khung 24 giờ từ thời điểm nhận và trả lời tin nhắn cùng độ lệch múi giờ đã cung cấp. Công cụ không xác minh mẫu, sự đồng ý hay quyền tài khoản và không gửi tin nhắn.

  • Ước tính chi phí sử dụng. Tính credit mô hình Quickchat AI và tổng riêng cho các khoản phí đã cung cấp. Công cụ không tra giá nhà cung cấp, cộng credit với tiền hay kiểm tra tài khoản.

Play

Chọn số điện thoại sẽ dùng cho WhatsApp. Bạn có thể đọc tài liệu WhatsApp hoặc xem câu hỏi bên dưới:

Số nào dùng được với WhatsApp Cloud API?

  • Cần số điện thoại riêng cho doanh nghiệp, nhận được SMS hoặc cuộc gọi thoại để xác minh.
  • Số phải hợp lệ, thuộc sở hữu của bạn và có mã quốc gia, mã vùng.

Có thể dùng số đang dùng trên WhatsApp cá nhân (WhatsApp Messenger) không?

  • Không. Bạn vẫn dùng số đó để gọi và nhắn SMS được, nhưng không dùng trong WhatsApp cá nhân.
  • Để kết nối, xóa tài khoản WhatsApp trên số này, đợi vài phút rồi kết nối. Xóa tài khoản sẽ xóa lịch sử chat của tài khoản đó, vì vậy hãy sao lưu lịch sử chat WhatsApp trước. Nếu muốn giữ các cuộc chat, hãy kết nối số khác.
  • Số bị cấm phải được gỡ cấm trước khi đăng ký.

Có thể dùng số đang dùng trong ứng dụng WhatsApp Business không?

  • Có (beta). Bạn có thể kết nối số này và tiếp tục dùng ứng dụng WhatsApp Business trên điện thoại. AI Agent của bạn trả lời khách hàng trên cùng số, và các cuộc chat vẫn nằm trong ứng dụng. Meta gọi tính năng này là Coexistence. Xem Tiếp tục dùng ứng dụng WhatsApp Business (Coexistence).
  • Không xóa tài khoản WhatsApp Business hoặc chuyển số để kết nối.

Có thể dùng số điện thoại mới không?

  • Có. Nếu không muốn dùng số hiện tại, hãy lấy số mới (SIM vật lý hoặc số ảo). Bạn có thể mua số ảo từ dịch vụ như Hushed.

Chuẩn bị các thông tin sau (bạn sẽ nhập trong quy trình tích hợp Meta):

  • Tên doanh nghiệp
  • Website doanh nghiệp
  • Danh mục doanh nghiệp
  • Mô tả doanh nghiệp

Ngay cả khi một số trường có vẻ không bắt buộc, hãy điền chính xác. Thông tin thiếu hoặc sai có thể trì hoãn phê duyệt hoặc khiến tài khoản bị hạn chế.

Mở ứng dụng Quickchat AI → Kênh → Ứng dụng bên ngoài → WhatsApp. Tại Bạn đang kết nối số nào?, chọn tùy chọn phù hợp với số của bạn:

  • Số mới chưa dùng trên WhatsApp: làm theo các bước bên dưới.
  • Số đã dùng trong ứng dụng WhatsApp Business: làm theo Tiếp tục dùng ứng dụng WhatsApp Business (Coexistence).
  • Số đã dùng trong WhatsApp cá nhân: trước tiên xóa tài khoản WhatsApp trên số đó (thao tác này xóa lịch sử chat của tài khoản), đợi vài phút rồi làm theo các bước bên dưới. Hoặc dùng số khác.

Sau đó nhấp Kết nối WhatsApp và làm theo cửa sổ Meta:

Bạn cũng có thể bắt đầu từ ChatGPT, Claude hoặc ứng dụng AI đã kết nối khác: yêu cầu liên kết để kết nối Agent này với WhatsApp. Liên kết có hiệu lực 10 phút, dùng một lần và chỉ dành cho tài khoản Quickchat đã yêu cầu. Mở trong trình duyệt đăng nhập tài khoản đó, làm theo thiết lập Meta, rồi hoàn tất mọi lựa chọn tài khoản hoặc số khi Quickchat mở lại. Sau đó nhờ ứng dụng AI kiểm tra thiết lập và gửi tin nhắn WhatsApp thật để xác nhận nhận được trả lời AI. Nếu kết nối nhiều số, kiểm thử từng số đang bật. Bạn phê duyệt quyền Meta trong trình duyệt, không chia sẻ token trong chat.

  1. Đăng nhập tài khoản Meta (Facebook).
  2. Xem các quyền sẽ chia sẻ với Quickchat AI (quyền truy cập WhatsApp Business Account và Business portfolio), rồi tiếp tục.
  3. Cung cấp thông tin doanh nghiệp chính xác (Business Portfolio, Business Name, Business Website, Country, v.v.).
  4. Tạo hoặc chọn WhatsApp Business Account.
  5. Chọn tên hiển thị và danh mục WhatsApp Business.
  6. Thêm số điện thoại doanh nghiệp và xác minh qua SMS/cuộc gọi theo hướng dẫn.
  7. Nhấp Confirm để cấp quyền cần thiết cho Quickchat AI.
  8. Khi Meta xác nhận thiết lập hoàn tất, nhấp Finish. Cửa sổ hiển thị xác nhận của Quickchat AI rằng tài khoản WhatsApp đã kết nối, rồi tự đóng.

Nếu số đang dùng trong WhatsApp Business App, chọn kết nối ứng dụng WhatsApp Business hiện có của bạn trong cửa sổ Meta, rồi xác nhận trong ứng dụng khi được yêu cầu (beta).

Nếu Meta cấp cho Quickchat AI quyền truy cập nhiều tài khoản, bảng WhatsApp hiển thị Chọn tài khoản WhatsApp Business thay vì kết nối ngay. Chọn tài khoản Agent cần trả lời rồi nhấp Dùng tài khoản này. Nếu đang kết nối lại, thiết lập WhatsApp hiện tại không thay đổi cho đến khi bạn xác nhận.

Trở lại ứng dụng Quickchat AI, bảng WhatsApp hiển thị Hoàn tất thiết lập cho đến khi xác minh được trao đổi thành công trên số doanh nghiệp của chính bạn. Nếu bảng chưa cập nhật sau khoảng 30 giây, nhấp biểu tượng làm mới.

Kết nối Meta và nhận tin nhắn chỉ là một phần thiết lập. Bảng hiển thị bước tiếp theo cho từng số đang bật:

  • Đang chờ tin nhắn đầu tiên: từ điện thoại khác, gửi tin nhắn WhatsApp đến số hiển thị rồi nhấp Làm mới. Đảm bảo gửi đến số doanh nghiệp khách hàng sẽ sử dụng.
  • Đang chờ phản hồi AI được chuyển đến: Quickchat đã nhận tin nhắn nhưng WhatsApp chưa xác nhận giao trả lời AI. Kiểm tra điện thoại kia đã nhận chưa. Nếu chưa, kiểm tra credit AI và cảnh báo trong bảng rồi gửi tin nhắn thử khác.
  • Phản hồi AI đã được chuyển đến: WhatsApp xác nhận trả lời AI cho một tin nhắn đến đã được giao trên số doanh nghiệp này.
  • Cần xử lý việc xác minh: xử lý cảnh báo kết nối, giữ số dự định sử dụng ở trạng thái bật và gửi tin nhắn thử mới.
  • Display name: mỗi số ở phần dưới bảng có trạng thái tên hiển thị từ Meta (Đã phê duyệt, Đang chờ xét duyệt, Bị từ chối, Đã hết hạn hoặc Chưa có tên hiển thị). Nếu đang xét duyệt, bạn không cần làm gì; thường hoàn tất trong vài ngày. Tên bị từ chối, hết hạn hoặc thiếu cần được gửi lại trong WhatsApp Manager.
  • Meta test number: số +1 555 do Meta cấp và số sandbox không xác minh kích hoạt số doanh nghiệp. Thêm số riêng trong WhatsApp Manager, bật trong Quickchat rồi kiểm thử số đó.

Bảng hiển thị Đang hoạt động khi mọi số doanh nghiệp đang bật đều có trao đổi đã xác minh và các kiểm tra kết nối đều ổn. Nếu bật nhiều số, kiểm thử từng số. Trao đổi thành công với số thử nghiệm, gửi mẫu hoặc thông báo hết hạn mức tin nhắn không hoàn thành kiểm tra này.

Giữ tích hợp bật trong lúc thử. Từ điện thoại khác, nhắn đến từng số doanh nghiệp dự định dùng, xác nhận trả lời AI đến nơi rồi nhấp Làm mới. Hội thoại cũng phải xuất hiện trong Hộp thư đến của ứng dụng Quickchat AI. Kết nối hiện có có thể yêu cầu trao đổi thử mới để xác minh giao tin; vẫn có thể nhận và trả lời tin nhắn trong lúc bạn hoàn tất bước này.

Nếu Meta còn bước thiết lập chưa xong, hoàn tất tại Setup guidance trong WhatsApp Manager. Quickchat AI cũng gửi email nhắc chủ tài khoản khi các bước Meta chưa hoàn tất.

Tiếp tục dùng ứng dụng WhatsApp Business (Coexistence)

Phần tiêu đề “Tiếp tục dùng ứng dụng WhatsApp Business (Coexistence)”

Bạn có thể kết nối số đã dùng trong ứng dụng WhatsApp Business và tiếp tục dùng ứng dụng trên điện thoại. Meta gọi tính năng này là Coexistence. Trong Quickchat AI, tính năng này đang ở giai đoạn beta. Bạn vẫn dùng ứng dụng như trước, trong khi AI Agent trả lời khách hàng trên cùng số.

  • Cập nhật ứng dụng WhatsApp Business trên điện thoại lên phiên bản 2.24.17 trở lên.
  • Nếu được, hãy bắt đầu thiết lập trên máy tính và để điện thoại có ứng dụng WhatsApp Business ở gần. Bạn sẽ xác nhận kết nối trong ứng dụng.
  1. Trong ứng dụng Quickchat AI, mở Kênh → Ứng dụng bên ngoài → WhatsApp.
  2. Tại Bạn đang kết nối số nào?, chọn Số đã dùng trong ứng dụng WhatsApp Business. Bảng sẽ hiển thị Tiếp tục dùng ứng dụng WhatsApp Business (beta).
  3. Nhấp Kết nối WhatsApp.
  4. Trong cửa sổ của Meta, nhấp Continue. Nếu Meta đề nghị kết nối ứng dụng WhatsApp Business hiện có, hãy chọn tùy chọn đó. Nếu không, chọn Enter a new phone number và nhập số bạn dùng trong ứng dụng WhatsApp Business.
  5. Khi ứng dụng WhatsApp Business trên điện thoại yêu cầu, chạm Connect, rồi Confirm.
  6. Meta có thể hỏi bạn có muốn chia sẻ lịch sử chat không. Bước này không bắt buộc. Quickchat AI không nhập các cuộc chat cũ: Inbox bắt đầu từ lúc bạn kết nối, và các cuộc chat trước đó vẫn nằm trong ứng dụng.

Sau đó gửi tin nhắn thử từ một điện thoại khác như mô tả ở trên, cho đến khi bảng hiển thị Đang hoạt động.

  • Tin nhắn của khách hàng và trả lời của AI Agent hiển thị cả trong ứng dụng WhatsApp Business lẫn trong Inbox của Quickchat AI.
  • Khi bạn trả lời khách hàng từ ứng dụng, AI Agent ngừng trả lời trong cuộc chat đó.
  • Khi cuộc chat im lặng 4 giờ (không có tin nhắn từ bất kỳ ai), tin nhắn tiếp theo của khách hàng sẽ bắt đầu một lượt hội thoại mới và AI Agent trả lời lại. Khoảng 4 giờ này là cố định và không thể thay đổi.
  • Bạn có thể giao lại cuộc chat bất cứ lúc nào bằng cách gán cuộc chat đó cho AI Agent trong Inbox.

Meta áp dụng các giới hạn sau cho số được kết nối qua Coexistence:

  • Danh sách phát tin bị tắt trong ứng dụng WhatsApp Business.
  • Các cuộc chat nhóm không được đồng bộ.
  • Không hỗ trợ WhatsApp for Windows.
  • Nếu bạn không mở ứng dụng WhatsApp Business trên điện thoại trong khoảng 14 ngày, Meta sẽ ngắt kết nối số.

Nếu Meta yêu cầu bạn giải phóng số hoặc xóa tài khoản WhatsApp Business, đừng làm. Thay vào đó, hãy gửi email đến support@quickchat.ai.

Khắc phục sự cố & Câu hỏi thường gặp

Phần tiêu đề “Khắc phục sự cố & Câu hỏi thường gặp”

WhatsApp Business API tính phí thế nào?

  • WhatsApp coi trả lời câu hỏi khách hàng chủ động gửi (tin đến) là tin nhắn dịch vụ. Doanh nghiệp dùng chúng để xử lý yêu cầu đến qua nhân viên hoặc bot AI hội thoại.
  • Khi người dùng nhắn cho doanh nghiệp, khung chăm sóc khách hàng 24 giờ mở ra. Trong thời gian đó, doanh nghiệp trả lời bằng tin nhắn dịch vụ miễn phí. Khung này được tính lại từ mỗi tin nhắn của người dùng.
  • Ngoài 24 giờ, phải dùng Message Templates đã phê duyệt (Marketing, Utility, Authentication, v.v.) và trả phí theo tin theo biểu phí WhatsApp Business Platform.
  • Meta phân loại và tính phí hội thoại. Đảm bảo WhatsApp Business Account có phương thức thanh toán hợp lệ cho tin do doanh nghiệp khởi tạo hoặc tin mẫu.

Nút Kết nối WhatsApp không hoạt động. Không thấy cửa sổ Meta.

  • Nếu trình duyệt chặn cửa sổ bật lên, cho phép cửa sổ của ứng dụng Quickchat AI rồi nhấp Thử lại. Bạn cũng có thể chọn Tiếp tục trên Meta trong thẻ này để hoàn tất cùng thiết lập mà không cần cửa sổ bật lên.

Quickchat không thể xác nhận kết nối WhatsApp

Quickchat hiển thị thông báo khôi phục này khi cửa sổ Meta không trả kết quả và Quickchat vẫn không xác minh được kết nối. Điều đó không chứng minh Meta chưa thay đổi gì.

  1. Xác nhận bạn là Admin của Meta Business sở hữu WhatsApp Business Account. Nếu không, nhờ Admin kết nối bằng tài khoản Facebook của họ.
  2. Nhấp Thử lại. Nếu trình chặn ảnh hưởng cửa sổ Meta, dùng cửa sổ riêng tư với tiện ích tạm dừng, hoặc nhấp Tiếp tục trên Meta trong thẻ này.
  3. Nếu số đang hoạt động trong WhatsApp cá nhân, xóa tài khoản WhatsApp trên số đó (thao tác này xóa lịch sử chat của tài khoản), đợi vài phút rồi thử lại, hoặc dùng số khác. Nếu số đang hoạt động trong ứng dụng WhatsApp Business, bạn không cần xóa gì: kết nối lại, chọn Số đã dùng trong ứng dụng WhatsApp Business, và trong cửa sổ của Meta, chọn kết nối ứng dụng WhatsApp Business hiện có. Xem Tiếp tục dùng ứng dụng WhatsApp Business (Coexistence).
  4. Nếu WhatsApp Business Account dùng Aircall, Twilio, 360dialog, MessageBird hoặc nhà cung cấp khác, thêm Quickchat AI làm đối tác trong Meta Business Settings:
    1. Mở Meta Business Settings và vào Accounts → WhatsApp Accounts.
    2. Chọn WhatsApp Business Account, mở Partners rồi nhấp Add Partners.
    3. Nhập Business ID của Quickchat AI: 270696274483463.
    4. Cấp Manage WhatsApp accounts, quay lại Quickchat AI và làm mới trạng thái.

Chỉ ngắt nhà cung cấp khác nếu Meta không cho phép cả hai đối tác trên tài khoản. Nếu chưa chắc, liên hệ hỗ trợ trước khi ngắt nhà cung cấp nhắn tin đang dùng.

Xác minh số thất bại.

  • Đảm bảo số nhận được SMS hoặc cuộc gọi thoại.
  • Nếu số dùng trong ứng dụng WhatsApp Business, hãy kết nối qua Coexistence và kiểm tra ứng dụng có phiên bản 2.24.17 trở lên. Không xóa tài khoản WhatsApp Business hoặc chuyển số để thử xóa lỗi.
  • Thông báo chung Ineligible hoặc chú giải This number can’t be shared with this app không xác định nguyên nhân. Gửi email đến support@quickchat.ai kèm nguyên văn thông báo và bước xuất hiện.

Tôi kết nối nhầm tài khoản.

  • Kết nối lại giữ nguyên tài khoản đã kết nối. Để chuyển AI Agent sang WhatsApp Business Account khác, nhấp Ngắt kết nối trong bảng WhatsApp, rồi Kết nối WhatsApp lại và chọn đúng tài khoản Meta Business, WhatsApp Account trong cửa sổ Meta.

Không thể xác định tài khoản WhatsApp Business cần kết nối

  • Tài khoản Meta của bạn có nhiều WhatsApp Business Account kèm số điện thoại và Quickchat không biết bạn muốn chọn tài khoản nào. Gửi số muốn kết nối đến support@quickchat.ai, chúng tôi sẽ hoàn tất thiết lập giúp bạn.

Tin nhắn không xuất hiện trong Quickchat AI Hộp thư đến.

  • Đảm bảo cửa sổ đã hiển thị xác nhận cuối: “WhatsApp account connected!”.
  • Kiểm tra lại đã liên kết đúng WhatsApp Account và chọn đúng AI Agent.
  • Thẻ Đang chờ tin nhắn đầu tiên ghi số mà Agent trả lời. Đảm bảo bạn nhắn đúng số và số đã bật trong bảng, rồi nhấp Làm mới.
  • Nếu gửi tin sau 24 giờ mà không có tin nhắn người dùng, dùng mẫu đã phê duyệt và đảm bảo đã đặt phương thức thanh toán trong WhatsApp Manager.

Trả lời WhatsApp của AI không gửi được.

Nếu trả lời AI không thể giao, Quickchat AI hiển thị cảnh báo “WhatsApp replies are failing” trong bảng WhatsApp ở Ứng dụng bên ngoài và thông báo trên bảng điều khiển. Nguyên nhân thường gặp và cách xử lý:

  • Tên hiển thị của số thử Meta chưa được duyệt: Meta giữ trả lời từ số +1 555 do họ cấp cho đến khi tên được duyệt. Cảnh báo tên trong bảng chuyển đỏ và nêu số. Chờ xét duyệt xong (thường vài ngày), hoặc nếu bị từ chối, gửi tên mới trong WhatsApp Manager, rồi gửi tin thử. Tên số riêng của bạn đang xét duyệt không tự nó chặn trả lời; bảng chỉ hiển thị ghi chú.
  • Kết nối hết hạn hoặc bị thu hồi: kết nối WhatsApp không còn hợp lệ. Mở bảng WhatsApp và nhấp Kết nối lại để tiếp tục gửi trả lời.
  • Số bị hạn chế: Meta giới hạn số do điểm chất lượng hoặc vấn đề chính sách. Kiểm tra trạng thái trong WhatsApp Manager để khôi phục gửi tin.
  • Business Account bị khóa (lỗi 131031): Meta chặn trả lời từ WhatsApp Business Account. Lỗi giao tin trong Hộp thư đến và bảng WhatsApp giải thích hạn chế. Mở Business Support Home, chọn tài khoản WhatsApp, chọn vi phạm rồi Request Review: Meta chỉ mở khóa tài khoản qua quy trình xét duyệt này. Kết nối lại Quickchat không gỡ hạn chế.

Cảnh báo khác tự biến mất khi một trả lời được gửi thành công trở lại. Cảnh báo khóa tài khoản còn giữ đến khi một tin mới từ khách truy cập thật nhận được trả lời AI giao hoàn toàn, vì Meta có thể chấp nhận trả lời nhưng sau đó vẫn thất bại. Nếu chỉ số thử Meta (+1 555) đang bật, trả lời AI gửi thành công tiếp theo sẽ xóa cảnh báo. Support AI cũng giải thích được lỗi khóa tài khoản gần đây đã lưu, nhưng bằng chứng quá khứ không chứng minh tài khoản hiện vẫn bị khóa.

Tin mẫu hoặc tin do doanh nghiệp khởi tạo thất bại.

  • Kiểm tra Message Templates đã phê duyệt và phương thức thanh toán đang hoạt động trong WhatsApp Manager.
  • Người gửi mới có giới hạn nhắn tin ban đầu, tăng theo chất lượng và xác minh. Nếu chạm giới hạn tin do doanh nghiệp khởi tạo, xem hướng dẫn Messaging Limits của Meta.
  • Kiểm tra giới hạn nhắn tin và điểm chất lượng trong WhatsApp Manager nếu giao tin bị hạn chế tốc độ.

Làm sao tạo liên kết WhatsApp và nút “Chat on WhatsApp” riêng?

<!-- WhatsApp inline button -->
<!-- Update WHATSAPP_PHONE_NUMBER and filename/path as needed -->
<a
aria-label="Chat on WhatsApp"
href="https://wa.me/WHATSAPP_PHONE_NUMBER"
target="_blank"
rel="noopener noreferrer"
>
<img
alt="Chat on WhatsApp"
src="WhatsAppButtonGreenLarge.svg"
style="
width: 200px;
height: auto;
cursor: pointer;
border-radius: 12px;
"
/>
</a>

hoặc

<!-- WhatsApp floating button -->
<!-- Update WHATSAPP_PHONE_NUMBER and filename/path as needed -->
<a
aria-label="Chat on WhatsApp"
href="https://wa.me/WHATSAPP_PHONE_NUMBER"
target="_blank"
rel="noopener noreferrer"
style="position: fixed; right: 20px; bottom: 20px; z-index: 9999"
>
<img
alt="Chat on WhatsApp"
src="WhatsAppButtonGreenLarge.svg"
style="
width: 200px;
height: auto;
cursor: pointer;
border-radius: 12px;
box-shadow: rgba(0, 0, 0, 0.5) 0px 5px 15px 0px;
transition: all 0.3s ease;
"
onmouseover="this.style.transform = 'scale(1.05)'"
onmouseout="this.style.transform = 'scale(1)'"
/>
</a>

Làm sao tạo mã QR WhatsApp riêng?

  • Mở WhatsApp Manager → Phone numbers → chọn số doanh nghiệp → Message links → Create Message Link.
  • Bạn cũng có thể tìm trong ứng dụng di động WhatsApp Business. Làm theo hướng dẫn WhatsApp này.

Có nên xóa tài khoản ứng dụng WhatsApp Business để sửa thiết lập không?

Quickchat AI có quyền gì với WhatsApp Business Account của chúng tôi?

  • Quyền API có phạm vi, không phải quyền sở hữu tài khoản. WhatsApp Business Account (WABA) nằm trong Meta Business Manager của chính bạn. Theo mô hình WABA Sharing, bạn sở hữu tài sản; Quickchat AI chỉ được thêm làm đối tác mà bạn có thể thu hồi bất cứ lúc nào trong Business Manager.
  • Chúng tôi có thể gửi, nhận tin qua Cloud API và nhận sự kiện tin nhắn qua webhook khi tích hợp hoạt động.
  • Chúng tôi không thể đóng, chuyển, đổi thương hiệu tài khoản, thay đổi thanh toán hoặc xóa quản trị viên.

Chat với Support AI của Quickchat trên WhatsApp:
📱 +1 302-405-9992: Bắt đầu trò chuyện

Hoặc quét mã QR:

Mã QR WhatsApp

Cập nhật lần cuối: