Câu hỏi thường gặp dành cho nhà phát triển
Account Kit

Nếu bạn gặp lỗi như "Rất tiếc, đã xảy ra lỗi" và gặp khó khăn trong việc xác định nguyên nhân, bạn có thể bật thông báo lỗi chi tiết hơn, nếu muốn. Thông báo này có thể hiển thị cho bạn thêm thông tin hữu ích. Bạn có thể tìm thêm tài liệu về cờ gỡ lỗi cho phương thức init() của SDK này tại https://developers.facebook.com/docs/accountkit/webjs/reference

Xác minh nhanh Account Kit không cần đến mã xác minh qua SMS khi người dùng Android nhập số điện thoại khớp với số điện thoại họ đã liệt kê trên Facebook.

Chỉ có thể sử dụng tính năng này nếu người dùng đang sử dụng ứng dụng Facebook dành cho Android. Nếu chúng tôi không thể xác nhận một lần khớp, thì người dùng này sẽ được đưa qua quy trình thông thường và nhận được mã xác minh qua SMS.

Account Kit sẽ hiển thị giao diện người dùng đã bản địa hóa cho các ngôn ngữ trong danh sách này: https://developers.facebook.com/docs/accountkit/languages.

Vui lòng tham khảo tại đây để biết danh sách cập nhật các quốc gia và mã quay số được hỗ trợ: https://developers.facebook.com/docs/accountkit/countrycodes.

Không, chúng tôi chỉ hỗ trợ liên kết SDK JS qua https://sdk.accountkit.com/en_US/sdk.js. Tập lệnh này sẽ tìm nạp trình tải SDK. Trình tải này sẽ tải SDK mới nhất từ accountkit.com hoặc từ bộ nhớ đệm của trình duyệt.

Đối với các trường hợp mà bạn muốn lưu trữ SDK qua máy chủ của chính mình thì thời gian gia hạn là 24 giờ. Sau khoảng thời gian gia hạn này, SDK sẽ bắt đầu đưa ra cảnh báo và dừng hoạt động sau 7 ngày.

Đặt thông số enableSendToFacebook (trên iOS) hoặc setFacebookNotificationsEnabled (trên Android) thành true.

Người dùng đăng nhập ứng dụng của bạn sẽ nhận được tin nhắn xác nhận qua thông báo Facebook nếu SMS có thể chưa được gửi và nếu số điện thoại họ đang sử dụng là số điện thoại chính được liên kết với tài khoản Facebook.

Bạn sẽ cần thêm quyền INTERNET để gọi các phương thức API. Ngoài ra, bạn có thể chọn thêm các quyền khác để giảm xung đột trong quá trình đăng nhập:

  • Để có quyền truy cập SMS, hãy thêm các quyền RECEIVE_SMSREAD_PHONE_STATE.
  • Để có các tính năng email, hãy thêm quyền GET_ACCOUNTS.

Bạn có thể tìm hiểu thêm về cách tích hợp Account Kit vào ứng dụng Android tại đây.

Android SDK

Khi người dùng mở hộp thoại chia sẻ trên di động hoặc hộp thoại nguồn cấp trên di động, nhưng đóng lại bằng cách hủy, ứng dụng của bạn sẽ được thông báo về điều này thông qua phương thức hồi đáp onSuccess(). Bạn có thể nghĩ rằng hồi đáp onSuccess() là cơ chế để báo hiệu hộp thoại đã được đóng thành công bằng cách nào đó, nhưng bạn không thể sử dụng phương thức này để thiết lập việc nội dung nào đó có thực sự được đăng hay không. Nếu người dùng cũng đã cấp cho ứng dụng của bạn phạm vi quyền "publish_actions", phương thức hồi đáp onCancel() sẽ được gọi khi hủy.

Để xem đầy đủ chi tiết về lớp FacebookCallback, vui lòng xem tài liệu tham khảo.

Nút Thích tự nhiên (LikeView) hoạt động giống như nút Thích trên web. Hầu hết các URL dựa trên Facebook đều không thể sử dụng được do quyền riêng tư. Các ngoại lệ bao gồm trang Facebook và trang chủ của Facebook.

Bạn có thể tiến hành kiểm tra sơ bộ bằng cách sử dụng trình xem trước nút Thích.

Điều này nằm trong dự tính. Chúng tôi đã thấy rất nhiều báo cáo spam và hành vi lạm dụng tính năng này. Để cải thiện trải nghiệm người dùng chung, chúng tôi đã quyết định thực thi thay đổi này.

Có những cách tốt hơn để chia sẻ trên Android được nêu tại đây.

Xét duyệt ứng dụng

We’ve moved all Messenger permissions to the Permissions and Features page.

We've consolidated this into one Permissions and Features page for Business apps, where you can see what access levels you have for each permission and feature.

Yes, developers may opt out of the Business app type and return to the previous App Review process for their app by selecting “Change App Type” on the App Dashboard. However, developers may not opt back into the Business app type and will need to create a new app to do so.

Additionally, apps previously in Development Mode that opt out to the legacy experience that have been approved for Advanced Access via App Review in the new model will lose access to data beyond what their business or anyone with a role on their app owns until they turn their app to Live Mode.

We have replaced Development and Live Mode with Standard and Advanced Access. Standard Access is always active and allows you to access data that a developer’s business or anyone with a role on their app owns. You may submit for App Review for permissions and features to access data owned by other businesses or people. Refer to our Access Levels document to learn more.

Business apps designed to help businesses and organizations manage Pages, Groups, Events, Ads, and ad-related assets.

Dưới đây là những lý do khiến ứng dụng của bạn mất quyền sau lần đầu phê duyệt:
  • Ứng dụng này được chuyển cho một doanh nghiệp khác chưa xác minh. Mọi quyền đã phê duyệt trước đó sẽ bị chặn.
    • Sau đó, nếu ứng dụng được chuyển lại cho doanh nghiệp đã xác minh, các quyền sẽ được bỏ chặn.
  • Ứng dụng được đánh dấu là Cung cấp dịch vụ cho các doanh nghiệp khác nhưng sau đó được chuyển cho một doanh nghiệp khác chưa được xác minh.

Yes, ALL apps that leverage permissions that require review (Pages API, Groups API, Events API, Business Manager API, Instagram Graph API, Messenger Platform, extended Facebook Login permissions, Marketing API and Lead Ads API) must submit for app review in adherence with the communicated deadlines.

Active apps that leverage permissions with an August 1st deadline (Pages API, Groups API, Events API, Business Manager API, Instagram Graph API, Messenger Platform, extended Facebook Login permissions) and have not yet proactively submitted for review will be auto-enrolled in the review process. You can accelerate the App Review process by submitting your app for review prior to auto-enrollment. This will give you more control over when your app is reviewed and what information is used for the review.

Để biết thêm thông tin chi tiết, hãy truy cập vào trang này. Thông qua quy trình này, bạn sẽ có cơ hội cung cấp thông tin chi tiết về việc bạn cần những quyền gì và sử dụng các quyền này như thế nào. Facebook sẽ xem xét trường hợp sử dụng rồi quyết định xem chính sách của chúng tôi có cho phép điều này hay không. Sau khi xem xét quyền, tùy thuộc vào API/quyền, chúng tôi có thể đưa ra thêm các yêu cầu như xác minh doanh nghiệp và ký hợp đồng.

Yêu cầu xét duyệt ứng dụng sẽ tùy vào cấp độ ID ứng dụng. Mỗi ứng dụng riêng lẻ dùng các quyền hoặc tính năng đó đều cần phải được gửi đi xét duyệt.

Yes, if your apps have made calls to the Graph API in the last 28 days as of July 31, 2018 and require access to the reviewable permissions with an August 1st deadline, your app will be auto-enrolled in the app review process. We will notify you when we have a process available to send us the additional information needed to complete the review process.

As we announced earlier this year, all apps accessing the Pages API, Groups API, Events API, Business Manager API, Instagram Graph API, Messenger Platform, and Facebook Login were expected to submit for app review by August 1.

To help protect the integrity of our platform, we have removed API access for apps that require these permissions, have not gone through app review, and have not been active within the last 28 days as of July 31, 2018. If you still need access to our APIs, we encourage you to submit for review through your app's App Dashboard.

All active apps that require these permissions will be auto-enrolled in app review in the coming weeks. Developers will be notified if we require additional information to complete the app review submission. If responses are not received in the allocated timeframe, reviewable API access will be disabled.

Nếu được yêu cầu cung cấp thêm thông tin cho nội dung gửi hiện tại của mình, bạn cần giải quyết và gửi lại nội dung đi xét duyệt trong vòng 30 ngày kể từ khi nhận được yêu cầu. Trong khoảng thời gian 30 ngày đó, đội ngũ Xét duyệt ứng dụng có thể yêu cầu bạn cung cấp thêm thông tin. Vui lòng lưu ý rằng khoảng thời gian 30 ngày này sẽ không đặt lại với mỗi lần gửi lại trong khoảng thời gian này.

Để thử nghiệm một tính năng/quyền mới, sau khi ứng dụng của bạn được xét duyệt và đăng, hãy dùng tính năng Tạo ứng dụng thử nghiệmtrong Bảng điều khiển ứng dụng để tạo bản sao cho ứng dụng chính thức của bạn. Trong Bảng điều khiển của ứng dụng chính thức, hãy nhấp vào mũi tên xuống bên cạnh tên ứng dụng ở ngăn điều hướng phía trên bên trái rồi nhấp vào Tạo ứng dụng thử nghiệm. Bản sao ứng dụng (được tạo ở trạng thái Đang phát triển) cho phép tất cả vai trò trên ứng dụng truy cập vào mọi tính năng và quyền.

Nếu khách hàng cũng là "chủ sở hữu" của ứng dụng, chính họ sẽ phải trải qua quy trình xét duyệt với tư cách là nhà phát triển trực tiếp. Nếu khách hàng có nhà phát triển bên thứ ba là "chủ sở hữu" của ứng dụng, nhà phát triển này sẽ phải trải qua quy trình xét duyệt.

Bạn cần yêu cầu các quyền leads_retrievalpages_manage_ads.

Bạn có thể cung cấp video quay màn hình tích hợp của mình hoặc nếu ứng dụng không có trải nghiệm người dùng cuối, bạn có thể cung cấp tối thiểu 2 ảnh chụp màn hình thể hiện chế độ xem cài đặt của trang, CRM hoặc Trình quản lý kinh doanh cũng như cung cấp ID Trang dành cho trang mà bạn sẽ sử dụng thông qua những sản phẩm này.

Tài liệu ứng dụng máy chủ tới máy chủ của chúng tôi cũng đưa ra các nguyên tắc hoàn thành quy trình xét duyệt ứng dụng đối với các ứng dụng không có giao diện người dùng.

Quy trình Xét duyệt ứng dụng dành cho những ứng dụng cần một số quyền API. Bạn có thể đọc về các quyền cần được xét duyệt tại đây. Đối với trường hợp thiết lập SDK, bạn không cần phải thực hiện quy trình Xét duyệt ứng dụng. Tuy nhiên, SDK cho phép các ứng dụng thực hiện lệnh gọi đến API Facebook. Do đó, nếu các API đó cần được xét duyệt, thì bạn cũng cần gửi ứng dụng đi xét duyệt.

Nếu đã có tài khoản Trình quản lý kinh doanh, bạn nên kết nối ứng dụng với Trình quản lý kinh doanh hiện có.

Nếu có nhiều tài khoản Trình quản lý kinh doanh thuộc về doanh nghiệp, bạn nên xác định lý do cho nhiều tài khoản Trình quản lý kinh doanh và kết nối ứng dụng với Trình quản lý kinh doanh phù hợp nhất. Nếu doanh nghiệp đã thiết lập hạn mức tín dụng thông qua Trình quản lý kinh doanh, bạn nên kết nối ứng dụng với Trình quản lý kinh doanh có hạn mức tín dụng.

Chúng tôi cho phép nhà phát triển cung cấp người dùng thử nghiệm cụ thể nếu có thêm cấu hình, hành động đưa vào danh sách hợp lệ hoặc thông tin trang cá nhân người dùng thử nghiệm mà họ muốn sử dụng. Nếu họ không cung cấp người dùng thử nghiệm, chúng tôi sẽ chỉ sử dụng một trong những người dùng thử nghiệm của riêng mình. Trường này sẽ được đánh dấu là tùy chọn và họ sẽ không bị chặn nếu không hoàn tất trường.

Bạn phải thực hiện quy trình xét duyệt ứng dụng cho mỗi ứng dụng. Bạn nên xem lại bảng điều khiển ứng dụng để nắm được danh sách các quyền cụ thể cần xét duyệt.

Bạn chỉ phải thực hiện quy trình Xác minh doanh nghiệp một lần cho mỗi Trình quản lý kinh doanh. Nếu chọn liên kết tất cả ứng dụng của mình với cùng một Trình quản lý kinh doanh, bạn chỉ cần thực hiện quy trình xác minh doanh nghiệp một lần.

Bạn cần liên kết ứng dụng với Trình quản lý kinh doanh của doanh nghiệp thực sự sở hữu ứng dụng và có quyền truy cập vào dữ liệu được tạo từ ứng dụng. Đây sẽ là doanh nghiệp phải thực hiện quy trình xác minh doanh nghiệp.

Bạn luôn có thể tìm thấy trạng thái của quá trình xác minh doanh nghiệp và hợp đồng, cũng như các bước để thực hiện trong ngăn xác minh doanh nghiệp thuộc tab xét duyệt ứng dụng trên bảng điều khiển ứng dụng. Chúng tôi sẽ gửi cho bạn thông báo trong suốt quy trình để bạn biết được mình cần thực hiện hành động nào.

You need to initiate app review before August 1, 2018 for these APIs: Pages API, Groups API, Events API, Instagram Platform API, Messenger Platform, Business Manager API, and Facebook Login.

You need to initiate App Review before February 1, 2019 for these APIs and features: the Marketing API and the Lead Ads Retrieval feature.

Hiện tại, chúng tôi đang phải xét duyệt một lượng lớn ứng dụng. Toàn bộ quá trình xét duyệt có thể kéo dài vài tuần.

  • Chúng tôi có thể mất đến vài tuần để xét duyệt quyền. Bạn có thể xem thông tin mới nhất của chúng tôi về lịch trình tại đây.
  • Quy trình xác minh doanh nghiệp sẽ diễn ra trong vài ngày nhưng còn tùy thuộc vào chất lượng tài liệu.
  • Thủ tục ký hợp đồng có thể được hoàn tất ngay khi bạn chỉ định một nhân viên ký tên vào hợp đồng.

Theo quy trình xét duyệt, bạn có thể phải cung cấp thông tin về doanh nghiệp như tên hợp pháp, địa chỉ và số điện thoại của doanh nghiệp. Ngoài ra, bạn có thể phải cung cấp giấy tờ kinh doanh như hóa đơn tiện ích, giấy phép, giấy chứng nhận thành lập hoặc điều lệ công ty.

Khi có các API mới, bạn cần yêu cầu quy trình Xét duyệt ứng dụng cho các API này. Tuy nhiên, bạn chỉ cần Xác minh doanh nghiệp một lần cho mỗi thực thể Trình quản lý kinh doanh. Vì thế, bạn không phải Xác minh doanh nghiệp lại nếu ứng dụng cần có các API hoặc quyền mới.

Tất cả ứng dụng có sẵn đang yêu cầu các quyền mở rộng của Đăng nhập Facebook và 6 API (Trang, Messenger, Trình quản lý kinh doanh, Instagram, Nhóm và Sự kiện) sẽ cần gửi sang quy trình Xét duyệt ứng dụng mới, trong đó bao gồm quy trình xác minh doanh nghiệp và ký kết hợp đồng. Không nhất thiết phải hoàn tất, mà chỉ cần gửi yêu cầu Xét duyệt ứng dụng trước ngày này. Nếu không gửi trước ngày 1/8/2018 thì bạn sẽ mất quyền truy cập các API đó vào ngày 2/8/2018.

Tất cả ứng dụng có sẵn yêu cầu Marketing API và API Truy xuất quảng cáo tìm kiếm khách hàng tiềm năng cần gửi sang quy trình Xét duyệt ứng dụng mới, trong đó bao gồm quy trình xác minh doanh nghiệp và ký kết hợp đồng trước ngày 1/2/2019.

Hãy truy cập trang này để biết thêm chi tiết. Nhờ quy trình này, bạn có thể cung cấp các chi tiết về những quyền mình cần và cách bạn sử dụng các quyền đó. Facebook sẽ xem xét trường hợp sử dụng và xác định xem trường hợp đó có được phép theo chính sách của chúng tôi hay không. Sau khi xét duyệt quyền, tùy thuộc vào API/quyền, chúng tôi có thể có thêm các yêu cầu khác, chẳng hạn như xác minh doanh nghiệp và ký kết hợp đồng.

Bạn chỉ cần xác minh doanh nghiệp một lần. Chỉ cần ký hợp đồng một lần ở cấp doanh nghiệp. Các lần gửi ứng dụng tiếp theo sẽ yêu cầu xét duyệt ứng dụng nhưng không cần xác minh.

Nhu cầu xét duyệt ứng dụng dựa trên cấp ID ứng dụng. Bạn đều phải gửi mỗi ứng dụng sử dụng các quyền hoặc tính năng đó để xin xét duyệt.

Vào ngày 1/5/2018, chúng tôi đã công bố quy trình Xét duyệt ứng dụng mới bắt buộc với Đăng nhập Facebook (quyền mở rộng) và 6 API (Trang, Messenger, Trình quản lý kinh doanh, Instagram, Nhóm và Sự kiện). Bạn phải gửi xin Xét duyệt ứng dụng đối với các API/quyền này trước ngày 1/8/2018 để duy trì quyền truy cập vào các API đó.

Vào ngày 2/7/2018, chúng tôi đã công bố các API khác yêu cầu xét duyệt ứng dụng: Marketing API và Truy xuất quảng cáo tìm kiếm khách hàng tiềm năng. Bạn phải gửi xin Xét duyệt ứng dụng đối với các API này trước ngày 1/2/2019 để duy trì quyền truy cập. Bạn có thể đọc thêm về ngày hết hạn tại đây.

Chúng tôi không thay đổi gì về API Trình quản lý kinh doanh trong API Đồ thị phiên bản 3.0. Những ứng dụng yêu cầu quyền Business_Management cần phải được Facebook xét duyệt.

Các thay đổi về chính sách Xét duyệt ứng dụng của Facebook không ảnh hưởng đến ứng dụng dùng API Marketing của Facebook. Vui lòng xem Nhật ký thay đổi API Đồ thị để biết các thay đổi về API thực tế.

Có. Nếu chưa được Xét duyệt ứng dụng, ứng dụng chỉ có thể truy cập vào tên người dùng, địa chỉ email và ảnh đại diện của người dùng. Nếu muốn có tất cả các quyền khác, ứng dụng cần phải được Facebook xét duyệt.

API Instagram không chịu ảnh hưởng từ API Đồ thị phiên bản 3.0. Tuy nhiên, tất cả những ứng dụng dùng API Instagram đều phải được Facebook xét duyệt.

Trong API Đồ thị phiên bản 3.0, các ứng dụng truy cập vào sự kiện cần dùng quyền user_events. Các ứng dụng dùng quyền đó sẽ cần được Facebook xét duyệt.

Quyền user_managed_groups không còn hoạt động trong API Đồ thị phiên bản 3.0. Thay vào đó, ứng dụng có thể dùng API Nhóm mới, cùng với các quyền publish_groupsread_groups_user_data. Muốn có các quyền và API mới này, ứng dụng phải trải qua quy trình xét duyệt của Facebook.

Quyền publish_actions đã ngừng hoạt động trong API Đồ thị phiên bản 3.0. Các ứng dụng vẫn có thể đăng tin thông qua trải nghiệm trung gian, chẳng hạn như hộp thoại Chia sẻ của Facebook trên web hoặc Trang tính chia sẻ dành cho iOS và Android. Ứng dụng có thể đăng lên nhóm thông qua quyền publish_groups. Muốn có quyền này, ứng dụng phải trải qua quy trình xét duyệt.

Có. Trong API Đồ thị phiên bản 3.0, tất cả API Nền tảng Messenger sẽ được đưa vào theo quyền Pages_messaging và cần được xét duyệt.

Có. Những ứng dụng truy cập vào nội dung của các trang công khai cần yêu cầu tính năng Truy cập vào nội dung công khai của Trang và cần được Facebook xét duyệt.

Trong quá trình xét duyệt, đội ngũ xét duyệt của chúng tôi làm theo hướng dẫn của bạn để tái tạo cách dùng quyền trong ứng dụng của bạn. Nếu chúng tôi không thể tái tạo trải nghiệm này, chẳng hạn như do không làm theo được hướng dẫn của bạn hoặc không đăng nhập được vào ứng dụng của bạn, chúng tôi cũng sẽ không thể phê duyệt nội dung gửi.

Để tránh điều này, vui lòng:

  • Cung cấp một phiên bản hoạt động của ứng dụng dùng quyền đó
  • Đảm bảo hướng dẫn của bạn rõ ràng trong phần Thêm ghi chú
  • Đảm bảo các quyền đăng nhập đã yêu cầu giúp cá nhân hóa trải nghiệm của người dùng và tuân thủ nguyên tắc của chúng tôi

Cụ thể, đối với quyền publish_actions, vui lòng xác nhận rằng chức năng đăng của ứng dụng được cấu hình đúng. Chúng tôi phải có khả năng đăng lại nội dung của ứng dụng lên Facebook trong quá trình xét duyệt.

Quy trình Xét duyệt ứng dụng bao gồm việc tải ứng dụng trên mỗi nền tảng được hỗ trợ, đăng nhập bằng Facebook và sử dụng mọi tiện ích tích hợp Facebook mà bạn đang yêu cầu xét duyệt. Điều này thường dẫn đến thứ mà chúng tôi gọi là "vấn đề chung". Đây là những lỗi liên quan đến việc tải ứng dụng, đăng nhập vào ứng dụng hoặc chức năng chung của ứng dụng. Điều này nghĩa là chúng tôi không thể thử nghiệm các quyền bạn yêu cầu trong nội dung gửi của mình.

Vì những vấn đề này khiến chúng tôi không thể xét duyệt chức năng của Facebook, nên chúng tôi không thể bình luận chi tiết về cách ứng dụng của bạn dùng chức năng của Facebook mà bạn đã gửi đi xét duyệt. Chính vì vậy, chúng tôi từ chối với lý do "Vấn đề chung" và phản hồi về sự cố này trên mỗi nền tảng.

Nếu bạn bị từ chối với lý do "Vấn đề chung", vui lòng đọc kỹ tất cả phản hồi. Mỗi nền tảng sẽ nhận được phản hồi riêng giải thích các vấn đề đã gặp phải khi xét duyệt.

Nội dung phản hồi xét duyệt sẽ giải thích rõ ràng về lý do ứng dụng của bạn không được phê duyệt, cũng như các bước tiếp theo bạn cần thực hiện. Chúng tôi muốn giúp bạn vượt qua quy trình này nhanh nhất có thể. Vì vậy, hãy đảm bảo đọc kỹ phản hồi này. Sau khi thực hiện các thay đổi cần thiết, bạn có thể gửi lại để xét duyệt.

Nếu ứng dụng của bạn dùng một quyền theo cách không thể phê duyệt được, phản hồi của chúng tôi sẽ giải thích điều này và bạn không nên gửi lại để xét duyệt.

Để được phê duyệt dùng Trung tâm ứng dụng, ứng dụng của bạn cần đáp ứng các yêu cầu của chúng tôi về tính đủ điều kiện. Ứng dụng đủ điều kiện dùng Trung tâm ứng dụng của Facebook phải sử dụng phương thức Đăng nhập bằng Facebook hoặc có một ứng dụng trên Canvas Facebook.

Dưới đây là những ứng dụng đủ điều kiện xuất hiện trong Trung tâm ứng dụng:

Tài sản văn bản và hình ảnh quảng cáo của bạn cũng phải đáp ứng nguyên tắc của chúng tôi.

Nếu đang sử dụng hộp thoại Chia sẻ hoặc bất kỳ plugin xã hội nào khác để đăng lại nội dung lên Facebook, bạn không cần gửi đi xét duyệt. Nếu vẫn không chắc chắn, bạn có thể tìm thêm thông tin trong tài liệu xét duyệt chung của chúng tôi.

Việc khuyến khích mọi người sử dụng các plugin xã hội hoặc thích một Trang là vi phạm Chính sách nền tảng 4.5. Điều này bao gồm tặng phần thưởng hoặc kiểm soát quyền truy cập ứng dụng hay nội dung ứng dụng dựa vào việc người đó có thích một Trang hay không. User_likes sẽ không được phê duyệt cho mục đích này.

Để đảm bảo kết nối chất lượng và giúp các doanh nghiệp tiếp cận những người quan trọng với họ, chúng tôi muốn mọi người thích Trang vì họ muốn kết nối và biết thông tin từ doanh nghiệp, chứ không phải vì các phần thưởng giả tạo. Chúng tôi tin rằng chính sách này sẽ có lợi cho mọi người cũng như nhà quảng cáo.

Đội ngũ xét duyệt của chúng tôi có thể cần thêm thông tin đăng nhập cho ứng dụng của bạn để hoàn tất quá trình xét duyệt.

Nếu ứng dụng của bạn yêu cầu đăng nhập lần hai trước hoặc sau Đăng nhập bằng Facebook, hãy đảm bảo cung cấp tên người dùng và mật khẩu cho yêu cầu này. Điều này có thể bao gồm thông tin đăng nhập cho một máy chủ thử nghiệm hoặc demo, đăng nhập lần hai cho ứng dụng của bạn hoặc quy trình đăng ký email.

Các ứng dụng được lưu trữ trên máy chủ tách chuyển hoặc phát triển có thể yêu cầu đăng nhập bổ sung để truy cập vào máy chủ của bạn. Vui lòng cung cấp cả mọi thông tin đăng nhập cần thiết cho yêu cầu này.

Nếu vẫn không chắc là còn thiếu thông tin đăng nhập nào, bạn có thể gửi nội dung tiếp theo kèm một video chỉ ra tùy chọn Đăng nhập bằng Facebook và tất cả các tiện ích tích hợp Facebook liên quan mà bạn đang gửi.

Để phê duyệt nội dung ứng dụng mà bạn gửi, đội ngũ xét duyệt của chúng tôi cần đăng nhập vào ứng dụng của bạn và kiểm tra mọi tiện ích tích hợp Facebook.

Nếu người xét duyệt không thể tải hoặc dùng ứng dụng đó, hãy đảm bảo rằng:

  • URL của ứng dụng có thể truy cập công khai và không được cấu hình như một máy chủ cục bộ
  • Bạn đã cung cấp tên người dùng và mật khẩu cần thiết để truy cập vào trang web phát triển hoặc tách chuyển
  • Chứng chỉ bảo mật của trang web được cập nhật và không gây lỗi cho người dùng mới
  • Bạn có thể đăng nhập và dùng ứng dụng của mình như một người dùng thử nghiệm mới tạo
  • Các mục bạn đã gửi để xét duyệt được tạo và hoạt động trong ứng dụng của bạn

Nếu bạn bị từ chối lần nữa vì cùng một lý do, hãy cập nhật phần Hướng dẫn xét duyệt hoặc Thêm ghi chú để yêu cầu người xét duyệt làm rõ hoặc cung cấp thêm thông tin.

Video quay màn hình là cách tuyệt vời để hướng dẫn chúng tôi trong suốt ứng dụng của bạn và cho chúng tôi biết cách bạn dùng các quyền được yêu cầu. Sau đây là một số cách làm tốt nhất và tài nguyên của bên thứ ba để tạo video quay màn hình.

Video của bạn phải hiển thị cách ứng dụng dùng từng quyền mà ứng dụng đó yêu cầu. Nếu bạn đang yêu cầu publish_actions, ứng dụng cũng phải hiển thị cách tạo và chia sẻ nội dung từ ứng dụng của bạn với Facebook.

Bạn không thể sử dụng ID ứng dụng Facebook được tạo cho Trò chơi tức thì với bất kỳ nền tảng nào khác. Bạn có thể tìm thêm thông tin trong tài liệu của chúng tôi.

Đội ngũ xét duyệt của chúng tôi sẽ sử dụng hướng dẫn bạn cung cấp để thử nghiệm các tiện ích tích hợp trên Facebook của ứng dụng.

Nếu bạn cảm thấy người xét duyệt của chúng tôi đã từ chối ứng dụng của bạn không thỏa đáng, bạn nên gửi đi xét duyệt lần nữa cùng với hướng dẫn xét duyệt cập nhật nhằm cung cấp thêm thông tin cho người xét duyệt.

Quy trình xét duyệt là cách tốt nhất để giao tiếp với người xét duyệt nhờ việc cập nhật ghi chú của bạn để xử lý phản hồi bạn đã nhận được.

Đội ngũ xét duyệt của chúng tôi sử dụng nhiều người dùng thử nghiệm khi xét duyệt nội dung gửi và không phải lúc nào chúng tôi cũng sử dụng người dùng thử nghiệm mà bạn cung cấp. Nếu nội dung bạn gửi cần được xét duyệt bằng một người dùng thử nghiệm cụ thể, vui lòng cho chúng tôi biết trong hướng dẫn xét duyệt của bạn.

Nếu bạn cung cấp một người dùng thử nghiệm, hãy đảm bảo bạn đã tạo đúng người dùng thử nghiệm và đính kèm người dùng này cùng với nội dung gửi.

Không. Sau khi được phê duyệt một quyền, bạn có thể dùng quyền đó trên mọi phiên bản của ứng dụng ở mọi nền tảng.

Nếu bạn mở rộng và phát triển ứng dụng trên một nền tảng mới, bạn sẽ không cần gửi quyền này để xét duyệt. Bạn chỉ cần gửi lại để xét duyệt nếu muốn yêu cầu một quyền mới, ví dụ như khi bạn thêm một tính năng mới vào ứng dụng của mình. Nếu bạn thay đổi và gửi Chi tiết ứng dụng hoặc hành động trong Open Graph, các quyền mà bạn đã được phê duyệt sẽ không bị ảnh hưởng.

Nếu ứng dụng của bạn là game và xuất hiện trên Facebook Canvas

Bạn có thể mời những người chơi mới tham gia game của mình bằng cách sử dụng:

  • Hộp thoại Yêu cầu. Khi sử dụng hộp thoại yêu cầu, bạn có thể đặt "filters=app_non_users" để lọc hộp thoại nhằm chỉ hiển thị những người không dùng ứng dụng của bạn. Nếu ứng dụng của bạn xuất hiện trên Canvas, bạn cũng có thể sử dụng hộp thoại Yêu cầu trên iOS và Android.
  • API Bạn bè có thể mời. Nếu ứng dụng của bạn là game và bạn muốn tạo công cụ chọn nhiều bạn bè của chính mình, bạn có thể dùng API Bạn bè có thể mời. API này sẽ trả về danh sách được xếp hạng gồm những bạn bè không dùng ứng dụng của người đó. Sau khi một người chọn nhiều bạn bè để mời, bạn có thể chuyển mã do API Bạn bè có thể mời trả về sang trường thông tin đến trong hộp thoại Yêu cầu. Sau đó, mã này sẽ cho phép người này gửi lời mời đến những người bạn đó.

Nếu ứng dụng của bạn không xuất hiện trên Facebook Canvas

Bạn có thể sử dụng hộp thoại Nhắn tin trên iOSAndroid hoặc hộp thoại Gửi trên Web. Những sản phẩm này cho phép một người nhắn tin trực tiếp cho bạn bè họ kèm liên kết đến ứng dụng của bạn.

Loại tin nhắn này là kênh tuyệt vời để giao tiếp với một nhóm người nhỏ hơn theo cách trực tiếp. Hộp thoại Nhắn tin và hộp thoại Gửi đều có menu đề xuất cho phép mọi người dễ dàng chọn nhiều bạn bè nhận lời mời.

Hiện tại, ứng dụng sẽ không cần phải trải qua quy trình Xét duyệt ứng dụng nếu chỉ dành cho người dùng có vai trò trên ứng dụng và những người chỉ đăng lên dòng thời gian hoặc Trang của chính mình. Tuy nhiên, kể từ ngày 01/08/2018, ứng dụng không thể đăng lên dòng thời gian của Người dùng nữa và bất kỳ ứng dụng nào cho phép Người dùng đăng lên Nhóm hoặc Trang đều phải trải qua quy trình Xét duyệt ứng dụng.

Đội ngũ xét duyệt của chúng tôi sẽ thực sự thử nghiệm cách ứng dụng của bạn dùng từng quyền trên mỗi nền tảng bạn đã liệt kê trong phần cài đặt của ứng dụng. Người xét duyệt đảm bảo rằng quá trình tích hợp phương thức Đăng nhập bằng Facebook diễn ra đúng cách và mỗi quyền được yêu cầu đều tuân thủ các nguyên tắc cũng như nguyên tắc thực tiễn của chúng tôi, đồng thời vẫn cải thiện được trải nghiệm cho người dùng.

Vui lòng xem nguyên tắchướng dẫn thực tiễn của chúng tôi để biết thêm thông tin.

Trước khi phê duyệt yêu cầu về user_likes, người xét duyệt cần xác nhận rằng ứng dụng của bạn cung cấp trải nghiệm độc đáo cho người dùng dựa trên thông tin lượt thích mà ứng dụng nhận được từ họ. Để thực hiện điều này, đội ngũ xét duyệt của chúng tôi sẽ thử nghiệm ứng dụng của bạn bằng nhiều người dùng thử nghiệm khác nhau, mỗi người có một nhóm lượt thích và sở thích khác nhau.

Khi gửi yêu cầu về user_likes, bạn nên viết hướng dẫn chi tiết bao gồm:

  • Phần giải thích rõ lý do bạn yêu cầu user_likes và cách quyền này cải thiện trải nghiệm của mọi người trong ứng dụng của bạn.
  • Danh sách Trang mẫu để người xét duyệt của chúng tôi thích nhằm xác minh việc bạn sử dụng user_likes. Vui lòng cung cấp liên kết trực tiếp đến Trang mà người xét duyệt của chúng tôi phải thích trước khi họ thử nghiệm ứng dụng của bạn.

Nếu bạn đang sử dụng user_likes như một phần thuật toán, điều quan trọng là người xét duyệt có thể nhìn thấy kết quả của thuật toán này và cách thuật toán ảnh hưởng đến nội dung hiển thị cho mọi người.

Trong một số trường hợp, bạn có thể cần người xét duyệt tái tạo một hành vi hoặc trải nghiệm nào đó chỉ khả dụng với một người dùng thử nghiệm cụ thể. Nếu trường hợp này xảy ra, bạn có thể thêm người dùng này vào nội dung gửi của mình trên trang Xét duyệt ứng dụng. Trong phần Mục đang xét duyệt, bạn sẽ nhìn thấy phần Người dùng thử nghiệm (không bắt buộc) cho phép bạn nhập tên người dùng mà bạn muốn sử dụng khi xét duyệt.

Những người dùng thử nghiệm duy nhất có tại đây là những người thuộc danh sách Người dùng thử nghiệm trong phần Vai trò của ứng dụng. Vui lòng không chia sẻ thông tin Đăng nhập bằng Facebook cho những người dùng trong hướng dẫn xét duyệt của bạn.

Tìm hiểu thêm về cách tạo người dùng thử nghiệm.

Không, bạn không cần gửi để xét duyệt để chạy quảng cáo cài đặt ứng dụng di động. Bạn chỉ cần một ứng dụng có trong iTunes App Store hoặc Cửa hàng Google Play. Bạn có thể làm theo hướng dẫn của chúng tôi để tạo quảng cáo cài đặt ứng dụng di động.

Bạn cần giải thích chính xác cách thử nghiệm mỗi quyền hoặc tính năng trong ứng dụng của mình để chúng tôi có thể đảm bảo quyền hoặc tính năng đó hoạt động và tuân thủ các chính sách của chúng tôi. Chúng tôi không thể phê duyệt ứng dụng của bạn nếu không thử nghiệm được đầy đủ cách ứng dụng đó tích hợp với Facebook. Việc cung cấp hướng dẫn chi tiết giúp bạn tránh khả năng phải gửi lại để xét duyệt.

Đối với mỗi quyền bạn yêu cầu, hãy liệt kê hướng dẫn tái tạo theo định dạng từng bước. Mọi hướng dẫn đều phải bằng tiếng Anh.

Hướng dẫn của bạn không nên:

  • Tham chiếu hướng dẫn từ các nội dung gửi hoặc tài liệu khác
  • Tóm tắt chức năng của ứng dụng thay vì cung cấp hướng dẫn
  • Cung cấp chi tiết kỹ thuật về cách hoạt động của API

Dưới đây là ví dụ điển hình về hướng dẫn từng bước:

  1. Nhấn nút Cài đặt ở menu bên trái.
  2. Chọn Đăng nhập bằng Facebook
  3. Hoàn tất bước thứ 3
  4. Hoàn tất bước thứ 4

Nếu bạn vẫn không biết chắc cần cung cấp những gì, vui lòng xem thêm ví dụ trong phần ví dụ về quy trình Xét duyệt ứng dụng của chúng tôi.

Do các thay đổi gần đây về quy trình xét duyệt và dự kiến khối lượng nội dung gửi lớn, nên có thể mất vài tuần để hoàn thành việc xét duyệt các ứng dụng đã gửi.

Để giúp ích cho người xét duyệt, vui lòng cung cấp nhiều thông tin nhất có thể, bao gồm ảnh chụp màn hình rõ ràng, hướng dẫn chi tiết cũng như video quay lại màn hình của ứng dụng và quá trình tích hợp Facebook cho ứng dụng đó.

Những ứng dụng dùng các sản phẩm chia sẻ qua trung gian, chẳng hạn như plugin xã hội, hộp thoại chia sẻ và trang tính chia sẻ hoặc một phần phương thức Đăng nhập bằng Facebook không cần phải được Facebook xét duyệt. Để tìm hiểu thêm những ứng dụng nào cần được xét duyệt, vui lòng xem tài liệu Xét duyệt ứng dụng của chúng tôi.

Chúng tôi xét duyệt ứng dụng để đảm bảo trải nghiệm Facebook chất lượng cao trên các ứng dụng. Nói chung, mọi người phải biết rằng họ đang đăng nhập và đăng lên Facebook. Mọi người phải có khả năng kiểm soát thông tin họ chia sẻ với ứng dụng của bạn hoặc chia sẻ lại với Facebook.

Lưu ý: Những người được liệt kê trong tab Vai trò của ứng dụng sẽ có các quyền mở rộng mà không cần trải qua xét duyệt (ví dụ: user_posts). Tuy nhiên, khi được phát hành công khai, ứng dụng cần phải được xét duyệt thì mới có thể truy cập vào thông tin, ngay cả đối với những người có vai trò trên ứng dụng.

Mọi chức năng đều dùng được khi ứng dụng ở Chế độ phát triển. Tuy nhiên, ở chế độ này, bạn sẽ chỉ có thể truy cập vào dữ liệu của mình, dữ liệu của người dùng thử nghiệm hoặc dữ liệu của trang. Nếu bạn muốn phát hành công khai ứng dụng (ngay cả khi bạn là người dùng duy nhất), ứng dụng này phải trải qua quy trình xét duyệt.

Trình quản lý kinh doanh

Nếu yêu cầu danh sách trang cho một Doanh nghiệp qua /BUSINESS_ID/pages, thì không phải mọi trường của trang đều có thể yêu cầu được và API này có thể phản hồi với một lỗi: (#100) Unknown fields: <FIELD_NAME>.

Điều này là do điểm cuối này không trả về một đối tượng Trang như các điểm cuối tương tự khác và điểm cuối này cũng bao gồm cả các yêu cầu đang chờ xử lý chưa được phê duyệt. Do đó, không thể sử dụng mở rộng trường để trả về các trường từ Trang này.

Bạn có thể sử dụng <BUSINESS_ID>/owned_pages hoặc <BUSINESS_ID>/client_pages - cả hai điểm cuối đó sẽ trả về đối tượng Trang và hỗ trợ mở rộng trường.

Để gửi yêu cầu cho trang đã xác minh, Trình quản lý đối tác của Facebook phải cấu hình doanh nghiệp để cho phép thực hiện các yêu cầu như vậy đối với tổ chức được liên kết với trang. Doanh nghiệp không có Trình quản lý đối tác của Facebook sẽ không thể thực hiện các yêu cầu như vậy.

Kiểm tra việc sử dụng dữ liệu

Với quy trình Kiểm tra việc sử dụng dữ liệu, quản trị viên ứng dụng cần phải:
1. Xem xét các tính năng và quyền được phê duyệt của ứng dụng
2. Xác nhận rằng ứng dụng đó tuân thủ cách sử dụng hợp lệ
3. Xác nhận việc tuân thủ Điều khoản nền tảngChính sách dành cho nhà phát triển của Facebook cùng với tất cả các điều khoản cũng như chính sách hiện hành khác

Kiểm tra việc sử dụng dữ liệu và Xét duyệt ứng dụng là 2 quy trình đánh giá tính toàn vẹn của nền tảng tuy khác biệt nhưng lại có liên quan với nhau. Xét duyệt ứng dụng là quy trình hướng đến tương lai nhằm kiểm soát quyền sử dụng một số quyền của Nền tảng Facebook. Trong quy trình này, nhà phát triển phải gửi đơn đăng ký để xin cấp quyền truy cập vào nền tảng. Đội ngũ phụ trách Hoạt động của nhà phát triển sẽ xét duyệt quy trình này theo cách thủ công. Sau khi được cấp quyền truy cập vào nền tảng, trong quy trình hàng năm Kiểm tra việc sử dụng dữ liệu, nhà phát triển phải xác nhận rằng việc họ tiếp tục sử dụng dữ liệu của Facebook tuân thủ Điều khoản nền tảngChính sách dành cho nhà phát triển của chúng tôi.

Những nhà phát triển quản lý nhiều ứng dụng có thể hoàn tất quy trình Kiểm tra việc sử dụng dữ liệu cho nhiều ứng dụng cùng lúc. Để xem quy trình này, bạn có thể truy cập vào trang “Ứng dụng của tôi” trong Bảng điều khiển ứng dụng. Từ đó, bạn sẽ thấy tất cả ứng dụng mà bạn là quản trị viên, có thể lọc ra một nhóm nhỏ (ví dụ: chỉ những ứng dụng cần phải Kiểm tra việc sử dụng dữ liệu) và hoàn tất quy trình đó.

Bạn sẽ cần hoàn tất quy trình kiểm tra đối với mỗi ứng dụng mà mình quản lý (mỗi ứng dụng có thể có nhiều quyền). Bạn có thể xác nhận cho từng ứng dụng và ưu tiên ứng dụng mà mình muốn, miễn là bạn hoàn tất quy trình này trước thời hạn quy định cho mỗi ứng dụng.

Bạn sẽ được nhắc xác nhận tất cả các quyền mình được phép sử dụng. Tuy nhiên, nếu nhận thấy mình không cần dùng một số quyền nữa, bạn có thể gỡ các quyền đó để không cần phải xác nhận.

Chế độ đã đăng và Chế độ phát triển là 2 chế độ ứng dụng liên quan đến chức năng của ứng dụng và quy trình Kiểm tra việc sử dụng dữ liệu. Chế độ phát triển thường dùng để thử nghiệm, tìm hiểu các quyền/sản phẩm API và hoàn tất quy trình Xét duyệt ứng dụng. Ứng dụng ở Chế độ phát triển không thể gọi dữ liệu ở cấp độ người dùng. Chế độ đã đăng dùng cho các trường hợp sản xuất. Chế độ này không kiểm soát quyền truy cập đối với dữ liệu/quyền mà ứng dụng đã được phê duyệt trong quy trình Xét duyệt ứng dụng. Chỉ những ứng dụng ở Chế độ đã đăng mới cần phải Kiểm tra việc sử dụng dữ liệu.

Nói chung, chúng tôi tìm cách nhóm thời hạn của nhiều ứng dụng với nhau nếu các ứng dụng đó có cùng một quản trị viên. Vì vậy, các ứng dụng của bạn sẽ có cùng một thời hạn. Tuy nhiên, có thể có những trường hợp ngoại lệ khiến một số quản trị viên ứng dụng cần hoàn tất quy trình này ở những thời hạn khác nhau. Chẳng hạn, nếu bạn tạo 1 ứng dụng sau khi các ứng dụng khác đã trải qua quy trình Kiểm tra việc sử dụng dữ liệu, ứng dụng đó sẽ có 1 thời hạn hàng năm khác.

Để xem tất cả ứng dụng cần phải Kiểm tra việc sử dụng dữ liệu, bạn có thể truy cập vào trang "Ứng dụng của tôi" trong Bảng điều khiển ứng dụng. Ở đó, bạn có thể xem tất cả ứng dụng mình quản lý và lọc ra những ứng dụng cần phải Kiểm tra việc sử dụng dữ liệu.

Quản trị viên ứng dụng nên hoàn tất quy trình này. Để xem lại ai là quản trị viên ứng dụng của bạn, hãy đăng nhập vào Bảng điều khiển ứng dụng rồi nhấp vào “Vai trò” ở bên trái trang đó. Quản trị viên ứng dụng phải giữ vai trò có quyền hạn để hành động thay mặt cho tổ chức của bạn.

Quản trị viên nào của ứng dụng cũng có thể xác nhận. Nếu một ứng dụng có nhiều quản trị viên, chỉ một quản trị viên cần xác nhận.

Bạn sẽ có 60 ngày kể từ thời điểm quy trình này bắt đầu (khi bạn nhận được Thông báo đầu tiên dành cho nhà phát triển) cho đến thời hạn cần hoàn tất.

Sau khi hết hạn, chúng tôi sẽ bắt đầu thu hồi quyền truy cập vào nền tảng bằng cách giới hạn các lệnh gọi API trong một tháng kể từ khi hết hạn. Trong khoảng thời gian này, bạn có thể chuyển đến Bảng điều khiển ứng dụng rồi hoàn tất quy trình Kiểm tra việc sử dụng dữ liệu để đưa ứng dụng lại về trạng thái tuân thủ và khôi phục hoàn toàn quyền truy cập vào nền tảng. Tuy nhiên, sau 1 tháng này, chúng tôi sẽ thu hồi toàn bộ quyền truy cập vào nền tảng.

Bạn vẫn có thể quay lại Bảng điều khiển ứng dụng, hoàn tất quy trình Kiểm tra việc sử dụng dữ liệu và khôi phục quyền truy cập. Tuy nhiên, theo định kỳ, chúng tôi tiến hành “thu hồi quyền” không hoạt động của các ứng dụng không hoạt động. Điều này nghĩa là sau một khoảng thời gian không hoạt động nhất định, chúng tôi có thể thu hồi vĩnh viễn các quyền của bạn. Khi đó, bạn sẽ cần phải gửi ứng dụng đi Xét duyệt để lấy lại quyền truy cập. Bạn nên hoàn tất quy trình Kiểm tra việc sử dụng dữ liệu trước thời hạn để tránh xảy ra trường hợp này.

Quy trình Kiểm tra việc sử dụng dữ liệu sẽ hiển thị tất cả các quyền mà ứng dụng của bạn được phép dùng, bất kể bạn có đang tích cực dùng các quyền đó hay không. Bạn nên tận dụng cơ hội này để kiểm tra tiện ích tích hợp của mình, hiểu rõ hơn các tính năng của ứng dụng và gỡ mọi quyền mà bạn không cần dùng.

Trong một số trường hợp, chúng tôi sẽ hiển thị thông tin về việc sử dụng API ngay trong quy trình Kiểm tra việc sử dụng dữ liệu. Nếu không, bạn có thể chuyển đến phần “Quyền và tính năng” trên Bảng điều khiển ứng dụng để xem cấp độ sử dụng của từng quyền. Sau khi đăng nhập, hãy nhấp vào “Xét duyệt ứng dụng” ở bên trái trang rồi chọn “Quyền và tính năng” trong danh sách thả xuống. Bạn sẽ thấy một cột tên là “Lệnh gọi API”. Cột này có dấu chọn màu xanh lá cây nếu nhật ký của chúng tôi cho thấy rằng bạn đang tích cực sử dụng quyền. Hãy nhớ rằng đây chỉ là sự ước đoán. Bạn nên liên hệ với đội ngũ phát triển để biết liệu tiện ích tích hợp của mình có phải dùng quyền đó hay không.

Chúng tôi đang yêu cầu nhà phát triển xác nhận các quyền “cơ bản” được cấp tự động này vì các quyền đó được sử dụng rộng rãi và cho phép truy cập vào dữ liệu người dùng. Tuy nhiên, nếu chưa sử dụng dữ liệu này, bạn vẫn phải hoàn tất quy trình trên vì việc xác nhận cho thấy rằng bạn tuân thủ khi sử dụng (kể cả khi không sử dụng) quyền.

Trước tiên, bạn nên dùng Bảng điều khiển ứng dụng để gỡ quyền đó (nhấp vào mục “Quyền và tính năng của tôi” trong danh sách thả xuống ở bên trái thuộc phần “Xét duyệt ứng dụng”). Sau đó, bạn có thể xác nhận những quyền và tính năng còn lại mà bạn vẫn đang sử dụng.

Tuy nhiên, bạn không thể gỡ một số quyền được cấp tự động. Bạn có thể được yêu cầu xác nhận những quyền đó. Nếu chưa sử dụng dữ liệu này, bạn vẫn phải hoàn tất quy trình trên vì việc xác nhận cho thấy rằng bạn tuân thủ khi sử dụng (kể cả khi không sử dụng) quyền.

Không. Sau khi gỡ quyền trong Bảng điều khiển ứng dụng, bạn có thể làm mới trang Kiểm tra việc sử dụng dữ liệu và quyền bạn đã gỡ sẽ biến mất.

Bạn sẽ phải hoàn tất quy trình Kiểm tra việc sử dụng dữ liệu đối với tất cả các quyền mà ứng dụng của bạn được phép dùng.

Chúng tôi sẽ tiến hành ra mắt quy trình Kiểm tra việc sử dụng dữ liệu theo giai đoạn nên bạn cần hoàn tất quy trình này trong những tháng sắp tới. Mỗi nhà phát triển sẽ có một thời hạn riêng. Hãy nhớ cập nhật thông tin liên hệ của bạn trong Bảng điều khiển ứng dụng và xem Thông báo dành cho nhà phát triển để biết thời hạn cụ thể dành cho bạn.

Tài khoản và dịch vụ dành cho nhà phát triển

In order to comply with certain legal obligations, Meta’s developer services may not be available in all locations, including countries and regions currently subject to U.S. sanctions prohibitions.

Registration reviews may take longer and you may be unable to access our service during that time. Please try again in a few days. For more information, please refer to Meta’s Terms of Service.

We are currently reviewing your registration details. This takes 24 to 48 hours. Once completed and approved, you may be able to login and complete your registration.

Công cụ dành cho nhà phát triển

Bạn không thể xóa ảnh chụp màn hình hoặc hình ảnh biểu ngữ đã được phê duyệt cho Trung tâm ứng dụng. Để thay thế các hình ảnh này bằng hình ảnh mới, hãy nhấp vào "Chỉnh sửa" trên ảnh chụp màn hình hoặc biểu ngữ và chọn hình ảnh thay thế.

Kiểm tra xem bạn có nhìn thấy thông báo lỗi khi không yêu cầu ảnh người dùng không và xác minh rằng thông báo lỗi có hiển thị lúc đầu. Sau đó, tiếp tục thực hiện yêu cầu API me/photos dưới đây rồi quay lại kiểm tra xem thông báo lỗi còn hiển thị không. Thông báo lỗi này sẽ không hiển thị nữa. Đảm bảo khi thử lệnh gọi me/photos, bạn sử dụng ứng dụng chủ định và lấy đúng mã truy cập yêu cầu quyền user_photos. Mọi thứ sẽ diễn ra như mong đợi!

Mục đích của quá trình kiểm tra này là đảm bảo nhà phát triển đã thử nghiệm kỹ tính năng trong ứng dụng trước khi yêu cầu chúng tôi cấp quyền tương tự. Việc thử nghiệm trong ứng dụng thử nghiệm sẽ không đảm bảo hoạt động ổn định tương tự như trong ứng dụng chính. Chúng tôi cần bạn đưa ra yêu cầu thử nghiệm từ ứng dụng chính để đảm bảo bạn thấy ứng dụng hoạt động như dự kiến trước khi cung cấp cho đối tượng bên ngoài. Vui lòng thực hiện các bước đã cho để đưa ra yêu cầu thủ công và kiểm tra xem bạn còn thấy cảnh báo này trên bảng điều khiển của mình nữa không.

Chuyển 'Bảo mật URL bài viết trong luồng' sẽ ngăn ứng dụng Facebook đăng bất kỳ URL nào không trỏ lại về một miền mà ứng dụng đó sở hữu. Vui lòng không sử dụng tùy chọn này nếu Ứng dụng của bạn đăng liên kết tới các trang web khác.

Tính năng bảng điều khiển này đã bị xóa. Bạn cần sử dụng điểm cuối '/{app-id}/accounts/test-users/' để liên kết người dùng thử nghiệm với ứng dụng. Bạn có thể đọc thêm thông tin tại đây.

Điều này nằm trong dự tính và được nêu tại đây - https://developers.facebook.com/docs/apps/test-users#rules - Người dùng thử nghiệm không thể trở thành người hâm mộ của Trang Facebook công khai hoặc tạo nội dung trên đó, chẳng hạn như viết lên tường của Trang. Tuy nhiên, người dùng thử nghiệm có thể xem và tương tác với bất kỳ tab ứng dụng nào trên Trang được liên kết với ứng dụng đã tạo ra tab đó.

Điều này nằm trong dự tính. Chúng tôi không cho phép nhiều miền tùy ý vì lý do bảo mật.

Đăng nhập bằng Facebook

Điều này nằm trong dự tính. Hộp thoại Đăng nhập sử dụng chiều rộng cố định và sẽ không mở rộng cho vừa với màn hình lớn hơn.

Điều này nằm trong dự tính. Trách nhiệm của nhà phát triển là đặt 'redirect_uri' thích hợp dựa trên thiết bị của người dùng, do đó, nếu người dùng sử dụng thiết bị di động thì 'redirect_uri' sẽ là URL trang web di động.

Điều này nằm trong dự tính, vì việc này sẽ giúp ngăn chặn lỗ hổng bảo mật. Một số trình duyệt sẽ thêm đoạn hash từ URL vào cuối URL mới mà trình duyệt được chuyển hướng tới (nếu bản thân URL mới đó không có đoạn hash).

Ví dụ: nếu example1.com trả về chuyển hướng tới example2.com, thì trình duyệt sẽ chuyển từ example1.com#abc thành example2.com#abc và nội dung đoạn hash từ example1.com sẽ truy cập được bằng tập lệnh trên example2.com.

Vì hệ thống có thể chuyển hướng giữa các luồng xác thực nên có thể truy cập dữ liệu xác thực nhạy cảm giữa các ứng dụng. Dữ liệu này được chuyển bằng cách thêm đoạn hash mới vào URL chuyển hướng để ngăn chế độ hoạt động này của trình duyệt. Nếu quan tâm đến yếu tố thẩm mỹ hoặc chế độ hoạt động phía máy khách của URL đích, thì bạn có thể sử dụng window.location.hash (hay thậm chí là chuyển hướng phía máy chủ của chính bạn) để xóa các phần không mong muốn.

API Đồ thị

Test apps created from Business apps will have Standard Access for all permissions and features.

No. For a given permission, Business apps have either None, Standard, or Advanced Access.

Yes. For Business apps, the Advanced Access level includes access to all data within the Standard Access level.

Để chia sẻ URL, hình ảnh liên kết cần có kích thước tối thiểu là 200x200 px. Nếu không, bạn sẽ gặp lỗi tương tự như "og:image được cung cấp không đủ lớn. Vui lòng sử dụng hình ảnh có kích thước tối thiểu là 200x200 px."

Để chọn một hình ảnh cho URL, trước tiên chúng tôi cần xem xét thẻ 'og:image' của bạn, xem thẻ đó có tồn tại không và có trên mức yêu cầu 200x200 px không. Nếu thẻ 'og:image' không tồn tại, chúng tôi sẽ chọn hình ảnh đầu tiên mà chúng tôi thấy trên trang web.

Nếu bạn gặp lỗi nhưng nghĩ rằng hình ảnh trang web của mình lớn hơn 200x200 px, thì bạn cần xác minh rằng mình đã đặt chính xác thẻ 'og:image', vì nguyên nhân có thể nhất là chúng tôi đang truy xuất không đúng hình ảnh từ trang web của bạn.

Chúng tôi đã thay đổi chế độ hoạt động của plugin chia sẻ để nhất quán với các plugin và tính năng khác trên nền tảng của mình.

Trình chia sẻ sẽ không chấp nhận thông số tùy chỉnh nữa và Facebook sẽ lấy thông tin được hiển thị trong bản xem trước giống như hiển thị trên Facebook dưới dạng bài viết, từ thẻ meta OG của URL.

Không, bạn không thể ghi đè 'chú thích' trên URL được chia sẻ, mà chỉ ghi đè được 'tiêu đề' và 'mô tả'.

Một ứng dụng không thể tải lên album do các ứng dụng khác tạo.

Trong một số trường hợp, có các album không được liên kết với bất kỳ ứng dụng nào (Album ảnh trên tường). Chúng tôi khuyên bạn nên kiểm tra trường can_upload. Nếu trường can_upload trả về giá trị sai, điều đó nghĩa là người dùng không thể đặt trực tiếp ảnh vào album này qua chế độ xem Album trên trang cá nhân của họ.

Nút kêu gọi hành động sẽ hiển thị bên dưới biểu tượng 'phát lại' sau khi kết thúc video.

GIF phải có kích thước dưới 8MB để có thể phát được trên Facebook.

Việc tạo bình luận cho bài viết chưa đăng thông qua API hiện chưa được hỗ trợ.

Bài viết có video được tạo trực tiếp sẽ không hiển thị trong điểm cuối promotable_posts vì bài viết đó đã được quảng cáo. Bài viết có video được tạo trực tiếp là bài viết được tạo trong quá trình tạo quảng cáo, do đó không thể quảng cáo riêng.

Vì vậy, bài viết được tạo trực tiếp sẽ không hiển thị trong điểm cuối /promotable_posts.

Điều này có thể xảy ra nếu bạn đang sử dụng Mã truy cập trang, trong đó người dùng được liên kết với mã truy cập không được liệt kê là nhà phân tích trong Vai trò trên Trang bên dưới Cài đặt của trang.

Khi yêu cầu dữ liệu bằng API Đồ thị, nhiều quy tắc quyền riêng tư khác nhau sẽ được áp dụng khiến một số dữ liệu không được trả về mặc dù bạn có thể xem dữ liệu đó trong trang web. Điều này có thể phụ thuộc vào nhiều yếu tố khác nhau, như cài đặt quyền riêng tư của người dùng, quyền cấp độ ứng dụng, v.v. Tức là dữ liệu do API trả về không nhất thiết bao gồm tất cả dữ liệu nhìn thấy trên trang web.

Nếu bài viết được tạo bằng 'object_story_spec' của API Quảng cáo, các bài viết này sẽ được phân loại là trực tiếp. Để xem các bài viết này, bạn cần sử dụng cạnh /{page-id}/promotable_posts và sử dụng phần bổ trợ 'is_inline' trong v2.3 trở xuống và 'include_inline' trong v2.4 trở lên. Bạn có thể đọc thêm tại đây.

Trường lượt chia sẻ sẽ trả về khi bài viết được chia sẻ nhiều hơn 10 lần. Nếu bài viết được chia sẻ ít hơn 10 lần, chúng tôi có thể bỏ qua trường này hoặc cố trả về một số.

Bạn có thể tìm hiểu thêm về điểm cuối này tại đây: https://developers.facebook.com/docs/graph-api/reference/v2.4/post.

Đây là giá trị cũ được sử dụng trên cơ sở hạ tầng cũ và chúng tôi giữ lại giá trị này cho khả năng tương thích ngược khi chuyển sang giá trị mới hơn.

Điều này xảy ra với các bài viết cũ chứ không phải bài viết gần đây.

Điều này nằm trong dự tính. Không có kết nối nào giữa bài viết và các ảnh trong bài viết. Chúng tôi chỉ trả về hình ảnh đầu tiên được tải lên trong bài viết.

Trường 'ứng dụng' sẽ không được trả về nếu bài viết được ghi nhận cho trang web hoặc ứng dụng di động của Facebook. Điều này phù hợp với trang web không hiển thị ghi nhận cho các loại bài viết đó.

Trường "quyền riêng tư" của một Bài viết sẽ bao gồm thông tin về chế độ hiển thị của bài viết đó trên Facebook, nhưng khi một bài viết trên Trang được nhắm mục tiêu hoặc được kiểm soát truy cập để chỉ hiển thị với đối tượng cụ thể, thông tin trong trường "quyền riêng tư" sẽ không hiển thị tất cả tùy chọn nhắm mục tiêu đã chọn.

Để xem đầy đủ chi tiết về cách Bài viết được nhắm mục tiêu hoặc được kiểm soát truy cập, hãy kiểm tra trường 'nhắm mục tiêu' (đối với kiểm soát truy cập) và trường 'feed_targeting' (đối với nhắm mục tiêu trong Bảng tin). Vui lòng xem tài liệu về Bài viết để biết thêm thông tin về những trường nào có sẵn.

Giá trị comment_count được trả về cho bài viết có thể bao gồm các bình luận đã bị ẩn hoặc xóa. Số lượng bình luận hiển thị trên một bài viết sẽ không bao giờ lớn hơn comment_count.

Bạn không thể ghi đè 'chú thích' của một URL được chia sẻ. Bạn chỉ có thể ghi đè 'tiêu đề' và 'mô tả' của URL đó.

Để biết thêm thông tin và các trường bạn có thể đăng qua API Đồ thị, vui lòng xem tài liệu /feed tại đây: https://developers.facebook.com/docs/graph-api/reference/v2.3/page/feed#publish

Điều này nằm trong thiết kế. Điều đó phù hợp với cách hiển thị nội dung do ứng dụng Facebook (di động hoặc web) tạo (mà không ghi nhận cho chính Facebook).

Phía chúng tôi đã thực hiện một số cập nhật về cách dữ liệu luồng và dữ liệu bài viết được truy xuất cũng như hiển thị qua API.

Nếu bạn gặp vấn đề khi tìm nạp bài viết từ API và tin rằng tính năng này không hoạt động như đã nêu, vui lòng xác minh thông tin sau -

  • mã truy cập bạn đang sử dụng có quyền thích hợp để truy cập bài viết mà bạn quan tâm.
  • Hãy đảm bảo rằng bất kỳ lệnh gọi API nào bạn thực hiện để truy xuất bài viết đều đang sử dụng 'id' được trả về cho bạn trong lệnh gọi trước và bạn không tạo thủ công ID dựa trên ID trang, ID người dùng hoặc các ID khác.

Ảnh được tải lên qua Instragram sẽ được đăng dưới dạng hành động trong Open Graph và yêu cầu quyền truy cập Open Graph thích hợp để đọc từ API Đồ thị.

Trong trường hợp ảnh trên Instagram, quyền yêu cầu sẽ là "user_actions:instapp" trong đó "instapp" là vùng tên ứng dụng của Instagram.

Các hành động trong Open Graph không xuất hiện trên kết nối /feed nhưng khi một ảnh được tải lên dưới dạng hành động trong Open Graph, thì ảnh đó có thể được truy cập bằng quyền thích hợp qua kết nối album của người dùng hoặc kết nối /photos nếu có.

Bạn có thể tìm thêm thông tin về quyền truy cập Open Graph tại đây.

Điều đó nằm trong dự tính. Hệ thống của chúng tôi sẽ trả về thông báo lỗi ở trên cho các đối tượng đã bị xóa hoặc không hiển thị đối với kiểm tra quyền riêng tư/quyền.

Điều này nằm trong dự kiến và hình thức phân trang này không được hỗ trợ cho bình luận.

Trường total_count dành cho thông số tóm tắt của điểm cuối /{user-id}/accounts có thể trả về một số cao hơn dự đoán. Lý do là vì total_count bao gồm mọi trang đã xóa mà người dùng cũng là quản trị viên.

Tuy nhiên, dữ liệu được chính điểm cuối trả về sẽ chỉ bao gồm các trang không bị xóa.

Điểm cuối /user/likes đã thay đổi từ phân trang theo thời gian (sử dụng 'since' và 'until' làm thông số) thành phân trang dựa vào con trỏ (sử dụng các thông số 'before' và 'after').

Bạn có thể đọc thêm về các khác biệt đó tại đây: https://developers.facebook.com/docs/graph-api/using-graph-api/v2.3#paging

Bằng việc giới thiệu ID người dùng trong ứng dụng, chúng tôi đã thay đổi cách điểm cuối trả về dữ liệu.

Vì v1.0 không được dùng nữa nên chúng tôi sẽ tập trung vào v2.x ở đây. /v2.0/{id} có thể trả về https://www.facebook.com/{id} hoặc có thể trả về https://www.facebook.com/app_scoped_user_id/{id}.

Điều này nằm trong dự tính. Lỗi này nghĩa là mã truy cập bạn đang cố gia hạn không thể truy cập ID ứng dụng đang cố gia hạn mã truy cập đó.

Lý do có thể nhất cho lỗi này là ứng dụng của bạn đã áp dụng các hạn chế về nhân khẩu học và chúng tôi phát hiện thấy rằng người dùng có mã truy cập mà bạn đang cố gia hạn không đáp ứng các hạn chế đó (hoặc không còn đáp ứng các hạn chế đó nữa, họ có thể đã chuyển vị trí hoặc có thể chúng tôi đã phát hiện được vị trí chính xác hơn cho họ).

Lý do có thể nhất tiếp theo là chúng tôi không thể xác nhận rằng người dùng đáp ứng các yêu cầu (ví dụ: chúng tôi không biết vị trí của họ) và các hạn chế của ứng dụng không cho phép những người dùng này truy cập ứng dụng.

Kể từ tháng 7/2013, bạn không thể sử dụng điểm cuối tìm kiếm bằng email trong loại tìm kiếm người dùng nữa.

Ngoài ra, còn có vô số các thay đổi đối với API Đồ thị khi giới thiệu v2.0. Hiện chưa thể tìm kiếm trên các bài viết công khai và tìm kiếm từ khóa với v2.0.

Vui lòng xem nhật ký thay đổi để biết thêm chi tiết.

Bất kỳ ứng dụng nào được tạo sau 30/4/2014 đều sử dụng API phiên bản 2 trở lên. Phiên bản này chỉ trả về bạn bè trong ứng dụng với điểm cuối /me/friends, như bạn đã nêu. Hơn nữa, tất cả ID người dùng hiện giờ sẽ là ID người dùng trong ứng dụng. ID này là duy nhất và vĩnh viễn đối với ứng dụng cụ thể của bạn.

Bạn có thể tìm hiểu thêm về tất cả các tính năng và thay đổi mới được giới thiệu trong v2.0.

Tài liệu về trường email của đối tượng User nêu rõ chế độ hoạt động dự kiến này tại đây, đó là: "trường này sẽ không được trả về nếu không có địa chỉ email hợp lệ".

Có nhiều trường hợp mà bạn có thể nghĩ rằng người dùng lẽ ra phải được trả về địa chỉ email nhưng lại không. Vì lý do bảo mật và quyền riêng tư, chúng tôi không thể giải thích lý do chính xác khiến địa chỉ email của bất kỳ người dùng cụ thể nào không được trả về.

Một số lý do có thể bao gồm:

  • Không có địa chỉ email trên tài khoản
  • Không có địa chỉ email đã xác nhận trên tài khoản
  • Không có địa chỉ email đã xác minh trên tài khoản
  • Người dùng đã nhập điểm kiểm tra bảo mật yêu cầu họ xác nhận lại địa chỉ email của mình mà họ chưa làm vậy
  • Địa chỉ email của người dùng không liên hệ được
Bạn cũng cần có quyền mở rộng 'email', ngay cả đối với những người dùng có địa chỉ email hợp lệ, đã xác nhận, liên hệ được trên hồ sơ.

Không thể tìm nạp các bài viết này qua API vì trong các bài viết đó, nội dung của người dùng được chia sẻ lại trên trang và người dùng đó chưa cho phép ứng dụng xem nội dung của mình.

Bài viết của người dùng được chia sẻ trên dòng thời gian của trang sẽ không có sẵn qua API nếu người dùng tắt quyền cơ bản đối với loại nội dung của bài viết.

Một cách để xem bài viết có ảnh bị thiếu của người hâm mộ là bạn có thể tìm nạp album trên trang bằng mã truy cập trang - các ảnh sẽ nằm trong album Ảnh trên Dòng thời gian

Mặc dù bài viết ở chế độ công khai và nhắc đến Trang được yêu cầu, nhưng Ứng dụng của bạn không thể xem các bài viết đó khi không có quyền read_stream từ chủ sở hữu các bài viết đó. Điều này nghĩa là điểm cuối {page_id}/tagged không trả về tất cả bài viết.

Bạn có thể đọc thêm về điều này trong tài liệu Nguồn cấp Trang.

Có những trường hợp mà một ứng dụng cụ thể (hay bất kỳ ứng dụng nào) không thể lấy thông tin bất kỳ về người dùng Facebook do cài đặt quyền riêng tư của người dùng đó - bao gồm khi truy cập bài viết tạo bởi người dùng đó trong ngữ cảnh mà ứng dụng của bạn dự kiến sẽ nhìn thấy bài viết đó (ví dụ: quản lý trang)

Ví dụ: khi người dùng đã chặn ứng dụng hoặc đã vô hiệu hóa tất cả ứng dụng nền tảng không cho truy cập thông tin của họ qua API.

Với bản phát hành v2.1 của API Đồ thị, chức năng này đã bị xóa. Đối với các ứng dụng được tạo trước 7/8/2014, trường này không có trong signed_request nữa.

Đối với các ứng dụng được tạo trước ngày này, thuộc tính liked sẽ luôn trả về giá trị true bất kể người đó có thích trang hay không.

Vui lòng sử dụng ngay liên kết paging.next và paging.previous được trả về trong phản hồi để lấy các trang kết quả khác. Sử dụng các liên kết đã cho sẽ đảm bảo rằng ứng dụng của bạn không bị hỏng khi định dạng của liên kết phân trang thay đổi trong tương lai.

Giống như hầu hết các mục trên API, hệ thống không nhằm khớp 1:1 chính xác với các tính năng và chức năng trên trang web Facebook chính. Số người xem tự nhiên qua giao diện người dùng Thông tin chi tiết Trang rất khác và được tính khác với Số người xem tự nhiên qua API.

Ví dụ: giá trị 'tự nhiên' trong giao diện người dùng Thông tin chi tiết Trang tương ứng với giá trị 'không trả phí' trong số liệu page_impressions_by_paid_non_paid_unique có sẵn qua API Đồ thị.

Chúng tôi đang muốn thống nhất 2 giá trị này nhưng quá trình này có thể mất chút thời gian.

Lỗi này cho biết người dùng được liên kết với mã truy cập không thể xem trang này vì lý do bảo mật. Ví dụ: trang có thể chưa đăng và người dùng cũng không phải là quản trị viên hợp lệ của trang.

Lỗi này thường xảy ra khi bạn đang cố tìm nạp thông tin chi tiết của một trang hoạt động rất tích cực. Điều này có thể là do bạn giảm khoảng thời gian mà mình đang yêu cầu thông tin chi tiết bằng cách sử dụng trường 'kể từ' và 'cho đến'.

Điều này nằm trong dự kiến đối với các ứng dụng thử nghiệm và ứng dụng ở chế độ phát triển. Khi ứng dụng được xuất bản, quá trình này sẽ diễn ra như mong đợi.

Bạn có thể xem lỗi liên quan của giới hạn thiết kế này tại đây

Chỉ Quản trị viên, Biên tập viên hay Người kiểm duyệt mới có thể đọc và gửi tin nhắn cho Trang. Người có vai trò khác, như Nhà quảng cáo và Nhà phân tích, không thể đọc cuộc trò chuyện trên Trang.

Vui lòng truy cập trang trợ giúp này để tìm hiểu thêm về các vai trò khác nhau trên Trang: https://www.facebook.com/help/289207354498410.

Tổng số lượng của 'page_fans' và 'page_fans_country' luôn không bằng nhau. Có nhiều yếu tố có thể ảnh hưởng đến giá trị 'page_fans_country'. Ví dụ: một số người hâm mộ trang có thể chưa đặt nước sở tại trên tài khoản của mình hoặc một số người hâm mộ trang có thể đặt cài đặt quyền riêng tư khiến nước sở tại bị ẩn.

Để tìm hiểu thêm về cài đặt quyền riêng tư của Facebook, vui lòng truy cập trang này trong trung tâm trợ giúp: https://www.facebook.com/help/445588775451827.

Một số bài viết công khai trên Trang là bài viết chia sẻ lại từ nội dung của người dùng. Nếu Người dùng tạo bài viết không cấp các quyền bắt buộc cho Ứng dụng, thì Ứng dụng sẽ không thể truy cập bài viết của họ qua API Đồ thị, do đó, không thể bình luận về các bài viết đó.

Không thể quảng cáo riêng các bài viết được tạo trực tiếp trong quá trình tạo Nội dung quảng cáo. Do đó, các bài viết này cũng không hiển thị trong lệnh gọi tới điểm cuối /promotable_posts của Trang.

Điều này xảy ra nếu bạn đang sử dụng ứng dụng vẫn ở chế độ phát triển để lên lịch bài viết. Vui lòng sử dụng ứng dụng đã đăng và quá trình này sẽ diễn ra bình thường.

Rất tiếc, chúng tôi hiện không hỗ trợ việc tạo, cập nhật hoặc xóa ảnh bìa thông qua API.

Để tìm hiểu thêm về API ảnh bìa, vui lòng truy cập https://developers.facebook.com/docs/graph-api/reference/cover-photo/#Creating

Đây là chế độ hoạt động hiện tại. Quản trị viên Trang không thể đăng lên trang dưới tên mình thông qua API Đồ thị - chức năng đó chỉ khả dụng trên http://www.facebook.com/ và các ứng dụng di động của chúng tôi.

Không, không có cách nào để lấy toàn bộ danh sách những người đã thích Trang. Điều này nằm trong thiết kế.

Hãy đảm bảo bạn đang sử dụng mã truy cập trang khi thực hiện các hành động thay mặt trang. Thông báo lỗi cho biết bạn đang sử dụng mã truy cập người dùng thay vì mã truy cập trang.

Bạn có thể tìm hiểu về các loại mã truy cập khác nhau tại đây: https://developers.facebook.com/docs/facebook-login/access-tokens

Không thể. Việc ghim bài viết và đọc bài viết được ghim chỉ khả dụng qua các sản phẩm tự nhiên của Facebook.

Nếu phản chiếu bình luận đã được bật cho URL bên ngoài tại thời điểm nào đó, các cảm xúc đối với bài viết có bình luận được phản chiếu sẽ được ghi lại cho chính URL đó và sẽ không được trả về khi gọi {URL-id}/reactions>.

Chúng tôi hiện chưa hỗ trợ tải dữ liệu cho hơn 1000 giá trị bảng phân tích của điểm cuối /app_insights/app_event. Chúng tôi khuyên bạn nên sử dụng giao diện người dùng Phân tích trên Facebook để phân chia thành các điểm dữ liệu cụ thể, chẳng hạn như các quốc gia cụ thể, nếu muốn phân tích dữ liệu thành các danh mục cụ thể.

Có thể bạn đang gọi điểm cuối quá nhanh, thậm chí trước khi dữ liệu truyền đến máy chủ của chúng tôi.

Nên thực hiện lệnh gọi API sau khi đợi 1-2 giây để cho phép thông tin truyền đến tất cả các máy chủ của chúng tôi.

Số liệu 'page_fans_country' thường là một tập hợp con của tổng page_fans. Số liệu này bao gồm bảng phân tích theo quốc gia của người hâm mộ trang, miễn là chúng tôi có thể xác định chính xác quốc gia của người dùng.

Số liệu này cũng chỉ bao gồm các quốc gia hàng đầu (theo số người hâm mộ) của người hâm mộ trang, chứ không phải tất cả các quốc gia có người hâm mộ; đối với trang có người hâm mộ ở nhiều quốc gia, các quốc gia ít đông dân nhất sẽ không được đưa vào số liệu này.

API không hỗ trợ việc sử dụng phân trang dựa trên bù trừ.

Thay vào đó, bạn nên sử dụng liên kết “phân trang” được trả về ở cuối mỗi phản hồi từ API Đồ thị hoặc sử dụng phân trang dựa vào “con trỏ”, tùy chọn này được ưu tiên nhất.

Thông tin thêm về cách phân trang chính xác thông qua API Đồ thị được mô tả tại đây: https://developers.facebook.com/docs/graph-api/using-graph-api/v2.3#paging

Có mã truy cập ngắn hạn và dài hạn. Mã truy cập ngắn hạn dùng cho phiên ngắn và thường hết hạn sau vài giờ.

Bạn có thể đổi mã truy cập ngắn hạn lấy mã truy cập dài hạn, mã này có thời gian sử dụng khoảng 60 ngày.

Bạn có thể đọc thông tin về mã này trong Tài liệu về mã truy cập.

Điều này nằm trong dự tính - API tìm kiếm tôn trọng quyền riêng tư trên Facebook, được điều chỉnh cho phù hợp với người dùng có mã truy cập bạn đang sử dụng, không hỗ trợ tìm kiếm hashtag cũng như không được thiết kế để tương đương với cùng một tìm kiếm chạy trong menu đề xuất tìm kiếm trên Facebook.com.

Rõ ràng, chúng tôi không hỗ trợ hay đặt mục tiêu API tìm kiếm trả về khối lượng kết quả hoặc kết quả cụ thể tương tự như tìm kiếm trên Facebook.com - và nhìn chung, các bài viết được trả về qua API thường được kiểm tra bảo mật và quyền riêng tư nghiêm ngặt hơn so với cùng một bài viết trên chính Facebook.

Hệ thống của chúng tôi sẽ thực thi giới hạn tốc độ đối với lệnh gọi API do Ứng dụng thực hiện. Để tìm hiểu thêm về nhiều giới hạn khác nhau và giúp Ứng dụng không bị giới hạn tốc độ, vui lòng truy cập https://developers.facebook.com/docs/marketing-api/api-rate-limiting

Bài viết tức thì

Bạn có thể thêm hình ảnh GIF động vào bài viết bằng thành phần <figure>. Thành phần này bọc thành phần <img> tham chiếu đến URL của hình ảnh GIF. Tương tự như các hình ảnh khác, bạn có thể thêm chú thích và ghi nhận vào hình ảnh GIF.

Bạn có thể tham khảo tài liệu để biết thêm chi tiết và ví dụ tại đây.

Bạn có thể sử dụng lại URL nguồn cấp trên các trang khác nhau, tuy nhiên hãy lưu ý rằng chỉ các bài viết có URL chính tắc khớp với miền của trang mới được thu nạp.

Chúng tôi khuyên bạn nên sử dụng nguồn cấp RSS riêng cho từng trang chỉ chứa các bài viết sẽ được trang đó thu nạp.

Bạn có thể thêm nội dung nhúng xã hội được hỗ trợ, bao gồm video, bằng Nội dung nhúng xã hội. Đối với các trình phát video bên thứ ba khác, bạn có thể thêm các trình phát này vào bài viết dưới dạng Nội dung nhúng tương tác.

Bạn có thể nhúng đồ họa và nội dung tương tác trong bài viết bằng <figure> cùng với lớp op-interactive. Hình phải chứa <iframe> và <iframe> chứa nội dung cần nhúng.

Bạn có thể tìm thêm chi tiết và xem ví dụ tại đây.

Bạn có thể chỉ định chú thích bằng thành phần <figcaption>. Trong chú thích, bạn có thể thêm ghi nhận bằng thành phần <cite>.

Bạn có thể tìm thêm chi tiết và ví dụ trong tài liệu tại đây.

Khi ở chế độ Bản nháp, bài viết sẽ chỉ hiển thị dưới dạng Bài viết tức thời với quản trị viên trang. Sau khi bài viết được đăng và ở chế độ Trực tiếp, bất kỳ ai cũng có thể chia sẻ bài viết trên Facebook và bài viết sẽ hiển thị dưới dạng Bài viết tức thời với mọi người.

Vui lòng kiểm tra xem bạn đã cấp quyền pages_manage_instant_articles cho ứng dụng chưa. Bạn cần quyền này cho việc gọi phương thức API để đọc và cập nhật Bài viết tức thời của trang.

Bạn có thể tìm hiểu thêm về cách sử dụng API tại đây.

Nếu bạn đang sử dụng thuộc tính dir="rtl" để hiển thị ngôn ngữ từ phải sang trái trong bài viết, bạn có thể đang xem bài viết trong một ứng dụng không hỗ trợ ngôn ngữ từ phải sang trái trong Bài viết tức thời.

Vui lòng kiểm tra xem bạn có sử dụng phiên bản ứng dụng mới nhất không. Phiên bản tối thiểu của từng ứng dụng hỗ trợ ngôn ngữ từ phải sang trái là:

  • Facebook dành cho iOS: 52.0
  • Facebook dành cho Android: 69.0
  • Trình quản lý Trang dành cho iOS: 44.0
Lưu ý rằng chúng tôi hiện không hỗ trợ ngôn ngữ từ phải sang trái trong Trình quản lý Trang dành cho Android.

Vui lòng kiểm tra xem bạn đã đặt thuộc tính dir="rtl" trên thẻ <body> của bài viết chưa. Nếu bài viết của bạn không sử dụng ngôn ngữ từ phải sang trái, bạn không nên đặt thuộc tính này trong bài viết.

Vui lòng kiểm tra xem bạn đã đặt thuộc tính dir trên thẻ nội dung của bài viết chưa. Đối với các ngôn ngữ từ phải sang trái, bạn phải đặt thuộc tính dir thành "rtl".

Bản xem trước trong Bảng tin của bài viết sử dụng hình ảnh được chỉ định trên thẻ meta og:image trong phiên bản web của bài viết. Bạn cũng có thể chọn thay thế hình ảnh bằng video bằng cách thêm lớp "fb-feed-cover" vào video bất kỳ trong bài viết. Bạn có thể đọc thêm về bản xem trước trong Bảng tin tại đây.

Khi chia sẻ URL của bài viết trước khi đăng Bài viết tức thời, URL sẽ chuyển hướng đến phiên bản web di động của bài viết. Sau khi bạn đăng Bài viết tức thời, tất cả lượt chia sẻ liên kết, bao gồm cả lượt chia sẻ đã đăng trước khi đăng bài viết, sẽ tự động hiển thị Bài viết tức thời khi được xem trên di động.

Hiện tại, số liệu "lượt xem" chỉ bao gồm người dùng iOS. Số lượt xem trên Android được tính riêng trong số liệu "android_views".

Bạn có thể xem thêm thông tin về điều này tại đây.

Chúng tôi vẫn chưa triển khai hỗ trợ cho nguồn cấp phát triển trong Trình quản lý Trang dành cho Android. Tạm thời, để xem bài viết của mình trên Android, bạn có thể thử thêm bài viết vào nguồn cấp sản xuất dưới dạng bản nháp.

Để chỉnh sửa Bài viết tức thời, bạn có thể sử dụng giao diện Trang. Để thực hiện điều đó, bạn có thể truy cập Trang trên trình duyệt và đi tới Công cụ đăng > Bài viết tức thời. Bạn có thể xem và chỉnh sửa bài viết ngay tại đó. Bạn có thể đọc thêm về việc chỉnh sửa tại đây: https://developers.facebook.com/docs/instant-articles/publishing.

Hiện tại, việc tải xuống nguồn cấp sẽ hết thời gian chờ sau 30 giây.

Không, liên kết được chia sẻ phải là URL chính tắc của bài viết. Nếu bạn thay đổi URL - ví dụ như thêm thông số - URL sẽ được coi là một URL khác.

Mọi lỗi hoặc cảnh báo xuất hiện khi thu nạp nguồn cấp RSS của bạn sẽ được hiển thị trên tab Bài viết tức thời của trang Cài đặt. Bạn cũng có thể xem các cảnh báo và lỗi cho từng bài viết bằng cách nhấp vào bài viết từ tab Bài viết tức thời của trang Công cụ đăng.

Vui lòng kiểm tra xem nguồn cấp RSS có tuân thủ định dạng được ghi lại tại đây không.

URL chính tắc của bài viết cũng phải sử dụng miền được cấu hình cho trang hoặc miền phụ của miền đó. Nếu bạn nhìn thấy bài viết mới được thu nạp nhưng các cập nhật cho bài viết hiện có không hiển thị, vui lòng kiểm tra xem bạn đã cập nhật dấu thời gian "op-modified" chưa.

Bạn có thể tìm thêm thông tin về điều này tại đây.

Một nguyên nhân phổ biến khiến bài viết không được cập nhật từ nguồn cấp RSS là dấu thời gian op-modified của bài viết trong nguồn cấp giống với phiên bản mà chúng tôi tìm nạp lần cuối. Chúng tôi chỉ cập nhật bài viết khi dấu thời gian mới hơn phiên bản cuối.

Ngoài ra, bạn cũng phải xác nhận rằng mình đã sử dụng cùng một URL chính tắc trong phiên bản cập nhật của bài viết.

Bạn có thể tham khảo tài liệu để biết thêm thông tin về cách chúng tôi tìm nạp bài viết từ nguồn cấp RSS tại đây.

Chúng tôi cố gắng tải đầy đủ và phân tích cú pháp nguồn cấp RSS của bạn trong vòng 10 giây. Lỗi này cho biết quá trình này không thành công.

Một cách giải quyết vấn đề này là đưa ít mục hơn vào nguồn cấp RSS của bạn, ví dụ: chỉ đưa vào các bài viết mới/được thay đổi từ ~10 phút trước. Do cứ 3 phút thì nguồn cấp được tìm nạp một lần, bạn không cần phải đưa vào các bài viết không thay đổi.

Rất tiếc, chúng tôi không có danh sách địa chỉ IP tĩnh cho trình thu thập dữ liệu. Tuy nhiên, bạn có thể sử dụng tác nhân người dùng của trình thu thập dữ liệu: facebookexternalhit/1.1

Nếu cập nhật cho Bài viết tức thời hiện có cách thời gian op-modified quá 24 giờ, quá trình tải sẽ bỏ qua bài viết này. Điều này có nghĩa là thời gian sửa đổi phải ở trong khoảng 24 giờ của thời gian sửa đổi đã đặt trong bài viết hiện có, chứ không phải là thời gian hiện tại. Trong trường hợp cập nhật bị bỏ qua, bạn có thể thực hiện thay đổi cho bài viết theo cách thủ công qua công cụ trình chỉnh sửa Bài viết tức thời dựa trên web.

Bạn có thể tìm thêm thông tin về điều này tại đây.

Vui lòng kiểm tra xem các bài viết trùng lặp có đang sử dụng URL chính tắc khác nhau không. Chúng tôi sử dụng URL chính tắc của bài viết làm số nhận dạng duy nhất của bài viết, do đó các bài viết có URL chính tắc khác nhau sẽ được coi là bài viết riêng.

Một sự cố thường gặp là CMS của bạn có thể đăng cập nhật cho các bài viết có URL khác nhau, dẫn đến việc cập nhật được thu nạp dưới dạng bài viết mới.

Có, mỗi trang được ánh xạ với một tên miền riêng và đây là ánh xạ 1:1. Chúng tôi yêu cầu Bài viết tức thời thuộc một trang cụ thể phải có URL chính tắc thuộc miền được chỉ định hoặc miền phụ của miền được chỉ định.

Tuy nhiên, miền của URL nguồn cấp RSS không cần khớp với miền được ánh xạ với trang. Hạn chế này chỉ áp dụng cho các URL chính tắc của bài viết trong nguồn cấp.

Nếu muốn đăng bài viết lên các trang khác nhau tùy theo ngôn ngữ, bạn phải thiết lập các nguồn cấp RSS khác nhau cho từng ngôn ngữ và cấu hình từng trang để sử dụng nguồn cấp RSS thích hợp.

Không, sau khi bài viết đã được thu nạp từ nguồn cấp RSS, bài viết đó vẫn được lưu trữ dưới dạng Bài viết tức thời cho đến khi bị xóa khỏi công cụ đăng của trang. Sau đó, bạn có thể yên tâm xóa bài viết khỏi nguồn cấp RSS để đẩy nhanh quá trình tìm nạp tiếp theo.

Hiện tại, không có cách đăng hoặc xóa bài viết qua API, tuy nhiên chúng tôi đang khắc phục vấn đề này.

Nút Thích sử dụng màu Chủ đề được cấu hình trong cài đặt kiểu của bạn. Vui lòng kiểm tra xem bạn đã cấu hình màu nổi bật so với tiêu đề chưa.

Ngoài ra, nút Thích chỉ hiển thị khi người dùng xem bài viết chưa thích trang, vì vậy nút Thích sẽ không hiển thị với Quản trị viên trang mà trước đó đã thích trang này.

Vui lòng kiểm tra để chắc chắn bạn không sử dụng nhiều thẻ <br> liên tiếp. Để chia văn bản của bài viết thành nhiều đoạn, bạn nên sử dụng thẻ đoạn (<p>) thay vì ngắt dòng.

Hãy đảm bảo rằng bạn đã thêm lớp "op-tracker" vào thẻ <figure> bọc pixel theo dõi. Nếu thiếu thẻ này, pixel sẽ bị coi là nội dung nhúng hình ảnh.

Vui lòng kiểm tra xem bạn có đang sử dụng định dạng được hỗ trợ cho tệp video không. Bạn có thể tìm danh sách tất cả định dạng video được hỗ trợ tại đây.

Bạn cũng phải đảm bảo bọc đúng nội dung nhúng video trong thẻ <figure> và không bọc video trong đoạn (thẻ <p>).

Cảnh báo này thường hiển thị khi bạn đã bọc nội dung không phải văn bản - chẳng hạn như hình ảnh hoặc nội dung nhúng tương tác - trong đoạn (thẻ <p>). Đoạn chỉ được chứa văn bản nội dung và bạn phải thêm mọi nội dung khác trong thẻ <figure> hoặc các thành phần vùng chứa thích hợp khác.

Không, thành phần Chú thích (<figcaption>) chỉ hỗ trợ thẻ <h1>, <h2> và <cite>. Thẻ đoạn (<p>) không được hỗ trợ.

Hiện chúng tôi chưa hỗ trợ thuộc tính "muted" trên thành phần <video>.

Quảng cáo trong bài viết được xác định bằng thành phần <figure> HTML5 tiêu chuẩn bọc một thành phần <iframe> chứa nội dung đánh dấu cho quảng cáo. Bạn có thể áp dụng lớp op-ad cho thành phần <figure> để chỉ định quảng cáo trong bài viết. Có 2 cách chỉ định quảng cáo: chỉ định trực tiếp URL của quảng cáo bằng thuộc tính "src" trong iframe hoặc nhúng nhóm HTML không thoát và các tập lệnh trong iframe.

Bạn có thể tìm thêm thông tin về quảng cáo tại đây: https://developers.facebook.com/docs/instant-articles/reference/ad.

Thành phần hình ảnh tiêu chuẩn không hỗ trợ sử dụng hình ảnh SVG. Thay vào đó, bạn có thể sử dụng nội dung nhúng tương tác ("op-interactive") và thêm thành phần <img> trong iframe, đồng thời đặt thuộc tính "src" thành URL của hình ảnh SVG.

Bạn có thể sử dụng thành phần Bản đồ được ghi lại tại đây: https://developers.facebook.com/docs/instant-articles/reference/map. Đây là cách thêm bản đồ vào Bài viết tức thời được khuyến nghị.

Nếu bạn đang thêm nội dung nhúng Google Maps vào bài viết làm nội dung nhúng tương tác, có một sự cố đã biết về cách hoạt động của nội dung nhúng có thể khiến bản đồ không hiển thị. Để khắc phục sự cố này, bạn cần bọc iframe tải nội dung bản đồ ("https://www.google.com/maps/embed?...") trong một iframe khác.

Bạn có thể nhúng các mô-đun tương tác bằng hình op-interactive. Bạn có thể xem thêm chi tiết và mẫu của mã tại đây: https://developers.facebook.com/docs/instant-articles/reference/interactive.

Để xác định chiều cao, hãy thêm thuộc tính "height" vào thành phần <iframe> bọc nội dung được nhúng của bạn. Giá trị của thuộc tính phải là giá trị số nguyên cho biết chiều cao bằng pixel. Bạn có thể đặt chiều cao tối đa là 960 pixel.

Bạn có thể thêm ảnh bìa bằng cách thêm thẻ <figure> trong tiêu đề. Bạn có thể sử dụng hình ảnh hoặc video làm ảnh bìa bằng cách thêm thẻ <img> hoặc <video> trong hình.

Bạn có thể tìm hiểu thêm về ảnh bìa tại đây.

Để thêm khoảng cách giữa các hình ảnh, bạn có thể thêm đoạn trống giữa những hình ảnh đó - ví dụ: <p>&nbsp;</p>.

Để thêm ghi nhận, hãy sử dụng thành phần <cite> bên trong thành phần <figcaption>.

Trên ảnh bìa, bạn có thể đặt ghi nhận luôn hiển thị bằng cách chỉ định rõ ràng một trong các thuộc tính Căn chỉnh dọc trên thành phần <cite>. Nếu không, trích dẫn của bạn sẽ không hiển thị trên hình ảnh cho tới khi được mở rộng.

Bạn có thể nhúng nội dung xã hội bằng cách thêm hình có lớp "op-social" và thêm iframe chứa nội dung cần nhúng.

Bạn có thể tham khảo tài liệu này để biết thêm chi tiết và mẫu của mã.

Bạn cần sử dụng liên kết trực tiếp tới tệp video (ví dụ: tệp mp4) để thêm ảnh bìa. Vì video được lưu trữ trên Facebook không cung cấp liên kết trực tiếp, bạn cần lưu trữ video ở nơi khác để sử dụng video làm ảnh bìa.

Bạn có thể sử dụng một số thẻ HTML bên trong mục danh sách để in đậm văn bản hoặc thêm liên kết chẳng hạn. Để tùy chỉnh màu hoặc kiểu phông chữ, bạn có thể sử dụng trình chỉnh sửa kiểu trên giao diện Trang Facebook (Cài đặt->Bài viết tức thời).

Bạn không thể nhúng video bằng thành phần HTML <video> vì chúng tôi không hỗ trợ phát nhiều video theo trình tự.

Bạn có thể nhúng trình phát video dưới dạng nội dung nhúng xã hội trong iframe, miễn là trình phát được nhúng hỗ trợ iframe.

Đoạn trích dài không được hỗ trợ. Bạn sẽ phải đặt đoạn trích dài bên ngoài thẻ đoạn.

Nếu tiêu đề của bài viết đủ dài để hiển thị trên 2 dòng thì chỉ có tiêu đề mới hiển thị trong Bảng tin. Nếu tiêu đề vừa trên một dòng, bản xem trước trong Bảng tin cũng sẽ hiển thị phần đầu nội dung bài viết.

Vui lòng kiểm tra để chắc chắn bạn không thêm thuộc tính "data-fb-disable-autoplay" vào video.

Nếu video không phát tự động đối với một người cụ thể, hãy kiểm tra xem bạn có tắt tính năng tự động phát video trong cài đặt của ứng dụng Facebook không. Bạn có thể tìm thấy hướng dẫn về cách kiểm tra tại đây.

Bạn có thể hiển thị video trên bản xem trước trong Bảng tin của bài viết bằng cách thêm lớp "fb-feed-cover" vào video bất kỳ trong bài viết. Bạn có thể đọc thêm về bản xem trước trong Bảng tin tại đây

Bạn cần đưa thành phần <time> vào nội dung đánh dấu HTML cho từng bài viết bằng lớp op-published để chỉ định ngày/giờ đăng bài viết ban đầu.

Không bắt buộc phải có lớp op-modified. Bạn chỉ cần bao gồm thành phần <time> có lớp này khi cập nhật nội dung của bài viết và muốn chúng tôi cập nhật phiên bản bài viết mà chúng tôi đã lưu trữ.

Vui lòng kiểm tra xem bạn đã bọc văn bản trong đoạn (thẻ <p>) chưa. Bạn có thể tìm hiểu thêm về cách tạo nội dung đánh dấu của bài viết tại đây.

Vui lòng kiểm tra để chắc chắn bạn không bọc <figure> trong đoạn (thẻ <p>). Hình ảnh phải nằm trong thẻ hình được lồng ghép ngay bên dưới thẻ bài viết.

Rất tiếc, bạn không thể thêm chú thích vào từng hình ảnh trong bản trình chiếu. Bạn chỉ có thể thêm một chú thích vào toàn bộ bản trình chiếu.

Bạn có thể tham khảo tài liệu về Bản trình chiếu để biết thêm chi tiết.

Bạn có thể thêm lượt thích hoặc bình luận vào hình ảnh bằng cách chỉ định thuộc tính "data-feedback" trên thẻ <figure> chứa hình ảnh. Ví dụ: thêm thuộc tính data-feedback="fb:likes,fb:comments" sẽ hiển thị cả lượt thích và bình luận trên hình ảnh.

Để biết thêm thông tin, bạn có thể tham khảo tài liệu dành cho thuộc tính phản hồi.

Khi chỉ định chiều rộng cho các mục như nội dung nhúng tương tác, vui lòng sử dụng giá trị số nguyên chỉ định chiều rộng bằng pixel. Theo mặc định, các mục hiển thị với chiều rộng tối đa.

Để hiển thị nội dung nhúng tương tác mà không có lề, bạn có thể thêm lớp "no-margin" vào iframe chứa nội dung của mình.

Nếu chúng tôi đã phê duyệt nguồn cấp RSS cho trang của bạn, bạn không cần gửi lại nguồn cấp để phê duyệt khi thay đổi URL nguồn cấp.

Chúng tôi ánh xạ từng trang với tên miền khác nhau. URL của nguồn cấp RSS không cần khớp với tên miền này. Tuy nhiên, URL chính tắc của từng bài viết trong nguồn cấp phải thuộc cùng một miền hoặc miền phụ của miền đó. Nếu bạn chỉ thay đổi URL của nguồn cấp RSS, điều này sẽ không gây bất kỳ sự cố nào.

Nếu bạn cũng cập nhật URL chính tắc của bài viết để trỏ đến miền mới, bạn cần yêu cầu cập nhật miền này thông qua Quản lý đối tác và họ sẽ có thể hướng dẫn bạn thực hiện quy trình.

iOS SDK

Hãy đảm bảo ứng dụng Facebook của bạn đã đặt ID trên cửa hàng iPhone, ID trên cửa hàng iPad thật (nếu để thử nghiệm thì không nhất thiết phải dùng ID thật, bạn có thể sử dụng một trong bất kỳ ứng dụng có sẵn nào tại Apple App Store) cũng như đã bật iOS - iPad trong Nền tảng được liệt kê trong Trung tâm ứng dụng.

Điều này nằm trong thiết kế. Hộp thoại Nguồn cấp sẽ đăng nội dung có tệp đính kèm nên không thể tùy chỉnh các tệp đính kèm bổ sung.

Javascript SDK

Vui lòng tham khảo tài liệu này để biết một số thực tiễn tốt nhất về tối ưu hóa hình ảnh để tạo bản xem trước tuyệt đẹp tại đây.

Dữ liệu phản hồi chỉ khả dụng nếu người dùng đã đăng nhập ứng dụng của bạn bằng Facebook và đã cấp publish_actions. Dữ liệu này cũng được ghi lại tại đây.

Đây là thay đổi có chủ ý. Chúng tôi đã rút ngắn danh sách bạn bè nhằm giúp yêu cầu chơi trò chơi phù hợp hơn với người chơi thích hợp. Lưu ý rằng người chơi vẫn có thể chọn bao nhiêu bạn bè tùy thích bằng cách sử dụng trường Tìm kiếm.

Tin vui là với thay đổi này, chúng tôi nhận thấy số lần nhấp đã tăng và CTR tổng thể cũng tăng đáng kể. Chúng tôi mong muốn tiếp tục tối ưu hóa kênh này, đồng thời tìm những cách mới để đảm bảo trò chơi thích hợp được hiển thị với đúng người.

Chia sẻ liên kết

Trình thu thập dữ liệu sẽ tìm bản ghi AAAA và trả về mã phản hồi 0 nếu không tìm thấy. Đảm bảo rằng bản ghi AAAA được cập nhật đúng khi bạn thay đổi URL hoặc máy chủ của mình.

Vui lòng xem Cập nhật URL để biết thêm thông tin.

Thay đổi og:title, og:image, v.v. chỉ áp dụng cho các lượt chia sẻ liên kết đó trong tương lai.

Khi một người hoặc trang chia sẻ liên kết và hiện có hơn 50 tương tác với bài viết (bình luận, lượt thích, lượt chia sẻ, v.v.), thì sẽ không thể thay đổi tiêu đề đó được. Điều này nhằm ngăn trang web thay đổi chi tiết liên kết sau khi bạn tương tác với liên kết đó, để gây hiểu nhầm rằng bạn đã tương tác với nội dung khác. Mọi thuộc tính khác đều có thể sửa đổi được bất cứ lúc nào.

Nếu bạn đã chia sẻ liên kết và cập nhật hình ảnh, lượt chia sẻ gốc sẽ tiếp tục hiển thị hình ảnh cũ, trừ khi bạn làm mới hình ảnh đó trong bài viết.

Cách làm mới hình ảnh liên kết trong bài viết:
  1. Chuyển đến bài viết trên bảng tin.
  2. Nhấp vào dấu chấm lửng ở góc trên bên phải của bài viết.
  3. Chọn Làm mới tệp đính kèm được chia sẻ.

Chúng tôi cố định tiêu đề sau khi một số hành động được thực hiện đối với đối tượng đó (được mô tả tại đây: Cập nhật URL.

Có nhiều yếu tố ảnh hưởng đến cách cắt hình ảnh. Ví dụ: chúng tôi cố gắng lấy tâm hình ảnh xung quanh khuôn mặt mà chúng tôi phát hiện được.

Đối với hình ảnh cỡ lớn, hãy cố gắng giữ hình ảnh gần tỷ lệ khung hình 1,91:1 nhất có thể để hiển thị hình ảnh đầy đủ trong Bảng feed mà không bị cắt.

Bài viết trên Trang luôn sử dụng hình ảnh ngang, lớn để chia sẻ liên kết. Bảng feed trên máy tính và di động cũng như vậy. Hãy cố gắng giữ cho hình ảnh của bạn gần với tỷ lệ khung hình 1,91:1 nhất có thể để hiển thị hình ảnh đầy đủ trên Bảng feed mà không bị cắt.

Liên kết của bạn có thể đã bị hệ thống lọc nội dung của chúng tôi gắn cờ. Nếu bạn cho rằng đây là lỗi, vui lòng gửi báo cáo trên Trang web trợ giúp của chúng tôi; hãy nhớ bao gồm URL liên quan.

Hình ảnh được lưu vào bộ nhớ đệm theo cách không đồng bộ, vì vậy hình ảnh có thể không hiển thị khi ai đó chia sẻ nội dung của bạn lần đầu tiên. Bạn có thể tránh điều này bằng cách:

Tất cả các lượt chia sẻ và lượt thích đều gắn với một URL cụ thể (được gọi là URL chính tắc). Do đó, việc thay đổi cấu trúc trang web để sử dụng URL mới sẽ bắt đầu ghi nhận các lượt thích và lượt chia sẻ cho URL mới đó.

Vui lòng xem Cập nhật URL để biết thêm thông tin.

Tất cả các lượt chia sẻ và lượt thích đều gắn với một URL cụ thể (được gọi là URL chính tắc). Do đó, việc thay đổi cấu trúc trang web để sử dụng URL mới sẽ bắt đầu ghi nhận các lượt thích và lượt chia sẻ cho URL mới đó.

Vui lòng xem Cập nhật URL để biết thêm thông tin.

Hình ảnh nhỏ hơn 600 x 315 pixel nhưng lớn hơn 200 x 200 pixel sẽ được hiển thị cùng hình ảnh vuông nhỏ.

Chúng tôi coi tất cả URL hình ảnh là không thể thay đổi vì các URL này được sử dụng để lưu các tài nguyên vào bộ nhớ đệm ở các lớp khác nhau, vì vậy, nếu cần thay thế hình ảnh, bạn cần sử dụng cả URL mới. Khi các bộ nhớ đệm bị cũ, chúng tôi sẽ tìm nạp hình ảnh mới và sự cố sẽ tự được khắc phục.

Nếu bạn đang sử dụng URL khác nhưng vẫn thấy hình ảnh cũ, bạn cũng có thể đi tới Trình gỡ lỗi chia sẻ và trích xuất lại URL:

Tất cả các URL phải là tuyệt đối khi thể hiện vị trí chính tắc của tài nguyên (trang/hình ảnh) để chúng tôi có thể tính các lượt chia sẻ và lượt thích cho đúng URL và lưu hình ảnh vào bộ nhớ đệm một cách hợp lý.

Hình ảnh gốc không còn khả dụng nữa, quá lớn hoặc không thể tìm nạp do sự cố tạm thời. Đảm bảo trình thu thập dữ liệu của chúng tôi có thể truy cập URL hình ảnh, hình ảnh không lớn hơn 8mb và độ trễ phân phối tối đa là vài giây.

Khi thay đổi hình ảnh gốc của trang, hãy đảm bảo bạn không xóa hình ảnh cũ khỏi trang web vì sau đó các lượt chia sẻ hiện tại sẽ hiển thị khoảng trắng này.

API Marketing

Điều này là do độ trễ sao chép trên các trung tâm dữ liệu của chúng tôi. Sẽ mất một vài giây trước khi quá trình này hoàn tất, trước thời điểm đó, bạn sẽ không thể truy cập ID đối tượng qua API này.

Nếu cố gắng đọc chi tiết của một quảng cáo trước khi quảng cáo đó được lưu hoàn toàn, bạn có thể nhận được GraphMethodException cùng với thông báo như Unsupported get request. Object with ID 'XXXXXXXXXXXXXXXXXX' does not exist, cannot be loaded due to missing permissions, or does not support this operation.

Để giải quyết vấn đề này, bạn nên đợi một chút trước khi tìm cách LẤY các chi tiết quảng cáo.

Đôi khi, bạn có thể gặp lỗi xác thực khi cố sử dụng một nội dung nhất định trong một chiến dịch cụ thể. Điều này có thể xảy ra khi chiến dịch có mục tiêu không tương thích với nội dung bạn đang sử dụng. Một ví dụ của trường hợp này là nội dung của bạn trỏ tới trò chơi canvas, trong khi mục tiêu chiến dịch là "MOBILE_APP_INSTALLS".

Để giải quyết lỗi xác thực mà bạn có thể đang gặp phải, bạn có thể làm theo Thực tiễn tốt nhất về xác thực API Tiếp thị.

Hãy kiểm tra để đảm bảo các phiên tải lên không chứa các mục được đề cập và không chứa bất kỳ lỗi nào.

Các mục sẽ bị xóa và không còn tồn tại trong nguồn cấp của phiên tải lên thành công khi deletion_enabled được đặt thành đúng.

Nếu bạn gặp lỗi này, vui lòng kiểm tra trạng thái của tài khoản quảng cáo được chỉ định. Lỗi này thường được trả về khi tài khoản quảng cáo ở trạng thái chưa thanh toán.

Điều này nằm trong dự kiến vì dữ liệu trong chương trình phụ trợ cho Thông tin chi tiết Trang chỉ được lưu trữ trong 2 năm. Do đó, lệnh gọi sẽ trả về giá trị 0. Các mục duy nhất không có giá trị 0 là lượt thích/bình luận/chia sẻ trực tiếp trên bài viết có dữ liệu được chính bài viết đó giữ lại.

Vui lòng kiểm tra cú pháp của thông số nhắm mục tiêu, cụ thể là đảm bảo rằng thông số nhắm mục tiêu có các thông số và giá trị geo_locations hợp lệ.

Khi bạn tạo quảng cáo với các mục tiêu nhất định, thông số chuyển đổi mặc định sẽ được đặt. Nếu bạn thay đổi thông số chuyển đổi, các thông số hiện tại sẽ bị ghi đè.

Xin lưu ý rằng các mục tiêu nhất định sẽ không có thông số chuyển đổi mặc định và phải được chỉ định rõ ràng.

Điều này có thể xảy ra vì đối tượng work_positions cho quốc gia bạn đang nhắm mục tiêu quá nhỏ nên không ảnh hưởng đến ước tính số người tiếp cận. Chúng tôi đang tiếp tục thu thập dữ liệu hy vọng sẽ giúp cải thiện số người được thêm vào trường hợp loại trừ work_positions để tác động đến ước tính số người tiếp cận.

Điều này xảy ra vì ứng dụng của bạn đã bật chuyển Bảo mật URL bài viết trong luồng.

Nếu ứng dụng của bạn đã bật cài đặt đó, thì hệ thống sẽ không cho phép tạo bất kỳ loại quảng cáo bài viết có liên kết nào trừ khi quảng cáo đó chuyển hướng đến URL canvas được tham chiếu trong cài đặt ứng dụng của bạn. Không bắt buộc phải bật cài đặt đó trừ khi ứng dụng của bạn là một ứng dụng canvas và chỉ đăng các tin chuyển hướng trở lại miền ứng dụng canvas.

Người dùng có khả năng được liên kết với tài khoản qua liên kết Trình quản lý doanh nghiệp, liên kết này sẽ không hiển thị dưới dạng liên kết API Đồ thị rõ ràng.

Vui lòng xác nhận rằng bạn đã chỉ định Danh mục đối tác trong trường nhắm mục tiêu thích hợp. Danh mục đối tác được truy xuất từ điểm cuối “/partnercategories” chứa trường có tên là “targeting_type”. Trường này chỉ định trường nhắm mục tiêu mà bạn cần sử dụng khi chỉ định Loại nhắm mục tiêu.

Ví dụ: nếu Danh mục đối tác trả về “targeting_type” của “hành vi” thì trong thông số nhắm mục tiêu, bạn nên sử dụng Danh mục đối tác đó trong trường “hành vi” của thông số nhắm mục tiêu.

Bạn có thể tìm thêm thông tin về Loại nhắm mục tiêu và Danh mục đối tác tại đây: https://developers.facebook.com/docs/marketing-api/partnercategories/v2.3#targeting_types

Lỗi này có thể là do Đối tượng tùy chỉnh chưa đặt bất kỳ trường hợp bao gồm/loại trừ nào gây ra. Cách tốt nhất để giải quyết vấn đề này là tạo Đối tượng tùy chỉnh mới và đảm bảo rằng bạn đã đặt một số trường hợp bao gồm/loại trừ.

Thông tin thêm về đối tượng tùy chỉnh có sẵn tại đây: https://developers.facebook.com/docs/marketing-api/custom-audience-targeting/v2.3.

Nhóm quảng cáo có thể có cả daily_budget và lifetime_budget. Giá trị daily_budget được xác định trong đơn vị tiền tệ của tài khoản tối thiểu phải bằng 100 cent và khoảng thời gian phải nhiều hơn 24 giờ. Nếu bạn truy vấn bất kỳ trường nào nêu trên, cả hai giá trị sẽ được trả về. Giá trị 0 sẽ được trả về khi một trường không được sử dụng.

Để tìm hiểu thêm, vui lòng truy cập: https://developers.facebook.com/docs/reference/ads-api/adset.

Điểm cuối adcampaign_groups sử dụng phân trang dựa vào con trỏ nên không trả về các trường số lượng, giới hạn và bù trừ. Chúng tôi khuyên bạn nên sử dụng phân trang dựa vào con trỏ cho tất cả các điểm cuối để nhận được kết quả nhất quán.

Để biết thêm thông tin về cách sử dụng phân trang dựa vào con trỏ, vui lòng xem tại đây: https://developers.facebook.com/docs/graph-api/using-graph-api/v2.0#paging.

Có thể là do một số bài viết được tạo trực tiếp. Để truy xuất các bài viết trực tiếp này, vui lòng xem ghi chú trên trường "is_inline" của /promotable_posts ở cuối phần tài liệu này: https://developers.facebook.com/docs/reference/ads-api/adcreative/v2.2#object_story_spec

Nền tảng Messenger

Ngay khi người dùng trả lời câu hỏi đầu tiên, cửa sổ nhắn tin sẽ mở ra. Nếu câu trả lời đã cung cấp cho thấy người dùng không đủ điều kiện hoặc người dùng không trả lời, trải nghiệm quảng cáo sẽ kết thúc và quảng cáo sẽ chuyển quyền kiểm soát cuộc trò chuyện đến ứng dụng mục tiêu và cung cấp siêu dữ liệu "messenger_lead_gen_incomplete", nhằm tạo điều kiện cho doanh nghiệp có được trải nghiệm dự phòng để chuyển đổi những người không phải là khách hàng tiềm năng thành khách hàng. Xem webhook HOP sau Quảng cáo tìm kiếm khách hàng tiềm năng để biết thêm thông tin

Tính năng Gửi bản tóm tắt chỉ mặc định bật khi bạn đã chọn Ứng dụng, trong hộp thoại Tạo mẫu trong Quảng cáo. Lưu ý rằng bạn có thể tắt tính năng tóm tắt cho quảng cáo sau khi chọn Ứng dụng được kết nối. Ngay cả khi bạn chưa chọn ứng dụng, Quảng cáo tìm kiếm khách hàng tiềm năng cũng chuyển quyền kiểm soát chuỗi trò chuyện đến đối tượng chính nhận Chuyển giao - nếu đặt như vậy - hoặc giải phóng quyền kiểm soát chuỗi trò chuyện. Sau khi dữ liệu khách hàng tiềm năng đã được gửi, mọi tin nhắn tiếp theo sẽ được chuyển đến các Ứng dụng đã đăng ký. Các ứng dụng này có thể truy vấn API Cuộc trò chuyện để truy xuất lịch sử tin nhắn và nhận thông tin được chia sẻ trong quá trình tìm kiếm khách hàng tiềm năng.

Theo mặc định, API Gửi và Webhook bị chặn khi Quảng cáo tìm kiếm khách hàng tiềm năng đang triển khai. ID ứng dụng: 413038776280800 cho Ứng dụng tìm kiếm khách hàng tiềm năng trên Messenger sẽ có biện pháp kiểm soát chuỗi trò chuyện. Bạn có thể vô hiệu hóa cơ chế này bằng cách sử dụng nút bật/tắt Chặn API Gửi trên hộp thoại Tạo mẫu trong Quảng cáo

Sau khi quá trình gửi dữ liệu khách hàng tiềm năng kết thúc, Ứng dụng sẽ nhận webhook về tin nhắn của người dùng và có thể trả lời họ. Nếu một ứng dụng được chọn làm một phần của Ứng dụng thì chỉ ứng dụng đã chọn đó mới được phép trả lời và sẽ nhận được webhook trên kênh nhắn tin. Cửa sổ nhắn tin mở ra và Ứng dụng có thể trả lời bằng API Gửi

Bạn có thể cài đặt ứng dụng từ trang web của ứng dụng bằng cách dùng tính năng Đăng nhập bằng Facebook và cấp quyền pages_messaging cho một Trang cụ thể. Ứng dụng được ủy quyền sẽ hiển thị trong phần Cài đặt Trang ở mục Nhắn tin nâng cao.

Chỉ Ứng dụng được ủy quyền cho Trang mới hiển thị. Bạn có thể xem Ứng dụng được ủy quyền trong phần Cài đặt Trang ở mục Nhắn tin nâng cao. Bạn có thể cài đặt ứng dụng từ trang web của ứng dụng bằng cách dùng tính năng Đăng nhập bằng Facebook và cấp quyền pages_messaging cho một Trang cụ thể.

Trải nghiệm chat tự động (ví dụ: bot) cần tiết lộ rằng người dùng đang tương tác với một dịch vụ tự động:

  • vào đầu cuộc trò chuyện hoặc chuỗi tin nhắn bất kỳ
  • sau một khoảng thời gian đáng kể
  • khi đoạn chat chuyển từ tương tác với con người sang trải nghiệm tự động

Tìm hiểu thêm về chính sách này tại đây.

Khi luật hiện hành yêu cầu, trải nghiệm chat tự động (ví dụ: bot) phải tiết lộ rằng người dùng đang tương tác với một dịch vụ tự động. Ngay cả khi luật hiện hành không yêu cầu thì bạn cũng nên tiết lộ điều này để người dùng không bất ngờ. Bạn có thể đọc thêm về chính sách này tại đây.

Có, một ứng dụng Facebook có thể đăng ký nhiều trang. Khi xem xét ứng dụng, như quyền pages_messaging, ứng dụng có thể đăng ký để nhận webhook trên nhiều trang. Bạn tự quyết định việc nhận ngữ cảnh của mỗi webhook dựa theo phần tải dữ liệu.

Được, bạn có thể đăng ký nhiều ứng dụng cho một trang. Khi nhiều ứng dụng xử lý cùng một cuộc trò chuyện, cách tốt nhất là dùng Giao thức chuyển giao để xử lý việc bot nào làm chủ chuỗi trò chuyện tại một thời điểm nhất định.

Việc này có thể xảy ra nếu người dùng đã xóa cuộc trò chuyện. Điều này khiến bot không thể nhắn tin lại cho người dùng. Bot có thể giao tiếp với người dùng sau khi người dùng bắt đầu lại bằng cách gửi tin nhắn.

Sau đây là cách sử dụng người dùng thử nghiệm nền tảng để tích hợp nền tảng Messenger:

  1. Từ trang Vai trò của ứng dụng, hãy tạo người dùng thử nghiệm mới bằng cách nhấp vào nút Thêm.
  2. Chuyển đổi tùy chọn Cho phép người dùng thử nghiệm của ứng dụng này? đồng thời cấp quyền "manage_pages""page_messaging".
  3. Sử dụng nút Chỉnh sửa và nhận mã truy cập cho người dùng này (dùng phiên bản 2.6). Hãy lưu để sử dụng sau.
  4. Sử dụng nút Chỉnh sửa để đăng nhập với tư cách người dùng thử nghiệm.
  5. Sau khi đăng nhập, hãy tạo một trang với tư cách người dùng thử nghiệm.
  6. Sử dụng mã truy cập người dùng cho người dùng thử nghiệm để nhận mã truy cập trang cho người dùng này. Bạn có thể thực hiện việc này bằng lệnh gọi sau:
    https://graph.facebook.com/v2.6/me/accounts?access_token=[TEST_USER_ACCESS_TOKEN]
    (Tài liệu)
  7. Sử dụng mã truy cập trang này để liên kết ứng dụng Facebook với Trang của bạn:
    https://graph.facebook.com/v2.6/me/subscribed_apps?method=POST&access_token=[TEST_USER_PAGE_ACCESS_TOKEN]
            
    (Tài liệu)
  8. Sau khi đã làm theo các bước này, bạn sẽ nhận được cập nhật RTU cho Trang thử nghiệm của mình và sẽ có thể nhắn tin cho người dùng thử nghiệm từ Trang thử nghiệm. Ngoài ra, bạn có thể thay thế mã truy cập bằng mã dài hạn nếu chúng hết hạn quá sớm khiến bạn không thể thử nghiệm. Vui lòng làm theo tài liệu tại đây:
    GET /oauth/access_token?  
        grant_type=fb_exchange_token&           
        client_id={app-id}&
        client_secret={app-secret}&
        fb_exchange_token={short-lived-token} 
            

Có nhiều lý do khiến điều này có thể xảy ra:

  • Bạn đang sử dụng ID từ Đăng nhập Facebook. ID người dùng từ Đăng nhập Facebook không được dùng để hoạt động với API Gửi/Nhận. Chỉ những ID người dùng có được thông qua quá trình xác thực với Nền tảng Messenger mới hoạt động với Nền tảng Messenger.
  • Bạn đang sử dụng ID với mã truy cập trang không chính xác. ID người dùng cho Nền tảng Messenger nằm trong một trang và do đó dành riêng cho trang. Nếu bạn sử dụng ID người dùng hợp lệ nhưng với mã truy cập trang được liên kết với trang khác, lệnh gọi sẽ không hoạt động. Hãy nhớ sử dụng ID người dùng và mã truy cập trang được liên kết với cùng trang.
  • Bạn đang gửi tới số điện thoại chưa được xác minh gần đây. Khi sử dụng API Gửi với số điện thoại, chúng tôi sẽ chỉ gửi tin nhắn nếu số điện thoại đã được xác minh gần đây. Ngay cả khi số điện thoại được hiển thị là đã xác minh nhưng chưa được xác minh gần đây, thì có thể không gửi được tin nhắn. Hãy xác minh lại số điện thoại và chờ 24 giờ rồi thử lại.

Khi sử dụng plugin “Gửi đến Messenger”, bạn có thể sử dụng thông số data-ref dưới dạng thông số chuyển qua để gửi qua bất kỳ thông tin nào liên quan đến ngữ cảnh của lần nhấp.

Mọi người cũng có thể khám phá trang của bạn thông qua tìm kiếm trong Messenger. Trong các trường hợp này, bạn sẽ không có thông số chuyển qua. Bạn có thể sử dụng tính năng liên kết tài khoản để liên kết cuộc trò chuyện với tài khoản người dùng trên trang web của mình.

Bảng điều khiển ứng dụng trong phần Cài đặt Messenger có một nút tên là "Hiển thị lỗi gần đây" để cho biết liệu webhook có nhận được phản hồi 200 hay đang gặp lỗi không.

Có một công cụ cho biết các lỗi gần đây xảy ra với webhook. Nếu webhook không phân phối được, các máy chủ của Facebook sẽ hủy đăng ký URL của bạn. Để tìm công cụ này, hãy vào Bảng điều khiển ứng dụng > Messenger > Cài đặt, bên trong thẻ Webhooks, có một nút tên là Hiển thị lỗi gần đây

Đảm bảo webhook của bạn đang phản hồi với mã trạng thái 200. Điều này cho chúng tôi biết rằng bạn đã nhận thành công webhook. Nếu bạn không trả về mã 200, chúng tôi sẽ thử lại lệnh gọi cho đến khi thành công. Đồng thời, nếu webhook không trả về mã 200 trong thời gian dài, chúng tôi sẽ hiển thị cảnh báo nhà phát triển.

Ngoài ra, hãy lưu ý rằng mã trạng thái thành công được trả về kịp thời. Lệnh gọi webhook sẽ hết thời gian chờ sau 20 giây. Hãy nhớ cấu trúc mã sao cho webhook được xử lý không đồng bộ để mã trạng thái thành công có thể được trả về ngay lập tức và xử lý riêng biệt.

Lệnh gọi đến webhook chứa một trường trong tiêu đề có tên là Chữ ký X-Hub. Trường này có thể được dùng để xác thực rằng lệnh gọi đến từ Facebook.

Có 2 bước để nhận được hồi đáp. Thứ nhất, hãy đảm bảo webhook của bạn được thiết lập đúng cách (https://developers.facebook.com/docs/messenger-platform/webhook-reference#setup). Chỉ báo sẽ xuất hiện khi webhook được thiết lập đúng cách.

Thứ hai, bạn phải đăng ký từng trang. Mọi trang được đăng ký đều sẽ được liệt kê.

Nếu lệnh gọi tới webhook của bạn không thực hiện được trong thời gian dài, ứng dụng của bạn sẽ bị hủy đăng ký và bạn sẽ phải thêm lại webhook cũng như đăng ký lại trang của mình.

Open Graph

Nhiều khả năng cần phải trích xuất lại nội dung, điều này sẽ diễn ra tự động vào thời điểm thích hợp hoặc có thể được kích hoạt thủ công qua Công cụ gỡ lỗi.

Bạn không thể kiểm soát cách bài viết hiển thị trong Bảng tin hoặc Dòng thời gian khi chia sẻ tin đăng bằng Open Graph ngoài việc cung cấp thẻ OG cho trang của mình. Facebook sẽ tự động tối ưu hóa các bài viết để đảm bảo tương tác tối đa cho nội dung của bạn.

Vâng, tính năng Liên kết hành động đã ngừng hoạt động. Liên kết hành động sẽ không được hỗ trợ trên trang web Facebook nữa nên tính năng này cũng sẽ ngừng hoạt động trên nền tảng này. Bạn có thể truy cập lại tính năng này trong tương lai, nhưng không phải trong lộ trình hiện tại.

Nếu trang web của bạn đang sử dụng thẻ meta OpenGraph của chúng tôi và bao gồm mục og:image, chúng tôi sẽ tìm nạp hình ảnh đó và hiển thị trong bản xem trước. Ngoài ra, nếu trang web của bạn cung cấp cả og:image, og:image:width và og:image:height, hình ảnh đó sẽ được sử dụng ngay cả với lượt chia sẻ được tạo đầu tiên.

Không cung cấp các thông số này nghĩa là bạn cần phải đợi trình thu thập dữ liệu của chúng tôi tìm nạp và phân tích hình ảnh trước tiên. Truy cập http://ogp.me/#structured để xem ví dụ về cách thực hiện việc này.

API Rest

Điều này nằm trong thiết kế. REST API từ lâu đã không được dùng nữa và dự kiến sẽ không tiếp tục hoạt động. Có một hạn chế - Không thể sử dụng mã truy cập Trang với REST API.

Plugin mạng xã hội

Bạn có thể đặt ngôn ngữ cho nút Thích bằng cách sử dụng thông số 'locale' trong JS SDK. Thông số này sẽ hoạt động với người dùng không đăng nhập. Nếu người dùng đã đăng nhập, tùy chọn ngôn ngữ của họ cũng sẽ được cân nhắc. Nếu thông số đó được đặt thành ngôn ngữ cụ thể, nút Thích sẽ hiển thị bằng ngôn ngữ đó.

Bạn có thể thử nghiệm chế độ hoạt động này bằng cách truy cập mà không đăng nhập Facebook (hoặc bằng cách sử dụng phiên duyệt web riêng tư).

Chính sách của Facebook không cho phép điền trước phần văn bản khi chia sẻ với Facebook. Người dùng ứng dụng của bạn sẽ phải tự điền văn bản mà họ muốn chia sẻ.

Việc điền trước phần văn bản khi chia sẻ sẽ vi phạm Chính sách nền tảng 2.3 ( https://developers.facebook.com/policy/#control ). Chúng tôi thực thi chính sách này để đảm bảo người dùng đang chia sẻ chính xác những gì họ muốn chia sẻ trên Facebook, chứ không vô tình chia sẻ văn bản mà họ không phê duyệt.

Điều này nằm trong dự kiến nếu bạn thay đổi hoặc sửa đổi URL của trang web. Mỗi URL chứa plugin bình luận được coi là một đối tượng Open Graph riêng và các bình luận sẽ được liên kết với đối tượng đó. Do đó, nếu bạn sửa đổi URL, một đối tượng mới sẽ được tạo và các bình luận hiện tại có thể không hiển thị trên trang.

Trình chia sẻ sẽ không cho phép bạn chuyển vào thông số tùy chỉnh mà thay vào đó sẽ kéo trực tiếp siêu dữ liệu vào từ thẻ meta Open Graph của trang.

Để tìm hiểu thêm thực tiễn tốt nhất về chia sẻ nội dung, vui lòng tham khảo tài liệu này: https://developers.facebook.com/docs/sharing/best-practices

API WhatsApp Business

Yes, Whatsapp Flows can be sent with On-Premises API. You can learn more about Whatsapp Flows here, or learn how to get started with Whatsapp Flows and On-Premises API here.

No this is not possible. Numbers that are registered under WABAs (WhatsApp Business Accounts) can only message regular WhatsApp accounts.

We will provide a seven day grace period post sending the warning. This will allow time for businesses to adjust their behavior. If businesses continue to exceed our internally set threshold of calls to the Contacts API vs. number of messages sent, we will permanently disable the phone number.

Interactive messages can be reopened by the user in order to resend an option. This is in case of mistyping the desired option or wanting to choose a new option.

Through user testing we’ve identified 10 as the optimal number of rows to provide a good user experience. If you have a list of more than 10 options, and cannot condense into one list message, we recommend creating an additional step in the flow and using two list messages. During testing businesses had higher response rates and conversions with this approach than using text-based lists.

Through user testing we’ve identified 3 as the optimal number of buttons to provide a good user experience. If you have a list of more than 3 options, and cannot condense it into one button message, we recommend using list messages. During testing, businesses had higher response rates and conversions with list messages than using text-based lists.

There may be a very small number of users for whom their app version does not support this feature, the business will receive a webhook notification throwing an error that describes why the message was unable to be received. It is up to the business to determine how to handle this error elegantly. Best practice would convert the interactive message to a text-based list to allow the user to complete the workflow.

If there is a delay in a subset of numbers, then it is likely not an issue affecting the customers integration but rather an issue on the recipients end, these delays in delivery can happen for a number of reasons. See Send Message Performance, Delays for more information.

Không, hiện tại chúng tôi không hỗ trợ thay đổi đường dẫn mặc định đến bộ nhớ file phương tiện (/usr/local/wamedia/). Tất cả bộ nhớ file phương tiện cần phải ở vị trí mặc định này thì mới có thể hoạt động bình thường.

Không, hiện tại chúng tôi phải sử dụng AWS EFS để chia sẻ phần dữ liệu file phương tiện giữa Coreapp và Webapp.

Không, chúng tôi không hỗ trợ KOPS. Chúng tôi hỗ trợ giải pháp AWS dựa trên ECS. Ngoài ra, chúng tôi còn cung cấp tài liệu hướng dẫn chung về cách thiết lập Kubernetes bằng minikube.

Coreapp sẽ kiểm tra các thư mục /usr/local/waent/data/usr/local/waent/log trong vùng chứa Coreapp để đảm bảo dung lượng lưu trữ tối thiểu là 10 MB, nếu không sẽ xảy ra lỗi nghiêm trọng này.

Hãy kiểm tra nhật ký và thư mục dữ liệu của bạn để đảm bảo có đủ dung lượng.

Không. Hiện không có cách nào để dùng nhiều số điện thoại bằng cùng một quy trình thiết lập ứng dụng API WhatsApp Business. Chúng tôi đang nỗ lực tìm ra giải pháp phù hợp để hỗ trợ điều này trong tương lai.

Sử dụng điểm cuối API services dọn dẹp cơ sở dữ liệu để xóa hoàn toàn các tin nhắn và biên lai tin nhắn tương ứng trong bảng messageStore.messagesmessageStore.messages_receipt_log.

Hãy kiểm tra kỹ tùy chọn cài đặt ứng dụng pass_through của bạn. Bạn sẽ không nhận được bất kỳ lệnh gọi lại trạng thái đã đọc nào nếu đã bật pass_through cho ứng dụng API WhatsApp Business v2.29.1 trở lên.

Nếu muốn nhận được lệnh gọi lại trạng thái đã đọc, hãy tắt tùy chọn cài đặt ứng dụng pass_through. Lưu ý rằng khi tắt pass_through, dung lượng cơ sở dữ liệu có thể tăng lên nhanh chóng. Để biết thêm thông tin về cách quản lý cơ sở dữ liệu, hãy xem tài liệu về Quản lý cơ sở dữ liệu.

Theo định kỳ, công cụ dọn dẹp cơ sở dữ liệu sẽ dọn dẹp các bảng messagesmessages_reciept_log để giúp quản lý cơ sở dữ liệu.

Công cụ dọn dẹp giữ lại một số tin nhắn để cho phép xử lý/gửi thành công. Ví dụ: giữ lại những tin nhắn đến trong một khoảng thời gian nhất định để cho phép các tiện ích tích hợp cho doanh nghiệp đánh dấu tin nhắn là đã đọc.

Coreapp tiến hành dọn dẹp theo tần suất ngẫu nhiên (ví dụ: vài giờ một lần). Điều này là để ngăn tình trạng suy giảm hiệu suất tiềm ẩn trong ngăn xếp Sẵn sàng cao do xung đột cơ sở dữ liệu.

Hoạt động dọn dẹp không phụ thuộc vào hàng đợi lệnh gọi lại. Ví dụ: nếu máy chủ Webhook không hoạt động trong 4 ngày, các lệnh gọi lại sẽ được lưu trữ để gửi đi khi kết nối máy chủ Webhook được khôi phục.

Liên kết sẽ chỉ hiển thị ở dạng có thể nhấp được nếu người nhận đã lưu số doanh nghiệp của bạn vào danh bạ hoặc bạn có Tài khoản kinh doanh chính thức.

Trước v2.29.x, kích thước hàng đợi tin nhắn đi có thể tăng theo thời gian do lỗi. Hãy nâng cấp lên v2.29.3 để khắc phục sự cố này.

Không có dữ liệu phân tích cho Mã QR và Liên kết ngắn vì chúng tôi chỉ ghi lại một lượng dữ liệu giới hạn để bảo vệ quyền riêng tư của người dùng.

Bạn sẽ chịu trách nhiệm sử dụng mã QR thích hợp dựa trên vị trí và ngôn ngữ dự kiến của người dùng.

Giờ đây, bạn có thể tạo và quản lý mã QR ngay trong API Quản lý WhatsApp Business. Người dùng có thể quét mã này bằng camera trên WhatsApp, iOS hoặc Android.

Ngoài ra, với mã QR trên WhatsApp

  • Bạn hoàn toàn có thể tùy chỉnh, cũng như thay đổi hoặc xóa các tin nhắn điền sẵn bất cứ lúc nào,
  • Người dùng sẽ luôn truy cập trực tiếp vào ứng dụng mà không có bất kỳ trang chèn giữa nào và
  • Người dùng sẽ nhận được thông báo rõ ràng trong ứng dụng khi một mã hết hạn.

Nếu người dùng cố truy cập vào một mã QR hoặc liên kết ngắn đã bị xóa, hệ thống sẽ hiển thị thông báo lỗi cho biết mã QR/liên kết ngắn đó đã hết hạn.

Nếu người dùng đã cài đặt ứng dụng WhatsApp dành cho máy tính, thao tác này sẽ bắt đầu một cuộc trò chuyện với doanh nghiệp của bạn. Nếu chưa, người dùng sẽ được nhắc cài đặt ứng dụng WhatsApp dành cho máy tính.

Với liên kết ngắn mới, bạn có thể chỉnh sửa hoặc xóa các tin nhắn điền sẵn được liên kết với một liên kết vào bất cứ lúc nào. Liên kết ngắn cũng rút gọn cú pháp của URL thành một mã ngẫu nhiên. Do đó, bạn không cần nhúng tin nhắn vào URL và số điện thoại cũng được che đi.

Bạn nên sử dụng định dạng file .svg để tài liệu in có chất lượng tốt nhất.

Bạn không thể liên kết một số điện thoại trên WABA với hơn 2.000 mã QR và liên kết ngắn.

We are announcing the deprecation of Groups through the WhatsApp Business API. Starting July 8, 2020, only API phone numbers in a group created prior to July 8th can continue to use/manage Groups through the WhatsApp Business API. All other API phone numbers won’t be able to create/manage Groups through the Whatsapp Business API. On October 8, 2020, we will deprecate this feature for all API phone numbers (i.e., API phone numbers will be removed from their groups and no longer be able to send messages to their group).

v2.25.x cải thiện hiệu quả kết nối đến và đi so với các bản phát hành trước. Tùy chọn tối ưu hóa này dựa trên việc tạo thêm lượt kết nối cơ sở dữ liệu. Đối với một số hoạt động triển khai, điều này có thể khiến số lượt kết nối cơ sở dữ liệu tăng lên và đạt đến giới hạn đã định cấu hình. Để hiệu quả luôn tăng, bạn có thể tăng số lượt kết nối tối đa mà máy chủ cơ sở dữ liệu của bạn có thể chấp nhận. Nếu không thể, bạn có thể thay đổi thông số axolotl_context_striping_disabled để tắt tùy chọn này. Hãy xem tài liệu về Cài đặt ứng dụng để biết thêm thông tin về cách thực hiện sự thay đổi này.

Không. Hiện tại, giới hạn nhắn tin chỉ áp dụng cho các tin nhắn do doanh nghiệp khởi tạo (thông báo).

Khi gửi hình ảnh dưới dạng album từ API WhatsApp Business, bạn cần gửi tối thiểu 4 hình ảnh liên tiếp. Nếu chế độ xem cuộc trò chuyện của người dùng đang hoạt động khi họ nhận được hình ảnh, bạn sẽ không dùng được chế độ xem album cho tới lần truy cập tiếp theo.

Bạn sẽ không tạo được album trong bất kỳ trường hợp nào sau đây:

  1. Hình ảnh có chú thích
  2. Công cụ phân chia tin nhắn chưa đọc - người dùng sẽ nhìn thấy một số hình ảnh nhưng không nhìn thấy phần còn lại
  3. Tiêu đề ngày - ngày mới giữa những lần gửi

Không. Hiện tại, ứng dụng API WhatsApp Business không chạy trên Docker cho Windows. Đối với các nhu cầu phát triển, bạn nên dùng máy ảo Linux và chạy Docker trong máy đó. Đối với các phần việc sản xuất, bạn nên dùng máy chủ Linux để tránh các vấn đề về hiệu quả và khả năng tương thích.

Đối với ứng dụng API WhatsApp Business đang chạy phiên bản 2.21.6, khi bị ngắt kết nối khỏi máy chủ, ứng dụng có thể vẫn ngắt kết nối trong vài phút (tối đa là 4 phút), sau đó sẽ thử kết nối lại. Nếu nâng cấp lên phiên bản 2.23.4, ứng dụng sẽ ngừng hoạt động trong thời gian ngắn hơn khi cố gắng kết nối với máy chủ.

Mã lỗi 471 liên quan đến giới hạn tốc độ dựa trên chất lượng. Hãy xem tài liệu về Giới hạn tốc độ dựa trên chất lượng để biết thêm thông tin.

Tất cả doanh nghiệp đều bắt đầu ở bậc thấp nhất và sẽ tự động được nâng cấp lên các bậc cao hơn khi họ gửi thêm nhiều tin nhắn có chất lượng cao.

Đúng vậy. Khi gửi mẫu tin nhắn, nếu tin nhắn không hiển thị được ở phía người nhận, bạn sẽ nhận được lệnh gọi lại có trạng thái "không thành công" kèm theo thông báo "không có cấu trúc" trong đối tượng lỗi. Đối tượng này cho biết rằng không hiển thị được tin nhắn. Tùy theo người nhận, bạn cũng có thể nhận được lệnh gọi lại có trạng thái là "đã gửi". Lệnh gọi này chỉ đơn thuần cho biết rằng tin nhắn đã được gửi đến người nhận, sau đó người nhận không hiển thị được tin nhắn.

Sau đây là các lỗi xác thực khi gửi mẫu tin nhắn và lý do bạn có thể gặp phải lỗi:

  • "Không có mẫu tin nhắn nào tồn tại ở ngôn ngữ ngôn ngữ của bạn" hoặc "Không có mẫu tin nhắn nào tồn tại ở ngôn ngữ ngôn ngữ của bạn và tiếng tiếng của bạn" - Gói ngôn ngữ đưa ra không tồn tại. Kiểm tra tài khoản Trình quản lý kinh doanh của bạn.
  • "Mẫu tên mẫu của bạn không tồn tại ở ngôn ngữ ngôn ngữ của bạn" hoặc "Mẫu tên mẫu của bạn không tồn tại ở ngôn ngữ ngôn ngữ của bạn và tiếng tiếng của bạn" - Bạn đang cố sử dụng một mẫu không tồn tại (chưa được tạo hoặc chưa được phê duyệt). Nếu cố gửi tin nhắn bằng một mẫu đã bị xóa, bạn cũng sẽ gặp lỗi này.
  • "Số lượng thông số có thể bản địa hóa num1 không khớp với số lượng thông số mong muốn num2" - Bạn đang cố gửi một mẫu tin nhắn có các thông số không khớp với số lượng thông số mong muốn. Vui lòng kiểm tra lệnh gọi API để khắc phục.
  • "your-template-name là một mẫu đa dạng thức và cần phải sử dụng API Mẫu tin nhắn" - Bạn đang cố gắng gửi một mẫu tin nhắn chứa file phương tiện ở dạng mẫu tin nhắn thông thường. Đảm bảo loại tin nhắn là template. Hãy xem tài liệu về Mẫu tin nhắn chứa file phương tiện để biết thêm thông tin.
  • Sau khi mẫu được phê duyệt trong Trình quản lý kinh doanh (hoặc bị xóa), có thể mất tới 20 phút để ứng dụng API WhatsApp Business nhận được mẫu cập nhật. Nếu đang cố gửi tin nhắn bằng mẫu vừa mới được phê duyệt và nhận được lỗi cho biết mẫu này không tồn tại, bạn có thể thử gửi lại tin nhắn sau khi chờ một khoảng thời gian đã chỉ định ở trên.

Hệ thống có thể gửi tin nhắn trùng lặp tới WhatsApp Webhook với điều kiện duy nhất là người nhận sẽ nhận được tin nhắn đó tối thiểu một lần (trái ngược với trường hợp chỉ đúng một lần). Nếu điều này ảnh hưởng đến cách bạn xử lý tin nhắn thì bạn nên loại bỏ trùng lặp các tin nhắn Webhook dựa trên ID tin nhắn.

Nếu số điện thoại đó chưa được dùng trên API WhatsApp Business, bạn có thể dùng số điện thoại đó. Hãy làm theo các bước di chuyển được nêu tại đây để dùng lại số điện thoại đó.

Kể từ bản phát hành phiên bản 2.18.26, điểm cuối Số liệu thống kê ứng dụng cho phép xuất số liệu nội bộ ở định dạng văn bản Prometheus. Hãy xem tài liệu về việc Giám sát phiên bản để biết thêm thông tin.

Đối tượng profile trống sẽ được trả về nếu Trang kinh doanh chỉ điền một phần. Vui lòng nâng cấp lên v2.21.4 để khắc phục sự cố này.

Hãy xem tài liệu về Cài đặt trang kinh doanh để biết thêm thông tin về cách hoàn tất trang kinh doanh.

Nếu bạn gặp lỗi tương tự như sau khi thiết lập phương thức triển khai AWS, hãy thử thay đổi thành tên ngăn xếp có tối đa 8 ký tự.

Tên quốc gia (mã gồm 2 chữ cái) [AU]:Tên tiểu bang hoặc tỉnh (tên đầy đủ) [Tiểu bang nào đó]:Tên địa phương (ví dụ: thành phố) []:Tên tổ chức (ví dụ: công ty) [Internet Widgits Pty Ltd]:Tên đơn vị tổ chức (ví dụ: bộ phận) []:Tên phổ biến (ví dụ: FQDN máy chủ hoặc tên CỦA BẠN) []:chuỗi quá dài, độ dài cần ít hơn 64 byte Tên phổ biến (ví dụ: FQDN máy chủ hoặc tên CỦA BẠN) []:Địa chỉ email []:lỗi, không có đối tượng nào được chỉ định trong sự cố file cấu hình tạo ra khóa thiết bị do Yêu cầu chứng chỉ tạo cho internal-wa-inc-name-LB-123456789.ap-southeast-1.elb.amazonaws.com

Không có giới hạn về số lượng thông số được phép trong một mẫu tin nhắn.

Nếu một sự kiện Webhook không gửi được vì bất kỳ lý do gì (ví dụ: ứng dụng không có kết nối mạng) hoặc nếu yêu cầu Webhook trả về mã trạng thái HTTP không phải là 200, chúng tôi sẽ thử gửi lại webhook. Chúng tôi sẽ tiếp tục thử gửi lại với thời gian trễ tăng dần tới một khoảng thời gian chờ nhất định (thường là 24 giờ, mặc dù khoảng thời gian này có thể thay đổi) hoặc cho đến khi gửi thành công.

Có thể có các trường hợp mà bạn cần thêm thời gian để xử lý câu hỏi của khách hàng và chỉ có thể phản hồi sau 24 giờ. Bạn nên tạo mẫu tin nhắn để:

  • cung cấp kết quả cho người dùng, hoặc
  • nhắc người dùng trả lời để kích hoạt cửa sổ dịch vụ khách hàng.

Trong cả hai trường hợp, vui lòng đảm bảo rằng bạn đưa nhiều ngữ cảnh nhất có thể vào mẫu tin nhắn. Ví dụ:

  • "Chào {{1}}! Về vấn đề bạn đã báo cáo trước đây, chúng tôi rất tiếc phải thông báo rằng {{2}}. Chúng tôi xin lỗi vì mọi sự bất tiện mà sự việc này gây ra."
  • Chúng tôi có thông tin cập nhật về phiếu của bạn. Vui lòng phản hồi lại nếu bạn muốn tiếp tục được hỗ trợ."

WhatsApp chạy các thử nghiệm để đo lường và tìm hiểu tác động của thông báo từ API WhatsApp Business đối với trải nghiệm của người dùng và toàn bộ sản phẩm nói chung. Nếu người dùng mà bạn đang nhắn tin thuộc một trong những thử nghiệm này thì họ có thể không nhận được thông báo từ bạn, ngay cả khi họ đã chọn nhận thông báo.

Nếu bạn sao lưu tùy chọn thiết lập hiện tại và khôi phục tùy chọn đó trên máy mới thì thông tin đăng ký sẽ chuyển qua phần còn lại trong quá trình triển khai. Hãy xem tài liệu về Cài đặt sao lưu và khôi phục để biết thêm thông tin.

Có, tính năng xoay nhật ký dành cho vùng chứa webapp và vùng chứa coreapp có các hành vi khác nhau một chút:

  • Webapp: 30 file nhật ký gần đây nhất sẽ được giữ lại. File nhật ký chỉ xoay khi kích thước lớn hơn 20 MB.
  • Coreapp: 30 file nhật ký gần đây nhất sẽ được giữ lại. File nhật ký chỉ xoay khi kích thước lớn hơn 15 MB. Các file đã xoay sẽ được nén.

Vui lòng liên hệ với bộ phận Hỗ trợ và cung cấp bất kỳ thông tin nào bạn có. Chúng tôi sẽ điều tra và ngừng hoạt động của mọi số giả.

Tất cả các bản dựng của Ứng dụng API WhatsApp Business đều hết hạn sau 6 tháng kể từ ngày phát hành. Nếu bạn gặp lỗi này, hãy nâng cấp lên phiên bản phát hành mới nhất ngay khi có thể.

Trước hết, bạn cần kiểm tra xem người liên hệ có tồn tại hay không rồi mới gửi tin nhắn. Hãy xem tài liệu về Người liên hệ để biết thêm thông tin về cách thực hiện việc này.

Lỗi này là do Coreapp chưa được khởi tạo. Điều đó nghĩa là chưa thực hiện đăng ký thành công. Vui lòng thử đăng ký trước khi thực hiện lệnh gọi tới một điểm cuối khác. Bước đầu tiên sau khi cài đặt API WhatsApp Business là đăng nhập. Bước thứ hai là đăng ký. Hai bước này là cần thiết trước khi đưa ra yêu cầu cho bất kỳ điểm cuối nào khác.

Lưu ý: kể từ v2.27.8, chúng tôi sẽ ngừng sử dụng chính sách ngôn ngữ fallbackdeterministic giờ sẽ là chính sách ngôn ngữ mặc định.

Nếu tạo bản dịch ở ngôn ngữ mới, bạn cần dịch tất cả các thành phần mà bạn dùng sang ngôn ngữ đó. Nếu không, bạn có thể gặp lỗi "không có cấu trúc" vì điện thoại của người nhận không thể tìm thấy thành phần mong muốn bằng ngôn ngữ dùng trên điện thoại. Bạn gặp phải lỗi cấu trúc không mong muốn này khi gửi mẫu tin nhắn bằng chính sách dự phòng.

Nếu không tạo được bản dịch ngôn ngữ tại thời điểm này, bạn có thể dùng chính sách xác định để tránh những lỗi này.

Phần tải tin nhắn từ người dùng có thể là văn bản hoặc file phương tiện.

Đối với văn bản, chúng tôi chưa xác định được bất kỳ mối nguy hại nào.

Đối với file phương tiện:

  • Thông thường, các doanh nghiệp nên có phần mềm bảo vệ nào đó (nghĩa là diệt vi rút, chống phần mềm độc hại, v.v.) tại chỗ để phân tích bất kỳ mối đe dọa tiềm ẩn nào.
  • WhatsApp không thể xác định hay kiểm tra nội dung của file đang được truyền vì file đó được mã hóa đầu cuối (điều này cũng áp dụng cho nội dung chỉ gồm văn bản).
  • Có một phương án ngăn chặn hành vi tự động tải xuống file phương tiện trong Ứng dụng API WhatsApp Business. Nếu doanh nghiệp không muốn nhận bất kỳ file nào từ người dùng, họ có thể đặt trường auto_download thành một mảng trống.

Không, không dùng được API WhatsApp Business để phát hiện nhiều thiết bị sử dụng cùng một số điện thoại.

Lỗi không có cấu trúc xảy ra khi điện thoại không thể đọc tin nhắn mẫu.

Mẫu được lưu trữ trên máy chủ. Khi một tin nhắn mẫu được gửi thông qua nút messages, chỉ có vùng tên, ngôn ngữ, tên thành phần và các thông số đã bản địa hóa mới được gửi đến điện thoại chứ không phải toàn bộ tin nhắn. Sau khi nhận được những giá trị này, điện thoại sẽ cố gắng hiển thị tin nhắn đó.

Nếu có lỗi xảy ra trong quá trình hiển thị, lỗi structure unavailable (không có cấu trúc) sẽ được gửi đến URL gọi lại có chứa ID người nhận và ID tin nhắn. Những lỗi này có thể xảy ra do vùng tên sai, thông số đã bản địa hóa không khớp, tên thành phần sai, v.v.

Bạn có thể chuyển đến Trình quản lý WhatsApp trong Trình quản lý kinh doanh trên Facebook để xem số lượng thông số chính xác. Hãy kiểm tra cẩn thận để chắc chắn rằng vùng tên chính xác và tên thành phần có tồn tại.

Một nguyên nhân phổ biến gây ra lỗi là không tạo bản dịch cho tất cả các mẫu đang sử dụng. Ví dụ: nếu bạn thường gửi 2 mẫu nhưng chỉ thêm bản dịch ngôn ngữ mới cho một mẫu, hãy nhớ thêm cả bản dịch ngôn ngữ mới đó cho mẫu còn lại. Nếu định hỗ trợ nhiều ngôn ngữ thì bạn cần cung cấp bản dịch cho tất cả các mẫu ở mọi ngôn ngữ được hỗ trợ.

Tin vui là lỗi structure unavailable (không có cấu trúc) thường xảy ra do sai sót trong lệnh gọi API đến nút messages và có thể khắc phục được bằng cách thay đổi phần tải dữ liệu gửi.

Trong Trình quản lý kinh doanh Facebook, bạn có thể đăng ký các số điện thoại mới và xóa số cũ thuộc Tài khoản WhatsApp.

  1. Trong Tài khoản WhatsApp, hãy chuyển đến phần Cài đặt.
  2. Nhấp vào Trình quản lý WhatsApp.
  3. Chọn tab Số điện thoại. Tại đây, bạn có thể quản lý tất cả số điện thoại cho tài khoản này.

Đối với hình ảnh, chú thích sẽ được thêm dưới dạng nội dung mô tả. Văn bản chú thích cho hình ảnh hiển thị ở độ dài đầy đủ trên cả Android lẫn iPhone.

Đối với tài liệu, chú thích sẽ thay thế tên file. Điều này không có nghĩa là chú thích hiển thị trên thiết bị của người dùng dưới dạng văn bản mô tả, mà thay vào đó là hiển thị tên của file. iPhone hiển thị văn bản đầy đủ trong khi Android cắt bớt tên file; đây là giới hạn kỹ thuật của quá trình triển khai WhatsApp trên cả hai thiết bị vào thời điểm hiện tại.

Nếu quá trình đăng ký bằng "sms" không thành công do có quá nhiều lần thực hiện và bạn nhận được thông báo "truy cập bị từ chối", vui lòng thử đăng ký bằng "cuộc gọi thoại"

Hiện tại là 7 ngày. Nếu không được cập nhật trong hơn 7 ngày, bộ nhớ đệm sẽ kéo gói ngôn ngữ mới nhất từ máy chủ, bất kể thành phần đã tồn tại trong gói hay chưa.

Trước hết, thiết bị sẽ tải từ bộ nhớ đệm. Nếu một thành phần tồn tại thì thiết bị sẽ giải nén tin nhắn sử dụng mẫu tin nhắn đó. Do đó, thay vì sửa đổi mẫu tin nhắn, cách an toàn nhất là bạn chỉ cần thêm một mẫu mới có tên thành phần khác. Điều này sẽ đảm bảo rằng gói ngôn ngữ được tải xuống lại khi thiết bị không tìm thấy thành phần đó. Chi phí lưu trữ mẫu tin nhắn là không đáng kể, do đó, không thực sự cần phải xóa mẫu tin nhắn.

Hãy xem phần Gửi mẫu tin nhắn - Ngôn ngữ để biết thêm thông tin.

Để đảm bảo trải nghiệm chất lượng cao cho doanh nghiệp và người dùng, chúng tôi có bản xem trước công khai giới hạn. Nếu bạn muốn hợp tác với chúng tôi, hãy gửi thêm thông tin về doanh nghiệp của bạn để được cân nhắc vì chúng tôi sẽ tiếp tục mở rộng phạm vi cung cấp, hoặc liên hệ với đại diện Facebook nếu bạn đã có ứng dụng.

Thao tác đăng xuất người dùng qua điểm cuối users sẽ vô hiệu hóa tất cả các mã xác thực được chỉ định cho tài khoản đó. Thao tác xóa người dùng cũng có tác dụng tương tự như vậy, mặc dù rõ rệt hơn rất nhiều. Lưu ý rằng thao tác đăng nhập người dùng qua điểm cuối users sẽ trả về mã xác thực mới, nhưng sẽ không vô hiệu hóa các mã xác thực đã lưu hành cho người dùng đó. Bất cứ ai sở hữu mã đã cung cấp trước đây đều sẽ tiếp tục sử dụng được mã đó cho đến khi mã hết hạn hoặc bị vô hiệu hóa bằng một trong những phương thức đề cập ở trên.

Nếu bạn gặp phải lỗi này nhưng thông số bắt buộc bị thiếu (mà lỗi đề cập đến) đã được đặt trong phần nội dung ở định dạng json thì đó có thể là lỗi phân tích cú pháp json. Lỗi này có thể xuất hiện khi không thể phân tích cú pháp toàn bộ phần tải dữ liệu ở định dạng json do lỗi định dạng json. Hãy kiểm tra giá trị của những thông số này để tìm các ký tự json không hợp lệ, chẳng hạn như ký tự xuống dòng ở cuối. Đôi khi, các thông số có thể bị sao chép thừa khoảng trắng, từ đó có thể có các ký tự phá vỡ định dạng json.

Có nhiều lý do cho điều này. Coreapp của bạn có thể ngừng hoạt động hoặc cơ sở dữ liệu chưa được thiết lập đúng cách. Nếu bạn không gặp phải những trường hợp này, vui lòng xem nhật ký Coreapp (hoặc nhật ký Coreapp chính nếu bạn đang chạy chế độ đa kết nối). Nếu bạn gặp phải lỗi kết nối cơ sở dữ liệu thì có khả năng cơ sở dữ liệu của bạn đã hết kết nối. Hãy xem tài liệu MySQL hoặc tài liệu PostgreSQL về lỗi này.

Bạn nên tăng số lượng kết nối cơ sở dữ liệu trên cơ sở dữ liệu của mình. Số lượng an toàn sẽ là 1000 kết nối cơ sở dữ liệu. Tuy nhiên, vui lòng đưa ra quyết định sáng suốt của riêng mình về số lượng kết nối. Nếu lỗi này vẫn tiếp diễn, vui lòng mở một phiếu hỗ trợ.

Dưới đây là các lý do khiến một mẫu tin nhắn có thể bị từ chối:

  • Chứa nội dung có thể lạm dụng, chẳng hạn như ngôn ngữ lạm dụng hoặc nội dung giống như spam
  • Chứa nội dung quảng cáo
  • Không khớp với một số loại thẻ
  • Có định dạng không chính xác

Lỗi "kết nối bị từ chối" nhiều khả năng có nghĩa là Coreapp hiện không chạy. Hãy dùng docker ps để xem Coreapp có đang hoạt động hay không. Nếu Coreapp không hoạt động, hãy xem nhật ký Docker. Coreapp có thể không kết nối được với cơ sở dữ liệu. Hãy đảm bảo thiết lập cơ sở dữ liệu đúng cách.

Lỗi này xảy ra khi cầu Docker bị hỏng. Cách xử lý tốt nhất cho lỗi này là dừng dịch vụ Docker và khởi động lại dịch vụ. Bạn cũng có thể dùng thử docker restart trên vùng chứa.

WhatsApp xác minh cẩn thận xem số được cung cấp có thực sự thuộc về một điện thoại hay không. Thực tế, khi một người dùng có tài khoản WhatsApp, nghĩa là họ đã xác nhận số này và sau đó không có ai khác sử dụng số đó để đăng ký trên WhatsApp. Tuy nhiên, điều đó không đảm bảo được vị trí thực của thẻ SIM.

Mặt khác, nếu điện thoại của người dùng bị mất hoặc bị đánh cắp, họ có thể vô hiệu hóa tài khoản WhatsApp của mình. Hãy xem phần Câu hỏi thường gặp về điện thoại bị mất và bị đánh cắp để đọc thêm thông tin về cách người dùng có thể vô hiệu hóa tài khoản của họ.

Nếu số điện thoại của khách hàng không hoạt động, nhưng khách hàng vẫn đang sử dụng WhatsApp thì họ sẽ tiếp tục có quyền truy cập vào WhatsApp cho đến khi/nếu số điện thoại được chỉ định lại hoặc đăng ký lại.

WhatsApp strongly verifies whether number provided actually belongs phone. The fact that a user has a WhatsApp account is proof that they confirmed the number and no one else has used that number to register on WhatsApp subsequently. However, It is not a guarantee of the physical location of the sim.

On the other hand, if users phone is lost or stolen, they can deactivate their WhatsApp account. You may read to know more about how users can deactivate their account here.

Lỗi này xuất hiện khi cơ sở dữ liệu chưa được thiết lập đúng cách.

  • Hãy đảm bảo bạn đang dùng MySQL 5.7 trở lên hoặc PostgreSQL 9.5.x, 9.6.x, 10.x.
  • Mật khẩu cơ sở dữ liệu không được chứa bất kỳ ký tự nào sau đây: ?{}&~!()^.
  • Nếu bạn đang dùng AWS, hãy đảm bảo ngăn xếp của bạn có tên ngắn. Hãy xem tài liệu Cài đặt để biết thêm thông tin.

Có, kết nối TCP rất cần thiết. Bạn có thể sử dụng SSL đã kết thúc nếu doanh nghiệp của bạn không thể mở thêm cổng.

Hãy xem tài liệu Yêu cầu về mạng để biết thêm thông tin.

Đây là một sự cố đã biết. Đôi khi, việc nâng cấp Ứng dụng API WhatsApp Business bằng tập lệnh CloudFormation cũng yêu cầu cập nhật lên ngăn xếp DB RDS. Ngăn xếp RDS mới sẽ không có cùng tên máy chủ như ngăn xếp ban đầu và vùng chứa Docker không thể kết nối với cơ sở dữ liệu. Giải pháp là đưa SSH vào phiên bản EC2 do CloudFormation tạo và cập nhật file whatsapp.conf bằng tên máy chủ mới, sau đó khởi động lại các vùng chứa Docker để chúng chọn các tùy chọn cài đặt mới.

Có, hãy gửi lệnh gọi API tới nút contacts trước khi gửi tin nhắn. Thông tin khi kiểm tra contacts sẽ được lưu vào bộ nhớ đệm trong vùng chứa. Nếu không làm vậy, lỗi Unkown Contact có thể xảy ra. Hãy xem tài liệu Kiểm tra danh bạ để biết thêm thông tin.

Use the mcdockerreset script and tear down the webapps then use the mcdockersetup script to bring up a new webapp.


Reason: When the webapp first connects to the DB, it creates the database.yml file. it will never try to create it again. The coreapps will just not start up on a bad DB config; however, the webapp will, so you see the master and slave nodes in your DB because they were setup correctly once you got around all the DB and script issues but the webapps were started by the script in a bad state to begin with.

Nếu Webhook không gửi được lệnh gọi lại, lệnh gọi lại này sẽ được đưa vào hàng đợi thử lại. Hệ thống sẽ không nhận được bất kỳ lệnh gọi lại nào đã gửi sau sự cố lệnh gọi lại ban đầu. Bạn chỉ có thể gửi các lệnh gọi lại khác sau khi gửi được lệnh gọi lại không thành công ban đầu.

Ứng dụng API WhatsApp Business gửi lệnh gọi lại Webhook cho bạn qua vùng chứa Coreapp. Do đó, bạn cần cấu hình điểm cuối Webhook để chấp nhận các yêu cầu đến từ Coreapp.

Bạn nên đăng ký số điện thoại thứ hai và tăng tốc ngăn xếp CloudFormation thứ hai hoặc phiên bản Docker để thử nghiệm. Nếu bạn có 2 Ứng dụng API WhatsApp Business đang hoạt động sử dụng cùng một số điện thoại, máy chủ sẽ đăng xuất bạn vì các khóa mã hóa xung đột. Bạn nên có môi trường thứ hai mà bạn có thể dùng để thử nghiệm phiên bản không phải là phiên bản chính thức trước khi thực hiện bất kỳ quá trình di chuyển nào trên ứng dụng chính thức.

Bạn cần có MySQL 5.7.x, PostgreSQL 9.5.x, 9.6.x, 10.x. Việc sử dụng một phiên bản trước sẽ gây ra lỗi Unable to initialize config store.

Khi gửi một tin nhắn, ngay khi bạn nhận lại ID tin nhắn thì nghĩa là yêu cầu tin nhắn đã được lưu trữ trong cơ sở dữ liệu. Ứng dụng API WhatsApp Business sẽ không ngừng tìm cách gửi tin nhắn đó cho đến khi được máy chủ WhatsApp công nhận. Quá trình này không có thời điểm kết thúc. Sau đó, máy chủ WhatsApp sẽ tìm cách gửi tin nhắn đó đến điện thoại của người dùng. Nếu điện thoại của người dùng không có kết nối mạng, tin nhắn sẽ được lưu trữ trong 30 ngày trước khi bị máy chủ WhatsApp xóa bỏ.

Bảng cơ sở dữ liệu lưu trữ thông tin liên quan đến tùy chọn cài đặt ứng dụng, đoạn chat, tin nhắn, file phương tiện, v.v. do ứng dụng yêu cầu để hoạt động.

Doanh nghiệp của bạn sẽ không nhận được thông báo khi một khách hàng thay đổi số điện thoại WhatsApp của họ. Khi bạn sử dụng nút contacts, trạng thái của số đó sẽ là invalid.

Không, bạn có thể chạy một tài khoản cho mỗi phiên bản. Nếu bạn cần tài khoản thử nghiệm thứ hai, hãy nhớ dùng số khác cho phiên bản thứ hai đó.

Hoạt động kiểm tra Tình trạng là hoàn toàn miễn phí và bạn có thể truy vấn thường xuyên khi cần.

Đọc tài liệu Số liệu thống kê để tìm hiểu thêm các số liệu thống kê về ứng dụng và cơ sở dữ liệu mà bạn có thể truy vấn. Số liệu thống kê về ứng dụng được lưu trữ trong bộ nhớ và bạn có thể truy vấn với chi phí không đáng kể. Số liệu thống kê về cơ sở dữ liệu cần nhiều tài nguyên hơn và bạn chỉ nên truy vấn khi cần.

Khi sử dụng nút messages, bạn cần đặt tiêu đề Content-Type thành application/json để ứng dụng API WhatsApp Business phân tích chính xác nội dung tin nhắn. Bạn cũng cần đặt tiêu đề Authorization và tiêu đề này phải chứa một mã truy cập chưa hết hạn. Hãy xem tài liệu Đăng nhập và xác thực để biết thông tin về cách lấy mã và thời điểm mã hết hạn.

Hệ thống của bạn có thể bắt đầu hoạt động chậm lại vì đầy dung lượng. Tình trạng này có thể do nhiều file phương tiện, tin nhắn và file nhật ký lớn. Các file nhật ký tự động được xoay, nhưng nếu chúng bắt đầu lớn lên thì bạn nên xóa.

Tin nhắn được lưu trữ trong cơ sở dữ liệu. Bạn có thể xóa tin nhắn khi cần. Ngoài ra, nếu pass_through được đặt thành false trong phần cài đặt ứng dụng thì tất cả tin nhắn đều được lưu vào cơ sở dữ liệu cho đến khi bị xóa hoàn toàn.

Các file phương tiện mà người dùng gửi cho bạn được tải xuống ổ đĩa phương tiện. Doanh nghiệp có quyền quyết định sẽ xóa file phương tiện nào, nhưng thông thường, cách an toàn là xóa mọi file phương tiện. Bạn có thể sử dụng docker inspect your-container-id để kiểm tra vị trí của thư mục ổ đĩa phương tiện.

Hãy làm theo Hướng dẫn về MySQL Docker để thiết lập MySQL nội bộ bằng Docker.

Hãy làm theo Hướng dẫn về PostgreSQL Docker để thiết lập PostgreSQL nội bộ bằng Docker.

Trong hầu hết các trường hợp, bạn nên chạy cơ sở dữ liệu trên một máy chủ thực tách biệt với vùng chứa core và web. Máy chủ cơ sở dữ liệu chỉ được chậm hơn (các) máy tính vài mili giây.

Bạn có quyền quyết định thời điểm xóa file phương tiện.

Sau khi tải file phương tiện lên, bạn sẽ nhận được ID file phương tiện. Bạn có thể dùng ID này để gửi tin nhắn bao gồm thành phần file phương tiện đã được tải lên. Sau khi gửi tin nhắn phương tiện, API WhatsApp Business sẽ mã hóa và tải file phương tiện lên máy chủ WhatsApp. Tại đây, file sẽ được lưu giữ trong 14 ngày. Sau đó, bạn có thể quyết định xóa file phương tiện bằng cách cung cấp ID file phương tiện hoặc giữ lại để sử dụng sau này. Mặc dù nên giữ file phương tiện trong 30 ngày, nhưng bạn có quyền quyết định chính sách lưu giữ theo chính sách hoặc trường hợp sử dụng của doanh nghiệp mình.

Có, bạn có thể dùng cơ sở dữ liệu theo những cách khác mà không ảnh hưởng đến các bảng liên quan đến WhatsApp.

Trước hết, hãy kiểm tra lệnh gọi lại để xem các lỗi nghiêm trọng nhằm chẩn đoán sự cố.

Nếu gặp phải lỗi "Xung đột: Đã phát hiện thấy nhiều phiên bản sử dụng cùng một số" thì bạn cần kiểm tra các vùng chứa. Khả năng lớn nhất là do bạn có nhiều vùng chứa Docker đang tìm cách kết nối với máy chủ WhatsApp bằng cùng một tài khoản WhatsApp. Hãy đảm bảo bạn chỉ có một vùng chứa đang hoạt động. Nếu bạn có các vùng chứa cũ, hãy tắt chúng và lỗi sẽ biến mất.

Nếu bạn muốn thử nghiệm giải pháp phức tạp hơn, luôn sẵn sàng hoạt động của chúng tôi, hãy xem tài liệu Độ sẵn sàng cao.

Có thể tạo danh sách hợp lệ bằng tên máy chủ hoặc địa chỉ IP.

Hãy xem phần Tên máy chủ trong tài liệu Yêu cầu về mạng để biết thêm thông tin.

Có! Với WhatsApp, bạn có thể định dạng văn bản đã chọn bên trong tin nhắn thành In đậm, In nghiêng, Gạch ngang hoặc Đơn cách.

Có, mẫu tin nhắn hỗ trợ tất cả các định dạng và ký tự nhắn tin qua WhatsApp, bao gồm biểu tượng cảm xúc, chữ in đậm, in nghiêng, v.v. Đối với biểu tượng cảm xúc, bạn cần sử dụng ký tự biểu tượng cảm xúc (sao chép/dán) chứ không phải là mã unicode tương đương của ký tự đó.

Bạn được phép dùng các số miễn phí miễn là bao gồm cả mã quốc gia. Lý do là vì chúng tôi không thể xác định duy nhất các số miễn phí không có mã quốc gia - cùng một số có thể áp dụng cho 2 quốc gia khác nhau.

Ngoài ra, lưu ý rằng việc sử dụng số miễn phí cũng làm gia tăng tính phức tạp. Thông thường, nếu bạn gọi một số miễn phí có mã quốc gia khi đang ở quốc gia này thì cuộc gọi sẽ không thực hiện được. Điều này nghĩa là khách hàng tại quốc gia của bạn có thể tìm cách gọi đến số hiển thị trong thông tin liên hệ của doanh nghiệp (có kèm mã quốc gia) và họ sẽ không thể liên hệ với bạn. Nếu lo ngại về điều này, bạn cần nói rõ cho họ biết.

Đọc thêm thông tin về số miễn phí tại đây.

KHÔNG! Tại thời điểm bất kỳ, bạn chỉ có thể chạy một phiên bản Ứng dụng API WhatsApp Business bằng một số điện thoại. Ngay khi bạn đăng ký phiên bản thứ hai, phiên bản đầu tiên của bạn sẽ khởi động và gặp lỗi. Chúng tôi đang nỗ lực tìm ra giải pháp phù hợp nhằm hỗ trợ bạn hoàn thành việc này. Chúng tôi sẽ cho thông báo cho bạn khi có thông tin cập nhật.

WhatsApp xem hoạt động kết nối với người dùng API Business (những người quản lý điểm cuối API trên các máy chủ mà họ kiểm soát) là được mã hóa đầu cuối vì không có quyền truy cập của bên thứ ba vào nội dung giữa các điểm cuối.

Một số tổ chức có thể chọn ủy quyền quản lý điểm cuối API WhatsApp Business của họ cho Nhà cung cấp giải pháp kinh doanh bên thứ ba. Trong những trường hợp này, hoạt động kết nối vẫn sử dụng phương thức Mã hóa giao thức tín hiệu tương tự. Tuy nhiên, vì người dùng API WhatsApp Business đã ủy quyền cho bên thứ ba quản lý điểm cuối của họ nên WhatsApp xem những tin nhắn này là chưa được mã hóa đầu cuối. Trong tương lai, vào năm 2021, điều này cũng sẽ áp dụng cho những doanh nghiệp chọn sử dụng phiên bản dựa trên đám mây của API do Facebook lưu trữ.

Ngoài ra, nếu bạn dùng HTTPS khi thực hiện lệnh gọi tới ứng dụng API WhatsApp Business, dữ liệu đó sẽ được mã hóa SSL (từ ứng dụng phụ trợ tới ứng dụng API WhatsApp Business).

Xem tài liệu chuyên sâu về kỹ thuật Tổng quan về mã hóa trên WhatsApp của chúng tôi để biết thêm thông tin chi tiết.

Đó là do lỗi trong phiên bản cũ của ứng dụng iOS. Chúng tôi mong muốn các lỗi này sẽ giảm đi theo thời gian khi mọi người nâng cấp.

Không, thứ tự tin nhắn đến nơi không được đảm bảo đúng như thứ tự tin nhắn đã gửi. Nếu thứ tự là yếu tố quan trọng trong trường hợp sử dụng của bạn, bạn nên nghe lệnh gọi lại đã gửi tin nhắn cho tin nhắn đầu tiên trước khi gửi tin nhắn thứ hai.

Bạn có thể kích hoạt từ bên ngoài một tập lệnh để xóa các nhật ký cũ của một vùng chứa:

docker exec CONTAINER_NAME /opt/whatsapp/bin/cleanup.sh

Tập lệnh này hoạt động với cả vùng chứa webapp lẫn coreapp. Bằng cách chạy tập lệnh này, các file nhật ký cũ sẽ bị gỡ để chỉ giữ lại 30 file nhật ký của vùng chứa.

Lưu ý: Vui lòng không gửi cùng một tin nhắn nhiều lần cho cùng một người nhận bằng API WhatsApp Business.

Có thể có nhiều lý do khiến tỷ lệ gửi không đạt 100%. Một số trường hợp thường gặp bao gồm người dùng có quyền truy cập không thường xuyên vào mạng, không hoạt động trong một khoảng thời gian hoặc để tạo trải nghiệm chất lượng cao cho người dùng.

Tin nhắn có thể gửi được bằng WhatsApp sẽ có tỷ lệ gửi rất cao. Tuy nhiên, có nhiều lý do khiến hệ thống có thể không gửi được tin nhắn. Bạn sẽ có quyền truy cập vào trạng thái chính xác của tin nhắn bằng cách giám sát lệnh gọi lại. Điều này khác với việc gửi tin nhắn bằng SMS, chẳng hạn trong trường hợp bạn không có quyền truy cập vào trạng thái gửi cuối cùng và việc gửi lại tin nhắn có thể thực sự mang lại kết quả khác.

Tin nhắn có thể vẫn chưa gửi được vì điện thoại của người dùng không hoạt động hoặc hết pin hay người dùng bị mất điện thoại rồi có điện thoại mới và đã vô hiệu hóa SIM. Có thể xảy ra lỗi liên quan đến khả năng kết nối mạng của ứng dụng kinh doanh. Cũng có thể lệnh gọi lại (Webhooks) hiện không được gửi. Bạn có thể dùng nút health để giám sát những tình huống này. Bạn có thể bật lệnh gọi lại cho hoạt động nhận trên máy chủ để biết rằng tin nhắn đã đến đám mây trên máy chủ WhatsApp.

Nếu và khi một người dùng kết nối lại với mạng, người dùng đó sẽ nhận được tất cả tin nhắn bạn đã gửi. Việc nhận nhiều tin nhắn có cùng nội dung sẽ để lại trải nghiệm không tốt cho người dùng. Có nhiều khả năng người dùng sẽ chặn bạn hoặc phàn nàn. Có nhiều khả năng bạn sẽ bị cấm.

Nếu gửi một tin nhắn và nhận được ID tin nhắn từ API thì bạn không cần phải làm gì nữa để gửi tin nhắn này. Đừng gửi lại cùng một nội dung cho cùng một người nhận.

Nếu bạn nhận thấy tỷ lệ gửi thấp trong một khoảng thời gian dài, vui lòng gửi phiếu hỗ trợ qua kênh Hỗ trợ trực tiếp.

Ứng dụng API WhatsApp Business Tại chỗ yêu cầu có cơ sở dữ liệu để lưu trữ các khóa nhằm giải mã tin nhắn được gửi giữa doanh nghiệp và khách hàng. Mọi tin nhắn trên WhatsApp đều được mã hóa bằng khóa người gửi và khóa người nhận. Khóa khách hàng được lưu trữ trên thiết bị di động của khách hàng và khóa doanh nghiệp được lưu trữ trong cơ sở dữ liệu của doanh nghiệp. Hãy tìm hiểu thêm về Tính bảo mật của WhatsApp.

API WhatsApp Business Đám mây là giải pháp thay thế, trong đó Meta lưu trữ cơ sở dữ liệu của doanh nghiệp. Thông qua API Đám mây, bạn có thể triển khai các API WhatsApp Business mà không mất chi phí lưu trữ máy chủ của chính mình. Tìm hiểu thêm.

Không. Ứng dụng API WhatsApp Business sẽ mở một kết nối TCP đi tới cổng 5222 hoặc 443 trên máy chủ WhatsApp. Lưu lượng truy cập TCP xuất hiện trên kết nối dài hạn này. Thông thường, tường lửa sẽ phân loại kết nối này là cho phép “lưu lượng truy cập đi và lưu lượng truy cập đã thiết lập”. Tất nhiên, các gói tin sẽ truyền đi truyền lại sau khi kết nối này được thiết lập. Tuy nhiên, điểm bắt đầu kết nối sẽ đến từ Ứng dụng API WhatsApp Business nên không cần quy tắc cho phép các kết nối đến.

MySQL và PostgreSQL được hỗ trợ. Nếu tự chạy Docker, bạn phải cung cấp cơ sở dữ liệu MySQL/PostgreSQL cho các vùng chứa để kết nối. Nếu bạn dùng mẫu AWS, cơ sở dữ liệu MySQL sẽ được thiết lập theo mặc định.

Các yêu cầu sẽ phụ thuộc vào dung lượng tải và trường hợp của bạn. Giải pháp này sẽ hoạt động trên bất kỳ máy nào có kết nối Internet và chạy Docker. Ví dụ: bạn có thể thực hiện kiểm tra đơn giản trên máy tính xách tay.

Đối với việc thiết lập máy chủ chính thức chứa một phiên bản, tối thiểu bạn nên sử dụng ổ SSD 250 GB, RAM 16 GB và CPU 4 lõi. Không nên dùng ổ HDD vì tốc độ Đầu vào/Đầu ra sẽ bị giảm xuống mức tối thiểu trong quá trình tải.

Đối với việc thiết lập máy chủ chính thức Đa kết nối, tối thiểu bạn nên sử dụng ổ SSD 50 GB, RAM 4 GB và CPU 2 lõi cho từng vùng chứa Coreapp/Master/Webapp.

Trong hầu hết các trường hợp, bạn nên chạy cơ sở dữ liệu trên một máy chủ thực tách biệt với vùng chứa core và web. Máy chủ cơ sở dữ liệu chỉ được chậm hơn (các) máy tính vài mili giây.

Phương thức thiết lập này hỗ trợ gửi xấp xỉ 20 tin nhắn/giây.

Hiện tại, không có cách nào để làm việc này. Nếu không có khả năng xử lý phản hồi đến từ người dùng trên WhatsApp, bạn nên gửi tin nhắn trả lời tự động để chuyển hướng họ đến các kênh hỗ trợ phù hợp của bạn.

Trong tình huống sử dụng bình thường, điều này là do thiết kế khi người gửi không có trong sổ địa chỉ của bạn và trước đây bạn chưa gửi tin nhắn cho người gửi này. Trong tình huống của doanh nghiệp, doanh nghiệp nên sử dụng Mẫu tin nhắn khi lần đầu tương tác với người dùng để tạo dựng "lòng tin"; khi làm như vậy, ứng dụng API WhatsApp Business sẽ có thể hiển thị liên kết và khiến người dùng có thể nhấp vào liên kết đó.

Trong tình huống sử dụng bình thường, điều này là do thiết kế khi người gửi không có trong sổ địa chỉ của bạn và trước đây bạn chưa gửi tin nhắn cho người gửi này. Trong tình huống của doanh nghiệp, doanh nghiệp nên sử dụng Mẫu tin nhắn khi lần đầu tương tác với người dùng để tạo dựng "lòng tin"; khi làm như vậy, Ứng dụng API WhatsApp Business sẽ tuân theo tùy chọn cài đặt tự động tải xuống.

Rất tiếc, bạn cần chọn một số điện thoại khác có khả năng nhận SMS hoặc cuộc gọi thoại để chúng tôi gửi mã đăng ký. Trước đây, chúng tôi đã cho phép mã đăng ký thủ công, nhưng hiện không còn hỗ trợ mã này. Các số điện thoại đã dùng mã đăng ký thủ công trước đây sẽ tiếp tục được hỗ trợ theo yêu cầu. Đối với mọi số điện thoại mới, chúng tôi sẽ chỉ gửi mã đăng ký qua SMS hoặc cuộc gọi thoại.

Nếu bạn muốn sử dụng 1800 hoặc số miễn phí, vui lòng đọc hướng dẫn này.

Hiện tại, không có cách nào để xem số người dùng hoặc người dùng nào đã chặn doanh nghiệp của bạn. Dấu hiệu tốt nhất là nghe lệnh gọi lại trạng thái và nếu bạn không nhận được trạng thái delivered thì nghĩa là người dùng đã chặn doanh nghiệp của bạn hoặc họ không có kết nối mạng. Hãy xem tài liệu Webhook để biết thêm chi tiết.

Nếu một người dùng đã chặn doanh nghiệp của bạn, API Danh bạ sẽ tiếp tục trả về số điện thoại đó dưới dạng người dùng WhatsApp hợp lệ. Tuy nhiên, khi bạn gửi tin nhắn, người dùng đó sẽ không bao giờ nhận được tin nhắn. Nếu đó là tin nhắn trả phí thì bạn sẽ không bị tính phí.

Có, chúng tôi có thể thiết lập số điện thoại mới hoặc thay đổi tên đã xác minh khi bạn sẵn sàng hoạt động.

Kích thước tải lên file tối đa là 64 MB, nghĩa là giới hạn này cũng áp dụng cho bất kỳ hình ảnh, tài liệu hoặc video nào mà bạn gửi kèm tin nhắn.

Để tìm điểm gắn kết của ổ đĩa phương tiện, bạn có thể chạy lệnh docker.

Yêu cầu

docker volume inspect whatsappMedia

Phản hồi

[
    {
        "Driver": "local",
        "Labels": {},
        "Mountpoint": "/var/lib/docker/volumes/whatsappMedia/_data",
        "Name": "whatsappMedia",
        "Options": {},
        "Scope": "local"
    }
]

Sau đó, để xem tất cả các file phương tiện đến, bạn có thể chạy lệnh ls với đường dẫn file Mountpoint nhận được:

ls /var/lib/docker/volumes/whatsappMedia/_data/

Đối với quá trình thiết lập AWS, ổ đĩa phương tiện được gắn vào đường dẫn /mnt/wa/media trên máy chủ.

Không có cơ chế xóa đối với file phương tiện đến hoặc đi. Bạn có thể tìm file phương tiện trên hệ thống file để xóa theo cách thủ công.

Để khởi động lại các vùng chứa Docker, bạn có thể chạy mã sau:

Vùng chứa Docker Coreapp

docker restart wacore<Current_WABA_Version>

Vùng chứa Docker Webapp

docker restart webapp<Current_WABA_Version>

Bạn có thể kiểm tra xem mình đang chạy phiên bản nào

docker ps

Có! Theo mặc định, Ứng dụng API WhatsApp Business sẽ tìm cách giao tiếp bằng chatd qua cổng 5222. Để có trải nghiệm tốt nhất, hãy mở cổng 5222 cho tất cả lưu lượng truy cập đi. Điều này không gây ra vấn đề về bảo mật vì lưu lượng truy cập chỉ đi từ trung tâm dữ liệu của bạn.

Nếu bạn không thể mở cổng 5222, Ứng dụng API WhatsApp Business sẽ tìm cách sử dụng cổng 443. Nếu tường lửa hoặc proxy của bạn vẫn đang ngắt các kết nối, vui lòng liên hệ với đội ngũ WhatsApp bằng cách gửi câu hỏi thông qua kênh Hỗ trợ trực tiếp để gỡ lỗi.

Hoạt động như dự kiến
Vui lòng sử dụng Trình gỡ lỗi chia sẻ của chúng tôi: https://developers.facebook.com/tools/debug/sharing/. Chúng tôi sẽ không duy trì Trình gỡ lỗi OG nữa.
The behavior is by design. All newly created accounts go through a classification process which may last up to 45 minutes. During that time, these accounts won't be able to login to any app.
Hình ảnh quay vòng không trả về "media_url" ở Nút phương tiện quay vòng vì đó là một bộ sưu tập các hình ảnh. Thay vào đó, người dùng nên truy vấn trẻ em{media_url} để xem "media_url" của các nút trẻ em.
Trong v2.9 trở lên, chúng tôi đã bắt đầu lọc ra tất cả các bài viết không đủ điều kiện do cần phải cập nhật phương thức thanh toán cho Tài khoản quảng cáo. Vui lòng kiểm tra kỹ để đảm bảo Tài khoản quảng cáo có phương thức thanh toán hợp lệ.
Trường này sẽ không được hỗ trợ qua API nữa. Thay vào đó, bạn có thể tìm thấy tất cả thông tin mà trường này cung cấp từ công cụ sau: https://developers.facebook.com/tools/app-ads-helper/
Theo thiết kế, Thread_key sẽ không được đưa vào sự kiện webhook
Khi 'estimate_DAU' bằng 0, chúng tôi sẽ tự động trả về giá thầu mặc định được đề xuất là 0 cho tất cả các mục nhập Lý do là chúng tôi không hiển thị quy mô đối tượng cho chiến dịch sử dụng đối tượng tùy chỉnh.
Với Đối tượng tùy chỉnh trên trang web có nhiều phần, chúng tôi sẽ trả về id pixel là 0 và số ngày lưu giữ vì chúng tôi không thể xác định việc lưu giữ dựa trên nhiều phần. Để tìm nạp quy tắc cho đối tượng này, bạn cần chỉ định rule_v2 thay vì quy tắc: GET audience_id?fields=rule_v2
At this time, "Force Web OAuth Reauthentication" feature is unsupported for Device Login. To enable device login feature, please turn off "Force Web OAuth Reauthentication" under Facebook Login settings.
Notifications on canvas games are not guaranteed. We have systems in place which will determine if a notification is of low or high signal automatically and filter users' jewel notifications accordingly. This means that not all notifications will appear within the users jewel notification.
We have privacy policies in place to prevent content generated from an Application that is not visible, to be distributed to the public. Also in effect is the app is in dev mode.
You should be able to add pages to your app that meet a few conditions:
  • The Page must be categorized as "App Page"
  • You should have access to the page via a role
  • The App Page should not already be linked to an existing app
  • The Page must have the same name (or a subset of the name) of the app
/page/* — User information will not be included in GET responses for any objects owned by (on) a Page unless the request is made with a Page access token. This affects all nodes and edges that return data for objects owned by a Page.
The business management permission is a granular permission, which means that it can be granted to some businesses and not granted to others. The access token debugging tool will show the access token has the permission even if it was granted for only some apps.
We maintain a specific cache on Android which can take some time to refresh. However, in iOS, you should see the updates almost instantly when you refresh the article.
The app must be subscribed to 'messaging_account_linking' Webhook event for Account Linking to work. You can subscribe to the event by going to the Messenger tab of your Application Settings.
In order to access the Leadgen information received from a Webhook you needed to be:
  • An admin of the campaigns
  • A full admin of the page
This message is usually shown if the user has an old Facebook for Android app installed on their device. If the user removes the old app and install the latest one, this message should disappear. If not, then please report a bug.
1. The message shown on screen does not mean the user has read it. In order to trigger a read receipt, there need to be some movements on the user side. (The user closing the input box is definitely a movement) An indicator of a message being read is the message text turns from the bold state into a normal state in the preview;
2. There won't necessarily be a read receipt for each message. The read receipt means that ALL messages before this watermark timestamp have been read by the user.
Unique fields are not supported with hourly breakdowns. Unique fields are those prepended with `unique_*` or `reach`.
Có sự khác biệt giữa các yêu cầu trò chơi được gửi từ một ứng dụng đến người dùng và yêu cầu trò chơi được gửi từ một người dùng đến người dùng:
  • Yêu cầu trò chơi từ ứng dụng đến người dùng được gửi thông qua /điểm cuối API apprequests. Các yêu cầu này tạo yêu cầu trong nguồn cấp hoạt động trò chơi, nhưng không tạo thông báo trên trang web. https://developers.facebook.com/docs/graph-api/reference/app-request#Creating
  • Yêu cầu trò chơi từ người dùng đến người dùng được gửi thông qua hộp thoại yêu cầu. Các yêu cầu này tạo yêu cầu trong nguồn cấp hoạt động trò chơi và thông báo trên trang web. https://developers.facebook.com/docs/games/services/gamerequests
  • Ngoài ra còn có thông báo từ ứng dụng đến người dùng được gửi qua /điểm cuối API thông báo. Các yêu cầu này tạo thông báo, nhưng không tạo yêu cầu trong nguồn cấp hoạt động trò chơi. https://developers.facebook.com/docs/games/services/appnotifications
Bài viết được nhắm mục tiêu đến khu vực hoặc quốc gia. Ví dụ: Nếu bài viết được nhắm mục tiêu đến "US hoặc CA", thì người dùng thỏa mãn quy tắc này nếu đến từ Hoa Kỳ (US) hoặc từ California (CA). Nếu muốn hạn chế nhắm mục tiêu đến một khu vực trong một quốc gia, thì bạn chỉ nên chỉ định khu vực.
Cấu trúc trang toàn cầu làm giảm số lượt thích trang. Sau khi cấu trúc Trang toàn cầu được thiết lập, người hâm mộ sẽ được chuyển sang Trang khác trong cấu trúc này dựa trên nhắm mục tiêu của mỗi Trang. Do đó, thay đổi về page_fans sẽ không khớp với thay đổi giữa page_fan_adds và page_fan_removes.
Các đối tượng tùy chỉnh mới được tạo đôi khi không tìm nạp được qua API này. Điều này có thể do độ trễ tỷ lệ giữ chân và độ trễ sao chép trên các trung tâm dữ liệu.
Không thể nhận ID bài viết cho url nội bộ của FB bằng ?ids= endpoint. Như đã được ghi lại (https://developers.facebook.com/docs/graph-api/reference/v2.8/url), cạnh đó được dùng cho URL bên ngoài.