> ## 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. # API Facebook Page > Options de publication à l'aide de l'API Facebook 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 } ; }; Si vous rencontrez des problèmes de connexion à Facebook, consultez le [guide de dépannage](/help-center/technical-support/facebook_posting_issues). ## Publier sur Facebook Publier via l'API Facebook nécessite de connecter une Page Facebook. Facebook n'autorise pas la connexion de comptes personnels. JSON pour une publication de base avec un lien et une image sur une Page Facebook : ```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"] } ``` L'API de Facebook ne prend pas en charge le mélange d'images et de vidéos dans une même publication. Vous pouvez inclure plusieurs images OU une seule vidéo, mais pas les deux. ## Carrousel d'images Publiez des images en carrousel Facebook via l'API Ayrshare avec le paramètre de corps `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" } ] } } } ``` **Remarque :** n'utilisez pas `media_urls` avec `carousel`. Si `media_urls` est utilisé, `carousels` sera ignoré. Consultez notre [guide Facebook Carousel](https://www.ayrshare.com/blog/post-a-series-of-facebook-images-as-a-carousel/) pour plus d'informations. ## Facebook Reels Vous pouvez publier une vidéo sur Facebook Reels avec les `facebookOptions` suivants. Meta impose une limite de 30 Reels par Page Facebook connectée sur toute période de 24 heures pour éviter le spam et garantir la qualité de la plateforme. Il s'agit d'une limite glissante : elle compte les 24 dernières heures, pas les jours calendaires. ```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 } } ``` Consultez les [exigences vidéo de l'API Reels](/media-guidelines/facebook_pages#reels) ou un [exemple d'utilisation de l'API Facebook Reels](https://www.ayrshare.com/blog/facebook-reels-api-how-to-post-fb-reels-using-a-social-media-api/). Meta rencontre parfois des problèmes de traitement des Facebook Reels pour certains comptes. Même si une réponse d'erreur est renvoyée, le Reel a peut-être quand même été publié. Si vous rencontrez des erreurs pour les Facebook Reels, nous recommandons de vérifier le statut du Reel. Si la publication n'a *pas* été diffusée, vous pouvez [réessayer de publier](/apis/post/retry-post). Cela réussit souvent. Vous pouvez utiliser l'URL contenue dans le champ `verifyReelsUrl` pour vérifier le statut. Veillez à utiliser la même Profile Key que votre publication d'origine. Attendez l'heure indiquée dans `verifyReelsIn` pour vérifier le statut du Reel (10 minutes). Si un code d'erreur HTTP `400` est renvoyé, la publication a échoué et vous pouvez tenter la publication une nouvelle fois. ```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 Publiez des Facebook Stories sur des Pages Facebook, sous forme de photo ou de vidéo. ```json Facebook Stories Post theme={"system"} { "post": "", // Ignored by stories "platforms": ["facebook"], "mediaUrls": ["https://img.ayrshare.com/012/stories.mp4"], "faceBookOptions": { "stories": true } } ``` Consultez les [exigences d'image et de vidéo de l'API Stories](/media-guidelines/facebook_pages#stories). ## Légendes des médias Définissez une légende Facebook pour chaque image publiée. Accepte un tableau de chaînes de texte de légende. Chaque tableau doit correspondre à une URL de média. Par ex. \["This is my best pic", "😃 here is the next one"] fait référence aux 1re et 2e URLs dans `mediaUrls`. ```json Facebook Media Captions theme={"system"} { "faceBookOptions": { "mediaCaptions": ["This is my best pic", "😃 here is the next one"] } } ``` ## Marquage de lieu Un marquage de lieu Facebook est spécifié par un `locationId`, qui est un ID de Page Facebook ou un nom de Page Facebook. Par exemple, l'ID de Page Facebook du [Guggenheim Museum](https://www.facebook.com/guggenheimmuseum) est `7640348500` ou le nom de Page Facebook `"@guggenheimmuseum"`. Les Pages doivent être associées à un lieu physique. ```json Facebook Location Tagging theme={"system"} // Using the Facebook Page Id - must be associated with a location { "faceBookOptions": { "locationId": 7640348500 // Guggenheim Museum Page Id } } ``` Vous pouvez rechercher le `locationId` (ID de Page) avec le [point de terminaison brand](/apis/listen/search/fb-page-search). Notez que la Page doit avoir un lieu répertorié, sinon locationId renverra une erreur. Non pris en charge pour les publications texte, images, reels et stories. Les vidéos ne sont pas prises en charge par Meta pour le marquage de lieu. ## Ciblage d'audience Lors de la création d'une publication de Page sur Facebook, vous avez la possibilité de limiter sa visibilité à une audience spécifique à l'aide de deux types de ciblage : 1. Targeting Facebook : vous permet de définir l'audience de votre publication en fonction de facteurs tels que l'âge, le sexe, la localisation et la relation. En définissant ces paramètres, vous vous assurez que votre publication n'est présentée qu'aux personnes correspondant aux critères spécifiés. 2. Feed Targeting Facebook : cette option vous permet d'affiner davantage la visibilité de votre publication dans le fil d'actualité de l'audience ciblée. Vous pouvez utiliser chaque option de ciblage individuellement ou les combiner. ### Targeting Le targeting Facebook [limite l'audience](https://www.facebook.com/help/352402648173466) pour la publication de contenu à des données démographiques spécifiques. Toute personne en dehors de ces catégories démographiques ne pourra pas voir ce contenu. Cela ne remplacera pas les éventuelles restrictions démographiques appliquées au niveau de la Page. Champs démographiques disponibles pour `targeting` : ```json Facebook Targeting theme={"system"} { "faceBookOptions": { "targeting": { "ageMin": 18, "countries": ["DE", "BR"] } } ``` ### Feed Targeting Les personnes appartenant à ces groupes de feed targeting Facebook sont plus susceptibles de voir cette publication ; les autres le sont moins mais peuvent la voir malgré tout. Utilisez targeting (voir ci-dessus) si vous souhaitez garantir la restriction. Champs démographiques disponibles pour `feedTargeting` : ```json Facebook Feed Targeting theme={"system"} { "feedTargeting": { "ageMax": 30, "ageMin": 26, "countries": ["DE", "BR"], "genders": [1, 2], "relationshipStatuses": [1, 2] } } ``` ## Texte alternatif Ajoutez du texte alternatif Facebook, également appelé alt text, à une image ou une vidéo. L'alt text Facebook est une fonctionnalité d'accessibilité utilisée pour fournir des informations supplémentaires aux utilisateurs et aux lecteurs d'écran. Utilisez `altText` dans l'objet `faceBookOptions`. ```json Facebook Alt Text theme={"system"} { "faceBookOptions": { // Array of Alt Texts "altText": ["This is my best pic", "😃 here is the next one"] } } ``` Chaque alt text doit correspondre à une image ou vidéo du tableau `mediaUrls`. L'alt text est appliqué à chaque image dans l'ordre. ## Miniature vidéo Définissez une miniature vidéo Facebook (image de couverture). Envoyez une URL distante d'un fichier PNG ou JPG des mêmes dimensions que la vidéo et de moins de 10 Mo. L'URL doit se terminer par .png ou .jpg. ```json Example Facebook Video Thumbnail theme={"system"} { "faceBookOptions": { "thumbNail": "https://octodex.github.com/images/Fintechtocat.png" } } ``` ## Titre de vidéo Ajoutez un titre à la vidéo Facebook avec le paramètre `title`. ```json Facebook Video Title theme={"system"} { "faceBookOptions": { "title": "The best video ever!" } } ``` ## GIFs animés Une seule URL `mediaUrls` est autorisée dans le tableau lors de la publication d'un GIF animé sur Facebook. Si l'URL du média ne se termine pas par « .gif » ou « .GIF », définissez le champ `isVideo` sur `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"] } ``` ## Mentions de Pages Facebook Vous pouvez mentionner une autre Page Facebook, ce qu'on appelle aussi Facebook mentions ou Facebook tagging, en incluant le nom de la Page Facebook ou l'ID de la Page dans le texte de la publication. Facebook n'autorise pas les mentions ou les tags de profils personnels ou de groupes. Incluez une mention avec le @mention suivant : `@page-name` ou `@[page-id]` ### Mention avec le nom de la Page Un exemple de texte de publication avec un nom de Page. Vous trouverez le nom de la Page dans l'URL Facebook, par ex. [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 fera de son mieux pour trouver la Page correspondante à partir du nom, mais parfois aucune correspondance n'est trouvée. Une méthode plus fiable consiste à utiliser un ID de Page. ### Mention avec l'ID de Page Un exemple de texte de publication avec un ID de Page ; notez l'utilisation de \[]. Voir ci-dessous comment trouver l'ID de la Page. ```json Facebook Page Mention with Page ID theme={"system"} { "post": "This is the best social media api by @[738681876342836]" // Ayrshare Page ID } ``` L'ID de Page Facebook se résoudra en Page correspondante et ***notifiera la Page mentionnée***. Utilisez la mention de Page avec précaution, en ne mentionnant que des Pages auxquelles vous êtes associé. Prenez garde à ne jamais spammer. Lorsque vous mentionnez une Page, **le propriétaire de la Page est notifié par une alerte et un e-mail**. Si plusieurs Pages se plaignent que vous les mentionnez, Facebook peut bannir votre compte. En général, mentionnez uniquement des Pages avec lesquelles vous avez une relation établie. La Page Facebook mentionnée **doit autoriser** les autres Pages à la mentionner / la taguer. Les mentions peuvent être activées dans les paramètres généraux de la Page, sous « Others Tag this Page ». Consultez les [règles importantes](/testing/post-verification#mentions) concernant les mentions. ### Trouver un ID de Page Facebook #### Point de terminaison Brand Vous pouvez rechercher soit un utilisateur Facebook, soit une Page Facebook à l'aide des [points de terminaison Brand](/apis/brand/overview). #### Sur Facebook.com 1. Depuis le fil d'actualité Facebook, cliquez sur **Pages** dans le menu de gauche. 2. Cliquez sur le nom de votre Page pour vous y rendre. 3. Cliquez sur **About** en haut de votre Page. Si vous ne le voyez pas, cliquez sur **More**▼. 4. Faites défiler pour trouver votre **Page ID** sous **MORE INFO**. ou si vous voulez trouver l'ID d'une page dont vous n'êtes pas propriétaire : `https://www.facebook.com/pages/ayrshare/123466789203`, alors l'ID de la Page est le nombre à la fin, tel que **123466789203**. Vous pouvez vérifier que l'ID de Page est correct en accédant à `https://facebook.com/page-id`, l'URL se résoudra vers la Page. Vous pouvez aussi essayer un outil tiers de recherche d'ID de Page Facebook, non pris en charge par Ayrshare, comme : [https://lookup-id.com/](https://lookup-id.com/) Si toutes les autres méthodes échouent, vous pouvez aller sur la page Facebook dans un navigateur et afficher la source de la page. Dans Chrome, cliquez avec le bouton droit et sélectionnez « View Source ». Recherchez ensuite soit `owning_profile_id` soit `profile_id` pour trouver l'ID de la Page. Consultez les [règles importantes](/testing/post-verification#mentions) concernant les mentions. ### Activer les mentions de Page La Page doit autoriser les mentions et les tags dans les publications et commentaires. Par défaut, cela est activé, mais vous pouvez vérifier en vous connectant sur facebook.com et en basculant sur votre Page. 1. En vue de votre Page, cliquez sur l'**image de profil** de votre page dans le coin supérieur droit. 2. Cliquez sur **Settings & Privacy** -> **Settings**. 3. Dans le menu Settings, cliquez sur **Privacy**. 4. Cliquez sur **Page and Tagging**. 5. Faites défiler jusqu'à **Reviewing**. 6. Basculez les paramètres pour autoriser les tags et mentions. ## Meta Business Suite ### Brouillons de publication Créez une publication Facebook brouillon qui apparaîtra dans l'onglet [Meta Business Suite Draft](https://business.facebook.com/latest/posts/draft_posts). Les brouillons de publication Facebook sont des publications que vous avez commencé à rédiger mais que vous n'avez pas encore publiées. Vous pouvez enregistrer des brouillons pour y revenir plus tard, ou les planifier pour une publication ultérieure. Ajoutez le paramètre `draft` à `faceBookOptions` pour envoyer la publication en tant que brouillon. Disponible pour les publications texte, images, vidéo et reels. ```json Facebook Draft Post theme={"system"} { "faceBookOptions": { "draft": true } } ``` ### Heure de publication planifiée Définissez une heure de publication planifiée pour les publications Facebook qui apparaîtront dans l'onglet [Meta Business Suite Scheduled Posts](https://business.facebook.com/latest/posts/scheduled_posts). Les publications planifiées Facebook sont des publications que vous avez créées et planifiées pour être diffusées à une date ultérieure, gérées dans le Meta Business Suite. Cela peut être utile pour planifier vos publications sur les réseaux sociaux à l'avance, ou pour publier à des moments où vous savez que votre audience est la plus active. Disponible pour les publications texte, images, vidéo et reels. L'heure de publication doit être supérieure à 10 minutes après l'heure actuelle et se situer dans les 29 jours suivant la date du jour. Sauf si vous devez gérer les publications Facebook dans Meta Business Suite, nous recommandons d'utiliser la [date de planification standard](/apis/post/overview#schedule-posts). Ajoutez le paramètre `scheduledPublishDate` à `faceBookOptions` pour planifier une heure de publication. ```json Facebook Scheduled Post theme={"system"} { "faceBookOptions": { "scheduledPublishDate": "2023-09-28T21:44:06Z" // Future date in UTC } } ``` ## Aperçu de lien Une publication Facebook créera automatiquement un aperçu d'un lien inclus dans le corps de la publication. Cependant, si vous souhaitez spécifier un autre lien ou forcer l'aperçu du lien, utilisez le paramètre `link` avec l'URL du lien. ```json Facebook Link Preview theme={"system"} { "faceBookOptions": { "link": "https://www.ayrshare.com/instagram-hashtag-guide/" } } ``` Si un champ `mediaUrls` est inclus dans la requête de publication, le média sera affiché à la place de l'aperçu du lien. ## Facebook Ads Les Facebook Ads sont un moyen de promouvoir vos publications auprès d'un public plus large. ## Limites de caractères Consultez [Facebook Character Limits](/help-center/technical-support/character_limits#facebook-character-limits) pour plus d'informations. ## Informations complémentaires ### Comment ajouter des sauts de ligne ou du texte enrichi à une publication Facebook ? Les sauts de ligne Facebook peuvent être ajoutés à une publication avec un [caractère de nouvelle ligne](/apis/post/overview#line-breaks) spécial. Le texte enrichi, tel que le gras ou l'italique, peut être ajouté à une publication Facebook avec quelques [éléments HTML](/apis/post/overview#rich-text-posts). ### Pourquoi je vois « Published by Ayrshare » sur une publication ? Pas d'inquiétude, cela n'apparaît que dans la vue admin. Consultez le [guide de dépannage](/help-center/technical-support/facebook_shows_published_by_ayrshare) pour plus d'informations.