Tài liệu này đã được cập nhật.
Bản dịch sang Tiếng Việt chưa hoàn tất.
Cập nhật bằng tiếng Anh: Hôm qua

Nhật ký thay đổi

Tài liệu này là nhật ký thay đổi của Nền tảng WhatsApp Business.

13/11/2024

API Đám mây

12/11/2024

API Đám mây

02/10/2024

API Đám mây, thay đổi đối với phiên bản 21.0

25/09/2024

API Đám mây

24/09/2024

API Đám mây

  • Đã thêm mẫu có nút thanh toán (chỉ áp dụng cho doanh nghiệp Ấn Độ sử dụng số điện thoại của doanh nghiệp có mã vùng quốc gia Ấn Độ).

10/09/2024

API Đám mây

  • Đã thay đổi hành vi lưu tài sản file phương tiện vào bộ nhớ đệm từ tùy chọn do nhà phát triển xác định (qua tiêu đề Cache-Control) thành khoảng thời gian cố định là 10 phút. Tuy nhiên, bạn vẫn có thể buộc chúng tôi tìm nạp tài sản từ máy chủ của bạn, thay vì bộ nhớ đệm của chúng tôi. Hãy xem bài viết Lưu file phương tiện vào bộ nhớ đệm.

06/09/2024

API Đám mây

01/06/2024

API Đám mây

Business Management API

10/04/2024

API Đám mây

18/03/2024

API Đám mây

13/02/2024

API Đám mây

  • Đã thay đổi giới hạn số lần đăng ký/hủy đăng ký số điện thoại của doanh nghiệp thành 10 yêu cầu trên mỗi số điện thoại của doanh nghiệp trong khoảng thời gian 72 giờ liên tục (trước đây là khoảng thời gian 1 tuần liên tục).

06/02/2024

API Đám mây, API Tại chỗ

26/01/2024

API Đám mây

  • Đã thay đổi thời gian tồn tại để thử gửi lại tin nhắn mẫu qua API Đám mây từ 24 giờ thành 30 ngày. Bạn vẫn có thể ghi đè giá trị này đối với mẫu xác thực.
  • Đã thay đổi số lượng ký tự tối đa của biz_opaque_callback_data từ 256 thành 512.

18/01/2024

API Đám mây

18/12/2023

API Đám mây

12/12/2023

Business Management API

20/11/2023

Business Management API

14/11/2023

API Đám mây

03/11/2023

Business Management API

  • Giờ đây, quy trình tạo mẫu quay vòng yêu cầu ít nhất một nút.

23/10/2023

Business Management API, API Đám mây, API Tại chỗ

10/10/2023

Flows

API Đám mây

04/10/2023

Business Management API, API Đám mây, API Tại chỗ

  • Giờ đây, các mẫu xác thực sử dụng cảnh báo hết hạn mã sẽ dùng giá trị code_expiration_minutes (thay cho giá trị mặc định là 10 phút) để xác định xem tin nhắn mẫu đã gửi sẽ hiển thị nút tự động điền hay nút sao chép mã.
  • Nút tự động điền hiển thị trong tin nhắn mẫu đã gửi sẽ bị vô hiệu hóa sau khoảng thời gian được biểu thị bằng giá trị code_expiration_minutes của mẫu, nếu có (hoặc sau 10 phút nếu không có giá trị này).

02/10/2023

API Đám mây

27/09/2023

API Đám mây

  • Đã thêm thuộc tính ctwa_clid vào đối tượng referral trong webhook tin nhắn. Cho biết ID lượt click được tạo khi người dùng nhấn vào quảng cáo click đến WhatsApp để gửi tin nhắn.

18/09/2023

API Đám mây, API Tại chỗ

  • Bạn có thể tiếp tục gửi, chỉnh sửa và kháng nghị đối với các mẫu xác thực cũ (mẫu xác thực không có nút mật khẩu một lần) cho đến ngày 01/04/2024 (gia hạn từ ngày 02/10/2023).

12/09/2023

Business Management API

API Đám mây

API Đám mây, API Tại chỗ

  • Nếu bạn chuyển số điện thoại của doanh nghiệp có cài đặt đa kết nối đang chạy 2 đoạn trở lên từ API Tại chỗ sang API Đám mây, hệ thống sẽ tự động nâng cấp số điện thoại này lên thông lượng API Đám mây cao hơn.

28/08/2023

API Đám mây, API Tại chỗ

15/08/2023

Business Management API

08/08/2023

Công cụ

Business Management API

Quy trình đăng ký nhúng sẵn

02/08/2023

Business Management API

11/07/2023

API Đám mây

  • Quá trình lên lịch và thực hiện nâng cấp thông lượng cho số điện thoại của doanh nghiệp không yêu cầu gọi trực tiếp nữa.
  • Giờ đây, bạn có thể chỉ định thời gian nâng cấp khi gửi phiếu yêu cầu hỗ trợ qua kênh Hỗ trợ trực tiếp để yêu cầu nâng cấp thông lượng cho số điện thoại của doanh nghiệp.
  • Thời gian số điện thoại của doanh nghiệp dừng chạy trong quá trình nâng cấp thông lượng giảm xuống còn 5 phút trở xuống.

07/07/2023

Business Management

  • Giờ đây, văn bản của nút sao chép mã và nút tự động điền trong mẫu xác thực là yêu cầu không bắt buộc khi tạo.

13/06/2023

Công cụ

Business Management

  • Đã thêm mã lỗi 2494100 cho Business Management API. Mã lỗi này cho biết số điện thoại của doanh nghiệp tạm thời ở chế độ bảo trì.

API Đám mây

26/05/2023

Công cụ

  • Đã thêm các tín hiệu lỗi giúp gỡ lỗi mẫu xác thực có nút tự động điền bằng mật khẩu một lần.

23/05/2023

API Đám mây

  • Giờ đây, hành vi cố gửi một mẫu bị tạm dừng trong tin nhắn mẫu bằng v17 trở lên sẽ trả về mã lỗi 132015 thay vì 132001.
  • Giờ đây, hành vi cố gửi một mẫu bị vô hiệu hóa trong tin nhắn mẫu bằng v17 trở lên sẽ trả về mã lỗi 132016 thay vì 132001.

API Tại chỗ

  • Giờ đây, hành vi cố gửi một mẫu bị tạm dừng trong tin nhắn mẫu sẽ trả về mã lỗi 2061.
  • Giờ đây, hành vi cố gửi một mẫu bị vô hiệu hóa trong tin nhắn mẫu sẽ trả về mã lỗi 2062.

09/05/2023

Business Management API

API Đám mây

API Tại chỗ

01/05/2023

Business Management API

  • Đã thêm các webhook mới thông báo cho bạn về việc từ chối tăng giới hạn nhắn tin đối với trường webhook account_alerts.
  • Giờ đây, tất cả các mẫu phải được phân loại là AUTHENTICATION, MARKETING hoặc UTILITY.

26/04/2023

Business Management API

  • Đã thêm trường hsm_id cho yêu cầu DELETE đến điểm cuối Tài khoản WhatsApp Business > Mẫu tin nhắn. Nếu được thêm, trường này sẽ xóa một mẫu khớp với ID đã cung cấp (chứ không xóa tất cả các mẫu khớp với tên đã cung cấp).

18/04/2023

API Đám mây

  • Đã thêm last_onboarded_time cho nút Số điện thoại WhatsApp Business. Cho biết thời điểm người dùng tạo số điện thoại của doanh nghiệp trên Tài khoản WhatsApp Business của họ bằng cách hoàn thành quy trình Đăng ký nhúng sẵn.

11/04/2023

API Đám mây

Quy trình đăng ký nhúng sẵn

04/04/2023

Business Management API, API Đám mây, API Tại chỗ

  • Xác thực hạng mục hiện nằm trong quy trình xét duyệt mẫu đối với mẫu mới tạo. Áp dụng cho phiên bản 16.0 trở lên.
  • Phản hồi API cho yêu cầu tạo hoặc chỉnh sửa mẫu hiện có cả trạng thái và hạng mục của mẫu. Áp dụng cho tất cả phiên bản API.
  • Đã thêm thông số allow_category_change cho yêu cầu POST đến điểm cuối Tài khoản WhatsApp Business > Mẫu tin nhắn.
  • Đã thêm INCORRECT_CATEGORY làm giá trị reason từ chối mới cho webhook trạng thái mẫu.
  • Những mẫu sử dụng các biến hiện yêu cầu cung cấp giá trị mẫu khi tạo hoặc chỉnh sửa. Áp dụng cho tất cả phiên bản.
  • Đã thêm trường previous_category cho Mẫu tin nhắn trên WhatsApp.
  • Cuộc trò chuyện do doanh nghiệp bắt đầu không đủ điều kiện là cuộc trò chuyện gói miễn phí nữa. Nếu Tài khoản WhatsApp Business của bạn phụ thuộc vào các dịch vụ của một Đối tác giải pháp hoặc một đối tác của Meta, bạn sẽ được miễn áp dụng những thay đổi này cho đến ngày 01/06/2023.

17/03/2023

Business Management API

  • Đã thêm trường đăng ký webhooktemplate_category_update mới. Nếu đã đăng ký trường này, bạn sẽ nhận được webhook cho biết hạng mục cũ và mới của một mẫu mỗi khi hạng mục của mẫu đó thay đổi.
  • Phản hồi API cho yêu cầu tạo và chỉnh sửa mẫu hiện có cả trạng thái và hạng mục của mẫu.

14/03/2023

API Đám mây

  • Giờ đây, bạn có thể chia sẻ thông tin vị trí với người dùng bằng cách thêm Tiêu đề vị trí vào mẫu của mình.

API Tại chỗ

01/03/2023

API Đám mây, API Tại chỗ

  • Quá trình chuyển số điện thoại của doanh nghiệp ở Ấn Độ từ API Tại chỗ sang API Đám mây không còn xóa dữ liệu tuân thủ khi bán hàng online. Vì vậy, bạn không phải tự điền lại dữ liệu này sau khi chuyển nữa.

15/02/2023

Business Management API

  • Đã thêm một điểm cuối so sánh mẫu mới để bạn có thể so sánh số lần gửi mẫu tin nhắn và tỷ lệ chặn.

03/02/2023

API Đám mây, API Tại chỗ

02/02/2023

Business Management API, API Đám mây

API Đám mây

  • Các mẫu được tạo hoặc chỉnh sửa thông qua v16.0 hiện phải được phân loại bằng một trong các hạng mục sau. Tất cả hạng mục khác không được hỗ trợ nữa. Áp dụng cho API Đám mây v16.0 trở lên. Sẽ áp dụng cho tất cả phiên bản kể từ ngày 01/05/2023. Chúng tôi giới thiệu thay đổi này để hỗ trợ quá trình chuyển sang mô hình định giá theo cuộc trò chuyện mới vào ngày 01/06/2023.
    • AUTHENTICATION
    • MARKETING
    • UTILITY
  • Mã lỗi phụ (hiếm khi được sử dụng và không nên dựa vào) sẽ không còn được bao gồm trong phản hồi lỗi v16.0 trở lên. Hãy sử dụng codedetails.
  • Mã lỗi 100 ("code":100) có nhiều tiêu đề khác nhau cho biết bản chất của lỗi 100 cụ thể. Tất cả lỗi có mã 100 hiện sẽ dùng Invalid parameter làm tiêu đề. Những tiêu đề cũ mô tả bản chất của lỗi có mã 100 cụ thể đã được chuyển sang thuộc tính details. Sự thay đổi này hiện cũng được phản ánh trong phần tải dữ liệu webhook mô tả phản hồi lỗi có mã 100.

Webhooks API Đám mây

  • Đối tượng errors trong webhook được kích hoạt bởi các lỗi yêu cầu v16.0 trở lên hiện chứa các thuộc tính messageerror_data.details. Giá trị title đã thay đổi đối với nhiều mã lỗi. Giờ đây, đối tượng errors có cấu trúc và dữ liệu như sau:
[
  {
    "code": <CODE>,
    "title" : "<TITLE>",
    "message": "<MESSAGE>",
    "error_data": {
      "details": "<DETAILS>"
    }
  },
  ...
]
  • Giá trị thuộc tính title đã được cập nhật cho các mã lỗi sau. Giá trị cũ của chúng hiện có trong error_data.details.
    • Giờ đây, tiêu đề mới của mã lỗi 130470Re-engagement message
    • Giờ đây, tiêu đề mới của mã lỗi 130429Rate limit hit
    • Giờ đây, tiêu đề mới của mã lỗi 131045Incorrect certificate
    • Giờ đây, tiêu đề mới của mã lỗi 131031Business Account locked
    • Giờ đây, tiêu đề mới của mã lỗi 131053Media upload error
    • Giờ đây, tiêu đề mới của mã lỗi 131027Something went wrong
    • Giờ đây, tiêu đề mới của mã lỗi 131042Business eligibility payment issue
    • Giờ đây, tiêu đề mới của mã lỗi 131026Message Undeliverable
    • Giờ đây, tiêu đề mới của mã lỗi 131000Something went wrong
  • Giá trị thuộc tính message giống với giá trị thuộc tính title - cho biết tiêu đề của mã lỗi. Thuộc tính này đối ghép với thuộc tính message trong phần tải dữ liệu phản hồi lỗi API.
  • Giờ đây, thuộc tính error_data.details có chứa tiêu đề của các mã lỗi được nêu ở trên và mô tả nguyên nhân cơ bản gây ra lỗi. Giá trị này đối ghép với thuộc tính details trong phần tải dữ liệu phản hồi lỗi API.

Những thay đổi này được phản ánh trong các thuộc tính errors sau đây trong webhook liên quan đến lỗi:

  • entry.changes.value.errors
  • entry.changes.value.messages.errors
  • entry.changes.value.statuses.errors

30/01/2023

API Đám mây

Giờ đây, doanh nghiệp chưa được xác minh có thể bắt đầu lên đến 250 cuộc trò chuyện trong khoảng thời gian 24 giờ liên tiếp.

13/12/2022

Kiểm tra quyền đối với file phương tiện

Áp dụng cho tất cả phiên bản API Đám mây.

Đã thêm trường không bắt buộc phone_number_id mới vào điểm cuối File phương tiện. Nếu bạn thêm thông số này và một ID số điện thoại doanh nghiệp, hệ thống chỉ xử lý thao tác nếu ID số điện thoại đó khớp với ID của số điện thoại dùng để tải file phương tiện lên.

08/12/2022

Lưu file phương tiện HTTP vào bộ nhớ đệm

Tính năng lưu file phương tiện HTTP vào bộ nhớ đệm của API Đám mây đã kết thúc giai đoạn beta và mọi người đều có thể sử dụng.

Webhooks

API Đám mây hiện sẽ thử gửi lại thông báo webhook không gửi được trong tối đa 7 ngày thay vì tối đa 30 ngày. Hãy xem phần Lỗi gửi webhook.

23/11/2022

Trường webhook mới

Áp dụng cho tất cả phiên bản.

  • Đã thêm trường template_performance_metrics mới. Thông báo cho bạn hàng tuần về tất cả số liệu hiệu quả của mẫu, bao gồm cả số tin nhắn đã gửi, số tin nhắn đã mở và lý do chặn phổ biến nhất.

22/11/2022

Trường và giá trị webhook mới

Áp dụng cho tất cả phiên bản.

Trường account_alerts mới:

  • Đã thêm trường account_alerts mới. Thông báo cho bạn về Doanh nghiệp, Tài khoản WhatsApp Business cũng như thông báo về số điện thoại của doanh nghiệp.

Giá trị mới cho trường account_update:

  • Đã thêm giá trị account_update.events mới: ACCOUNT_DELETED. Cho biết một số điện thoại đã bị hủy đăng ký hoặc bị xóa khỏi Tài khoản WhatsApp Business.
  • Đã thêm giá trị message_template_status_update.events mới: PENDING_DELETION. Cho biết một mẫu tin nhắn đã được đánh dấu để xóa.

Thông báo Webhooks mẫu được gửi khi những sự kiện mới sau được kích hoạt:

Trường mới cho nút Tài khoản WhatsApp Business

Đã thêm những trường sau đây cho nút Tài khoản WhatsApp Business:

  • country (áp dụng cho v15.0+)
  • ownership_type (áp dụng cho v15.0+)
  • business_verification_status (áp dụng cho tất cả phiên bản)

Bộ lọc mới cho điểm cuối Doanh nghiệp

Áp dụng cho v15.0 trở lên.

Đã thêm những tùy chọn bộ lọc sau đây vào điểm cuối Tài khoản WhatsApp Business cho khách hàng doanh nghiệp:

  • Lọc theo trường creation_time của Tài khoản WhatsApp Business bằng cách sử dụng toán tử GREATER_THAN, LESS_THAN hoặc IN_RANGE.
  • Lọc theo ownership_type của Tài khoản WhatsApp Business bằng cách sử dụng toán tử EQUAL hoặc IN.

Đã thêm những tùy chọn bộ lọc sau đây vào điểm cuối Tài khoản WhatsApp Business do doanh nghiệp sở hữu:

  • Lọc theo creation_time của Tài khoản WhatsApp Business bằng cách sử dụng toán tử GREATER_THAN, LESS_THAN hoặc IN_RANGE.
  • Lọc theo ownership_type của Tài khoản WhatsApp Business bằng cách sử dụng toán tử EQUAL hoặc IN.
  • Lọc theo country của Tài khoản WhatsApp Business bằng cách sử dụng toán tử EQUAL hoặc IN.

Trường mới cho nút Số điện thoại

Áp dụng cho v15.0 trở lên

Đã thêm những trường sau đây cho nút Số điện thoại WhatsApp Business:

  • is_official_business_account
  • messaging_limit_tier

Ngoài ra, bạn có thể lọc điểm cuối Số điện thoại của Tài khoản WhatsApp Business theo is_official_business_account.

03/11/2022

Số tin nhắn mỗi giây

API Đám mây hiện hỗ trợ lên đến 500 (tăng lên từ 350) tin nhắn mỗi giây (mps) khi kết hợp cả tin nhắn văn bản và tin nhắn có file phương tiện theo yêu cầu. Hãy xem phần Thông lượng để biết chi tiết.

Nếu bạn đã có 350 mps, thông lượng sẽ tự động tăng lên 500 mps. Nếu đã yêu cầu 350 mps nhưng quá trình này chưa toàn tất, bạn sẽ nhận được 500 mps sau khi hoàn tất.

Lưu HTTP file phương tiện vào bộ nhớ đệm

Chúng tôi hiện đang thực hiện thử nghiệm beta đối với tính năng lưu HTTP file phương tiện vào bộ nhớ đệm của API Đám mây. Nếu bạn là Đối tác giải pháp, hãy xem phần Lưu HTTP file phương tiện vào bộ nhớ đệm để tìm hiểu cách sử dụng tiêu đề trong phản hồi máy chủ. Phản hồi này sẽ hướng dẫn chúng tôi lưu tài sản file phương tiện của bạn vào bộ nhớ đệm để sử dụng lại cho những tin nhắn sau này.

Chú thích trên tài liệu

API Đám mây hiện hỗ trợ chú thích trên những tài liệu được gửi đến và nhận từ khách hàng. Hãy xem phần Đối tượng File phương tiện trong tài liệu tham khảo về File phương tiện.

25/10/2022

Tăng giới hạn mẫu tin nhắn

Tài khoản WhatsApp Business hiện có thể có lên đến 6.000 mẫu tin nhắn nếu doanh nghiệp mẹ đã được xác minh và ít nhất một Tài khoản WhatsApp Business của doanh nghiệp mẹ đó sở hữu số điện thoại doanh nghiệp có tên hiển thị đã được phê duyệt.

Cùng với thay đổi này, những phiên bản đã dịch của một mẫu tin nhắn hiện được tính vào giới hạn mẫu của Tài khoản WhatsApp Business.

20/10/2022

Lập hóa đơn

Doanh nghiệp ở Ấn Độ hiện có thể dùng thẻ tín dụng để thanh toán cho những tin nhắn đã gửi bằng nền tảng này. Hãy xem bài viết Thêm thẻ tín dụng vào tài khoản Nền tảng WhatsApp Business.

12/10/2022

Chuyển số điện thoại của doanh nghiệp

Bạn hiện có thể chuyển số điện thoại của doanh nghiệp sang/từ Tài khoản WhatsApp Business qua API Đám mây. Hãy xem bài viết Chuyển số điện thoại sang WABA khác.

06/10/2022

Ghi đè lệnh gọi lại

Chỉ áp dụng với API Đám mây.

Bạn hiện có thể sử dụng các URL gọi lại khác nhau cho mỗi Tài khoản WhatsApp Business mà không cần phải tạo từng ứng dụng riêng biệt cho mỗi Tài khoản WhatsApp Business. Hãy xem phần Ghi đè URL gọi lại để biết chi tiết.

Lệnh gọi phiên bản 15

Mọi điểm cuối API Đám mây hiện đều hỗ trợ lệnh gọi phiên bản 15.

Mẫu tin nhắn

Chỉ áp dụng với API Đám mây.

Hiện tại, thông số văn bản (components.parameters.text) của mẫu tin nhắn chỉ sử dụng một thành phần nội dung (components.type:body) có thể lên đến 32.768 ký tự. Hãy xem phần Đối tượng Thông số.

Số tin nhắn mỗi giây

Chỉ áp dụng với API Đám mây.

API Đám mây hiện hỗ trợ lên đến 350 (tăng lên từ 250) tin nhắn mỗi giây (mps) khi kết hợp cả tin nhắn văn bản và tin nhắn có file phương tiện theo yêu cầu. Hãy xem phần Thông lượng để biết chi tiết.

Nếu bạn đã có 250 mps, thông lượng sẽ tự động tăng lên 350 mps. Nếu đã yêu cầu 250 mps nhưng quá trình này chưa toàn tất, bạn sẽ nhận được 350 mps sau khi hoàn tất.

API Đám mây - 22/09/2022

Cảm xúc

Cảm xúc hiện đã được hỗ trợ. Hãy xem phần Gửi tin nhắn - Tin nhắn bày tỏ cảm xúc để tìm hiểu cách gửi và nhận cảm xúc, đồng thời tham khảo phần Phần tải dữ liệu mẫu - Tin nhắn bày tỏ cảm xúc để xem ví dụ về thông báo phần tải dữ liệu webhook.

Trang kinh doanh

Trường about trên trang kinh doanh hiện đã được hỗ trợ. Hãy xem bài viết Trang kinh doanh để biết chi tiết.

API Đám mây - 07/09/2022

Số tin nhắn mỗi giây

Hiện đã có tài liệu mới nhất về việc yêu cầu chuyển từ 80 tin nhắn mỗi giây lên 250 tin nhắn mỗi giây, kết hợp cả gửi và nhận tin nhắn văn bản cũng như tin nhắn có file phương tiện. Hãy xem phần Thông lượng.

API Đám mây - 25/08/2022

Nhãn dán động

Giờ đây, bạn có thể thêm nhãn dán động vào tin nhắn đi do doanh nghiệp bắt đầu và nhận webhook tin nhắn mô tả những tin nhắn đó theo cách tương tự như khi gửi nhãn dán không phải loại động. Hãy tham khảo thuộc tính sticker của đối tượng Tin nhắn và các yêu cầu về tài sản nhãn dán động.

Tin nhắn có chứa sản phẩm

Giờ đây, bạn có thể thêm sản phẩm và dịch vụ vào tin nhắn gửi cho khách hàng. Khách hàng cũng có thể thêm sản phẩm/dịch vụ này vào giỏ hàng mà không phải rời khỏi đoạn chat. Hãy tham khảo tài liệu hướng dẫn Bán sản phẩm và dịch vụ để tìm hiểu cách gửi Tin nhắn gồm một sản phẩm và Tin nhắn gồm nhiều sản phẩm cho khách hàng.

API Đám mây - 21/07/2022

Tin trả lời

Giờ đây, doanh nghiệp có thể trả lời bất cứ tin nhắn nào trong chuỗi trò chuyện. Tin trả lời sẽ bao gồm một bong bóng ngữ cảnh tham chiếu đến tin nhắn được trả lời. Hãy tham khảo tài liệu hướng dẫn Gửi tin nhắn để tìm hiểu cách trả lời tin nhắn.

Số tin nhắn mỗi giây

API Đám mây hiện hỗ trợ lên đến 250 tin nhắn mỗi giây khi kết hợp cả gửi và nhận (bao gồm tin nhắn văn bản và tin nhắn có file phương tiện) theo yêu cầu. Nếu là đối tác doanh nghiệp, bạn có thể mở phiếu Hỗ trợ trực tiếp để yêu cầu thông lượng 250 tin nhắn mỗi giây bằng cách chọn Chủ đề câu hỏi: "Vấn đề về API Đám mây", Loại yêu cầu: "Yêu cầu chuyển sang thông lượng 250 tin nhắn mỗi giây" rồi điền các thông tin bắt buộc.

Thông báo dành cho nhà phát triển: Thông báo những thay đổi không tương thích ngược đối với v2.43 và v2.45 trong tương lai

v2.43 11/10/2022

  • Kể từ v2.43, hành vi của điểm cuối contacts sẽ thay đổi
    • Phản hồi cho status sẽ thay đổi. Dù người dùng có sử dụng WhatsApp hay không, hệ thống sẽ luôn trả về giá trị valid cho status trong phản hồi và wa_id. Chúng tôi không đảm bảo rằng wa_id được trả về sẽ hợp lệ. Những thay đổi này có thể áp dụng cho cả phản hồi trực tiếp cũng như phản hồi webhook cho các cuộc gọi không chặn
    • Đảm bảo rằng mã của bạn không dựa vào statuswa_id được trả về trong nút contacts. Ngoài ra, bạn có thể gửi tin nhắn trên v2.39.1 trở lên mà không phải gọi nút contacts

  • Đảm bảo rằng mã của bạn xử lý lỗi 1013Người dùng không hợp lệ có thể xảy ra khi cố gửi mẫu tin nhắn. Hệ thống sẽ trả về lỗi này nếu bạn cố gửi mẫu tin nhắn đến một số điện thoại không có tài khoản WhatsApp

  • Đối với các tin nhắn không phải là mẫu, nếu bạn gửi tin nhắn đến số điện thoại không có tài khoản WhatsApp, hệ thống sẽ trả về lỗi 470

v2.45 10/01/2023

  • Kể từ v2.45, thông số cert không bắt buộc trong nút shards sẽ trở thành thông số bắt buộc đối với tất cả yêu cầu. Vui lòng cập nhật tiện ích tích hợp của bạn để luôn bao gồm cert hợp lệ khi gọi nút shards

  • Kể từ v2.41.2, doanh nghiệp có thể sử dụng nút application để lọc ra các trạng thái tin nhắn đã gửi mà họ không quan tâm qua đối tượng message trong đối tượng webhooks. Trong v2.45, sent_status sẽ ngừng hoạt động. Vì vậy, hãy cập nhật tiện ích tích hợp của bạn để sử dụng đối tượng webhooks trong nút application cho mọi biện pháp kiểm soát webhook

  • Kể từ v2.39.1, recipient_id khả dụng trong cả đối tượng statuses và đối tượng message. Trong v2.45, recipient_id sẽ bị gỡ trong đối tượng statuses. Vì vậy, hãy cập nhật tiện ích tích hợp của bạn để sử dụng recipient_id trong đối tượng message

API Tại chỗ - 19/09/2022 (v2.41.3)

Bản phát hành 2.41.3

Phiên bản v2.41.3 của ứng dụng API WhatsApp Business bao gồm: Đã thêm chỉ mục bảng mới trên message_receipt_log. Việc này có thể giúp ích cho những đối tác cần thông lượng cao. Ví dụ: điểm cải tiến này cho phép đối tác gửi hơn 200 tin nhắn/giây.

API Tại chỗ - 27/06/2022 (v2.41.2)

Vui lòng làm theo những cách làm tốt nhất bên dưới để đảm bảo nâng cấp liền mạch lên phiên bản 2.41.2:

Trong v2.41.2, chúng tôi sẽ thực hiện các thay đổi đối với lược đồ cơ sở dữ liệu để cải thiện hiệu suất của hệ thống. Do đó, quá trình nâng cấp từ v2.37.2 và v2.39.x để thiết lập các cơ sở dữ liệu lớn chứa hàng triệu mục tin nhắn và người liên hệ sẽ lâu hơn bình thường.

Nhìn chung, bạn nên thực hiện nâng cấp ngoài giờ cao điểm, đồng thời nâng cấp trước những cách thiết lập có thông lượng thấp hơn.

Đối với cơ sở dữ liệu lớn, hãy làm theo các bước sau:

  • Chạy quy trình thu thập dữ liệu rác qua điểm cuối /services/message/gc trước khi nâng cấp và đảm bảo quy trình này hoàn tất thành công

  • Vui lòng sử dụng công cụ dbupgrade để nâng cấp lược đồ cơ sở dữ liệu trước khi nâng cấp phiên bản. Sau khi hoàn tất, bạn sẽ có thể giảm thiểu thời gian ngừng hoạt động khi nâng cấp phiên bản API. Bạn nên tắt ứng dụng API trước khi sử dụng công cụ dbupgrade. Hãy đảm bảo công cụ dbupgrade hoàn tất thành công (mã thoát là 0), đồng thời tránh hoặc giới hạn số yêu cầu API trong khi đang nâng cấp

Bạn nên tăng thời gian chờ truy vấn trên máy chủ cơ sở dữ liệu của mình lên 1 giờ cho đến khi hoàn tất thành công quá trình nâng cấp.

Phiên bản ứng dụng này chứa các tính năng và bản cập nhật sau:

  • Giảm độ trễ khi gửi yêu cầu hàng loạt đến điểm cuối /contacts và giải quyết sự cố đình trệ hoàn toàn
  • Cải thiện hiệu quả và độ tin cậy của quy trình thu thập dữ liệu rác
  • Giờ đây, doanh nghiệp có thể bật/tắt thông báo webhook deliveredread. Nhờ đó, doanh nghiệp có thể kiểm soát thông báo webhook cho tin nhắn hiệu quả hơn. Họ có thể thực hiện việc này thông qua điểm cuối settings/application
  • namespace là trường không bắt buộc cho đối tượng mẫu
  • Xử lý lỗi tải file phương tiện xuống mạnh mẽ hơn để giảm số lượng sự cố tải file phương tiện xuống mà khách hàng báo cáo
  • Tăng độ tin cậy và sửa lỗi trong quy trình gửi tin nhắn và đăng ký

API Đám mây của WhatsApp Business - 19/05/2022

Kể từ hôm nay, tất cả nhà phát triển xây dựng sản phẩm hoặc dịch vụ cho bản thân hoặc tổ chức đều có thể sử dụng API Đám mây của WhatsApp Business. Hãy xem hướng dẫn của chúng tôi để bắt đầu. Nếu bạn muốn cấp quyền truy cập API cho khách hàng, vui lòng đăng ký vào danh sách chờ của chúng tôi.

WhatsApp Business Management API - 19/05/2022

Hạng mục mẫu tin nhắn

Kể từ phiên bản v14.0 trở lên, các giá trị sau của thông số category dành cho điểm cuối /WHATSAPP-BUSINESS-ACCOUNT-ID/message_template đã ngừng hoạt động:

  • ACCOUNT_UPDATE
  • ALERT_UPDATE
  • APPOINTMENT_UPDATE
  • AUTO_REPLY
  • ISSUE_RESOLUTION
  • PAYMENT_UPDATE
  • PERSONAL_FINANCE_UPDATE
  • RESERVATION_UPDATE
  • SHIPPING_UPDATE
  • TICKET_UPDATE
  • TRANSPORTATION_UPDATE

Chúng tôi đã thêm những giá trị sau đây:

  • TRANSACTIONAL
  • MARKETING

API Tại chỗ của WhatsApp - 10/05/2022 (v2.39.4)

Phiên bản ứng dụng này chứa tất cả tính năng và bản sửa lỗi trong v2.39.1. Ngoài ra, bản phát hành này:

  • Khắc phục lỗi không cho gửi tin nhắn video trong một số trường hợp. Bản sửa lỗi này cũng đã được đưa vào v2.39.2.
  • Khắc phục lỗi không cho doanh nghiệp gửi tin nhắn đến khách hàng nếu khách hàng là người bắt đầu tương tác giữa 2 bên trên WhatsApp và tương tác đó bắt đầu hơn 7 ngày trước. Bản sửa lỗi này cũng đã được đưa vào v2.39.3.
  • Khắc phục lỗi không cho doanh nghiệp nhận tin nhắn tự hủy từ khách hàng. Sau khi cài đặt v2.39.4, doanh nghiệp sẽ nhận được thông báo rằng họ đã nhận được một tin nhắn tự hủy qua thông báo webhook có loại được đặt là "ephemeral". Doanh nghiệp sẽ không thể xem nội dung tin nhắn.

Khi chúng tôi ra mắt v2.39.3, vấn đề với tin nhắn tạm thời đã được WhatsApp xử lý bằng cách tự động vô hiệu hóa những tin nhắn này trong đoạn chat với khách hàng. Đối với v2.39.4, chúng tôi sẽ không thực hiện việc đó. Với phiên bản này, doanh nghiệp nhận được tin nhắn tạm thời phải yêu cầu khách hàng vô hiệu hóa tin nhắn tạm thời và gửi lại tin nhắn mới nhất.

API Đám mây - 03/05/2022

Kể từ hôm nay, API Đám mây sẽ bao gồm các bản nâng cấp sau:

  • Đã khắc phục vấn đề liên quan đến tin nhắn tự hủy từ người dùng.
  • Xác định chất lượng hình thu nhỏ hiệu quả hơn cho tin nhắn có file phương tiện.

API Đám mây - 05/04/2022

Kể từ hôm nay, tất cả Đối tác giải pháp và khách hàng trực tiếp hiện tại đều có thể sử dụng API Đám mây. Ngoài ra, chúng tôi sẽ phát hành các tính năng sau cho nhà phát triển API Đám mây:

  • Tin nhắn có nhãn dán: Gửi tin nhắn có file phương tiện chứa nhãn dán tĩnh của bên thứ ba. Hãy xem tài liệu sau để biết thêm chi tiết: Tài liệu tham khảo, Tin nhắnTài liệu tham khảo, File phương tiện. Chúng tôi hỗ trợ cả nhãn dán gửi đến và gửi đi. Đối với nhãn dán gửi đi, chúng tôi chỉ hỗ trợ nhãn dán tĩnh của bên thứ ba. Đối với nhãn dán gửi đến, chúng tôi hỗ trợ mọi loại nhãn dán.
  • API Hủy đăng ký số điện thoại: Thực hiện lệnh gọi POST đến PHONE_NUMBER_ID/deregister để gỡ số điện thoại khỏi API WhatsApp Business. Hãy xem bài viết Đăng ký để biết thông tin.
  • Tùy chọn xác minh số điện thoại mới: Xác minh số điện thoại của doanh nghiệp bạn qua lệnh gọi API Đồ thị. Hãy xem bài viết Số điện thoại để biết thông tin.
  • Webhooks tham chiếu mới: Nhận thông báo Webhooks khi người dùng nhấp vào một quảng cáo click đến WhatsApp và gửi tin nhắn cho doanh nghiệp. Hãy xem bài viết Webhooks để biết thông tin. Lưu ý rằng đối tượng referral webhook của API Đám mây khác với đối tượng referral của API Tại chỗ.

Ngoài ra, chúng tôi cũng xin thông báo rằng các nhà phát triển bên thứ nhất sử dụng API Đám mây sẽ không phải trải qua quy trình Xét duyệt ứng dụng nữa. Tất cả các nhà phát triển đều phải tuân theo giới hạn nhắn tin của Nền tảng WhatsApp Business.

API Tại chỗ - 26/03/2022

Phiên bản này có các tính năng giống như v2.37.1, nhưng có ngày hết hạn khác. v2.37.2 sẽ hết hạn vào ngày 22/09/2022.

Các sự cố đã biết

Một số nhà phát triển Kubernetes có thể gặp lỗi CrashLoopBackOff đối với vùng chứa webapp và vùng chứa của họ có thể không khởi động được. Để khắc phục lỗi đó, hãy thêm dòng sau vào file YML triển khai Kubernetes trong cấu hình webapp:

command: ["/opt/whatsapp/bin/wait_on_mysql.sh", "/opt/whatsapp/bin/launch_within_docker.sh"]

API Tại chỗ - 25/03/2022

Kể từ hôm nay, các nhà phát triển đã có thể sử dụng phiên bản v2.39.3 của ứng dụng API WhatsApp Business. Ứng dụng mới này có 2 bản sửa lỗi và nhật ký bổ sung để hỗ trợ gỡ lỗi. 2 bản sửa lỗi bao gồm:

  • Đã khắc phục lỗi không cho doanh nghiệp gửi tin nhắn đến khách hàng nếu khách hàng là người bắt đầu tương tác giữa 2 bên trên WhatsApp và tương tác đó bắt đầu hơn 7 ngày trước.
  • Đã khắc phục lỗi không cho doanh nghiệp nhận tin nhắn tự hủy từ khách hàng. Sau khi cài đặt v2.39.3, doanh nghiệp sẽ nhận được thông báo rằng họ đã nhận được một tin nhắn tự hủy qua thông báo webhook. Về phía khách hàng, họ sẽ nhìn thấy cảnh báo cho biết chế độ tin nhắn tự hủy đã bị tắt.

API Đám mây - 15/03/2022

Tin nhắn đính kèm danh sách và nút trả lời

Kể từ hôm nay, người dùng API Đám mây phiên bản beta có thể bắt đầu gửi tin nhắn đính kèm danh sách và chứa nút trả lời. Hãy xem tài liệu sau để biết thêm chi tiết:

URL xem trước

Kể từ hôm nay, người dùng API Đám mây phiên bản beta có thể thêm ô URL xem trước vào tin nhắn văn bản có chứa URL. Hãy xem các tài liệu sau để biết thêm chi tiết:

Tài liệu hướng dẫn mới

API Tại chỗ - 04/03/2022

Chúng tôi vừa phát hành API Tại chỗ v2.39.2. Phiên bản này khắc phục lỗi không cho gửi tin nhắn video trong một số trường hợp.

Các sự cố đã biết

  • Tồn tại lỗi không cho doanh nghiệp gửi tin nhắn đến khách hàng nếu khách hàng là người bắt đầu tương tác giữa 2 bên trên WhatsApp và tương tác đó bắt đầu hơn 7 ngày trước.
  • Tồn tại lỗi không cho doanh nghiệp nhận tin nhắn tự hủy từ khách hàng.

API Đám mây - 01/03/2022

Tin nhắn video

Kể từ hôm nay, người dùng API Đám mây phiên bản beta có thể bắt đầu gửi và nhận tin nhắn video. Hãy tham khảo các tài liệu sau để biết thêm thông tin:

01/02/2022

Nền tảng WhatsApp Business

Kể từ hôm nay, WhatsApp đã chuyển từ mô hình định giá theo thông báo sang mô hình định giá theo cuộc trò chuyện. Doanh nghiệp sẽ được tính phí theo cuộc trò chuyện, bao gồm tất cả tin nhắn được gửi trong phiên trò chuyện 24 giờ. Hãy xem bài viết Định giá theo cuộc trò chuyện để biết thông tin.

API Đám mây

Tin nhắn có chứa thông tin vị trí và thông tin liên hệ

Kể từ hôm nay, người dùng API Đám mây phiên bản beta có thể bắt đầu gửi và nhận tin nhắn có chứa thông tin vị trí và thông tin liên hệ. Hãy xem tài liệu dưới đây để biết thêm thông tin:

Thay đổi về thông lượng cao nhất

Hiện tại, chúng tôi hỗ trợ thông lượng cao nhất là 80 tin nhắn/giây cho mỗi số điện thoại. Thông lượng này tính cả tin nhắn đến và đi, cũng như tin nhắn văn bản, mẫu tin nhắn và tin nhắn có file phương tiện.

API Tại chỗ (2.39.1)

Kể từ hôm nay, các nhà phát triển đã có thể sử dụng phiên bản 2.39.1 của ứng dụng API WhatsApp Business. Ứng dụng mới này bao gồm:

API Đặt số đoạn

Kể từ phiên bản ứng dụng API mới, bạn có thể cung cấp chứng chỉ của điện thoại khi thiết lập giải pháp đa kết nối. Nghĩa là khi gọi điểm cuối /v1/account/shards, bạn có thể thêm chứng chỉ được mã hóa Base64 trong trường chứng chỉ. Hãy xem bài viết Mở rộng quy mô ứng dụng API bằng giải pháp Đa kết nối để biết thông tin.

Tên máy chủ mới

Chúng tôi đã thêm graph.whatsapp.com vào danh sách tên máy chủ WhatsApp mà ứng dụng API WhatsApp Business yêu cầu kết nối. Hãy xem bài viết Thiết lập và gỡ lỗi mạng, Tên máy chủ để biết thông tin.

Thay đổi về mã lỗi

Với v2.39, chúng tôi đã thêm mã lỗi 1031. Bạn sẽ nhận được lỗi này nếu tài khoản của bạn đã bị khóa và không thể gửi tin nhắn do vi phạm chính sách về tính toàn vẹn. Hãy xem bài viết Thông báo lỗi và thông báo trạng thái cũng như Thực thi chính sách để biết thông tin.

Trường hợp ngừng hoạt động

  • API Tin nhắn: Loại hsm đã ngừng hoạt động kể từ v2.39. Thay vào đó, bạn nên sử dụng loại template.
  • Cài đặt ứng dụng: Cài đặt ứng dụng webhook_payload_conversation_pricingmodel_disabled đã ngừng hoạt động.

Các sự cố đã biết

Không thể gửi một số tin nhắn video trong các trường hợp nhất định.