WhatsApp

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.

Công cụ thiết lập tùy chọn

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

Xem video

Play

Bước 0 - Điều kiện cần có

A. Số điện thoại doanh nghiệp

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 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 Messenger.
• Nếu số đang dùng trên WhatsApp Messenger, xóa trước. Đừng quên sao lưu lịch sử chat WhatsApp.
• Số bị cấm phải được gỡ cấm trước khi đăng ký.

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

• Quy trình kết nối hiện tại của Quickchat AI chưa cung cấp phương thức Coexistence đã xác minh cho số WhatsApp Business App hiện có. Meta mô tả cách cùng tồn tại trong tích hợp được hỗ trợ tại hướng dẫn thiết lập Business App.
• Nếu cần giữ số hiện tại, tài khoản Business App và lịch sử chat, gửi email đến support@quickchat.ai trước khi tiếp tục. Không xóa, ngắt kết nối tài khoản Business App hoặc chuyển số như một bước khắc phục sự cố.

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.

B. Thông tin doanh nghiệp

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

Chú ý

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

Bước 1 - Kết nối WhatsApp

Mở ứng dụng Quickchat AI → External Apps → WhatsApp → nhấp Connect 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 Meta cấp cho Quickchat AI quyền truy cập nhiều tài khoản, bảng WhatsApp hiển thị Choose your WhatsApp Business Account thay vì kết nối ngay. Chọn tài khoản Agent cần trả lời rồi nhấp Use this account. 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ị Finish setup 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:

• Waiting for your first message: từ điện thoại khác, gửi tin nhắn WhatsApp đến số hiển thị rồi nhấp Refresh. Đảm bảo gửi đến số doanh nghiệp khách hàng sẽ sử dụng.
• Waiting for the AI reply to be delivered: 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.
• AI reply delivered: 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.
• Verification needs attention: 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 (Approved, Pending review, Declined, Expired hoặc No display name). 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ị Live 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.

Mẹo

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 Refresh. Hội thoại cũng phải xuất hiện trong Inbox 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.

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 Connect 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 Try again. Bạn cũng có thể chọn Continue on Meta in this tab để hoàn tất cùng thiết lập mà không cần cửa sổ bật lên.

Quickchat couldn’t confirm the WhatsApp connection

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 Try again. 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 Continue on Meta in this tab.
3. Nếu số đang hoạt động trong WhatsApp Messenger, xóa ở đó trước hoặc dùng số khác. Nếu đang dùng trong WhatsApp Business App, dừng tại đây và gửi email đến support@quickchat.ai trước khi tiếp tục. Quy trình hiện tại của Quickchat AI chưa có phương thức Coexistence đã xác minh. Không xóa, ngắt kết nối tài khoản Business App hay chuyển số để xử lý thông báo này.
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.
• 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 hay chứng minh đã đáp ứng yêu cầu cùng tồn tại của Meta. Gửi email đến support@quickchat.ai kèm nguyên văn thông báo và bước xuất hiện.
• Nếu số dùng trong WhatsApp Business App và bạn cần giữ tài khoản, lịch sử, liên hệ hỗ trợ trước khi tiếp tục. Không xóa, ngắt kết nối tài khoản hoặc chuyển số để thử xóa lỗi.

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

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

We could not tell which WhatsApp Business Account to connect

• 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 Inbox.

• Đả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ẻ Waiting for your first message 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 Refresh.
• 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 ở External Apps 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 Reconnect để 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 Inbox 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?

• Làm theo hướng dẫn WhatsApp này.
• Hoặc tải thiết kế nút thương hiệu WhatsApp và dùng một trong các đoạn mã nhúng sau:

<!-- 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 ngắt tài khoản WhatsApp Business App để sửa thiết lập không?

• Không. Không xóa, ngắt kết nối tài khoản Business App hoặc chuyển số để khắc phục sự cố. Quy trình kết nối hiện tại của Quickchat AI chưa có phương thức Coexistence đã xác minh bảo toàn thiết lập ứng dụng và lịch sử hiện có.
• Gửi email đến support@quickchat.ai trước khi thay đổi tài khoản Business App đang dùng. Hướng dẫn thiết lập Business App của Meta mô tả cùng tồn tại cho các tích hợp được hỗ trợ, không xác nhận tính năng có sẵn cho thiết lập Quickchat AI của bạn.

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.

Cần trợ giúp?

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: