Bắt đầu
Tài liệu này mô tả các bước và yêu cầu mà bạn cần hoàn tất để tích hợp quy trình Đăng ký được nhúng vào trang web hoặc cổng thông tin khách hàng của mình.
Trước khi bạn bắt đầu
Để bắt đầu tích hợp quy trình Đăng ký được nhúng, trước tiên, bạn cần thiết lập Trình quản lý kinh doanh và ứng dụng trên Meta.
Trình quản lý kinh doanh
Bạn cần có tài khoản Trình quản lý kinh doanh để quản lý hạn mức tín dụng và Tài khoản WhatsApp Business (WABA) của khách hàng đã tích hợp. Để biết thông tin về cách tạo tài khoản kinh doanh, hãy xem phần Tạo Trình quản lý kinh doanh. Sau khi thiết lập Trình quản lý kinh doanh, hãy xác minh doanh nghiệp của bạn.
Ứng dụng trên Meta
Từ tài khoản nhà phát triển của bạn trên Meta, hãy tạo một ứng dụng thuộc loại Kinh doanh. Trong Bảng điều khiển ứng dụng, bạn có thể truy cập vào bất kỳ ứng dụng nào của mình trên Meta để kiểm soát chế độ cài đặt và yêu cầu quyền.
Các ứng dụng dành cho Doanh nghiệp được tự động phê duyệt Quyền truy cập tiêu chuẩn đối với tất cả các Quyền và Tính năng được cung cấp cho loại ứng dụng dành cho Doanh nghiệp. Nhờ vậy, bạn có thể phát triển và thử nghiệm ứng dụng trong khi ở cấp độ truy cập này.
Quyền truy cập tiêu chuẩn hạn chế một cách hiệu quả các ứng dụng dành cho Doanh nghiệp để chỉ cho phép các ứng dụng này truy cập vào dữ liệu thuộc sở hữu của người dùng có vai trò trên ứng dụng hoặc trong Doanh nghiệp. Để có thể phát hành, ứng dụng của bạn trên Meta phải trải qua quy trình Xét duyệt ứng dụng và yêu cầu Quyền truy cập nâng cao vào quyền whatsapp_business_management. Bạn nên bắt đầu quy trình này càng sớm càng tốt. Bạn không nhất thiết phải chờ triển khai xong quy trình Đăng ký được nhúng mới bắt đầu quy trình này.
Bạn cũng cần yêu cầu quyền whatsapp_business_messaging cho API Đám mây của WhatsApp vì bạn sẽ cần có quyền này để thực hiện các lệnh gọi API.
Bạn không nên yêu cầu các quyền khác ngoài 2 quyền này vì điều đó sẽ làm trì hoãn quá trình đăng ký của bạn một cách không cần thiết.
Mã truy cập
Bạn có thể sử dụng cả mã truy cập dành cho Người dùng hệ thống của Tiện ích tích hợp cho doanh nghiệp và mã truy cập dành cho Người dùng hệ thống để truy cập vào dữ liệu của khách hàng đã tích hợp. Loại mã bạn sử dụng phụ thuộc vào việc bạn đang đặt cấu hình quy trình Đăng ký được nhúng thông qua phương thức Đăng nhập bằng Facebook hay thông qua phương thức Đăng nhập bằng Facebook cho doanh nghiệp, cũng như việc bạn là Nhà cung cấp công nghệ hay Nhà cung cấp giải pháp.
Nhà cung cấp công nghệ
Mã ưu tiên dành cho Nhà cung cấp công nghệ là mã truy cập dành cho Người dùng hệ thống của Tiện ích tích hợp cho doanh nghiệp do loại mã này được cấp cho khách hàng cá nhân. Bạn có thể lấy một trong các mã này bằng cách đổi mã mà bạn nhận được khi khách hàng hoàn tất quy trình Đăng ký được nhúng đã đặt cấu hình thông qua phương thức Đăng nhập bằng Facebook cho doanh nghiệp. Nếu đang dùng quy trình Đăng ký được nhúng đã đặt cấu hình thông qua phương thức Đăng nhập bằng Facebook (không khuyên dùng), bạn phải sử dụng mã truy cập dành cho Người dùng hệ thống.
Nếu sử dụng mã truy cập dành cho Người dùng hệ thống, Người dùng hệ thống phải cấp cho ứng dụng của bạn quyền whatsapp_business_management.
Đối tác giải pháp
Bạn phải sử dụng mã truy cập dành cho Người dùng hệ thống để chia sẻ hạn mức tín dụng của mình với khách hàng đã tích hợp. Đối với tất cả yêu cầu khác, giải pháp ưu tiên là sử dụng mã truy cập dành cho Người dùng hệ thống của Tiện ích tích hợp cho doanh nghiệp.
Bạn có thể lấy mã truy cập dành cho Người dùng hệ thống của Tiện ích tích hợp cho doanh nghiệp bằng cách đổi mã mà bạn nhận được khi khách hàng hoàn tất quy trình Đăng ký được nhúng đã đặt cấu hình thông qua phương thức Đăng nhập bằng Facebook cho doanh nghiệp. Nếu đang dùng quy trình Đăng ký được nhúng đã đặt cấu hình thông qua phương thức Đăng nhập bằng Facebook (không khuyên dùng), bạn phải sử dụng mã truy cập dành cho Người dùng hệ thống.
Lưu ý rằng đối với mã truy cập dành cho Người dùng hệ thống, người dùng hệ thống phải được cấp quyền whatsapp_business_management trên ứng dụng (bạn có thể cấp quyền này khi tạo mã). Bạn phải cấp cho Người dùng hệ thống vai trò Người phụ trách thông tin tài chính để họ có thể chia sẻ hạn mức tín dụng của bạn với khách hàng đã tích hợp.
Cách cấp vai trò Người phụ trách thông tin tài chính cho người dùng hệ thống:
- Đăng nhập vào Meta Business Suite.
- Tìm tài khoản kinh doanh của bạn trong menu thả xuống ở trên cùng bên trái rồi nhấp vào biểu tượng Cài đặt (bánh răng).
- Nhấp vào Cài đặt cho doanh nghiệp.
- Điều hướng đến Người dùng > Người dùng hệ thống.
- Chỉnh sửa và cấp cho người dùng vai trò Người phụ trách thông tin tài chính.
Hạn mức tín dụng
Bạn cần thiết lập hạn mức tín dụng để gửi tin nhắn bằng Nền tảng WhatsApp Business. Đây là hạn mức tín dụng mà bạn sẽ chia sẻ với khách hàng. Vì vậy, hãy nhớ chấp nhận các điều khoản API Phân bổ tín dụng trong Cài đặt cho doanh nghiệp > Thanh toán trong Trình quản lý kinh doanh.
Để biết thông tin về cách chia sẻ hạn mức tín dụng qua Trình quản lý kinh doanh, thay vì qua API, hãy xem phần Chia sẻ quyền truy cập vào tính năng lập hóa đơn hàng tháng.
Ứng dụng API Tại chỗ của Nền tảng WhatsApp Business
Nếu bạn đang sử dụng API Tại chỗ, hãy đảm bảo rằng bạn đang chạy phiên bản chưa hết hạn của ứng dụng API WhatsApp Business.
Quy trình tích hợp
Trong quy trình tích hợp, ứng dụng của bạn trên Meta phải trải qua quy trình Xét duyệt ứng dụng và yêu cầu Quyền truy cập nâng cao vào quyền whatsapp_business_management. Bạn nên bắt đầu quy trình này càng sớm càng tốt. Bạn không nhất thiết phải chờ triển khai xong quy trình Đăng ký được nhúng mới bắt đầu quy trình này.
1: Nhúng quy trình đăng ký
Thiết lập Facebook JavaScript SDK và phương thức Đăng nhập bằng Facebook để nhúng quy trình đăng ký vào trang web hoặc cổng thông tin khách hàng của bạn. Bạn có thể nhúng quy trình này vào nhiều trang web hoặc cổng thông tin của mình.
2: Tích hợp với các điểm cuối bắt buộc
Sau khi nhúng quy trình đăng ký, hãy tích hợp với các điểm cuối API cần để hoàn tất quy trình tích hợp. Để chuyển sang bước tiếp theo, bạn phải có khả năng:
Sau khi hoàn tất quy trình đăng ký, hãy sử dụng điểm cuối message_templates để tải mẫu tin nhắn được phê duyệt trước và vùng tên để doanh nghiệp có thể bắt đầu gửi tin nhắn.
Bạn phải sử dụng điểm cuối được bảo mật (HTTPS). Để biết thêm thông tin, hãy xem phần Bảo mật đăng nhập.
3: Đăng ký WABA để nhận webhook
Sau khi doanh nghiệp hoàn tất quy trình đăng ký, bạn có thể đăng ký mọi WABA mà bạn muốn nhận webhook. Bạn có thể thiết lập webhook để nhận được thông báo khi:
- tên của một số điện thoại được cập nhật,
- trạng thái chất lượng của một số điện thoại được cập nhật và
- một tài khoản được xét duyệt, nâng cấp hoặc bị cấm.
Không bắt buộc
Nếu muốn, bạn có thể: