Chúng tôi đã cập nhật tài liệu này để thể hiện các thay đổi bổ sung mà sẽ có hiệu lực từ ngày 01/07/2025. Những thay đổi này được mô tả bên dưới.
Vào tháng 10/2024, chúng tôi đã thông báo việc cập nhật mô hình định giá trên Nền tảng WhatsApp Business để đơn giản và nhất quán hơn với thông lệ ngành, tạo điều kiện để mọi người có trải nghiệm nhắn tin chất lượng cao hơn, cũng như phù hợp hơn với giá trị mang lại cho cả cá nhân lẫn doanh nghiệp.
Vào ngày 15/05/2025, chúng tôi đã thông báo các cập nhật bổ sung cũng sẽ có hiệu lực từ ngày 01/07/2025, trong nỗ lực không ngừng nhằm hỗ trợ các đối tác và doanh nghiệp của chúng tôi khai thác được giá trị của tin nhắn tiện ích cũng như tin nhắn xác thực thông qua mô hình định giá đơn giản và hấp dẫn.
File PDF giải thích về mô hình định giá được liên kết dưới đây sẽ nêu bật mô hình định giá trên Nền tảng WhatsApp Business, có hiệu lực từ ngày 01/07/2025. Trong file có nội dung cập nhật được đề cập trong tài liệu này, chẳng hạn như mô hình định giá trên mỗi tin nhắn cũng như bậc số lượng mới cho tin nhắn tiện ích và tin nhắn xác thực.
File PDF giải thích về mô hình định giáLưu ý rằng tài liệu của chúng tôi về Định giá vẫn phản ánh cách chúng tôi tính phí hiện tại, đồng thời sẽ được cập nhật từ ngày 01/07/2025 nhằm thể hiện mô hình định giá trên mỗi tin nhắn cùng những nội dung cập nhật khác được nêu trong phần còn lại của tài liệu này.
Mô hình định giá trên mỗi tin nhắn sẽ được áp dụng cho tất cả doanh nghiệp kể từ 0:00 ngày 01/07/2025, theo múi giờ của Tài khoản WhatsApp Business. Với mô hình định giá trên mỗi tin nhắn, chúng tôi sẽ tính phí cho doanh nghiệp trên nền tảng của mình như sau:
Ví dụ: Nếu bạn gửi 1 mẫu marketing, sau đó gửi 2 mẫu tiện ích cho một người dùng WhatsApp, chúng tôi sẽ tính phí 3 lần (1 mẫu marketing, 2 mẫu tiện ích). Tuy nhiên, nếu bạn gửi 2 mẫu tiện ích khi khung thời gian chăm sóc khách hàng đang mở giữa bạn và người dùng đó, chúng tôi sẽ chỉ tính phí 1 lần (1 mẫu marketing).
Chúng tôi sẽ ra mắt trường pricing_analytics mới vào ngày 01/07/2025 để bạn có thể nhận số liệu chia nhỏ về giá trên mỗi tin nhắn cho bất kỳ tin nhắn nào bạn đã gửi.
Kể từ ngày 01/07/2025, các đối tượng conversation
và pricing
trong webhook tin nhắn về trạng thái sẽ bị ảnh hưởng theo những cách sau đây, tùy theo phiên bản trường webhook mà bạn đăng ký. Bạn có thể điều chỉnh gói đăng ký qua Bảng điều khiển ứng dụng > WhatsApp > menu thả xuống Phiên bản của bảng điều khiển Cấu hình cho từng trường webhook.
/* conversation object omitted unless webhook is for a free entry point conversation */ "conversation": { "id": "<CONVERSATION_ID>", // new behavior, see table below "expiration_timestamp": "<CONVERSATION_EXPIRATION_TIMESTAMP>", "origin": { "type": "<CONVERSATION_CATEGORY>" } }, "pricing": { "billable": <IS_BILLABLE?>, "pricing_model": "<PRICING_MODEL>", // new value, see table below "type": "<PRICING_TYPE>", // new property, see table below "category": "<CONVERSATION_CATEGORY>" }
"conversation": { "id": "<CONVERSATION_ID>", // new behavior, see table below "expiration_timestamp": "<CONVERSATION_EXPIRATION_TIMESTAMP>", "origin": { "type": "<CONVERSATION_CATEGORY>" } }, "pricing": { "billable": <IS_BILLABLE?>, "pricing_model": "<PRICING_MODEL>", // new value, see table below "type": "<PRICING_TYPE>", // new property, see table below "category": "<PRICING_CATEGORY>" }
Phần giữ chỗ | Mô tả |
---|---|
| Phiên bản 24.0 trở lên:
Phiên bản 23.0 trở xuống:
|
| Không thay đổi. |
| Không thay đổi. |
| Không thay đổi. Tuy nhiên, thuộc tính |
| Giá trị
|
| Thuộc tính mới. Các giá trị có thể là:
|
| Các giá trị không thay đổi nhưng hiện có thể được diễn giải như sau:
|
Các thay đổi đối với thông báo trạng thái và giá cả của tin nhắn qua API Tại chỗ sẽ thể hiện những thay đổi của webhook phiên bản 24.0 dành cho API Đám mây.
Các thay đổi đối với thông báo trạng thái và giá cả của tin nhắn qua API Tại chỗ sẽ thể hiện những thay đổi của webhook phiên bản 23.0 dành cho API Đám mây. Tuy nhiên, webhook sẽ không chứa thuộc tính pricing.type
.
Giá trị pricing.type
có thể được dùng cùng với giá trị pricing.category
để xác định liệu webhook có mô tả tin nhắn có thể lập hóa đơn hay không và nếu có thì mức phí nào được áp dụng. Ví dụ:
Loại | Hạng mục | Mức phí | Lý do |
---|---|---|---|
|
| Marketing | Tất cả tin nhắn mẫu marketing đều có thể lập hóa đơn. |
|
| Tiện ích | Các tin nhắn mẫu tiện ích gửi ngoài khung thời gian chăm sóc khách hàng đều có thể lập hóa đơn. |
|
| không áp dụng | Các tin nhắn mẫu tiện ích gửi trong khung thời gian chăm sóc khách hàng sẽ được miễn phí. |
|
| không áp dụng | Tin nhắn không dùng mẫu sẽ được miễn phí. |
Mọi thông tin trong tài liệu này cũng áp dụng cho API Marketing Messages Lite.
Kể từ ngày 01/07/2025, tất cả doanh nghiệp đều có thể gửi miễn phí mẫu tiện ích trong khung thời gian chăm sóc khách hàng ("CSW"). Mẫu tiện ích được gửi ngoài CSW sẽ tiếp tục được tính phí theo mức phí tiện ích.
Hình minh họa cho thấy hành vi của 2 mẫu tiện ích do một doanh nghiệp gửi vào hoặc sau ngày 01/07/2025:
Mẫu tiện ích um1 miễn phí vì mẫu này được gửi khi CSW vẫn đang mở, còn um2 được lập hóa đơn theo mức phí tiện ích do mẫu này được gửi sau khi CSW đóng.
Lưu ý rằng bạn cũng có thể trả lời miễn phí trong CSW bằng tin nhắn không dùng mẫu, chẳng hạn như tin nhắn văn bản. Trường hợp này cũng không phát sinh chi phí (điều này sẽ không thay đổi).
Nếu cuộc trò chuyện tiện ích giữa bạn và người dùng kéo dài đến khi chuyển sang mô hình định giá trên mỗi tin nhắn (cuộc trò chuyện được mở trước khi chuyển nhưng sẽ không đóng đến sau khi chuyển), các mẫu tiện ích gửi đến người dùng sau khi chuyển trong khi cuộc trò chuyện đang mở sẽ miễn phí, nhưng được ghi nhận cho cuộc trò chuyện đang mở đó. Những tin nhắn này sẽ có pricing_model
là CBP
và ID cuộc trò chuyện tiện ích sẽ được chỉ định cho conversation.id
trong webhook tin nhắn về trạng thái. Sau khi cuộc trò chuyện đóng, tin nhắn tiện ích tiếp theo gửi đến người dùng sẽ tuân theo hành vi mới như minh họa ở trên.
Sử dụng đối tượng pricing
trong webhook tin nhắn về trạng thái như sau để xác định xem webhook có được liên kết với mẫu tiện ích miễn phí (hoặc có thể lập hóa đơn) hay không.
Kể từ ngày 01/07/2025:
"pricing": { "billable": false, // vs. "true" for a billable utility template "pricing_model": "PMP", // new value, will be set to "PMP" "type": "free_customer_service", // new property, vs. "regular" for a billable utility template "category": "utility" }
Sử dụng đối tượng pricing
trong webhook thông báo trạng thái tin nhắn và giá cả như sau để xác định xem webhook có được liên kết với mẫu tiện ích miễn phí (hoặc có thể lập hóa đơn) hay không.
Kể từ ngày 01/07/2025:
"pricing": { "billable": false, // vs. "true" for a billable utility template "pricing_model": "PMP", // new value, will be set to "PMP" "type": "free_customer_service", // new property, vs. "regular" for a billable utility template "category": "utility" }
Kể từ ngày 01/07/2025:
"pricing": { "billable": false, // vs. "true" for a billable utility template "pricing_model": "PMP", // will be set to "PMP" "category": "utility" }
Kể từ ngày 01/07/2025, tin nhắn mẫu tiện ích miễn phí sẽ có các giá trị sau đây trong đối tượng điểm dữ liệu được trả về trong phản hồi dữ liệu phân tích giá:
{ "pricing_analytics": { "data": [ { "data_points": [ { "start": <START_TIME>, "end": <END_TIME>, "volume": 1, "pricing_type": "FREE_CUSTOMER_SERVICE", // Will be set to "FREE_CUSTOMER_SERVICE" "pricing_category": "UTILITY", // Will be set to "UTILITY" }, ... ] } ] } }
Kể từ ngày 01/07/2025, chúng tôi sẽ áp dụng bậc số lượng cho tin nhắn tiện ích và tin nhắn xác thực nhằm khuyến khích dùng các trường hợp sử dụng này trên WhatsApp. Doanh nghiệp có thể được hưởng mức phí thấp hơn khi đạt bậc số lượng cao hơn.
Bậc số lượng sẽ có hiệu lực từ ngày 01/07/2025 và được thể hiện cùng với bảng giá của chúng tôi ở bên dưới.
Lưu ý rằng các mẫu tiện ích gửi đến người dùng WhatsApp trong khung thời gian chăm sóc khách hàng đang mở sẽ không bị tính phí, do đó không tính vào bậc số lượng.
Bảng dưới đây mang tính minh họa và chỉ nêu bật sự thay đổi về bậc số lượng. Bậc số lượng sẽ có hiệu lực từ ngày 01/07/2025 và được thể hiện cùng với bảng giá của chúng tôi ở bên dưới.
Thông tin về bậc số lượng sẽ có trong phần dữ liệu phân tích giá. Hãy thêm thông số TIER
mới vào mảng dimensions
để lấy thông tin về bậc số lượng.
Cú pháp phản hồi mẫu
{ "start": <START_TIMESTAMP>, "end": <END_TIMESTAMP>, "phone_number": "<BUSINESS_PHONE_NUMBER>", "country": "<COUNTRY_CODE>", "tier": "<LOWER>:<UPPER>", <!-- This is new --> "pricing_type": "<PRICING_TYPE>", "pricing_category": "<PRICING_CATEGORY>", "volume": <VOLUME>, "cost": <COST> }
Giá trị thuộc tính tier
biểu thị mối liên kết giữa giới hạn dưới và giới hạn trên của bậc theo từng cặp thị trường-hạng mục cụ thể (country
và pricing_category
).
<LOWER>
- Một số nguyên biểu thị giới hạn dưới của bậc (bao gồm cả giá trị này).<UPPER>
- Một số nguyên biểu thị giới hạn trên của bậc (bao gồm cả giá trị này) hoặc chuỗi MAX
.Phản hồi mẫu
{ "start": 1733644800, "end": 1733731200, "phone_number": "15550783881", "country": "IN", "tier": "750000:15000000", "pricing_type": "REGULAR", "pricing_category": "UTILITY", "volume": 5, "cost": 0.0065 }
Lưu ý
Kể từ ngày 01/07/2025, chúng tôi sẽ cập nhật mức phí cho tin nhắn tiện ích và tin nhắn xác thực tại một số thị trường trong nỗ lực không ngừng nhằm đảm bảo rằng mức giá của chúng tôi ngang bằng với các kênh thay thế, từ đó khuyến khích dùng các trường hợp sử dụng này trên WhatsApp.
Mức phí có hiệu lực từ ngày 01/07/2025
Nếu bạn muốn tìm hiểu mức phí cập nhật sẽ có hiệu lực từ ngày 01/07/2025, file CSV sau đây sẽ nêu bật phần trăm thay đổi so với mức phí hiện tại, áp dụng trên toàn bộ bảng giá.
File CSV về phần trăm thay đổi so với mức phí hiện tạiBạn vẫn có thể xem bảng giá hiện tại của chúng tôi (có hiệu lực cho đến hết ngày 30/06/2025) tại đây.
Kể từ ngày 01/07/2025, chúng tôi sẽ cập nhật định nghĩa về tiện ích cho cụ thể và rõ ràng. Để một mẫu được phân vào hạng mục tiện ích, mẫu đó phải đáp ứng các tiêu chí bổ sung sau đây:
Tức là kể từ ngày 01/07/2025, chúng tôi sẽ:
File PDF giải thích về hạng mục mẫu được liên kết dưới đây sẽ trình bày những nguyên tắc mới này về tiện ích, đồng thời nêu bật toàn bộ nguyên tắc hiện hành về hạng mục mẫu của tất cả hạng mục mẫu tin nhắn.
File PDF giải thích về hạng mục mẫuLưu ý rằng tài liệu Phân loại mẫu của chúng tôi vẫn thể hiện nguyên tắc hiện hành về hạng mục mẫu cho đến hết ngày 30/06/2025.
Kể từ ngày 01/11/2024, mọi doanh nghiệp đều có thể sử dụng miễn phí cuộc trò chuyện dịch vụ (cuộc trò chuyện gói miễn phí lúc này sẽ không có giới hạn, thay vì bị giới hạn ở 1.000 cuộc trò chuyện). Lưu ý rằng khung thời gian chăm sóc khách hàng phải mở giữa bạn và người dùng WhatsApp thì bạn mới có thể gửi tin nhắn không dùng mẫu cho người dùng.
Sử dụng đối tượng pricing
trong webhook tin nhắn về trạng thái như sau để xác định xem webhook có được liên kết với tin nhắn/cuộc trò chuyện dịch vụ miễn phí hay không.
01/11/2024 đến 30/06/2025:
"pricing": { "billable": true, "pricing_model": "CBP", "category": "service" // Will be set to "service" }
Kể từ ngày 01/07/2025:
"pricing": { "billable": false, "pricing_model": "PMP", // New "PMP" value "type": "free_customer_service", "category": "service" }
Sử dụng đối tượng định giá trong webhook thông báo trạng thái và giá cả như sau để xác định xem webhook có được liên kết với tin nhắn/cuộc trò chuyện dịch vụ miễn phí hay không.
01/11/2024 đến 30/06/2025:
"pricing": { "billable": true, "pricing_model": "CBP", "category": "service" // Will be set to "service" }
Kể từ ngày 01/07/2025:
"pricing": { "billable": false, "pricing_model": "PMP", // New "PMP" value "type": "free_customer_service", // New "type" property "category": "service" }
01/11/2024 đến 30/06/2025:
"pricing": { "billable": true, "pricing_model": "CBP", "category": "service" // Will be set to "service" }
Kể từ ngày 01/07/2025:
"pricing": { "billable": false, "pricing_model": "PMP", // New "PMP" value "category": "service" }
Mọi cuộc trò chuyện dịch vụ được mở từ ngày 01/11/2024 trở đi sẽ được xác định là FREE_TIER
. Nếu bạn yêu cầu lọc dữ liệu phân tích cuộc trò chuyện cho cuộc trò chuyện dịch vụ (conversation_categories
bao gồm SERVICE
) và sử dụng khoảng thời gian xem lại kéo dài từ ngày này:
conversation_types
có giá trị là FREE_TIER
(các cuộc trò chuyện được mở trước khi đạt đến giới hạn 1.000 cuộc trò chuyện miễn phí) hoặc REGULAR
(các cuộc trò chuyện được mở sau khi đạt đến giới hạn 1.000 cuộc trò chuyện miễn phí). Lưu ý rằng chúng tôi tính phí các cuộc trò chuyện mở trước ngày này nhưng được phân phối sau ngày này. Do đó, những cuộc trò chuyện này sẽ được xác định là REGULAR
.conversation_types
có 1 trong 2 loại giá trị trên nhưng REGULAR
sẽ bằng 0 (0
), vì khi đó mọi cuộc trò chuyện dịch vụ đều miễn phí và được xác định là FREE_TIER
.Trường conversation_analytics
sẽ ngừng hoạt động khi API Đồ thị phiên bản 25.0 được phát hành (cuối tháng 10 hoặc đầu tháng 11/2025). Nhờ đó, bạn sẽ có đủ thời gian để tìm nạp bất kỳ dữ liệu phân tích cuộc trò chuyện cũ nào mà bạn có thể cần trước khi trường này không còn dùng được nữa.
Kể từ ngày 01/11/2024, bảng điều khiển Trình quản lý WhatsApp > Công cụ trong tài khoản > Thông tin chi tiết sẽ thay đổi như sau:
Khi mô hình định giá trên mỗi tin nhắn ra mắt, cuộc trò chuyện miễn phí từ điểm truy cập sẽ hoạt động như trước nhưng thể hiện tin nhắn thay vì cuộc trò chuyện. Nếu người dùng WhatsApp nhắn tin cho bạn qua nền tảng điểm truy cập miễn phí, bạn có thể phản hồi bằng bất kỳ loại tin nhắn miễn phí nào trong vòng 24 giờ. Nếu bạn phản hồi, thao tác này sẽ mở ra khung thời gian điểm truy cập miễn phí dài 72 giờ. Bạn có thể dùng bất kỳ loại tin nhắn nào để tiếp tục nhắn tin miễn phí cho người dùng đó khi khung thời gian này đang mở. Lưu ý rằng sau 24 giờ kể từ khi khách hàng gửi tin nhắn đầu tiên, bạn chỉ có thể gửi mẫu (miễn phí) trừ khi khách hàng nhắn tin lại cho bạn.
Kể từ ngày 01/02/2025, bất kỳ doanh nghiệp nào đủ điều kiện áp dụng mức phí xác thực quốc tế sẽ được tính phí theo mức phí này ở 7 thị trường bổ sung dưới đây, ngoại trừ thị trường khớp với Vị trí kinh doanh chính của họ (tại đây, doanh nghiệp sẽ tiếp tục được tính phí theo mức phí xác thực).
Chúng tôi sẽ tiếp tục thông báo cho doanh nghiệp 30 ngày trước ngày bắt đầu áp dụng mức phí xác thực quốc tế.
Thông tin thay đổi về mức phí có trong bảng giá bên dưới.
Kể từ ngày 01/07/2025, ngưỡng điều kiện áp dụng mức phí xác thực quốc tế sẽ dựa trên tin nhắn xác thực bạn gửi, thay vì cuộc trò chuyện xác thực mà bạn mở trên tất cả 9 thị trường có mức phí xác thực quốc tế.
pricing_model
là PMP
thay vì CBP
và đối tượng cuộc trò chuyện sẽ có dữ liệu không chính xác.id
sẽ được đặt thành một ID riêng biệt cho mỗi tin nhắn, thay vì trên mỗi cuộc trò chuyện, trong webhook tin nhắn về trạng thái, trừ khi webhook này dành cho tin nhắn thuộc cuộc trò chuyện miễn phí từ điểm truy cập.conversation
sẽ chỉ có trong webhook tin nhắn về trạng thái dành cho tin nhắn thuộc cuộc trò chuyện miễn phí từ điểm truy cập.conversation_analytics
sẽ trả về lỗi cho yêu cầu dữ liệu phân tích cuộc trò chuyện.12/06/2025:
<PRICING_MODEL>
để nêu rõ rằng giá trị CBP
chỉ có thể dùng được đến ngày 01/07/2025.07/06/2025:
28/05/2025:
marketing_lite
làm giá trị hạng mục khả thi trong bảng Thông số webhook API Đám mây.27/05/2025:
22/05/2025:
19/05/2025:
15/05/2025:
12/05/2025:
18/04/2025:
expiration_timestamp
vào ví dụ về webhook định giá trên mỗi tin nhắn qua API Đám mây và bảng mô tả thông số.<PRICING_CATEGORY>
từ authentication-international
thành authentication_international
trong bảng mô tả thông số webhook định giá trên mỗi tin nhắn qua API Đám mây.01/04/2025:
27/03/2025:
06/03/2025:
pricing.type
trong ngày áp dụng cho API Đám mây và API Tại chỗ thành ngày 01/07/2025."PMP"
mới của pricing_model
thành ngày 01/07/2025.25/02/2025:
20/12/2024:
conversation_analytics
.31/10/2024:
28/10/2024: