Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Reels de teste do Instagram através da API: trial_params e graduação

A API do Instagram publica reels de teste, que a princípio só são mostrados a não seguidores, ao adicionar trial_params a um container REELS. O graduation_strategy define como o reel chega aos seguidores: MANUAL deixa a decisão ao titular da conta na aplicação do Instagram, e SS_PERFORMANCE gradua-o automaticamente se tiver bom desempenho. A Meta suporta-o com o Instagram Login desde dezembro de 2025.

O easyCoexistence publica Reels com publish_instagram_post a partir do Claude, do ChatGPT ou do seu próprio código, para os seguidores como habitualmente: a ferramenta não aceita trial_params, pelo que um reel de teste é partilhado a partir da app do Instagram.

3 Dec 2025

Quando a Meta adicionou reels de teste à Content Publishing API, tanto para o Instagram Login como para o Facebook Login.

2 strategies

MANUAL, graduado manualmente na aplicação do Instagram, ou SS_PERFORMANCE, graduado automaticamente se o reel de teste tiver bom desempenho.

REELS

O media_type que um container tem de ter sempre que trial_params está no pedido.

15 min

Duração máxima de vídeo de um container de reel; o mínimo é de 3 segundos e o ficheiro maior tem 300 MB.

24 hours

Tempo que um container multimédia dura por publicar antes de expirar.

O que é um reel de teste?

Um reel que o Instagram partilha apenas com pessoas que não seguem a conta. A graduação converte-o num reel normal partilhado com os seguidores, seja quando o titular da conta o decide na aplicação do Instagram, seja automaticamente se tiver bom desempenho, consoante a estratégia definida na publicação.

Como se publica um através da API?

Com as chamadas habituais de reels e um parâmetro extra. Crie o container com POST /<IG_ID>/media, definindo media_type como REELS, o video_url, uma legenda e trial_params com um graduation_strategy; aguarde até que o status_code do container indique FINISHED; depois publique-o com POST /<IG_ID>/media_publish, passando o ID do container como creation_id.

Creating a trial reel container with Instagram Login
POST https://graph.instagram.com/v26.0/<IG_ID>/media
Content-Type: application/json
Authorization: Bearer <ACCESS_TOKEN>

{
  "media_type": "REELS",
  "video_url": "https://www.example.com/videos/reel.mp4",
  "caption": "<CAPTION>",
  "trial_params": { "graduation_strategy": "MANUAL" }
}

Qual estratégia de graduação escolher?

MANUAL quando alguém vai analisar os resultados antes de os seguidores verem o reel: continua apenas com não seguidores até ser graduado manualmente na aplicação do Instagram. SS_PERFORMANCE quando a decisão pode ficar a cargo do Instagram: o reel de teste gradua-se automaticamente se tiver bom desempenho. graduation_strategy é obrigatório dentro de trial_params, e só existem estes dois valores.

Que regras continuam a aplicar-se?

Todas as regras de um reel, já que um reel de teste é criado com os mesmos parâmetros mais trial_params:

  • Vídeo: MOV ou MP4, de 3 segundos a 15 minutos e até 300 MB, num URL público que a Meta consiga obter.
  • Processamento: verifique o status_code do container até indicar FINISHED, uma vez por minuto e durante no máximo 5 minutos, como a Meta sugere.
  • Expiração: um container não publicado em 24 horas expira e tem de ser criado novamente.
  • Legenda: até 2.200 caracteres e 20 menções @, com até 5 hashtags pela regra atual do Instagram (a referência da API da Meta ainda indica 30).
  • Carrosséis: os reels não podem aparecer neles.

Funciona com o Instagram Login?

Sim. O changelog da Meta introduziu os reels de teste para a API do Instagram com o Instagram Login e com o Facebook Login a 3 de dezembro de 2025, e o guia de publicação mostra a chamada contra graph.instagram.com. As permissões são o par de publicação: instagram_business_basic e instagram_business_content_publish.

Um reel de teste pode ser graduado através da API?

A Meta descreve duas formas de um reel de teste ser graduado: manualmente na aplicação do Instagram, para MANUAL, e automaticamente se tiver bom desempenho, para SS_PERFORMANCE. O guia de publicação e a referência de conteúdo multimédia da Meta não descrevem nenhuma chamada de API para graduar, por isso a parte da API termina quando o reel de teste é publicado.

Como se publica um reel de teste a partir do Claude ou do ChatGPT?

Hoje não através do easyCoexistence. publish_instagram_post cria ele próprio o container do Reel e não aceita trial_params, pelo que os Reels que publica chegam aos seguidores como habitualmente, e os tokens do Instagram não são entregues para uma chamada própria. Partilhe um reel de teste a partir da app do Instagram, com o interruptor Trial no ecrã de partilha.

Erros comuns

  • Acrescentar trial_params a um container de foto, carrossel ou Story. A Meta só o aceita quando media_type é REELS.
  • Omitir graduation_strategy. É obrigatório dentro de trial_params, como MANUAL ou SS_PERFORMANCE.
  • Publicar antes de o vídeo ter sido processado. media_publish só tem sucesso quando o status_code do container indica FINISHED.
  • Esperar que os seguidores vejam um reel de teste quando é publicado. Chega apenas a não seguidores até ser graduado.
Fazer isto com a EasyCoexistence

De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias gratuitos.

Perguntas frequentes

A API do Instagram pode publicar reels de teste?

Sim. Adicione trial_params com um graduation_strategy a um container REELS e publique-o como de costume, com o Instagram Login ou o Facebook Login.

Pode usar-se trial_params numa foto ou num carrossel?

Não. A Meta só aceita trial_params num container cujo media_type seja REELS, por isso containers de foto, carrossel e Story não podem ser publicações de teste.

Os seguidores veem um reel de teste?

Não de início. Um reel de teste é partilhado apenas com não seguidores e chega aos seguidores quando for graduado.

Qual é a duração máxima de um reel de teste?

A mesma de qualquer reel: de 3 segundos a 15 minutos, num ficheiro MOV ou MP4 até 300 MB, num URL público que a Meta consiga obter.

Continue a ler

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorizado 24/7

Verificado em