Posts
Publicar trial reels no Instagram pela API
Um trial reel é mostrado primeiro a quem ainda não segue a conta. Com format reels e instagram.trial_graduation_strategy, o Connect publica o reel nesse modo, sem app review e sem lidar com tokens.
A chamada
POST /api/posts?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>
{
"external_reference": "reel-trial-12",
"format": "reels",
"caption": "Teste novo: o que acha?",
"media": [
{
"type": "video",
"url": "https://cdn.example.com/trial.mp4"
}
],
"instagram": {
"trial_graduation_strategy": "SS_PERFORMANCE"
}
}O que dá para fazer
- Publicar um reel como trial reel com uma única opção, trial_graduation_strategy.
- Escolher MANUAL para a conta decidir se promove o reel ao perfil.
- Escolher SS_PERFORMANCE para o Instagram promover sozinho se o desempenho for bom.
- Combinar com capa, áudio, colaboradores e primeiro comentário, como em qualquer reel.
Regras e limites
- trial_graduation_strategy só vale em format reels e aceita MANUAL ou SS_PERFORMANCE.
- Reels aceita exatamente 1 vídeo.
- A resposta é 202: a publicação roda em segundo plano. Acompanhe pelo GET /posts/{uuid}.
- external_reference é obrigatório e Idempotency-Key permite repetir a chamada sem duplicar.
Campos principais
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| external_reference | string | Sim | O id do post no seu sistema (até 100 caracteres). Impede publicar o mesmo post duas vezes na mesma conta. |
| format | string | Sim | Formato do post. No Instagram: feed, reels ou story. No Facebook: feed, reels ou story. |
| caption | string | Não | Legenda. No Instagram, até 2200 caracteres, 30 hashtags e 20 menções. Stories não levam legenda. |
| media | array | Sim | Lista de mídias, em ordem. Cada item tem type e url. |
| media.url | string | Sim | URL https:// pública que a rede consegue baixar (até 2048 caracteres). |
| instagram.trial_graduation_strategy | string | Não | Publica como trial reel. MANUAL: a conta decide se promove ao perfil. SS_PERFORMANCE: o Instagram promove se o desempenho for bom. Só em reels. |
| instagram.share_to_feed | boolean | Não | Se o reel também aparece no grid do perfil. Só em reels. |
Para quem
Teste de conteúdo
Seu SaaS publica variações de um vídeo como trial reel para medir o alcance entre não seguidores antes de ir ao perfil.
Agência
Valide criativos de vários clientes: SS_PERFORMANCE promove só os que performarem bem.
Agente de IA de growth
Um agente publica um lote de reels em teste e, com MANUAL, deixa a decisão final para a conta.
Funciona com
Instagram Business
Instagram
Perguntas frequentes
O que é um trial reel?
É um reel mostrado primeiro a não seguidores. Você define como ele é promovido ao perfil: MANUAL ou SS_PERFORMANCE.
Qual a diferença entre MANUAL e SS_PERFORMANCE?
Com MANUAL a conta decide se promove o reel ao perfil. Com SS_PERFORMANCE o Instagram promove automaticamente se o desempenho for bom.
Posso usar trial_graduation_strategy em feed ou story?
Não. A opção só vale em reels.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
