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:
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.
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.
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.
To access one of these fields, you will need to submit for Advanced Access for the Business Asset User Profile Access feature through App Review.
Business apps designed to help businesses and organizations manage Pages, Groups, Events, Ads, and ad-related assets.
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_retrieval
và pages_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.
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.
Same as other permissions, you will lose access.
Kể từ ngày 01/08/2018, bạn chỉ cần xác minh Trình quản lý kinh doanh kết nối với ứng dụng.
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.
Đúng vậy. Ứng dụng thử nghiệm sẽ kế thừa các quyền có thể xét duyệt từ ứng dụng gốc.
Vui lòng tham khảo bài viết này để biết thông tin tóm tắt về dòng thời gian.
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.
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:
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:
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:
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 iOS và Android 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.
Độ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ắc và hướ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:
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:
Dưới đây là ví dụ điển hình về hướng dẫn từng bước:
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.
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.
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ảng và Chí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ảng và Chính sách dành cho nhà phát triển của chúng tôi.
Bạn phải xác nhận cho từng ứng dụng mà doanh nghiệp bạn quản lý.
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ếu vì lý do nào đó bạn không thể truy cập vào một ứng dụng và cần lấy lại vai trò quản trị viên, hãy nhấp vào đây.
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.
Không.
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.
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.
Meta’s services are not available in all regions.
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.
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.
Đ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.
Test apps created from Business apps will have Standard Access for all permissions and features.
No. The access level model only applies to permissions and features.
No. For a given permission, Business apps have either None, Standard, or Advanced Access.
Yes. A Business app will be auto-granted Standard Access and may request Advanced Access for a given permission.
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 -
Ả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 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
Không, bạn không thể chỉnh sửa chiều rộng qua API.
Đâ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ạ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à:
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.
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> </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.
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.
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.
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: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:
og:image:height
và og:image:width
để chỉ định rõ hình ảnh 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.
Đ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
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:
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.
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:
https://graph.facebook.com/v2.6/me/accounts?access_token=[TEST_USER_ACCESS_TOKEN](Tài liệu)
https://graph.facebook.com/v2.6/me/subscribed_apps?method=POST&access_token=[TEST_USER_PAGE_ACCESS_TOKEN](Tài liệu)
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:
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.
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.
Đ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.
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.
Không, bạn không được phép đăng bình luận lên plugin bình luận qua API.
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
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
và /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.messages
và messageStore.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 messages
và messages_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.
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
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 có thể xem, tạo, chỉnh sửa cũng như xóa mã QR và liên kết ngắn trong API Quản lý WhatsApp Business hoặc trong Giao diện người dùng Trình quản lý kinh doanh.
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.
Nếu bạn hoặc khách hàng cuối của bạn muốn yêu cầu trở thành tài khoản kinh doanh chính thức trên WhatsApp, hãy xem hướng dẫn trong phần tài liệu Yêu cầu tài khoản kinh doanh chính thức.
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:
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:
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.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.
Giới hạn tối đa là 250 mẫu tin nhắn cho mỗi tài khoản WhatsApp Business.
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 để:
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ụ:
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:
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ữ fallback
và deterministic
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:
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.
Đố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:
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.
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.
Tất nhiên là có! Hãy liên hệ với đại diện WhatsApp và đưa ra yêu cầu nà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.
Không. Giải pháp API WhatsApp Business yêu cầu một số điện thoại mới.
Để tìm điểm gắn kết của ổ đĩa phương tiện, bạn có thể chạy lệnh docker.
docker volume inspect whatsappMedia
[ { "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:
docker restart wacore<Current_WABA_Version>
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.