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

CampoTipoObrigatórioDescrição
external_referencestringSimO id do post no seu sistema (até 100 caracteres). Impede publicar o mesmo post duas vezes na mesma conta.
formatstringSimFormato do post. No Instagram: feed, reels ou story. No Facebook: feed, reels ou story.
captionstringNãoLegenda. No Instagram, até 2200 caracteres, 30 hashtags e 20 menções. Stories não levam legenda.
mediaarraySimLista de mídias, em ordem. Cada item tem type e url.
media.urlstringSimURL https:// pública que a rede consegue baixar (até 2048 caracteres).
instagram.trial_graduation_strategystringNãoPublica 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_feedbooleanNãoSe 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.

Relacionadas

Ver tudo que dá para fazer em Posts

Veja o Connect aplicado ao seu produto.

Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.