> ## Documentation Index > Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Facebook Page API > Các tùy chọn để đăng bài bằng Facebook API export const PlansAvailable = ({plans = [], maxPackRequired}) => { let displayPlans = plans; if (plans && plans.length === 1) { const lowerCasePlan = plans[0].toLowerCase(); if (lowerCasePlan === "business") { displayPlans = ["Launch", "Business", "Enterprise"]; } else if (lowerCasePlan === "premium") { displayPlans = ["Premium", "Launch", "Business", "Enterprise"]; } } return Available on {displayPlans.length === 1 ? "the " : ""} {displayPlans.join(", ").replace(/\b\w/g, l => l.toUpperCase())}{" "} {displayPlans.length > 1 ? "plans" : "plan"}. {maxPackRequired && window.open('https://www.ayrshare.com/docs/additional/maxpack', '_self')} className="flex items-center mt-2 cursor-pointer"> Max Pack required } ; }; Nếu bạn gặp vấn đề khi kết nối Facebook, vui lòng xem [hướng dẫn khắc phục sự cố](/help-center/technical-support/facebook_posting_issues). ## Đăng bài lên Facebook Đăng bài bằng Facebook API yêu cầu kết nối một Facebook Page. Facebook không cho phép kết nối tài khoản cá nhân. JSON cho một bài đăng cơ bản với liên kết và hình ảnh lên một Facebook page: ```json Facebook Post with Image theme={"system"} { "post": "The best FB post ever #best https://www.facebook.com", // empty string is allowed "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], "platforms": ["facebook"] } ``` API của Facebook không hỗ trợ trộn lẫn hình ảnh và video trong một bài đăng duy nhất. Bạn có thể bao gồm nhiều hình ảnh HOẶC một video, nhưng không phải cả hai. ## Hình ảnh Carousel Đăng hình ảnh Facebook Carousel qua API của Ayrshare với tham số body `carousel`. ```json Facebook Carousel Post theme={"system"} { "faceBookOptions": { "carousel": { // The URL of the "See More At" button - required "link": "URL of See More At...", "items": [ // 2 min, 10 max elements in the array { "name": "Image name", // optional "link": "URL when image clicked", // required "picture": "URL of image" // required }, { "name": "Image name", "link": "URL when image clicked", "picture": "URL of image" } ] } } } ``` **Lưu ý:** Không sử dụng `media_urls` với `carousel`. Nếu `media_urls` được sử dụng, `carousels` sẽ bị bỏ qua. Vui lòng xem [Hướng dẫn Facebook Carousel](https://www.ayrshare.com/blog/post-a-series-of-facebook-images-as-a-carousel/) của chúng tôi để biết thêm thông tin. ## Facebook Reels Bạn có thể đăng một video lên Facebook Reels với `facebookOptions` sau. Meta thực thi giới hạn 30 Reels cho mỗi Facebook Page được kết nối trong bất kỳ khoảng thời gian 24 giờ nào để ngăn chặn spam và đảm bảo chất lượng nền tảng. Đây là giới hạn cuộn, có nghĩa là nó tính 24 giờ gần nhất, không phải ngày dương lịch. ```json Facebook Reels Post theme={"system"} { "post": "The description of the video", "platforms": ["facebook"], "mediaUrls": ["https://img.ayrshare.com/012/reel.mp4"], "faceBookOptions": { "reels": true, "title": "Super title for the Reel", // optional "thumbNail": "https://img.ayrshare.com/012/reel-thumbnail.jpg" // optional } } ``` Vui lòng xem [yêu cầu video Reels API](/media-guidelines/facebook_pages#reels) hoặc [ví dụ về việc sử dụng Facebook Reels API](https://www.ayrshare.com/blog/facebook-reels-api-how-to-post-fb-reels-using-a-social-media-api/). Đôi khi Meta gặp vấn đề khi xử lý Facebook Reels cho một số tài khoản. Mặc dù có thể trả về phản hồi lỗi, Reel vẫn có thể đã được xuất bản. Nếu bạn gặp lỗi với Facebook Reels, chúng tôi khuyến nghị kiểm tra trạng thái Reel. Nếu bài đăng *chưa được* xuất bản, bạn có thể thử [đăng lại một lần nữa](/apis/post/retry-post). Điều này thường thành công. Bạn có thể sử dụng URL có trong trường `verifyReelsUrl` để kiểm tra trạng thái. Hãy chắc chắn sử dụng cùng Profile Key với bài đăng gốc của bạn. Đợi đến thời gian trong `verifyReelsIn` để kiểm tra trạng thái Reel (10 phút). Nếu mã lỗi HTTP `400` được trả về, bài đăng đã thất bại và bạn có thể thử đăng bài một lần nữa. ```json Facebook Reels Post Error theme={"system"} { "action": "post", "status": "error", "code": 108, "message": "Facebook Error: Facebook cannot process your post at this time. Please try again. ", "detailsData": { "id": "104619420979033_36930641143", "verifyReelsUrl": "https://api.ayrshare.com/history/36930641143?searchPlatformId=true&platform=facebook", "verifyReelsIn": "2024-01-26T00:07:05.170Z", "postUrl": "https://www.facebook.com/1046194209_36930641143", "reels": true }, "retryAvailable": true, "platform": "facebook" } ``` ## Facebook Stories Xuất bản Facebook Stories lên Facebook Pages dưới dạng ảnh hoặc video. ```json Facebook Stories Post theme={"system"} { "post": "", // Ignored by stories "platforms": ["facebook"], "mediaUrls": ["https://img.ayrshare.com/012/stories.mp4"], "faceBookOptions": { "stories": true } } ``` Vui lòng xem [yêu cầu hình ảnh và video của Stories API](/media-guidelines/facebook_pages#stories). ## Chú thích phương tiện Đặt chú thích Facebook cho mỗi hình ảnh phương tiện được đăng. Chấp nhận một mảng chuỗi nội dung chú thích. Mỗi mảng phải tương ứng với một url phương tiện. Ví dụ: \["This is my best pic", "😃 here is the next one"] tham chiếu đến url thứ 1 và thứ 2 trong `mediaUrls`. ```json Facebook Media Captions theme={"system"} { "faceBookOptions": { "mediaCaptions": ["This is my best pic", "😃 here is the next one"] } } ``` ## Gắn thẻ vị trí Một thẻ vị trí Facebook được chỉ định bằng `locationId`, là Facebook Page ID hoặc tên Facebook Page. Ví dụ, Facebook page Id của [Guggenheim Museum](https://www.facebook.com/guggenheimmuseum) là `7640348500` hoặc tên Facebook page `"@guggenheimmuseum"`. Các trang phải được liên kết với một vị trí thực. ```json Facebook Location Tagging theme={"system"} // Using the Facebook Page Id - must be associated with a location { "faceBookOptions": { "locationId": 7640348500 // Guggenheim Museum Page Id } } ``` Bạn có thể tra cứu `locationId` (Page Id) với [endpoint brand](/apis/listen/search/fb-page-search). Xin lưu ý rằng Page phải có vị trí được liệt kê hoặc locationId sẽ trả về lỗi. Không được hỗ trợ trên bài đăng văn bản, hình ảnh, reels, và stories. Video không được Meta hỗ trợ để gắn thẻ vị trí. ## Nhắm mục tiêu khán giả Khi tạo bài đăng Page trên Facebook, bạn có tùy chọn giới hạn tính hiển thị đến một đối tượng cụ thể bằng hai loại nhắm mục tiêu: 1. Facebook Targeting: Điều này cho phép bạn xác định đối tượng cho bài đăng của mình dựa trên các yếu tố như tuổi, giới tính, vị trí, và mối quan hệ. Bằng cách đặt các tham số này, bạn có thể đảm bảo bài đăng chỉ được hiển thị với những người đáp ứng các tiêu chí đã chỉ định. 2. Facebook Feed Targeting: Tùy chọn này cho phép bạn tinh chỉnh thêm tính hiển thị của bài đăng trong News Feeds của đối tượng mục tiêu. Bạn có thể sử dụng một tùy chọn nhắm mục tiêu riêng lẻ hoặc kết hợp chúng. ### Targeting Facebook targeting [giới hạn đối tượng](https://www.facebook.com/help/352402648173466) đối với việc xuất bản nội dung cho các nhóm nhân khẩu học cụ thể. Bất kỳ ai không thuộc các nhóm này sẽ không thể xem nội dung. Điều này sẽ không ghi đè bất kỳ hạn chế nhân khẩu học cấp Page nào có thể đang được áp dụng. Các trường nhân khẩu học khả dụng `targeting`: ```json Facebook Targeting theme={"system"} { "faceBookOptions": { "targeting": { "ageMin": 18, "countries": ["DE", "BR"] } } ``` ### Feed Targeting Bất kỳ ai trong các nhóm nhắm mục tiêu feed Facebook này đều có nhiều khả năng hơn để thấy bài đăng này, những người khác ít có khả năng hơn, nhưng vẫn có thể thấy nó. Sử dụng targeting, xem ở trên, nếu bạn muốn đảm bảo hạn chế. Các trường nhân khẩu học khả dụng cho `feedTargeting`: ```json Facebook Feed Targeting theme={"system"} { "feedTargeting": { "ageMax": 30, "ageMin": 26, "countries": ["DE", "BR"], "genders": [1, 2], "relationshipStatuses": [1, 2] } } ``` ## Văn bản thay thế (Alt Text) Thêm văn bản thay thế Facebook, còn được gọi là alt text, vào một hình ảnh hoặc video. Alt text Facebook là một tính năng trợ năng được sử dụng cho thông tin bổ sung của người dùng và trình đọc màn hình. Sử dụng `altText` trong đối tượng `faceBookOptions`. ```json Facebook Alt Text theme={"system"} { "faceBookOptions": { // Array of Alt Texts "altText": ["This is my best pic", "😃 here is the next one"] } } ``` Mỗi alt text phải tương ứng với một hình ảnh hoặc video trong mảng `mediaUrls`. Alt text sẽ được áp dụng cho từng hình ảnh theo thứ tự. ## Thumbnail video Đặt thumbnail video Facebook (hình ảnh bìa). Gửi URL từ xa của một file PNG hoặc JPG có cùng kích thước với video và ít hơn 10 MB. URL phải kết thúc bằng .png hoặc .jpg. ```json Example Facebook Video Thumbnail theme={"system"} { "faceBookOptions": { "thumbNail": "https://octodex.github.com/images/Fintechtocat.png" } } ``` ## Tiêu đề video Thêm tiêu đề video Facebook với tham số `title`. ```json Facebook Video Title theme={"system"} { "faceBookOptions": { "title": "The best video ever!" } } ``` ## GIF động Chỉ được phép một URL `mediaUrls` trong mảng khi đăng GIF động Facebook. Nếu URL phương tiện không kết thúc bằng ".gif" hoặc ".GIF", hãy đặt trường `isVideo` thành `true`. ```json Facebook Animated GIF theme={"system"} { "randomPost": true, "platforms": ["facebook"], // Set to true if the GIF URL does not end in .gif or .GIF "isVideo": false, // Only one URL is allowed in the array "mediaUrls": ["https://img.ayrshare.com/012/cat.gif"] } ``` ## Nhắc tên Facebook Page (Mention) Bạn có thể nhắc tên một Facebook Page khác, còn được gọi là Facebook mentions hoặc Facebook tagging, bằng cách bao gồm tên Facebook Page hoặc Page ID trong nội dung bài đăng. Facebook không cho phép nhắc tên hoặc gắn thẻ profile cá nhân hoặc nhóm. Bao gồm một mention với @mention sau: `@page-name` hoặc `@[page-id]` ### Nhắc tên với tên Page Một ví dụ nội dung bài đăng với tên Page. Bạn có thể tìm tên Page từ URL Facebook, ví dụ [https://www.facebook.com/Ayrshare](https://www.facebook.com/Ayrshare) ```json Facebook Page Mention with Page Name theme={"system"} { "post": "This is the best social media api by @Ayrshare" } ``` Ayrshare sẽ nỗ lực hết sức để tìm Page phù hợp dựa trên tên, nhưng đôi khi không thể tìm được một kết quả phù hợp. Phương pháp đáng tin cậy hơn là sử dụng Page ID. ### Nhắc tên với Page ID Một ví dụ nội dung bài đăng với Page ID; lưu ý việc sử dụng \[]. Vui lòng xem bên dưới cách tìm Page ID. ```json Facebook Page Mention with Page ID theme={"system"} { "post": "This is the best social media api by @[738681876342836]" // Ayrshare Page ID } ``` Facebook Page ID sẽ giải quyết thành trang phù hợp và ***thông báo cho Page được nhắc tên***. Sử dụng Page mentioning một cách cẩn thận bằng cách chỉ nhắc tên các Page bạn có liên kết. Bạn nên cẩn thận không bao giờ spam. Khi bạn nhắc tên một Page, **chủ sở hữu của Page sẽ được thông báo qua cảnh báo và email**. Nếu nhiều Page phàn nàn về việc bạn nhắc tên họ, Facebook có thể cấm tài khoản của bạn. Nói chung, bạn chỉ nên gắn thẻ các Page mà bạn có mối quan hệ đã được thiết lập. Facebook Page được nhắc tên **phải cho phép** các Page khác nhắc tên/gắn thẻ Page của họ. Có thể bật Mentions trong cài đặt chung của Page tại "Others Tag this Page". Vui lòng xem lại [các quy tắc quan trọng](/testing/post-verification#mentions) về nhắc tên. ### Tìm Facebook Page ID #### Endpoint Brand Bạn có thể tra cứu người dùng Facebook hoặc Facebook Page bằng [Brand endpoints](/apis/brand/overview). #### Tại Facebook.com 1. Từ Facebook News Feed, nhấp vào **Pages** trong menu bên trái. 2. Nhấp vào tên Page của bạn để đến Page. 3. Nhấp vào **About** ở đầu Page. Nếu bạn không thấy, hãy nhấp vào **More**▼. 4. Cuộn xuống để tìm **Page ID** của bạn bên dưới **MORE INFO**. hoặc nếu bạn muốn tìm ID của một page bạn không sở hữu: `https://www.facebook.com/pages/ayrshare/123466789203` thì Page ID là số ở cuối, chẳng hạn như **123466789203**. Bạn có thể kiểm tra xem Page ID có đúng không bằng cách vào `https://facebook.com/page-id` và nó sẽ giải quyết thành Page. Bạn cũng có thể thử một công cụ tra cứu Facebook Page của bên thứ ba, không được Ayrshare hỗ trợ, chẳng hạn như: [https://lookup-id.com/](https://lookup-id.com/) Nếu tất cả các phương pháp khác đều thất bại, bạn có thể vào trang Facebook trong trình duyệt và xem mã nguồn của trang. Trong Chrome, nhấp chuột phải để chọn "View Source". Sau đó tìm kiếm `owning_profile_id` hoặc `profile_id` để tìm Page ID. Vui lòng xem lại [các quy tắc quan trọng](/testing/post-verification#mentions) về nhắc tên. ### Bật Page Mentions Page phải cho phép mentions và gắn thẻ trong bài đăng và bình luận. Theo mặc định điều này được bật, nhưng bạn có thể xác minh bằng cách đăng nhập vào facebook.com và chuyển sang Page của bạn. 1. Xem với tư cách Page của bạn, hãy nhấp vào **hình ảnh profile** của page ở góc trên bên phải. 2. Nhấp vào **Settings & Privacy** -> **Settings**. 3. Trong menu Settings, nhấp vào **Privacy**. 4. Nhấp vào **Page and Tagging**. 5. Cuộn xuống **Reviewing**. 6. Chuyển đổi cài đặt để cho phép gắn thẻ và mentions. ## Meta Business Suite ### Bài đăng nháp Tạo một bài đăng nháp Facebook xuất hiện trong tab [Meta Business Suite Draft](https://business.facebook.com/latest/posts/draft_posts). Các bài đăng nháp Facebook là các bài đăng bạn đã bắt đầu viết, nhưng chưa xuất bản. Bạn có thể lưu các bài đăng nháp để quay lại sau, hoặc bạn có thể lên lịch chúng để xuất bản vào một ngày sau đó. Thêm tham số `draft` vào `faceBookOptions` để gửi bài đăng dưới dạng nháp. Khả dụng cho các bài đăng văn bản, hình ảnh, video, và reels. ```json Facebook Draft Post theme={"system"} { "faceBookOptions": { "draft": true } } ``` ### Thời gian lên lịch xuất bản Đặt thời gian lên lịch xuất bản cho các bài đăng Facebook xuất hiện trong tab [Meta Business Suite Scheduled Posts](https://business.facebook.com/latest/posts/scheduled_posts). Các bài đăng đã lên lịch Facebook là các bài đăng bạn đã tạo và lên lịch để xuất bản vào một ngày sau đó và được quản lý trong Meta Business Suite. Điều này có thể hữu ích cho việc lên kế hoạch cho các bài đăng mạng xã hội của bạn trước, hoặc để xuất bản các bài đăng vào thời điểm bạn biết đối tượng của mình hoạt động nhiều nhất. Khả dụng cho các bài đăng văn bản, hình ảnh, video, và reels. Thời gian xuất bản phải lớn hơn 10 phút so với thời gian hiện tại và trong vòng 29 ngày kể từ ngày hiện tại. Trừ khi bạn cần quản lý các bài đăng Facebook trong Meta Business Suite, chúng tôi khuyến nghị sử dụng [ngày lên lịch bài đăng](/apis/post/overview#schedule-posts) tiêu chuẩn. Thêm tham số `scheduledPublishDate` vào `faceBookOptions` để lên lịch thời gian đăng bài. ```json Facebook Scheduled Post theme={"system"} { "faceBookOptions": { "scheduledPublishDate": "2023-09-28T21:44:06Z" // Future date in UTC } } ``` ## Xem trước liên kết Bài đăng Facebook sẽ tự động tạo bản xem trước liên kết của một liên kết trong nội dung bài đăng. Tuy nhiên, nếu bạn muốn chỉ định một liên kết khác hoặc buộc bản xem trước liên kết, hãy sử dụng tham số `link` với URL của liên kết. ```json Facebook Link Preview theme={"system"} { "faceBookOptions": { "link": "https://www.ayrshare.com/instagram-hashtag-guide/" } } ``` Nếu trường `mediaUrls` được bao gồm trong yêu cầu bài đăng, phương tiện sẽ được hiển thị thay vì bản xem trước liên kết. ## Facebook Ads Facebook Ads là một cách để quảng bá bài đăng của bạn đến đối tượng rộng hơn. ## Giới hạn ký tự Vui lòng xem [Giới hạn ký tự Facebook](/help-center/technical-support/character_limits#facebook-character-limits) để biết thêm thông tin. ## Thông tin bổ sung ### Làm cách nào để thêm ngắt dòng hoặc văn bản phong phú vào bài đăng Facebook? Ngắt dòng Facebook có thể được thêm vào bài đăng với một [ký tự dòng mới](/apis/post/overview#line-breaks) đặc biệt. Văn bản phong phú, chẳng hạn như chữ đậm hoặc nghiêng, có thể được thêm vào bài đăng Facebook với một vài [phần tử html](/apis/post/overview#rich-text-posts). ### Tại sao tôi thấy "Published by Ayrshare" trên một bài đăng? Đừng lo, nó chỉ hiển thị trong chế độ xem admin. Vui lòng xem [hướng dẫn khắc phục sự cố](/help-center/technical-support/facebook_shows_published_by_ayrshare) để biết thêm thông tin.