WhatsApp¶
WhatsApp là ứng dụng nhắn tin tức thời và thoại qua IP cho phép người dùng gửi tin nhắn, thực hiện cuộc gọi và chia sẻ nội dung. Các doanh nghiệp có thể sử dụng WhatsApp Business để giao tiếp với khách hàng bằng tin nhắn, gửi tài liệu và cung cấp hỗ trợ.
Cảnh báo
WhatsApp là ứng dụng chỉ dành cho SoOn Enterprise và không hoạt động trong phiên bản Cộng đồng SoOn. Để đăng ký phiên bản SoOn Enterprise, hãy nhấp vào đây: Dùng thử miễn phí SoOn.
Xem thêm
Để biết thêm thông tin về việc di chuyển từ phiên bản Cộng đồng SoOn sang phiên bản SoOn Enterprise, hãy xem tài liệu này: /administration/on_tiền đề/community_to_enterprise.
Với ứng dụng SoOn WhatsApp, công ty có thể kết nối Tài khoản WhatsApp Business (WABA) với cơ sở dữ liệu SoOn, cho phép thực hiện những điều sau:
Nhận và trả lời tin nhắn WhatsApp trực tiếp từ cơ sở dữ liệu SoOn
Tạo mẫu mới với trình giữ chỗ/biến động
Gửi các mẫu được phê duyệt trước sử dụng các biến động, chẳng hạn như:
Báo giá từ ứng dụng Bán hàng
Biên lai và hóa đơn từ ứng dụng Điểm bán hàng
Vé từ ứng dụng Sự kiện
Xem thêm
WhatsApp là dịch vụ nhắn tin được điều hành bởi Meta, công ty mẹ của Facebook. WhatsApp thường được sử dụng làm công cụ liên lạc ở nhiều quốc gia và nhiều doanh nghiệp. Tài liệu này sẽ đề cập đến việc tích hợp Tài khoản WhatsApp Business với SoOn. Tài khoản Meta của công ty được định cấu hình trong SoOn thông qua kết nối API.
Trình kết nối WhatsApp hỗ trợ hai luồng: do công ty khởi xướng và do khách hàng khởi xướng. Một công ty có thể bắt đầu cuộc thảo luận bằng cách gửi mẫu cho một hoặc nhiều người. Sau khi mẫu được gửi, người nhận có thể trả lời để kích hoạt cuộc thảo luận giữa người gửi và người nhận (cửa sổ trò chuyện Thảo luận sẽ bật lên nếu khách hàng trả lời trong vòng 15 ngày).
Nếu cuộc thảo luận do khách hàng khởi xướng (ví dụ: bằng cách gửi tới số WhatsApp công khai của công ty), thì SoOn sẽ mở một cuộc trò chuyện nhóm với tất cả các nhà điều hành chịu trách nhiệm về kênh WhatsApp này.
Mẹo
Bạn nên thiết lập nhiều tài khoản WhatsApp cho các bộ phận khác nhau. Ví dụ: nhóm trợ giúp và nhóm bán hàng có thể trò chuyện trên các kênh khác nhau.
Cấu hình WhatsApp trong Meta¶
Việc tích hợp WhatsApp với SoOn sử dụng kết nối API tiêu chuẩn và được định cấu hình trên Meta theo các bước sau:
Tạo tài khoản doanh nghiệp Meta
Tạo tài khoản nhà phát triển Meta
Thiết lập ứng dụng và sản phẩm WhatsApp trên bảng điều khiển dành cho nhà phát triển của Meta
Kiểm tra kết nối API.
Sau khi kết nối, tin nhắn sẽ được gửi và nhận thông qua ứng dụng Thảo luận của SoOn bằng cách sử dụng WhatsApp API.
Thiết lập tài khoản doanh nghiệp Meta¶
Để tạo tài khoản Doanh nghiệp với Meta (chủ sở hữu Facebook), hãy điều hướng đến: Trình quản lý doanh nghiệp Facebook. Bắt đầu bằng cách nhấp vào Tạo tài khoản rồi nhập tên doanh nghiệp, tên quản trị viên và địa chỉ email cơ quan. Sau đó nhấp vào Next, và một cửa sổ bật lên sẽ xuất hiện nhắc bạn xác nhận địa chỉ email. Sau khi xác nhận, nhấn Done để đóng cửa sổ.
Tiếp theo, hãy làm theo hướng dẫn trong email do Facebook gửi để xác nhận việc tạo tài khoản doanh nghiệp và hoàn tất quá trình thiết lập.
Quan trọng
Nếu tài khoản doanh nghiệp được liên kết với tài khoản Facebook cá nhân thì quản trị viên phải chuyển đổi giữa tài khoản cá nhân sang tài khoản doanh nghiệp trong phần còn lại của cấu hình.
Để chuyển sang tài khoản doanh nghiệp, hãy điều hướng đến Bảng điều khiển dành cho nhà phát triển Facebook và nhấp vào tên tài khoản ở góc trên bên phải. Trong tiêu đề Tài khoản doanh nghiệp, hãy nhấp vào doanh nghiệp mong muốn mà cấu hình WhatsApp sẽ diễn ra. Đây sẽ là tài khoản mà SoOn sẽ gửi và nhận tin nhắn WhatsApp.
Quan trọng
Để tạo tài khoản doanh nghiệp Meta, người dùng phải có tài khoản Facebook cá nhân đã tồn tại tối thiểu một giờ trước khi thiết lập tài khoản Facebook Business. Việc cố gắng tạo tài khoản doanh nghiệp trước thời điểm này sẽ dẫn đến lỗi.
Tạo ứng dụng¶
Trên bảng điều khiển Meta dành cho nhà phát triển, đăng nhập bằng tài khoản nhà phát triển Meta. Nếu chưa có tài khoản nào được định cấu hình, hãy liên kết tài khoản Facebook để tạo tài khoản nhà phát triển Meta.
Ghi chú
Tài khoản nhà phát triển Facebook khác với tài khoản Facebook doanh nghiệp. Mặc dù tài khoản nhà phát triển được tạo thành từ tài khoản Facebook cá nhân, nhưng tài khoản doanh nghiệp không vì chúng đại diện cho một doanh nghiệp và quản lý tất cả tài sản của doanh nghiệp trong Meta, chẳng hạn như ứng dụng.
Nhấp vào My Apps ở góc trên cùng bên phải sau khi đăng nhập thành công vào tài khoản nhà phát triển Meta. Điều này sẽ chuyển hướng quản trị viên đến tất cả các ứng dụng mà nhà phát triển đã định cấu hình trong tài khoản nhà phát triển cụ thể này. Nhấp vào Create App để bắt đầu quá trình định cấu hình ứng dụng Meta mới.
Loại ứng dụng¶
Trên trang , chọn Other trong phần được gắn nhãn, Đang tìm kiếm nội dung khác?, rồi nhấp vào Tiếp theo để được chuyển hướng đến một trang khác để chọn loại ứng dụng. Sau đó, nhấp vào tùy chọn đầu tiên được liệt kê dưới nhãn Select an app type, có tiêu đề Business. Lựa chọn này cho phép tạo và quản lý WhatsApp API.
Bây giờ, hãy nhấp vào Next để định cấu hình ứng dụng như mong muốn. Khi loại ứng dụng đã được định cấu hình, quản trị viên sẽ chuyển sang phần chi tiết ứng dụng.
Chi tiết về ứng dụng¶
Trên phần Details của quy trình Tạo ứng dụng, nhập SoOn vào trường dưới nhãn Thêm tên ứng dụng.
Ghi chú
Tên ứng dụng có thể được thay đổi sau này trong cài đặt, nếu cần.
Cảnh báo
Các nhãn hiệu và thành phần thương hiệu không được phép sử dụng trong phần văn bản này. Chúng bao gồm nhóm các công ty Meta. Không bao gồm từ: WhatsApp nếu không hệ thống sẽ gắn cờ lỗi này.
Tiếp theo, nhập địa chỉ email của nhà phát triển vào trường bên dưới nhãn App contact email.
Cuối cùng, đặt trường Tài khoản doanh nghiệp - Tùy chọn thành hồ sơ tài khoản doanh nghiệp Meta, sử dụng menu thả xuống. Để hoàn tất, hãy nhấp vào Tạo ứng dụng. Hành động này sẽ tạo ứng dụng và nhắc đến các thỏa thuận Điều khoản của nền tảng Meta và Chính sách dành cho nhà phát triển.
Để chấp nhận các thỏa thuận, hãy nhập mật khẩu Facebook vì mục đích bảo mật và nhấp vào Gửi để hoàn tất quá trình tạo ứng dụng. Sau đó, trình duyệt sẽ chuyển hướng đến bảng điều khiển Meta for Developers.
Ghi chú
Nếu tài khoản doanh nghiệp Meta bị cấm quảng cáo thì việc xác nhận quyền sở hữu một ứng dụng sẽ không được phép. Để giải quyết vấn đề này, hãy truy cập https://business.facebook.com/business để được hỗ trợ.
Để biết thêm thông tin, hãy xem Tài liệu của Meta về các hạn chế quảng cáo.
Thêm sản phẩm WhatsApp vào ứng dụng¶
Bây giờ cấu trúc cơ bản của ứng dụng đã được tạo, bạn sẽ cần thêm một sản phẩm vào ứng dụng. Bắt đầu bằng cách truy cập trang tổng quan ứng dụng Meta bằng cách điều hướng đến https://developers.facebook.com/apps và nhấp vào ứng dụng đang được định cấu hình.
Trên trang tiếp theo: vì WhatsApp sẽ được sử dụng, hãy nhấp vào Set up bên cạnh hộp chứa WhatsApp, nằm ở cuối trang.
Sau đó, trang này sẽ chuyển hướng đến trang cấu hình cho API nền tảng kinh doanh WhatsApp. Sử dụng menu thả xuống để chọn doanh nghiệp Meta sẽ được định cấu hình cho tùy chọn Chọn tài khoản Meta Business, sau đó nhấp vào Tiếp tục để xác nhận lựa chọn.
Ghi chú
Khi Tiếp tục được nhấp vào, quản trị viên đồng ý với các điều khoản và điều kiện của Meta như được liên kết trên Bảng điều khiển ứng dụng Meta.
Ghi chú
Sau khi sản phẩm WhatsApp được thêm vào ứng dụng, Meta sẽ cung cấp số điện thoại thử nghiệm WhatsApp cùng với 5 tin nhắn thử nghiệm.
Bắt đầu sử dụng API WhatsApp¶
Sau khi hoàn thành trình hướng dẫn sản phẩm WhatsApp trước đó và nhấp vào Tiếp tục, trình duyệt sẽ được chuyển hướng đến trang WhatsApp Quickstart; Trang Quickstart này là nơi bắt đầu định cấu hình API WhatsApp bằng cách thêm số điện thoại rồi gửi tin nhắn thử nghiệm ban đầu.
Ghi chú
Nếu trình duyệt không có trên trang Quickstart dành cho WhatsApp, hãy điều hướng đến https://developers.facebook.com/apps và nhấp vào ứng dụng đang được định cấu hình, (tên ứng dụng là SoOn nếu làm theo hướng dẫn ở trên).
Sau đó, trong menu ở phía bên trái của trang, hãy nhấp vào biểu tượng v (chuyển đổi menu) bên cạnh tiêu đề phần WhatsApp. Một menu nhỏ sẽ mở ra, chứa các tùy chọn sau:
Bắt đầu nhanh
Cài đặt API
Cấu hình
Nhấp vào tùy chọn Quickstart, sau đó nhấp vào Start use the API.
Thiết lập API¶
Sau khi nhấp vào Bắt đầu sử dụng API, trang sẽ điều hướng đến API Setup. Bây giờ số kiểm tra đã được tạo, một tin nhắn kiểm tra có thể được gửi để xác nhận rằng WhatsApp đang hoạt động bình thường. Để bắt đầu, hãy điều hướng đến phần trên trang có nhãn Gửi và nhận tin nhắn và nhấp vào menu thả xuống bên cạnh To, trong Bước 1 Chọn số điện thoại.
Bây giờ, hãy chọn tùy chọn duy nhất có sẵn: Quản lý danh sách số điện thoại. Làm theo các bước và cộng tối đa năm số để gửi tin nhắn kiểm tra miễn phí tới. Sau khi nhập mã quốc gia và số điện thoại phù hợp, nhấp vào Next.
Quan trọng
Việc thêm số điện thoại để gửi đến trong bước này sẽ cho phép thiết bị đầu cuối gửi thử nghiệm thành công. Điều này rất quan trọng để đảm bảo WhatsApp API đang hoạt động.
Sau đó, mã xác minh từ WhatsApp Business sẽ được gửi đến số điện thoại cần được nhập trên màn hình tiếp theo để xác minh quyền sở hữu số đó. Nhập mã xác minh và nhấp vào Next để xác minh số.
Gửi tin nhắn thử nghiệm qua thiết bị đầu cuối¶
Tiếp theo, gửi tin nhắn kiểm tra qua thiết bị đầu cuối. Trong phần có nhãn Bước 2 Gửi tin nhắn bằng API, nhấp vào Gửi tin nhắn. Sau đó, một tin nhắn kiểm tra sẽ được gửi đến số điện thoại đã thiết lập ở phần trước.
Sau khi nhận được tin nhắn tới số thành công, hãy chuyển sang phần tiếp theo để tạo và định cấu hình webhook.
Cấu hình WhatsApp trong SoOn¶
Các bước tiếp theo được định cấu hình trong phần này đều nằm trong cơ sở dữ liệu SoOn. Một vài giá trị khác nhau cho mã thông báo, số điện thoại và ID tài khoản đều cần được định cấu hình trong SoOn; những giá trị này là cần thiết để tạo Callback URL và Webhook Verify Token, sau đó được sử dụng để định cấu hình webhook (để nhận tin nhắn trở lại cơ sở dữ liệu).
Trong SoOn, điều hướng đến . Sau đó nhấp vào Mới để định cấu hình tài khoản doanh nghiệp WhatsApp trong SoOn.
Trong tab trình duyệt khác, điều hướng đến , sau đó sao chép các giá trị sau từ bảng điều khiển dành cho nhà phát triển Meta vào bảng điều khiển tương ứng các trường trong SoOn:
Tên |
Bảng điều khiển Meta |
Giao diện SoOn |
|---|---|---|
Điện thoại |
ID số điện thoại |
ID số điện thoại |
Mã thông báo |
Mã thông báo truy cập tạm thời |
Mã thông báo truy cập |
ID ứng dụng |
ID ứng dụng |
ID ứng dụng |
ID tài khoản |
ID tài khoản doanh nghiệp WhatsApp |
ID tài khoản |
Để truy xuất App Secret, hãy điều hướng đến bảng điều khiển dành cho nhà phát triển Meta, https://developers.facebook.com/apps và chọn ứng dụng mà SoOn đang được định cấu hình. Sau đó, ở bên trái- menu bên, trong Cài đặt ứng dụng, chọn Cơ bản.
Tiếp theo, nhấp vào Show bên cạnh trường App secret và nhập mật khẩu tài khoản để xác minh quyền sở hữu. Sao chép App secret rồi dán giá trị đã sao chép đó vào trường App Secret trên bảng điều khiển cấu hình SoOn WhatsApp Business Account.
Để hoàn tất quá trình thiết lập tài khoản doanh nghiệp WhatsApp trong SoOn, hãy nhấp vào Test Connection. Thông báo thành công màu xanh lục sẽ xuất hiện ở góc trên bên phải của trang tổng quan nếu cấu hình được đặt chính xác.
Định cấu hình webhook¶
Để định cấu hình webhooks cho WhatsApp trong SoOn, hãy điều hướng đến https://developers.facebook.com/apps và chọn ứng dụng mà SoOn đang được định cấu hình. Tiếp theo trong menu WhatsApp hướng tới ở bên trái màn hình, nhấp vào mục menu API Setup. Cuối cùng đi đến phần được đánh dấu Bước 3: Định cấu hình webhooks để nhận tin nhắn và nhấp vào Định cấu hình webhooks.
Mẹo
Một cách khác để định cấu hình Webhooks là điều hướng đến https://developers.facebook.com/apps và chọn ứng dụng mà SoOn đang được định cấu hình. Sau đó chọn Webhooks ở tay trái thực đơn.
Trên trang , nhấp vào Edit, trong đó cả hai giá trị Callback URL và Webhook Verify Token từ SoOn sẽ được thêm vào.
Ghi chú
Cả hai giá trị Callback URL và Webhook Verify Token đều được tự động điền sau khi nhấp vào Test Connection ở bước trước.
Trong một cửa sổ trình duyệt riêng, truy xuất các giá trị cần thiết trong SoOn bằng cách điều hướng đến và chọn tài khoản đang được định cấu hình. Xác định vị trí các giá trị trong phần có nhãn Nhận tin nhắn.
Sao chép và dán Callback URL từ SoOn vào trường Callback URL trong Meta. Tương tự, sao chép và dán Webhook Verify Token vào trường Verify Token trên bảng điều khiển dành cho nhà phát triển Meta.
Cuối cùng, nhấp vào Xác minh và lưu để ghi lại các giá trị trong bảng điều khiển dành cho nhà phát triển Meta.
Trường webhook¶
Bây giờ hãy nhập các trường webhook riêng lẻ vào bảng điều khiển dành cho nhà phát triển của Meta, trong phần Webhook field. Nhấp vào Quản lý và khi cửa sổ bật lên xuất hiện, hãy chọn các hộp trong cột Subscribe cho các tên trường sau:
cập nhật tài khoản
message_template_quality_update
message_template_status_update
tin nhắn
mẫu_category_update
Sau khi thực hiện các lựa chọn, hãy nhấp vào Done.
Cấu hình Webhooks đã hoàn tất sẽ xuất hiện như thế này trong bảng điều khiển dành cho nhà phát triển Meta:
Quan trọng
Trường Webhook sẽ chỉ xuất hiện sau khi đăng ký được xác nhận bằng cách sử dụng URL gọi lại và Mã thông báo xác minh Webhook.
Thêm số điện thoại¶
Để định cấu hình số điện thoại sẽ sử dụng cho WhatsApp trong SoOn, hãy quay lại bảng điều khiển dành cho nhà phát triển Meta (https://developers.facebook.com/apps) và chọn lại ứng dụng mà SoOn đang được định cấu hình. Trong tiêu đề menu WhatsApp ở bên trái màn hình, nhấp vào mục menu API Setup. Từ đó, đi đến phần được đánh dấu: Bước 5: Thêm số điện thoại và nhấp vào Thêm số điện thoại.
Trong các trường, hãy nhập Tên doanh nghiệp cũng như Trang web hoặc trang hồ sơ doanh nghiệp.
Mẹo
Trường Trang web doanh nghiệp hoặc trang hồ sơ có thể là URL của trang mạng xã hội.
Hoàn tất việc điền thông tin doanh nghiệp bằng cách tiếp theo chọn quốc gia mà công ty kinh doanh từ menu thả xuống trong phần Quốc gia. Thêm địa chỉ nếu muốn, tuy nhiên thông tin này là tùy chọn. Sau khi thêm vị trí, nhấp vào Next để tiếp tục.
Trang sau chứa thông tin về Hồ sơ WhatsApp Business. Hoàn thành các phần sau cho phù hợp:
Tên hiển thị hồ sơ doanh nghiệp WhatsApp
Múi giờ
Danh mục
Mô tả doanh nghiệp (tùy chọn)
Khi các phần này hoàn tất, hãy nhấp vào Next. Trang này sẽ làm mới và sau đó nhắc quản trị viên Thêm số điện thoại cho WhatsApp trong trường tương ứng. Tại đây, nhập số điện thoại để định cấu hình trong WhatsApp.
Xem thêm
Di chuyển số WhatsApp hiện có sang tài khoản doanh nghiệp <https://developers.facebook.com/docs/whatsapp/cloud-api/get-started/migrate-ex hiện-whatsapp- number-to-a-business-account> _.
Tiếp theo, chọn phương thức xác minh cho số điện thoại. Chọn Tin nhắn văn bản hoặc Phone call, sau đó nhấp vào Tiếp theo để tiếp tục.
Số điện thoại đã nhập sẽ nhận được tin nhắn văn bản hoặc cuộc gọi từ WhatsApp kèm theo mã, tùy thuộc vào phương thức xác minh đã chọn. Nhập mã xác minh đó vào trường Mã xác minh và nhấp vào Tiếp theo để hoàn tất.
Cảnh báo
Nếu phương thức thanh toán chưa được thêm thì bạn cần phải tiếp tục. Truy cập tài liệu của Meta về cách thêm phương thức thanh toán trong Trình quản lý doanh nghiệp của Meta. Đây là một phần của hệ thống phát hiện gian lận của Meta, để đảm bảo rằng tài khoản/công ty là thật, cần có phương thức thanh toán để tiếp tục.
Mã thông báo vĩnh viễn¶
Sau khi hoàn tất cấu hình và kiểm tra, một mã thông báo vĩnh viễn sẽ được tạo để thay thế Mã thông báo tạm thời.
Bắt đầu bằng cách điều hướng đến https://business.facebook.com/ rồi đi tới . Chọn người dùng hệ thống hiện có hoặc tạo người dùng hệ thống mới bằng cách nhấp vào Add.
Tài sản bây giờ phải được thêm vào người dùng hệ thống và sau đó có thể tạo mã thông báo vĩnh viễn.
Nhấp vào Thêm nội dung và khi cửa sổ bật lên xuất hiện, hãy chọn Apps bên dưới Chọn loại nội dung. Sau đó, chọn ứng dụng SoOn và chuyển quyền sang Bật trong tùy chọn Kiểm soát hoàn toàn. Đặt cài đặt quyền mới này bằng cách nhấp vào Save Changes, cửa sổ xác nhận sẽ xuất hiện, xác nhận việc bổ sung nội dung cho người dùng hệ thống. Kết thúc bằng cách nhấp vào Done.
Tiếp theo, mã thông báo vĩnh viễn sẽ được tạo. Nhấp vào Tạo mã thông báo mới và một cửa sổ bật lên sẽ xuất hiện hỏi xem mã thông báo này sẽ được tạo cho ứng dụng nào. Chọn App mà mã thông báo này dành cho. Sau đó xác định ngày hết hạn của 60 ngày hoặc Never.
Cuối cùng, khi Meta hỏi người dùng hệ thống nên cho phép những quyền nào, hãy thêm tất cả các quyền sau:
WhatsApp_business_messaging
WhatsApp_business_quản lý
Khi quyền được đặt, hãy nhấp vào Tạo mã thông báo. Sao chép giá trị mã thông báo xuất hiện trên màn hình tiếp theo.
Với giá trị mã thông báo đó, hãy cập nhật trường Access Token trong tài khoản doanh nghiệp WhatsApp trong SoOn bằng cách điều hướng đến .
Phát trực tiếp với ứng dụng Meta¶
Cuối cùng, để khởi chạy ứng dụng, ứng dụng Meta phải được đặt thành Live trong bảng điều khiển dành cho nhà phát triển Meta. Điều hướng đến https://developers.facebook.com/apps và nhấp vào ứng dụng đang được định cấu hình. Ở menu trên cùng, chuyển đổi trường Chế độ ứng dụng từ Development thành Live.
Quan trọng
Nếu trạng thái ứng dụng không được đặt thành trực tiếp thì cơ sở dữ liệu sẽ chỉ có thể liên hệ với các số thử nghiệm được chỉ định trong bảng điều khiển dành cho nhà phát triển.
Cảnh báo
URL chính sách quyền riêng tư phải được đặt để ứng dụng có thể hoạt động. Đi tới bảng điều khiển dành cho nhà phát triển Meta, https://developers.facebook.com/apps và chọn ứng dụng mà SoOn đang được định cấu hình. Sau đó, sử dụng menu ở bên trái màn hình, đi tới: lựa chọn menu:Cài đặt ứng dụng --> Cơ bản. Sau đó, nhập địa chỉ siêu liên kết chính sách quyền riêng tư trong trường URL chính sách quyền riêng tư của biểu mẫu. Nhấp vào Save Changes để áp dụng chính sách quyền riêng tư cho ứng dụng.
Sau khi ứng dụng xuất hiện trực tuyến trong bảng điều khiển dành cho nhà phát triển Meta, email xác nhận sẽ được gửi tới quản trị viên.
Mẫu WhatsApp¶
Mẫu WhatsApp là các tin nhắn đã lưu được sử dụng nhiều lần để gửi tin nhắn từ cơ sở dữ liệu. Chúng cho phép người dùng gửi thông tin liên lạc chất lượng mà không cần phải soạn đi soạn lại cùng một văn bản.
Việc tạo các mẫu khác nhau phù hợp với các tình huống cụ thể cho phép người dùng chọn đúng thông điệp cho đúng đối tượng. Điều này làm tăng chất lượng của tin nhắn và tỷ lệ tương tác tổng thể với khách hàng.
Mẫu WhatsApp có thể được tạo trên cả bảng điều khiển SoOn và Meta. Quy trình sau đây sẽ tổng quan về quy trình tạo mẫu trong SoOn và sau đó là trong Meta.
Quan trọng
WhatsApp có quy trình phê duyệt phải được hoàn thành trước khi có thể sử dụng mẫu. năng suất/whatsapp/phê duyệt.
Tạo mẫu trong SoOn¶
Để truy cập và tạo mẫu WhatsApp, hãy bắt đầu bằng cách điều hướng đến bảng điều khiển .
Ở cuối biểu mẫu của một mẫu riêng lẻ, có ba tab: Body, Buttons, và Variables; ba tab này kết hợp sẽ tạo ra mẫu WhatsApp.
Văn bản được nhập vào tab Body và nội dung động được gọi ra trong tab Body được chỉ định trong tab Variables. Mỗi phần nội dung động (ví dụ: phần giữ chỗ) trong tin nhắn (nội dung) được gọi ra và chỉ định cụ thể trong tab Variables.
Mẫu là các bố cục được tạo sẵn cho phép người dùng gửi tin nhắn có giao diện chuyên nghiệp tới khách hàng. Các mẫu này có khả năng chứa dữ liệu động sẽ xuất hiện trong thông báo kết thúc bằng cách sử dụng các biến được đặt trong cấu hình mẫu. Ví dụ: tin nhắn có thể chứa tên người dùng cuối, gọi tên các sản phẩm cụ thể hoặc tham chiếu đơn đặt hàng để đặt tên cho một số biến thuận tiện và có tác động.
Để tạo mẫu WhatsApp, hãy đi tới và nhấp vào Mới. Trên biểu mẫu, nhập Name cho mẫu và chọn Language.
Quan trọng
Để hoàn thành nhiệm vụ tiếp theo này, cần có quyền truy cập của quản trị viên để chỉnh sửa trường Applies to. Hãy xem tài liệu về quyền truy cập để biết thêm thông tin.
Trong menu thả xuống Account, hãy chọn tài khoản doanh nghiệp WhatsApp trong SoOn mà mẫu này sẽ liên kết đến. Tiếp theo, trong trường Applies to, chọn model mà hành động của máy chủ sẽ áp dụng cho mẫu này.
Mẹo
Những mô hình này cũng có thể được truy cập trong developer mode. Trên biểu mẫu liên hệ (hoặc biểu mẫu liên quan tương tự trong SoOn), hãy điều hướng đến mô hình sẽ được tham chiếu và di chuột qua bất kỳ tên trường nào. Một hộp thông tin phụ trợ sẽ tự hiển thị với tên SoOn Model cụ thể trong phần phụ trợ. Tìm kiếm (sử dụng tên giao diện người dùng) cho mô hình này trong menu thả xuống Applies to trong mẫu WhatsApp.
Cảnh báo
Thông thường khi thay đổi kiểu máy hoặc trường Applies to, Phone Field có thể tạo ra lỗi Phone Field phải luôn được đặt thành kiểu Phone hoặc Mobile.
Để tìm kiếm các trường có sẵn, hãy nhập tên giao diện người dùng vào hộp Search.... Thao tác này sẽ tìm thấy kết quả từ tất cả các trường có sẵn cho mô hình (Applies to) mà mẫu được tạo.
Ghi chú
Để tìm các trường cụ thể, có thể cần phải điều hướng nhiều cấp độ trong hộp kết quả tìm kiếm. Sử dụng các biểu tượng > (chevron bên phải) và ⬅️ (mũi tên trái) để điều hướng giữa các cấp menu.
Thay đổi Category để phù hợp với danh mục Marketing, Utility hoặc Authentication. Trong hầu hết các trường hợp, hai tùy chọn đầu tiên sẽ được sử dụng, trừ khi người dùng muốn gửi yêu cầu đặt lại mật khẩu hoặc điều gì đó liên quan đến bảo mật. Đặt thành Marketing nếu có bất kỳ nội dung quảng cáo nào được gửi và đặt thành Utility nếu có thông báo giao dịch chung được gửi (ví dụ: đơn đặt hàng, vé sự kiện, v.v.).
Quan trọng
Việc chỉ định danh mục không chính xác có thể gây ra cờ/trạng thái bị từ chối từ Meta trong quá trình phê duyệt.
Thêm bất kỳ Users nào được phép sử dụng bản mẫu này. Trong cột bên phải, một Header type cũng có thể được định cấu hình cùng với Header message.
Các loại Các loại tiêu đề có sẵn như sau:
Chữ
Hình ảnh
Băng hình
Tài liệu
Vị trí (các biến cần được đặt)
Điều hướng đến tab Body để định cấu hình thông báo chính của mẫu.
Khi tất cả các thay đổi cần thiết được thực hiện đối với mẫu, hãy nhấp vào nút Gửi để phê duyệt ở góc trên bên trái. Điều này sẽ khiến trạng thái của mẫu thay đổi thành Đang chờ xử lý.
Trạng thái sẽ vẫn ở Đang chờ xử lý cho đến khi Meta đưa ra quyết định, theo đó, email xác nhận sẽ được gửi cho biết rằng mẫu đã được phê duyệt (hoặc bị từ chối). Sau đó, các mẫu sẽ cần được đồng bộ hóa từ cơ sở dữ liệu SoOn.
Xem phần này để biết thêm thông tin về mẫu đồng bộ hóa.
Mẹo
Có sẵn các mẫu dữ liệu demo được cấu hình sẵn trong SoOn để sử dụng hoặc sửa đổi. Các mẫu này có thể được sử dụng nguyên trạng hoặc được sửa đổi để phù hợp với nhu cầu kinh doanh cụ thể.
Để sử dụng các mẫu này, hãy điều hướng đến và chọn một mẫu được định cấu hình sẵn. Nhấp vào Gửi để phê duyệt để bắt đầu quá trình phê duyệt. Một email sẽ được gửi đến quản trị viên của tài khoản Meta khi mẫu đã được phê duyệt.
Sử dụng phần giữ chỗ và biến¶
Biến động tham chiếu các trường nhất định trong cơ sở dữ liệu SoOn để tạo ra dữ liệu duy nhất trong tin nhắn WhatsApp khi sử dụng mẫu. Các biến động được mã hóa để hiển thị các trường từ bên trong cơ sở dữ liệu, tham chiếu các trường từ bên trong mô hình.
Example
Nhiều công ty muốn tùy chỉnh tin nhắn WhatsApp của họ bằng một phần thông tin khách hàng được cá nhân hóa để thu hút sự chú ý. Điều này có thể được thực hiện trong SoOn bằng cách tham chiếu một trường trong mô hình bằng cách đặt một biến động. Ví dụ: tên của khách hàng có thể được tham chiếu trong email từ trường Customer trên mô hình Sales Order.
Các biến động có thể được thêm vào Body bằng cách thêm placeholders vào text. Để thêm phần giữ chỗ trong nội dung thư, hãy nhập văn bản sau {{1}}. Đối với phần giữ chỗ thứ hai, hãy nhập {{2}} và tăng dần khi có nhiều phần giữ chỗ hơn được thêm vào văn bản.
Example
Sau đây là nội dung từ nội dung mẫu biên nhận thanh toán:
Kính gửi {{1}},
Cảm ơn
Xem thêm
năng suất/whatsapp/templates.
Các phần giữ chỗ này phải được định cấu hình trên tab Variables của mẫu trước khi gửi để Meta phê duyệt. Để chỉnh sửa các biến động trên một mẫu, trước tiên hãy thay đổi Type thành Field of Model. Điều này cho phép SoOn tham chiếu một trường trong mô hình để tạo ra dữ liệu duy nhất trong tin nhắn được gửi.
Tiếp theo, chỉnh sửa Field của các biến động. Trường Applies to trong mẫu phải được chỉnh sửa trước để đảm bảo tham chiếu đúng mô hình và trường.
Để tìm kiếm các trường có sẵn, hãy nhập tên giao diện người dùng của trường vào hộp tìm kiếm. Thao tác này sẽ tìm thấy kết quả từ tất cả các trường có sẵn cho mô hình (Applies to) mà mẫu được tạo. Có thể có nhiều cấp độ cần được cấu hình.
Example
Sau đây là ví dụ về các biến được đặt cho phần giữ chỗ trên trong biên lai thanh toán được ghi chú ở trên:
Tên |
Giá trị mẫu |
Kiểu |
Cánh đồng |
|---|---|---|---|
cơ thể - {{1}} |
Nội thất Azure |
Lĩnh vực mô hình |
|
cơ thể - {{2}} |
INV/2022/00001 |
Lĩnh vực mô hình |
|
cơ thể - {{3}} |
Công ty của tôi |
Lĩnh vực mô hình |
|
cơ thể - {{4}} |
$ |
Lĩnh vực mô hình |
|
cơ thể - {{5}} |
4000 |
Lĩnh vực mô hình |
|
cơ thể - {{6}} |
https://.. |
Liên kết cổng thông tin |
Example
Ví dụ: trong tab Body, nếu nội dung sau được nhập, "Xin chào {{1}}," thì {{1}} phải được đặt trong tab Variables. Đối với trường hợp cụ thể này, thông báo phải chào khách hàng theo tên, do đó, {{1}} phải được định cấu hình để điền vào {{1}} Field với Customer tên.
Cảnh báo
Việc tùy chỉnh các mẫu WhatsApp nằm ngoài phạm vi hỗ trợ của SoOn.
Phê duyệt mẫu meta¶
Sau khi cập nhật các biến động trên mẫu, mẫu cần được gửi tới Meta để phê duyệt lại. Nhấp vào Gửi để phê duyệt để bắt đầu quá trình phê duyệt. Một email sẽ được gửi đến quản trị viên của tài khoản Meta khi mẫu đã được phê duyệt.
Sau khi được Meta phê duyệt, hãy đồng bộ hóa lại các mẫu trong cơ sở dữ liệu SoOn. Xem tài liệu này: Đồng bộ hóa mẫu.
Mẹo
Để xem trạng thái trên bảng điều khiển mẫu WhatsApp của Meta bằng cách điều hướng đến https://business.facebook.com/wa/manage/home. Sau đó đi tới .
Đồng bộ hóa mẫu¶
Các mẫu phải được đồng bộ hóa trên cơ sở dữ liệu SoOn sau khi được nhóm Meta phê duyệt. Để làm như vậy, hãy bắt đầu bằng cách điều hướng đến và chọn cấu hình sẽ được đồng bộ hóa. Trong phần được đánh dấu :menuelection:`Gửi tin nhắn`, về phía dưới cùng, nhấp vào Sync Mẫu. Meta sẽ cập nhật các mẫu đã được phê duyệt để có thể sử dụng chúng với nhiều ứng dụng khác nhau trong cơ sở dữ liệu.
Thông báo thành công màu xanh xuất hiện ở góc trên bên phải kèm theo số lượng mẫu đã cập nhật.
Mẹo
Các mẫu cũng có thể được đồng bộ hóa riêng lẻ từ chính mẫu đó. Điều hướng đến bảng điều khiển và chọn mẫu để đồng bộ hóa. Sau đó, nhấp vào nút Sync Mẫu nằm ở menu trên cùng của biểu mẫu mẫu.
Tạo mẫu trong Meta¶
Trước tiên, hãy điều hướng đến trang tổng quan mẫu WhatsApp của Meta, sau đó đi tới .
Để tạo mẫu WhatsApp, hãy nhấp vào nút Tạo mẫu màu xanh lam, sau đó chọn Category. Các tùy chọn được liệt kê bao gồm: Marketing, Utility, và Authentication. Trong hầu hết các trường hợp, hai tùy chọn đầu tiên sẽ được sử dụng, trừ khi người dùng muốn gửi yêu cầu đặt lại mật khẩu hoặc điều gì đó liên quan đến bảo mật.
Nhập Name của mẫu và sau đó chọn Language cho mẫu.
Ghi chú
Có thể chọn nhiều ngôn ngữ bằng cách nhập (các) tên ngôn ngữ và chọn các ngôn ngữ khác nếu cần.
Sau khi thực hiện các lựa chọn thích hợp, nhấp vào Tiếp tục ở góc trên bên phải. Trang này chuyển hướng đến trang Chỉnh sửa mẫu. Ở đây Header, Body, Footer và Buttons được cấu hình. Ở bên phải của mẫu là bản xem trước mẫu sẽ trông như thế nào khi sản xuất.
Khi tất cả các thay đổi cần thiết được thực hiện đối với mẫu, hãy nhấp vào nút Gửi ở góc trên bên phải. Một cửa sổ xác nhận xuất hiện để xác nhận ngôn ngữ— nhấp vào Confirm để phê duyệt và sau đó một cửa sổ khác xuất hiện cho biết mẫu sẽ được gửi tới Meta để xem xét và phê duyệt.
Status của mẫu sẽ vẫn ở Đang xem xét cho đến khi Meta đưa ra quyết định. Sau khi nhận được email xác nhận phê duyệt mẫu, các mẫu sẽ cần được đồng bộ hóa từ bên trong cơ sở dữ liệu SoOn.
Xem thêm
Để biết thêm thông tin về cách định cấu hình mẫu trên bảng điều khiển dành cho nhà phát triển Meta, hãy truy cập Tài liệu về mẫu WhatsApp của Meta.
Thông báo¶
Thông báo trong WhatsApp được xử lý tương tự như cuộc trò chuyện bằng tin nhắn trong SoOn. Một cửa sổ bật lên xuất hiện với cuộc trò chuyện đã nhận từ khách hàng. Theo mặc định, thông báo được đặt trong cấu hình tài khoản doanh nghiệp WhatsApp trong SoOn.
Bạn có thể điều chỉnh cài đặt thông báo bằng cách điều hướng đến . Từ đó, chọn tài khoản và cuộn xuống phần nơi xử lý thông báo. Trong tiêu đề Thông báo cho người dùng, hãy nhập trường mà (những) người dùng sẽ được thông báo cho kênh WhatsApp cụ thể này.
Ghi chú
Sau khi cuộc trò chuyện được bắt đầu giữa người dùng và khách hàng, thông báo tới tất cả người dùng được chỉ định trong cấu hình tài khoản doanh nghiệp WhatsApp sẽ không xuất hiện. Chỉ có thông báo cho (những) người dùng trong cuộc trò chuyện mới xuất hiện. Nếu người dùng không phản hồi trong vòng 15 ngày thì câu trả lời của khách hàng sau 15 ngày sẽ được gửi lại cho tất cả người dùng được chỉ định trong cấu hình WhatsApp.
Thêm người dùng vào trò chuyện¶
Người dùng có thể được thêm vào cuộc trò chuyện WhatsApp bằng cách mở rộng cửa sổ bật lên WhatsApp. Cuộc trò chuyện WhatsApp được đặt trong ứng dụng Thảo luận. Bấm vào biểu tượng 👤+ (thêm người dùng) bên cạnh, sẽ xuất hiện cửa sổ mời người dùng tham gia cuộc trò chuyện.
Câu hỏi thường gặp về API WhatsApp¶
Xác minh¶
Kể từ ngày 1 tháng 2 năm 2023, nếu ứng dụng Meta yêu cầu quyền truy cập ở cấp độ nâng cao thì có thể cần phải hoàn tất quy trình xác minh doanh nghiệp hoàn chỉnh. Điều này bao gồm việc gửi tài liệu kinh doanh văn phòng tới Meta. Xem tài liệu này.
Lỗi mẫu¶
Việc chỉnh sửa mẫu có thể gây ra lỗi và truy nguyên trừ khi thực hiện đúng quy trình ở trên, tại đây: (Mẫu WhatsApp).
Lỗi xác thực trùng lặp¶
Khi đồng bộ hóa các mẫu, có thể xảy ra trường hợp có nhiều mẫu có cùng tên trên trình quản lý doanh nghiệp của Meta và trong SoOn. Điều này gây ra lỗi xác thực trùng lặp. Để khắc phục sự cố này, hãy đổi tên tên mẫu trùng lặp trên SoOn và đồng bộ hóa lại các mẫu bằng cách làm theo các bước tại đây: Đồng bộ hóa mẫu.
Lỗi mã thông báo¶
Lỗi người dùng¶
Nếu mã thông báo tạm thời không được thay thế bằng mã thông báo vĩnh viễn thì lỗi người dùng sẽ xuất hiện trong SoOn khi kiểm tra kết nối sau khi gửi không thành công. Để khắc phục sự cố này, hãy xem Mã thông báo vĩnh viễn.
Lỗi người dùng hệ thống 100¶
Nếu người dùng hệ thống là Employee khi thiết lập mã thông báo vĩnh viễn, lỗi người dùng 100 sẽ xuất hiện.
Để sửa lỗi này, hãy tạo người dùng hệ thống Admin, làm theo quy trình được nêu ở đây: Mã thông báo vĩnh viễn.
