Reels de teste no Instagram pela API: trial_params e graduação
A API do Instagram publica reels de teste, exibidos a princípio só para quem não segue a conta, ao adicionar trial_params a um container REELS. O graduation_strategy define como o reel chega aos seguidores: MANUAL deixa a decisão com o dono da conta no app do Instagram, e SS_PERFORMANCE gradua automaticamente se o reel tiver bom desempenho. A Meta oferece suporte com 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 normalmente: a ferramenta não aceita trial_params, então um reel de teste é compartilhado pelo app do Instagram.
Quando a Meta adicionou reels de teste à Content Publishing API, tanto para Instagram Login quanto para Facebook Login.
MANUAL, graduado à mão no app do Instagram, ou SS_PERFORMANCE, graduado automaticamente se o reel de teste tiver bom desempenho.
O media_type que o container precisa ter sempre que trial_params estiver na requisição.
Duração máxima de vídeo de um container de reel; o mínimo é de 3 segundos e o arquivo maior tem 300 MB.
Por quanto tempo um container de mídia permanece sem publicação antes de expirar.
O que é um reel de teste?
Um reel que o Instagram mostra apenas a pessoas que não seguem a conta. Ao ser graduado, ele se torna um reel comum, exibido aos seguidores: seja quando o dono da conta decide isso no app do Instagram, seja automaticamente se tiver bom desempenho, conforme a estratégia definida na publicação.
Como publicar um pela API?
Com as chamadas habituais de reel e um parâmetro a mais. 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é o status_code do container indicar FINISHED; depois publique com POST /<IG_ID>/media_publish, passando o ID do container como creation_id.
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: ele fica com quem não segue até ser graduado à mão no app do Instagram. SS_PERFORMANCE quando a decisão pode ficar com o Instagram: o reel de teste é graduado automaticamente se tiver bom desempenho. graduation_strategy é obrigatório dentro de trial_params, e esses são seus únicos dois valores.
Quais regras continuam valendo?
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, em uma URL pública que a Meta consiga acessar.
- Processamento: verifique o
status_codedo container até que indique FINISHED, uma vez por minuto e por no máximo 5 minutos, como sugere a Meta. - Expiração: um container não publicado em até 24 horas expira e precisa ser criado novamente.
- Legenda: até 2.200 caracteres e 20 marcações @, com até 5 hashtags pela regra atual do Instagram (a referência da API da Meta ainda lista 30).
- Carrosséis: reels não podem aparecer neles.
Funciona com Instagram Login?
Sim. O changelog da Meta introduziu reels de teste na API do Instagram com Instagram Login e com Facebook Login em 3 de dezembro de 2025, e o guia de publicação mostra a chamada em 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 pela API?
A Meta descreve duas formas de graduação: à mão no app do Instagram, para MANUAL, e automaticamente se tiver bom desempenho, para SS_PERFORMANCE. Seu guia de publicação e a referência de mídia não descrevem nenhuma chamada de API para graduar, então a parte da API termina quando o reel de teste é publicado.
Como publicar um reel de teste pelo Claude ou pelo ChatGPT?
Hoje não pelo easyCoexistence. publish_instagram_post cria o container do Reel por conta própria e não aceita trial_params, então os Reels que ele publica vão para os seguidores normalmente, e os tokens do Instagram não são entregues para uma chamada sua. Compartilhe um reel de teste pelo app do Instagram, com a chave Trial na tela de compartilhamento.
Erros comuns
- Adicionar trial_params a um container de foto, carrossel ou Story. A Meta aceita apenas quando media_type é REELS.
- Deixar graduation_strategy de fora. Ele é obrigatório dentro de trial_params, como MANUAL ou SS_PERFORMANCE.
- Publicar antes de o vídeo ser processado. media_publish só funciona quando o status_code do container indica FINISHED.
- Esperar que os seguidores vejam um reel de teste ao publicá-lo. Ele vai só para quem não segue até ser graduado.
De US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os primeiros 3 dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
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 como de costume, com Instagram Login ou Facebook Login.
trial_params pode ser usado em foto ou carrossel?
Não. A Meta aceita trial_params apenas em um container cujo media_type é REELS, então 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 é exibido apenas a quem não segue e chega aos seguidores depois de graduado.
Qual o tamanho máximo de um reel de teste?
O mesmo de qualquer reel: de 3 segundos a 15 minutos, em arquivo MOV ou MP4 de até 300 MB, em uma URL pública que a Meta consiga acessar.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em