posteverywhere/grok-plugin

Publier une vidéo en cross-publication

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 s'importent en arrière-plan : appelez get_media avec le media_id retourné jusqu'à ce que media_status soit "ready". Si le statut devient "failed", expliquez le error_message en termes simples à l'utilisateur. N'attachez jamais une vidéo qui n'est pas prête. Pour une vidéo déjà dans la 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 en termes de durée, taille et ratio. get_media affiche les détails de la vidéo. Si la vidéo enfreint une règle d'une plateforme, excluez 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 sains 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 la légende propre à 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'accepte 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 donne envie de 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 le post. 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 ce post exact.
7. Publier ou planifier. Après confirmation de l'utilisateur, appelez schedule_post avec le post_id et scheduled_for (avec le timezone) ou publish_now: true.
8. Vérifier le résultat. Les vidéos prennent quelques minutes à traiter sur chaque plateforme. Appelez get_post_results après une courte attente et signalez les plateformes qui ont publié, avec les liens, ainsi que tout échec en termes simples (voir fix-failed-posts).

Bonnes pratiques par défaut

• La 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 post. Pour publier deux vidéos, créez deux posts.