Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs-agents.fpt.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Giới thiệu

Sau khi hoàn thiện AI Agent, người dùng có thể muốn đưa Agent lên WhatsApp để phục vụ người dùng cuối. Để hỗ trợ nhu cầu này, hệ thống đã bổ sung tính năng tích hợp WhatsApp thông qua Meta Developer, giúp người dùng dễ dàng kết nối và triển khai AI Agent trên nền tảng WhatsApp.

​
Kết nối với WhatsApp

Trước khi tích hợp WhatsApp, người dùng cần phải có:
  • Tài khoản Meta Developer. Cách tạo tài khoản xem tại: https://developers.facebook.com/docs/development/register
  • Trang quản lý tài sản doanh nghiệp trong Meta Business Suite. Xem chi tiết tại: https://www.facebook.com/business/help/1710077379203657
Sau khi thỏa mãn các điều kiện trên, thực hiện tích hợp theo các bước sau:

​
Bước 1. Tạo ứng dụng trên Meta

Truy cập https://developers.facebook.com/apps và ấn “Tạo ứng dụng”. Image434 Điền Tên và Email liên hệ của ứng dụng. Image435 Lựa chọn Trường hợp sử dụng theo nhu cầu, cho phép lựa chọn nhiều.
Nếu chọn “Kết nối với khách hàng qua WhatsApp”, cần có hồ sơ doanh nghiệp đã được xác minh.
Image436 Kết nối với tài khoản doanh nghiệp: Kết nối với tài khoản doanh nghiệp của bạn. Nếu chưa có hồ sơ doanh nghiệp, người dùng có thể tạo mới bằng cách chọn “Hãy tạo hồ sơ doanh nghiệp”. Image437 Kiểm tra các Yêu cầu về việc phát hành. Nếu không có yêu cầu nào, vui lòng bỏ qua. Image438 Kiểm tra thông tin ứng dụng và chọn “Đi đến bảng điều khiển” để hoàn tất việc tạo ứng dụng. Image439

​
Bước 2. Thêm vào cài đặt WhatsApp trên Meta Developer

Sau khi tạo ứng dụng thành công, truy cập ứng dụng vừa tạo. Thiết lập WhatsApp: Trên màn hình Bảng điều khiển ứng dụng, chọn WhatsApp và chọn “Thiết lập”. Image440 Chọn Trang quản lý tài sản doanh nghiệp: Trên thanh công cụ bên trái, chọn WhatsApp > Bắt đầu nhanh (Quickstart). Chọn Trang quản lý tài sản doanh nghiệp và ấn “Tiếp tục (Continue)”. Image441

​
Bước 3. Điền thông tin vào mục Cài đặt của WhatsApp

Trên thanh công cụ bên trái, chọn WhatsApp > Cấu hình. Điền Callback URL Truy cập AI Agent > Deploy > WhatsApp, sao chép phần Đường dẫn. Image442 Điền Đường dẫn vừa sao chép vào mục URL gọi lại trên WhatsApp. Image443 Điền Mã xác minh (Verify token) Truy cập AI Agent > Deploy > WhatsApp, sao chép phần Khóa bí mật. Image444 Điền Khóa bí mật vừa sao chép vào mục Xác minh mã, sau đó ấn Xác minh và Lưu. Image445 Chuyển trạng thái message sang Đã đăng ký Trong danh sách Trường webhook, chuyển trạng thái của message sang Đã đăng ký. Image446

​
Bước 4. Điền thông tin tích hợp trên AI Agent

Điền ID ứng dụng và Khóa bí mật của ứng dụng Truy cập vào ứng dụng trên https://developers.facebook.com/apps, trên thanh công cụ bên trái vào Cài đặt ứng dụng > Thông tin cơ bản. Sao chép ID ứng dụng và Khóa bí mật của ứng dụng trên WhatsApp. Image447 Truy cập AI Agent > Deploy > WhatsApp, điền giá trị đã sao chép vào 2 trường tương ứng. Image448 Điền ID tài khoản doanh nghiệp và ID số điện thoại Truy cập vào ứng dụng trên https://developers.facebook.com/apps, trên thanh công cụ bên trái vào WhatsApp > Thiết lập API. Sao chép ID số điện thoại và ID tài khoản doanh nghiệp trên WhatsApp. Image449 Truy cập AI Agent > Deploy > WhatsApp, điền giá trị đã sao chép vào 2 trường tương ứng. Image450

​
Bước 5. Điền thông tin Access Token

FPT AI Agent sẽ xác minh và chấp nhận Long-term access token từ WhatsApp. Bạn có thể tạo Người dùng hệ thống trong Meta Business Suite và tạo mã truy cập cho Người dùng hệ thống, với thời hạn hiệu lực có thể được đặt thành 60 ngày hoặc vĩnh viễn. Tạo người dùng hệ thống Truy cập trang https://business.facebook.com/settings/system-users và đăng nhập. Trong thanh công cụ bên trái chọn Người dùng > Người dùng hệ thống, ấn + Thêm. Image451 Điền System user name và chọn System user role, ấn Create system user để xác nhận tạo Người dùng. Image452 Chỉ định tài sản cho người dùng vừa tạo Chọn người dùng vừa tạo, ấn ”…” và chọn Chỉ định tài sản. Image453 Trong mục Ứng dụng, chọn ứng dụng và chỉ định quyền như mong muốn. Image454 Trong mục Tài khoản WhatsApp, chọn tài khoản và chỉ định quyền Toàn quyền kiểm soát, ấn Chỉ định tài sản. Image455 Sau khi chỉ định, tài sản sẽ hiển thị trên màn hình chi tiết Người dùng. Image456 Tạo mã long-term access token Trong chi tiết người dùng, chọn Tạo mã. Image457 Chọn ứng dụng tạo mã (ứng dụng tích hợp với AI Agent), ấn Tiếp. Image458 Chọn thời gian hết hạn của mã: 60 ngày hoặc Không bao giờ, tùy theo nhu cầu.
  • Nếu muốn kết nối lâu dài, nên chọn Không bao giờ.
  • Trong trường hợp chọn thời gian hết hạn trong 60 ngày, 60 ngày sau khi kết nối sẽ lỗi do token không tự động gia hạn. Để tiếp tục sử dụng, người dùng nên hủy kết nối và kết nối lại.
Image459 Chọn các quyền sau rồi chọn Tạo mã:
  • whatsapp_business_management
  • whatsapp_business_messaging
  • business_management
  • public_profile
Image460 Sao chép mã và ấn Xong.
Mã chỉ hiển thị một lần duy nhất. Cần sao chép và lưu trữ ngay sau khi tạo.
Image461 Điền mã đã sao chép vào mục Access Token trên AI Agent. Image462

​
Bước 6. Ấn Kết nối trên AI Agent

Kiểm tra thông tin và ấn Kết nối trên AI Agent. Sau khi kết nối, truy cập cấu hình WhatsApp và chọn Chuyển hướng trang để truy cập đường dẫn chat trên WhatsApp. Image463
Do giới hạn của WhatsApp chỉ cho phép hiển thị tối đa 3 nút bấm (button). Vì vậy, khi cấu hình AI Agent, người dùng cần lưu ý để thiết kế nội dung và luồng tương tác phù hợp.

​
Hủy kết nối WhatsApp

Để hủy kết nối WhatsApp, truy cập AI Agent > Deploy. Trong mục đã cấu hình, chọn WhatsApp, chọn Ngắt kết nối. Image464