Giới thiệu API Đồ thị v16.0 và API Marketing v16.0 của Facebook

Hôm nay, chúng tôi sẽ phát hành API Đồ thị v16.0 và API Marketing v16.0 của Facebook. Trong đợt phát hành này, chúng tôi sẽ nêu bật những thay đổi dưới đây mà chúng tôi cho là có liên quan đến cộng đồng nhà phát triển. Những thay đổi này bao gồm thông báo, phần cập nhật về sản phẩm cũng như thông báo về sản phẩm ngừng hoạt động mà chúng tôi cho là có liên quan đến quá trình tích hợp (các) ứng dụng của bạn với nền tảng của chúng tôi.

Để biết danh sách đầy đủ tất cả thay đổi và thông tin chi tiết về những thay đổi đó, vui lòng xem nhật ký thay đổi của chúng tôi.

Thông báo và cập nhật chung

Phản hồi lỗi Nền tảng WhatsApp Business

Trong nỗ lực không ngừng nhằm cải thiện hành vi phản hồi lỗi API, chúng tôi đã thực hiện các thay đổi sau.

• 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ó trong phản hồi lỗi v16.0 trở lên. Thay vào đó, hãy sử dụng mã và chi tiết.
• Mã lỗi 100 ("code":100) có nhiều tiêu đề khác nhau cho biết bản chất của một lỗi cụ thể. Giờ đây, tất cả lỗi có mã 100 sẽ sử dụng Thông số không hợp lệ 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 chi tiết. Sự thay đổi này hiện cũng được phản ánh trong phần tải dữ liệu webhooks mô tả phản hồi lỗi có mã 100.
• Các đối tượng lỗi webhook có được thuộc tính thông báo mới ánh xạ đến thuộc tính thông báo trong phần tải dữ liệu phản hồi lỗi API.

Nền tảng dành cho nhà phát triển hiện sẽ yêu cầu Xác minh doanh nghiệp để có Quyền truy cập nâng cao vào API bất kỳ

Như đã thông báo vào ngày 01/02/2023, Meta hiện sẽ yêu cầu nhà phát triển xác minh doanh nghiệp của họ để có quyền truy cập nâng cao đối với bất kỳ quyền nào trên Nền tảng dành cho nhà phát triển của Meta. Đây là yêu cầu trong quy trình của chúng tôi nhằm giúp xác nhận tính xác thực và hợp pháp của một doanh nghiệp hoặc tổ chức.

Đối với các ứng dụng được tạo sau ngày 01/02/2023, chúng tôi sẽ bắt đầu triển khai dần tính năng này khi các ứng dụng mới yêu cầu quyền truy cập nâng cao. Những ứng dụng được tạo trước ngày 01/02/2023 có quyền truy cập nâng cao sẽ phải liên kết với một doanh nghiệp đã được xác minh kể từ ngày 01/05/2023. Nếu bạn muốn biết danh sách các quyền yêu cầu xác minh doanh nghiệp để được phê duyệt quyền truy cập nâng cao, hãy xem trang này.

Phiên bản ngừng hoạt động và những thay đổi quan trọng

Tính năng Cân nhắc chuyến đi ngừng hoạt động

Năm 2018, chúng tôi ra mắt tính năng Cân nhắc chuyến đi dưới dạng một nút chuyển mà nhà quảng cáo du lịch có thể bật để ưu tiên phân phối quảng cáo cho những người đã thể hiện ý định đi du lịch nhưng chưa quyết định sẽ đi đâu. Tính năng Cân nhắc chuyến đi hoạt động phối hợp với các lựa chọn nhắm mục tiêu hiện có để hỗ trợ nhà quảng cáo phân phối quảng cáo đến đúng người, vào đúng thời điểm trên Facebook, Instagram và Audience Network. Trong 4 năm qua, nhờ liên tục phát triển các hệ thống máy học và thử nghiệm rộng rãi, chúng tôi hiện có thể hỗ trợ nhà quảng cáo du lịch tiếp cận người tiêu dùng có ý định đi du lịch, đồng thời đạt được các mục tiêu hiệu quả tương tự mà không cần lựa chọn nút chuyển này.

Từ ngày 02/02/2023, chúng tôi sẽ gỡ lựa chọn nút chuyển Cân nhắc chuyến đi trong Trình quản lý quảng cáo và API đối với các chiến dịch mới. Chúng tôi xác định rằng nút chuyển không còn cần thiết nữa và nhà quảng cáo sẽ thấy hiệu quả tương tự mà không cần đến nút chuyển này. Trong thời gian chuyển tiếp, việc bật hoặc tắt nút chuyển này không có khả năng ảnh hưởng đáng kể đến hiệu quả của chiến dịch.

Khi các mô hình máy học được cải thiện, hiện bạn có thể đạt được các mục tiêu và hiệu quả tương tự mà không cần lựa chọn nút chuyển này. Vì vậy, chúng tôi tin rằng việc gỡ nút chuyển này sẽ mang lại trải nghiệm tinh giản hơn.

Tính năng Quảng cáo chuyến bay để tìm kiếm khách hàng tiềm năng ngừng hoạt động

Tháng 09/2018, chúng tôi ra mắt thành công Quảng cáo chuyến bay để tìm kiếm khách hàng tiềm năng. Giữa năm 2021, sản phẩm này bắt đầu gặp phải những thách thức về kỹ thuật và các lỗi đã được xác định khiến cho nhiều chiến dịch không thể chạy hiệu quả. Do đó, chúng tôi đưa ra quyết định chủ động yêu cầu nhà quảng cáo chuyển hướng sang các lựa chọn tìm khách hàng tiềm năng khác. Tính năng nhắm mục tiêu lại vẫn còn và các nhà quảng cáo có thể sử dụng tính năng này.

Nếu bạn hoặc đối tác của bạn đang sử dụng Quảng cáo chuyến bay để tìm kiếm khách hàng tiềm năng, bạn nên tắt mọi chiến dịch hiện có muộn nhất vào ngày 01/05/2023.

Vị trí quảng cáo Bài viết tức thì ngừng hoạt động

Chúng tôi sẽ gỡ Bài viết tức thì và vị trí quảng cáo Bài viết tức thì khỏi Facebook kể từ ngày 20/04/2023. Chúng tôi giới thiệu Bài viết tức thì lần đầu tiên vào năm 2015 để nhà phát hành có thể tạo bài viết chứa file phương tiện tương tác trên di động và kiếm tiền từ nội dung này bằng quảng cáo trên Facebook. Tuy nhiên, khám phá tin tức là một phần nhỏ trong trải nghiệm Facebook đối với phần lớn những người sử dụng nền tảng này, đồng thời, mọi người cho biết họ muốn ẩn bớt nội dung này trong Bảng feed của mình. Do đó, chúng tôi đang điều chỉnh các hoạt động đầu tư của mình để phù hợp hơn với sở thích của người dùng.

Vị trí quảng cáo Bài viết tức thì sẽ không còn dùng được để tạo chiến dịch mới trong Trình quản lý quảng cáo và API Marketing kể từ ngày 20/04/2023. Sau ngày 20/04/2023, các nhóm quảng cáo trước đây chỉ chứa vị trí quảng cáo Bài viết tức thì sẽ bị tạm dừng, còn tất cả những nhóm quảng cáo khác chứa vị trí quảng cáo Bài viết tức thì sẽ tự động được cập nhật để loại trừ vị trí đó.

Ẩn cảm xúc, bình luận và thẻ trên nội dung đã đăng lên trang cá nhân của người dùng

Với lần phát hành này, chúng tôi đang triển khai một thay đổi sẽ dẫn đến việc ẩn bình luận, cảm xúc và thẻ của người dùng phiên. Trường thông tin "via" and "sharedposts" cũng sẽ trả dữ liệu trống về cho các bài viết trên trang cá nhân của người dùng. Sự thay đổi này sẽ chỉ ảnh hưởng đến nội dung được đăng lên trang cá nhân của người dùng.

Ngừng hỗ trợ TLS ở các phiên bản cũ hơn 1.2

Để tăng cường tình trạng bảo mật, chúng tôi sẽ ngừng hỗ trợ API Đồ thị cho các phiên bản TLS cũ hơn TLS 1.2. Nếu sử dụng TLS 1.2, quyền truy cập bằng mã RSA tĩnh (AES128-GCM-SHA256, AES256-GCM-SHA384, AES128-SHA, AES256-SHA, DES-CBC3-SHA) cũng sẽ không được dùng nữa. Các yêu cầu API được thực hiện thông qua các phiên bản TLS cũ hơn sẽ nhận được lỗi sau 90 ngày.

Chúng tôi cũng sẽ từ chối lưu lượng truy cập web vào developer.facebook.com sau ngày 01/05/2023 từ các trình duyệt sử dụng phiên bản TLS cũ hơn (cũ hơn TLS 1.2 và dùng mã RSA tĩnh [AES128-GCM-SHA256, AES256-GCM-SHA384, AES128-SHA, AES256-SHA, DES-CBC3-SHA] nếu sử dụng TLS1.2).

Hạng mục mẫu WhatsApp

Năm trước, chúng tôi đã cập nhật loại hạng mục mẫu trong API và Trình quản lý WhatsApp để ghi nhận trường hợp sử dụng mới được gửi trên Nền tảng WhatsApp Business. Từ ngày 02/02/2023, chúng tôi sẽ đổi tên những hạng mục mẫu sau đây để phản ánh chính xác hơn các trường hợp sử dụng này:

• Mẫu marketing vẫn sẽ có tên là marketing (không có thay đổi)
• Mẫu giao dịch sẽ đổi tên thành tiện ích
• Mẫu OTP sẽ đổi tên thành xác thực

Doanh nghiệp phải sử dụng các hạng mục mẫu được cập nhật này nếu tạo hoặc chỉnh sửa mẫu bằng Đồ thị v16. Ngày 01/05, thay đổi này sẽ áp dụng cho tất cả các phiên bản. Vì vậy, mọi nỗ lực tạo hoặc chỉnh sửa mẫu bằng bất kỳ phiên bản nào đều phải sử dụng những hạng mục mới này. Để đảm bảo không có sự gián đoạn nào đối với việc tạo hoặc chỉnh sửa mẫu, các doanh nghiệp và nhà cung cấp giải pháp kinh doanh nên ưu tiên cập nhật lệnh gọi API của mình để sử dụng các giá trị hạng mục lẫn mẫu mới không muộn hơn ngày 01/05/2023.

Dưới đây là một số điểm cần cân nhắc và ngày quan trọng khác:

• Chuyển mẫu: Ngày 01/04, WhatsApp sẽ chuyển tất cả các mẫu hiện có sang hạng mục mẫu mới. Doanh nghiệp có thể xem cách phân loại mới cho các mẫu của họ trong Trình quản lý WhatsApp và sẽ có thời hạn đến ngày 15/05 để xem xét. Nếu doanh nghiệp không đồng ý với cách phân loại này, họ có thể gửi đơn kháng nghị cho đến ngày 15/05. Mọi mẫu mới được tạo/chỉnh sửa bằng API Đồ thị v15 trở xuống trong khoảng thời gian từ 01/04-01/05 sẽ được chuyển vào ngày 05/05. Do đó, bạn nên bắt đầu gọi v16 để tạo mẫu kể từ ngày 01/04. Từ ngày 01/05, mọi mẫu được tạo trong Trình quản lý WhatsApp hoặc API Đồ thị phiên bản bất kỳ sẽ phản ánh các hạng mục mẫu mới.
• Quy trình tạo mẫu theo hạng mục mẫu mới: Từ ngày 01/04, tất cả các mẫu được tạo trong API Đồ thị v16 và Trình quản lý WhatsApp sẽ phải trải qua quy trình xác thực hạng mục để được phê duyệt. Mọi mẫu mới được tạo/chỉnh sửa đều có thể bị từ chối nếu WhatsApp phát hiện hạng mục đã chọn không chính xác. Lý do từ chối sẽ giải thích rằng hạng mục đã chọn không khớp với nội dung mẫu theo nguyên tắc tạo mẫu của chúng tôi. Sau đó, các doanh nghiệp có thể sửa đổi lựa chọn hạng mục và gửi lại, chỉnh sửa mẫu hoặc kháng nghị quyết định này. Có hiệu lực từ ngày 01/05, các mẫu mới tạo chứa biến sẽ phải có mẫu phù hợp. Có hiệu lực từ ngày 01/06, doanh nghiệp sẽ bị tính phí dựa trên bảng giá mới theo hạng mục mẫu.

Nền tảng Messenger API

Chúng tôi sẽ đơn giản hóa các thông báo định kỳ bằng cách gỡ lựa chọn chỉ định tần suất thông báo kể từ v16. Để biết thêm thông tin, hãy xem bài viết Nhật ký thay đổi của Messenger.

Phiên bản API ngừng hoạt động:

Theo lịch lập phiên bản API Đồ thị và API Marketing của Facebook, vui lòng lưu ý các phiên bản sắp ngừng hoạt động sau đây:

API Đồ thị

• 23/02/2023: API Đồ thị v9.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng
• 08/06/2023: API Đồ thị v10.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng
• 14/09/2023: API Đồ thị v11.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng

API Marketing

• 25/04/2023: API Marketing v14.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng

Để tránh bị gián đoạn hoạt động kinh doanh, bạn nên chuyển tất cả lệnh gọi sang phiên bản API mới nhất ra mắt hôm nay.

SDK Nền tảng Facebook

Theo lịch ngừng hoạt động sau 2 năm của SDK Nền tảng, vui lòng lưu ý các SDK sắp ngừng hoạt động và ngừng cung cấp sau đây:

• 06/2023: SDK Nền tảng Facebook v9.0 trở xuống sẽ ngừng hoạt động
• 10/2023: SDK Nền tảng Facebook v11.0 trở xuống sẽ ngừng hoạt động
• 02/2024: SDK Nền tảng Facebook v12.0 trở xuống sẽ ngừng hoạt động