Publier des vidéos sur une Page Facebook via l'API
Une vidéo arrive sur une Page Facebook par POST /{page-id}/videos, soit avec file_url, une URL que Meta télécharge elle-même, soit avec un fichier que l'application envoie d'abord à Meta. title nomme la vidéo, et description est le texte que Meta peut afficher avec la publication. Meta traite ensuite le fichier, et GET /{video-id}?fields=status indique video_status en cours de traitement jusqu'à ce que la valeur soit ready.
easyCoexistence publie des vidéos sur les Pages Facebook avec publish_facebook_post depuis Claude, ChatGPT ou votre propre code, immédiatement ou programmées jusqu'à 90 jours à l'avance.
Code d'erreur lorsque Meta ne peut pas récupérer le fichier vidéo à l'URL donnée dans file_url.
Code d'erreur pour un fichier vidéo trop petit pour être téléversé ; Meta demande un fichier plus volumineux.
Fenêtre pour scheduled_publish_time sur l'edge videos, comptée à partir de la publication de la vidéo.
Plage de processing_progress, la part du traitement d'une vidéo effectuée, affichée à côté de video_status.
Hôte pour les téléversements vidéo, selon la vue d'ensemble de l'API vidéo de Meta, qui déclare graph-video.facebook.com obsolète pour cet usage.
Le handle renvoyé par un téléversement, transmis à /{page-id}/videos comme fbuploader_video_file_chunk pour publier la vidéo.
Comment une vidéo est-elle publiée sur une Page ?
Avec POST /{page-id}/videos et un token d'accès de Page. Le fichier parvient à Meta de deux manières : file_url, une URL accessible de la vidéo que Meta récupère elle-même, ou un téléversement, où l'application envoie d'abord les octets. file_url ne peut pas être combiné avec upload_phase, le paramètre du téléversement fragmenté, si bien qu'une requête utilise l'une ou l'autre voie.
| file_url | Uploaded file | |
|---|---|---|
| Where the video is | At a URL Meta can reach | On your own system |
| On /{page-id}/videos | file_url | fbuploader_video_file_chunk with the upload's handle |
| Before publishing | Nothing: Meta fetches the file | An upload session, then the bytes |
| If it fails | Error 389 when Meta cannot fetch it | Resume from the offset Meta reports |
Comment fonctionne le téléversement d'un fichier qui n'est pas en ligne ?
Le guide de publication vidéo de Meta utilise l'API Resumable Upload. POST /{app-id}/uploads avec file_name, file_length et file_type ouvre une session, puis POST /upload:{session-id} avec un en-tête file_offset et les octets renvoie un handle, h. La vidéo est ensuite publiée avec POST /{page-id}/videos et fbuploader_video_file_chunk défini sur ce handle, à côté de title et description. Ces appels de téléversement utilisent un token d'accès utilisateur.
- Un téléversement interrompu reprend à partir du
file_offsetque renvoie GET /upload:{session-id}. - La référence des vidéos documente aussi un téléversement fragmenté sur le même edge :
upload_phasestart, transfer et finish, avecstart_offset,file_sizeetvideo_file_chunk.
À quoi servent title et description ?
title est le titre de la vidéo. description est, selon les mots de Meta, le texte décrivant une publication qui peut être affiché dans une story à son sujet ; c'est donc là que va le texte de la publication. Les deux champs sont facultatifs sur l'edge videos, et publish_facebook_post envoie son message comme description et laisse title non défini.
Comment savoir quand la vidéo est prête ?
Meta traite une vidéo après sa réception. GET /{video-id}?fields=status renvoie video_status, qui vaut processing pendant le traitement, ready une fois la vidéo téléversée, encodée et dotée de ses miniatures, ou error si le traitement a échoué, avec processing_progress donnant la part effectuée de 0 à 100. Meta peut aussi signaler l'état de publication par les webhooks de Page sur le champ videos, auxquels easyCoexistence ne s'abonne pas.
Quelle taille et quelle durée la vidéo peut-elle avoir ?
La référence des vidéos de Page et le guide de publication vidéo de Meta n'indiquent ni taille de fichier ni durée maximales ; la seule règle de taille qu'ils nomment est l'erreur 382, pour un fichier trop petit pour être téléversé. Les guides Reels et stories de Meta fixent leurs propres durées : de 3 à 90 secondes pour un Reel et 60 secondes au maximum pour une vidéo en story. Lorsque easyCoexistence programme une vidéo, il copie le fichier à ce moment-là et refuse un fichier de plus de 1 Go.
Quelles permissions et quelle tâche de Page sont nécessaires ?
pages_manage_posts, pages_read_engagement et pages_show_list, avec un token de Page émis pour une personne pouvant exécuter la tâche CREATE_CONTENT, selon la référence des vidéos et le guide de publication. La vue d'ensemble de l'API vidéo de Meta est plus stricte : la personne doit pouvoir effectuer des tâches équivalentes à celles d'un administrateur sur la Page, ou détenir un rôle Admin accordé dans Business Manager.
Quelles erreurs une publication vidéo peut-elle renvoyer ?
La référence des vidéos de Meta liste celles-ci pour POST /{page-id}/videos :
- 389 : impossible de récupérer le fichier vidéo depuis l'URL.
- 382 : le fichier vidéo est trop petit ; réessayez avec un fichier plus volumineux.
- 6000 : un problème lors du téléversement du fichier vidéo ; réessayez avec un autre fichier.
- 6001 : un problème lors du téléversement de la vidéo ; réessayez.
- 368 : l'action a été jugée abusive ou est autrement interdite.
- 100 : paramètre invalide ; 200 : erreur de permissions ; 190 : token d'accès OAuth 2.0 invalide.
Comment publish_facebook_post publie-t-il une vidéo ?
Il prend video_url, un lien HTTPS public vers le fichier, et message, et les envoie à /{page-id}/videos sous forme de file_url et description, si bien que Meta récupère lui-même la vidéo. Une publication contient une seule vidéo, et un lien envoyé à côté est refusé : placez donc l'URL dans le message. Le post_id du résultat contient l'identifiant renvoyé par Meta, qui pour une vidéo est l'identifiant propre de la vidéo.
Comment programmer une publication vidéo ?
Donnez à publish_facebook_post un scheduled_at au format ISO 8601 avec un fuseau horaire, de 1 minute à 90 jours à l'avance. easyCoexistence copie la vidéo au moment où la publication est programmée et la publie sur la Page à ce moment-là ; list_scheduled_posts l'affiche, update_scheduled_post la déplace ou modifie son texte, et cancel_scheduled_post l'annule. Le scheduled_publish_time propre de Meta sur l'edge videos accepte de 10 minutes à 6 mois.
Erreurs courantes
- Pointer file_url vers une page qui lit la vidéo plutôt que vers le fichier. Meta télécharge l'adresse elle-même, et une adresse qu'il ne peut pas récupérer échoue avec l'erreur 389.
- Téléverser vers graph-video.facebook.com. La vue d'ensemble de l'API vidéo de Meta déclare cet hôte obsolète pour les téléversements vidéo et demande graph.facebook.com.
- Annoncer la vidéo avant qu'elle soit prête. Vérifiez le statut jusqu'à ce que video_status indique ready, car le traitement se poursuit après le retour de l'appel de publication.
- Envoyer un lien avec la vidéo. publish_facebook_post refuse un lien à côté d'un fichier ; écrivez plutôt l'URL dans le message.
Votre plateforme peut faire la même chose avec POST /channels/:id/posts sur la Partner API. De US$ 9 à US$ 0.75 par connexion et par mois, le prix baisse à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.
Questions fréquemment posées
Puis-je téléverser une vidéo depuis mon ordinateur sur une Page Facebook via l'API ?
Oui, avec l'API Resumable Upload de Meta, qui renvoie un handle pour /{page-id}/videos, ou le téléversement fragmenté sur cet edge. publish_facebook_post prend en revanche une URL HTTPS publique, il faut donc d'abord héberger le fichier.
Peut-on téléverser une vidéo sans qu'elle apparaisse dans le fil de la Page ?
Oui. published défini sur false met la publication en attente, no_story supprime la story du fil d'actualité et de la chronologie, et secret garde la vidéo hors de Facebook et hors des recherches.
Une même vidéo peut-elle être publiée sur plusieurs Pages ?
Oui, par crossposting : une vidéo publiée peut être diffusée sur d'autres Pages que la personne administre sans être téléversée à nouveau, et elle reçoit son propre identifiant de vidéo sur chaque Page.
Combien coûte easyCoexistence pour une Page Facebook ?
De US$ 9 à US$ 0.75 par connexion et par mois, selon le nombre total de connexions, avec un essai gratuit de 3 jours. Chaque Page est une connexion.
Poursuivre la lecture
Connectez votre premier canal en deux minutes.
Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.
- 3 jours gratuits
- Résiliable à tout moment
- API officielles uniquement
- Supervisé 24/7
Vérifié le