Cross-postar um vídeo

O que Cross-postar um vídeo faz?

Faça o upload do vídeo uma vez, escreva uma legenda para cada plataforma e escolha o formato certo em cada uma.

Etapas

1. Obter o vídeo. O usuário fornece um link público para um arquivo MP4. Chame upload_media_from_url com a url. Vídeos importam em segundo plano: chame get_media com o media_id retornado até que media_status seja "ready". Se ficar "failed", informe ao usuário o error_message em palavras simples. Nunca anexe um vídeo que não esteja pronto. Para um vídeo já na biblioteca, encontre-o com list_media e type: "video".
2. Verificar as regras. Chame get_platform_rules e compare o vídeo com os limites de cada plataforma para duração, tamanho e proporção. get_media mostra os detalhes do vídeo. Se o vídeo violar alguma regra de uma plataforma, deixe essa plataforma de fora e informe o motivo ao usuário.
3. Escolher as contas. Chame list_accounts. Use as contas que o usuário mencionou ou todas as contas saudáveis em uma plataforma de vídeo. Pule qualquer conta que não possa postar e explique o motivo.
4. Escrever uma legenda para cada plataforma. Coloque uma legenda geral em content e defina a legenda de cada plataforma em platform_content:
   • TikTok: {"tiktok": {"content": "..."}}. Curta, o gancho primeiro, hashtags no final.
   • Instagram Reels: {"instagram": {"content": "...", "contentType": "Reels"}}. Hashtags no final.
   • YouTube Shorts: {"youtube": {"content": "<descrição>", "contentType": "Short", "settings": {"title": "<título>"}}}. O título tem até 100 caracteres, e o YouTube não permite < ou >. Coloque sobre o que é o vídeo nas duas primeiras linhas da descrição. Para um vídeo normal do YouTube, use "contentType": "Video".
   • LinkedIn: {"linkedin": {"content": "..."}}. Uma primeira linha que mereça o clique, parágrafos curtos.
   • Facebook Reels: {"facebook": {"content": "...", "contentType": "Reels"}}. Siga o guia de voz do usuário, se houver (veja brand-voice). Não invente fatos sobre o vídeo; pergunte ao usuário o que ele mostra se você não souber.
5. Mostrar os rascunhos. Mostre, por plataforma: formato, título (YouTube), legenda e horário. Peça confirmação ao usuário.
6. Criar o post. Chame create_post com content, account_ids, media_ids: [<media_id>], platform_content e draft: true, a menos que o usuário já tenha dito para publicar agora ou dado um horário para este post exato.
7. Publicar ou agendar. Após a confirmação do usuário, chame schedule_post com o post_id e scheduled_for (com timezone) ou publish_now: true.
8. Verificar o resultado. Os vídeos levam alguns minutos para serem processados em cada plataforma. Chame get_post_results após uma breve espera e relate quais plataformas publicaram, com links, e qualquer falha em palavras simples (veja fix-failed-posts).

Bons padrões

• Vídeo vertical (9:16) é adequado para TikTok, Reels e Shorts. Para um vídeo largo, verifique as get_platform_rules antes de escolher um formato de short-form.
• Um vídeo por post. Para postar dois vídeos, faça dois posts.