Posts

Publicar reels no Instagram pela API

Com format reels e um vídeo em media, o Connect publica um reel na conta Instagram conectada pelo seu cliente. Uma só chamada serve para todas as contas, sem app review e sem guardar 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-310",
  "format": "reels",
  "caption": "Bastidores da campanha #reels",
  "media": [
    {
      "type": "video",
      "url": "https://cdn.example.com/reel.mp4"
    }
  ],
  "instagram": {
    "share_to_feed": true,
    "cover_url": "https://cdn.example.com/capa.jpg",
    "first_comment": "Qual parte você mais gostou?"
  }
}

O que dá para fazer

  • Publicar um reel a partir de uma URL de vídeo https:// pública.
  • Escolher uma imagem de capa com instagram.cover_url.
  • Decidir se o reel também aparece no grid do perfil com instagram.share_to_feed.
  • Usar um áudio do Instagram com audio_id e ajustar audio_volume e video_volume.
  • Adicionar colaboradores, local, primeiro comentário e desativar comentários.

Regras e limites

  • Reels aceita exatamente 1 vídeo.
  • A legenda vai até 2200 caracteres, com no máximo 30 hashtags e 20 menções.
  • share_to_feed vale true por padrão.
  • audio_volume e video_volume exigem audio_id.
  • A resposta é 202: a publicação roda em segundo plano e você acompanha pelo GET /posts/{uuid}.
  • external_reference é obrigatório (409 se já existir publicação igual) e Idempotency-Key, de até 255 caracteres, devolve o post já gravado com 200 no replay.

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.share_to_feedbooleanNãoSe o reel também aparece no grid do perfil. Só em reels.
instagram.cover_urlstringNãoURL https:// da imagem de capa do reel. Só em reels.
instagram.audio_idstringNãoId de um áudio do Instagram para o reel. Só em reels.

Para quem

  • Ferramenta de vídeo curto

    Seu editor exporta o vídeo e publica o reel direto na conta do usuário, com capa e legenda definidas na hora.

  • Agência com muitos clientes

    Um único fluxo publica o mesmo reel em dezenas de contas Instagram conectadas, cada uma com seu customer_integration.

  • Agente de IA de social media

    Um agente gera o vídeo, escolhe a capa e publica o reel, deixando o primeiro comentário já pronto.

Funciona com

  • Instagram Business
  • Instagram

Perguntas frequentes

Posso publicar um vídeo sozinho como feed?

Não. Um vídeo sozinho deve ir como reels; feed é para 1 imagem ou carrossel de 2 a 10 mídias.

O reel aparece no grid do perfil?

Por padrão sim, porque share_to_feed vale true. Envie instagram.share_to_feed como false para não aparecer.

Funciona com contas instagram e instagram_business?

Sim. As duas conexões aceitam o mesmo POST /posts e o mesmo bloco instagram.

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.