Hướng dẫn này trình bày cách tích hợp Quickchat AI Agent của bạn với WhatsApp. Quy trình được chia thành 2 bước đơn giản:
- Bước 0 - Điều kiện tiên quyết
- Bước 1 - Kết nối WhatsApp
Nếu bạn gặp vấn đề khi tích hợp hoặc cần trợ giúp, hãy xem phần Troubleshooting & FAQs hoặc liên hệ với chúng tôi.
Xem video
Bước 0 - Điều kiện tiên quyết
A. Số điện thoại doanh nghiệp
Hãy quyết định số điện thoại nào bạn sẽ dùng cho WhatsApp. Bạn có thể đọc thêm trong tài liệu WhatsApp hoặc xem phần câu hỏi thường gặp bên dưới:
Có thể dùng số nào trong WhatsApp Cloud API?
- Bạn cần dùng một số điện thoại doanh nghiệp chuyên dụng có thể nhận 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, đồng thời có mã quốc gia và mã vùng.
Tôi có thể dùng số đang được sử dụng trong WhatsApp Messenger không?
- Không. Bạn có thể tiếp tục dùng số này cho cuộc gọi và tin nhắn SMS, nhưng không dùng trong WhatsApp Messenger.
- Nếu số này đang được sử dụng trong WhatsApp Messenger, hãy xóa số đó trước. Đừng quên sao lưu lịch sử chat WhatsApp của bạn.
- Các số bị cấm phải được gỡ cấm trước khi đăng ký.
Tôi có thể dùng số đang được WhatsApp Business App sử dụng không?
- Có. Nếu số của bạn hiện đang được dùng trong WhatsApp Business App, bạn có thể đưa số đó lên Cloud API mà không cần xóa tài khoản ứng dụng. Đọc thêm về quy trình onboarding Coexistence trong tài liệu Meta.
Tôi có thể dùng một số điện thoại mới không?
- Có, nếu bạn không muốn dùng số hiện tại, hãy lấy một số mới (SIM vật lý hoặc số ảo). Bạn có thể mua số điện thoại ảo từ các dịch vụ như Hushed.
B. Thông tin doanh nghiệp
Chuẩn bị sẵn các thông tin này (bạn sẽ nhập chúng trong luồng 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ẻ là tùy chọn, hãy điền chính xác. Thông tin thiếu hoặc không chính xác có thể làm chậm quá trình phê duyệt hoặc dẫn đến hạn chế tài khoản.
Bước 1 - Kết nối WhatsApp
Kể từ bản cập nhật mới nhất của chúng tôi, việc kết nối chỉ cần một cú nhấp. Không còn bước thứ hai riêng biệt nữa: trình hướng dẫn Embedded Signup của Meta sẽ dẫn bạn qua việc tạo WhatsApp Business Account và số mới, hoặc chọn tài khoản và số bạn đã có, sau đó Quickchat AI hoàn tất phần còn lại.
Mở Quickchat AI App → External Apps → WhatsApp → nhấp vào nút Connect WhatsApp và làm theo cửa sổ bật lên của Meta:
- Đăng nhập vào tài khoản Meta (Facebook) của bạn.
- Xem lại các quyền bạn sẽ chia sẻ với Quickchat AI (quyền truy cập WhatsApp Business account và quyền truy cập Business portfolio), sau đó tiếp tục.
- Cung cấp thông tin doanh nghiệp chính xác (Business Portfolio, Business Name, Business Website, Country, v.v.).
- Tạo hoặc chọn WhatsApp Business Account của bạn.
- Chọn tên hiển thị và danh mục cho WhatsApp Business.
- Thêm số điện thoại doanh nghiệp của bạn và xác minh qua SMS/cuộc gọi thoại theo lời nhắc.
- Nhấp Confirm để cấp cho Quickchat AI quyền truy cập cần thiết.
- Khi Meta xác nhận thiết lập đã hoàn tất, nhấp Finish. Cửa sổ bật lên hiển thị xác nhận của Quickchat AI rằng tài khoản WhatsApp của bạn đã được kết nối và tự động đóng.
Quay lại Quickchat AI App, panel WhatsApp hiển thị Connecting your WhatsApp account và cập nhật thành Connected trong khoảng 30 giây. Nếu không, hãy nhấp Refresh Status trong panel. Nếu vẫn chưa được, vui lòng xem lại phần Điều kiện tiên quyết ở trên để đảm bảo bạn đã cung cấp đúng số điện thoại và thông tin doanh nghiệp.
Connected nghĩa là Quickchat AI có thể truy cập WhatsApp Business Account của bạn. Ngay bên dưới, panel hiển thị những gì vẫn cần hoàn tất trước khi khách hàng nhận được phản hồi:
Panel Connected liệt kê những việc còn lại: ở đây là tin nhắn đầu tiên
- Waiting for your first message: gửi một tin nhắn WhatsApp đến số được hiển thị từ một điện thoại khác, sau đó nhấp Refresh. Khi tin nhắn đã đến, panel hiển thị Messages Received bên cạnh Webhook Active và Admin Assigned.
- Display name: mỗi số được liệt kê ở phần dưới của panel có trạng thái tên hiển thị từ Meta (Approved, Pending review, Declined, Expired hoặc No display name). Một lượt xét duyệt đang diễn ra không yêu cầu bạn làm gì và thường hoàn tất trong vài ngày. Nếu tên hiển thị bị từ chối, hết hạn hoặc bị thiếu, bạn cần gửi một tên trong WhatsApp Manager.
- Meta test number: nếu số đang hoạt động là số +1 555 do Meta cung cấp, panel sẽ cho biết điều đó. Các số này dùng để thử nghiệm và không thể chuyển sang tài khoản khác. Hãy thêm số của bạn trong WhatsApp Manager để đưa vào hoạt động chính thức.
Khi panel hiển thị Messages Received, bạn đã hoạt động! 🎉 Khách hàng có thể nhắn tin đến số WhatsApp của bạn, và AI Agent của bạn sẽ tự động phản hồi.
Để xác minh tích hợp lần cuối, hãy gửi một tin nhắn văn bản đến số WhatsApp bạn vừa kết nối, sau đó nhấp Refresh trong panel. Waiting for your first message chuyển thành Messages Received, bạn sẽ nhận được phản hồi từ AI Agent của mình, và cuộc hội thoại sẽ xuất hiện trong Inbox của Quickchat AI App. Nếu bạn để lại bất kỳ bước thiết lập nào của Meta chưa hoàn tất, Quickchat AI cũng sẽ gửi email cho chủ sở hữu tài khoản với các bước còn lại để nhắc nhở.
Khắc phục sự cố và câu hỏi thường gặp
Cách tính giá WhatsApp Business API hoạt động như thế nào?
- Các phản hồi cho yêu cầu của khách hàng do người dùng khởi tạo (inbound) được WhatsApp xử lý như Service messages. Những tin nhắn này cho phép doanh nghiệp quản lý các yêu cầu đến từ khách hàng, dù thông qua nhân viên hỗ trợ hay bot hội thoại dùng AI.
- Khi người dùng nhắn tin cho doanh nghiệp, thao tác này mở một cửa sổ dịch vụ khách hàng 24 giờ, trong đó doanh nghiệp có thể phản hồi bằng service messages, không mất phí. Cửa sổ này được đặt lại với mỗi tin nhắn của người dùng.
- Ngoài 24 giờ, bạn phải dùng Message Templates đã được phê duyệt (Marketing, Utility, Authentication, v.v.) và trả phí theo từng tin nhắn theo WhatsApp Business Platform Message Rates.
- Các cuộc hội thoại được Meta phân loại và tính phí. Hãy đảm bảo WhatsApp Business Account của bạn có phương thức thanh toán hợp lệ cho tin nhắn do doanh nghiệp khởi tạo/tin nhắn template.
Nút Connect WhatsApp không hoạt động. Tôi không thấy cửa sổ bật lên của Meta.
- Nếu trình duyệt của bạn chặn cửa sổ bật lên, ứng dụng sẽ hiển thị thông báo yêu cầu bạn cho phép cửa sổ bật lên. Tắt trình chặn cửa sổ bật lên và trình chặn tracker trong trình duyệt của bạn, làm mới website và thử lại. Nếu không hiệu quả, hãy thử một trình duyệt khác.
Xác minh số không thành công.
- Hãy đảm bảo số có thể nhận SMS/cuộc gọi thoại và không bị chặn bởi một đường dẫn đăng ký đang hoạt động mà Meta không cho phép cùng tồn tại. Nếu số đang được dùng trong Business App, hãy thử onboarding qua Coexistence.
Meta cho biết thiết lập của tôi chưa hoàn tất, hoặc panel hiển thị cảnh báo.
- Trước tiên hãy đọc thẻ bên dưới Connected: thẻ này nêu số mà AI Agent của bạn trả lời và cho biết Meta có còn đang xét duyệt tên hiển thị của số đó hay không, số đó có phải là số thử nghiệm của Meta hay không, hoặc tin nhắn đầu tiên đã đến hay chưa. Mỗi thẻ liên kết đến đúng vị trí trong WhatsApp Manager.
- Nếu cảnh báo liên quan đến chính kết nối, hãy nhấp Reconnect WhatsApp trong panel. Thao tác này giải quyết hầu hết trường hợp.
- Nếu không, số của bạn có thể đang được kết nối với một nhà cung cấp khác (Meta chỉ cho phép một đối tác cho mỗi tài khoản WhatsApp tại một thời điểm). Làm theo hướng dẫn trên màn hình để thêm Quickchat AI làm đối tác trong cài đặt Meta Business, sau đó nhấp Refresh Status.
Tôi đã kết nối sai tài khoản.
- Reconnect giữ nguyên tài khoản đã được kết nối. Để chuyển đổi, nhấp Disconnect trong panel WhatsApp, sau đó nhấp lại Connect WhatsApp và chọn đúng tài khoản Meta Business cùng WhatsApp Account trong cửa sổ của Meta.
Tin nhắn không xuất hiện trong Quickchat AI Inbox.
- Xác nhận rằng cửa sổ bật lên đã hiển thị xác nhận cuối cùng rằng tài khoản WhatsApp của bạn đã được kết nối.
- Kiểm tra lại rằng bạn đã liên kết đúng WhatsApp Account dự định và đã chọn đúng AI Agent.
- Thẻ Waiting for your first message nêu số mà AI Agent của bạn trả lời. Hãy đảm bảo bạn đã nhắn đúng số đó và số đó đang được bật trong panel, sau đó nhấp Refresh.
- Nếu bạn đang gửi tin nhắn sau 24 giờ mà không có tin nhắn từ người dùng, hãy dùng template đã được phê duyệt và đảm bảo phương thức thanh toán đã được thiết lập trong WhatsApp Manager.
Các phản hồi WhatsApp của AI của tôi không gửi được.
- Quickchat AI hiển thị cảnh báo “WhatsApp replies are failing” trên panel WhatsApp và một thông báo trên dashboard của bạn. Các cách khắc phục phổ biến: hoàn tất phê duyệt tên hiển thị trong WhatsApp Manager; nếu kết nối đã hết hạn hoặc bị thu hồi, nhấp Reconnect; nếu Meta đã hạn chế số của bạn do chất lượng hoặc chính sách, hãy kiểm tra trạng thái của số trong WhatsApp Manager. Cảnh báo sẽ biến mất khi một phản hồi được gửi thành công trở lại.
Tin nhắn template hoặc tin nhắn do doanh nghiệp khởi tạo không gửi được.
- Xác minh Message Templates của bạn đã được phê duyệt và phương thức thanh toán của bạn đang hoạt động trong WhatsApp Manager.
- Người gửi mới bắt đầu với giới hạn nhắn tin tăng dần dựa trên chất lượng và xác minh. Nếu bạn chạm giới hạn đối với tin nhắn do doanh nghiệp khởi tạo, hãy xem hướng dẫn Messaging Limits của Meta.
- Kiểm tra giới hạn nhắn tin và xếp hạng chất lượng trong WhatsApp Manager nếu việc gửi bị điều tiết.
Cách tạo liên kết WhatsApp và nút “Chat on WhatsApp” của riêng tôi?
- Làm theo hướng dẫn WhatsApp này.
Cách tạo mã QR WhatsApp của riêng tôi?
- Truy cập WhatsApp Manager → Phone numbers → chọn số điện thoại doanh nghiệp của bạn → Message links → Create Message Link.
- Ngoài ra, bạn có thể tìm mã này trong ứng dụng di động WhatsApp Business của mình. Làm theo hướng dẫn WhatsApp này.
Cần trợ giúp?
Chat với Support AI của Quickchat trên WhatsApp:
📱 +1 302-405-9992: Bắt đầu chat
Hoặc quét mã QR:
