> ## 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. # Tích hợp Whatsapp #### 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