Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

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.

389

Code d'erreur lorsque Meta ne peut pas récupérer le fichier vidéo à l'URL donnée dans file_url.

382

Code d'erreur pour un fichier vidéo trop petit pour être téléversé ; Meta demande un fichier plus volumineux.

10 min to 6 months

Fenêtre pour scheduled_publish_time sur l'edge videos, comptée à partir de la publication de la vidéo.

0 to 100

Plage de processing_progress, la part du traitement d'une vidéo effectuée, affichée à côté de video_status.

graph.facebook.com

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.

h

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_urlUploaded file
Where the video isAt a URL Meta can reachOn your own system
On /{page-id}/videosfile_urlfbuploader_video_file_chunk with the upload's handle
Before publishingNothing: Meta fetches the fileAn upload session, then the bytes
If it failsError 389 when Meta cannot fetch itResume 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_offset que 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_phase start, transfer et finish, avec start_offset, file_size et video_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.
Faire cela avec EasyCoexistence

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