posteverywhere/grok-plugin

Publicar un video en varias plataformas

Sube el video una vez, escribe una descripción para cada plataforma y elige el formato adecuado en cada una.

Pasos

1. Obtén el video. El usuario proporciona un enlace público a un archivo MP4. Llama a upload_media_from_url con la url. Los videos se importan en segundo plano: llama a get_media con el media_id devuelto hasta que media_status sea "ready". Si pasa a "failed", comunica al usuario el error_message en palabras claras. Nunca adjuntes un video que no esté listo. Para un video que ya está en su biblioteca, búscalo con list_media y type: "video".
2. Revisa las reglas. Llama a get_platform_rules y compara el video con los límites de cada plataforma en cuanto a duración, tamaño y relación de aspecto. get_media muestra los detalles del video. Si el video incumple una regla de una plataforma, omite esa plataforma e informa al usuario del motivo.
3. Selecciona las cuentas. Llama a list_accounts. Usa las cuentas que el usuario haya nombrado, o todas las cuentas activas en una plataforma de video. Omite cualquier cuenta que no pueda publicar y explica por qué.
4. Escribe una descripción para cada plataforma. Coloca una descripción general en content, y establece la descripción específica de cada plataforma en platform_content:
   • TikTok: {"tiktok": {"content": "..."}}. Corta, con gancho al inicio, hashtags al final.
   • Instagram Reels: {"instagram": {"content": "...", "contentType": "Reels"}}. Hashtags al final.
   • YouTube Shorts: {"youtube": {"content": "<description>", "contentType": "Short", "settings": {"title": "<title>"}}}. El título tiene un máximo de 100 caracteres y YouTube no permite < o >. Coloca de qué trata el video en las dos primeras líneas de la descripción. Para un video normal de YouTube, usa "contentType": "Video".
   • LinkedIn: {"linkedin": {"content": "..."}}. Una primera línea que incite al clic, párrafos cortos.
   • Facebook Reels: {"facebook": {"content": "...", "contentType": "Reels"}}. Sigue la guía de voz del usuario si existe (consulta brand-voice). No inventes datos sobre el video; pregunta al usuario qué muestra si no lo sabes.
5. Muestra los borradores. Muestra, por plataforma: formato, título (YouTube), descripción y hora. Pide al usuario que confirme.
6. Crea la publicación. Llama a create_post con content, account_ids, media_ids: [<media_id>], platform_content y draft: true, a menos que el usuario ya haya dicho que publique ahora o haya indicado una hora para esta publicación exacta.
7. Publica o programa. Después de que el usuario confirme, llama a schedule_post con el post_id y scheduled_for (con timezone) o publish_now: true.
8. Verifica el resultado. Los videos tardan unos minutos en procesarse en cada plataforma. Llama a get_post_results tras una breve espera e informa qué plataformas publicaron, con enlaces, y cualquier fallo en palabras claras (consulta fix-failed-posts).

Buenas prácticas por defecto

• El video vertical (9:16) es adecuado para TikTok, Reels y Shorts. Para un video apaisado, revisa get_platform_rules antes de elegir un formato de corta duración.
• Un video por publicación. Para publicar dos videos, haz dos publicaciones.