posteverywhere/codex-plugin

Publier une vidéo en cross-poste

Téléchargez la vidéo une fois, rédigez une légende pour chaque plateforme et choisissez le bon format pour chacune.

Étapes

1. Récupérer la vidéo. L'utilisateur fournit un lien public vers un fichier MP4. Appelez upload_media_from_url avec l'url. Les vidéos sont importées en arrière-plan : appelez get_media avec le media_id renvoyé jusqu'à ce que media_status soit "ready". S'il devient "failed", dites à l'utilisateur l'error_message en termes simples. N'attachez jamais une vidéo qui n'est pas prête. Pour une vidéo déjà dans leur bibliothèque, trouvez-la avec list_media et type: "video".
2. Vérifier les règles. Appelez get_platform_rules et comparez la vidéo avec les limites de chaque plateforme (durée, taille, format). get_media affiche les détails de la vidéo. Si la vidéo enfreint une règle d'une plateforme, retirez cette plateforme et expliquez pourquoi à l'utilisateur.
3. Choisir les comptes. Appelez list_accounts. Utilisez les comptes nommés par l'utilisateur, ou tous les comptes actifs sur une plateforme vidéo. Ignorez tout compte qui ne peut pas publier et expliquez pourquoi.
4. Rédiger une légende pour chaque plateforme. Placez une légende générale dans content, et définissez celle de chaque plateforme dans platform_content :
   • TikTok : {"tiktok": {"content": "..."}}. Court, accroche en premier, hashtags à la fin.
   • Instagram Reels : {"instagram": {"content": "...", "contentType": "Reels"}}. Hashtags à la fin.
   • YouTube Shorts : {"youtube": {"content": "<description>", "contentType": "Short", "settings": {"title": "<title>"}}}. Le titre fait jusqu'à 100 caractères, et YouTube n'autorise pas < ou >. Mettez le sujet de la vidéo dans les deux premières lignes de la description. Pour une vidéo YouTube normale, utilisez "contentType": "Video".
   • LinkedIn : {"linkedin": {"content": "..."}}. Une première ligne qui incite à cliquer, des paragraphes courts.
   • Facebook Reels : {"facebook": {"content": "...", "contentType": "Reels"}}. Suivez le guide vocal de l'utilisateur s'il existe (voir brand-voice). N'inventez pas de faits sur la vidéo ; demandez à l'utilisateur ce qu'elle montre si vous ne le savez pas.
5. Afficher les brouillons. Affichez, par plateforme : le format, le titre (YouTube), la légende et l'heure. Demandez à l'utilisateur de confirmer.
6. Créer la publication. Appelez create_post avec content, account_ids, media_ids: [<media_id>], platform_content et draft: true, sauf si l'utilisateur a déjà dit de publier maintenant ou a donné une heure pour cette publication exacte.
7. Publier ou planifier. Après confirmation de l'utilisateur, appelez schedule_post avec le post_id et scheduled_for (avec timezone) ou publish_now: true.
8. Vérifier le résultat. Les vidéos prennent quelques minutes à être traitées sur chaque plateforme. Appelez get_post_results après une courte attente et signalez quelles plateformes ont publié, avec des liens, et toute échec en termes simples (voir fix-failed-posts).

Bonnes valeurs par défaut

• Une vidéo verticale (9:16) convient à TikTok, Reels et Shorts. Pour une vidéo large, vérifiez get_platform_rules avant de choisir un format court.
• Une vidéo par publication. Pour publier deux vidéos, créez deux publications.