Posts

Publicar o primeiro comentário no Instagram pela API

Com instagram.first_comment, a própria conta comenta logo depois de publicar. É útil para hashtags, links e chamadas à ação sem poluir a legenda, e vale para feed e reels.

A chamada

POST /api/posts?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>

{
  "external_reference": "post-4410",
  "format": "feed",
  "caption": "Nova coleção no ar",
  "media": [
    {
      "type": "image",
      "url": "https://cdn.example.com/colecao.jpg"
    }
  ],
  "instagram": {
    "first_comment": "#colecao #verao #moda",
    "comments_disabled": false
  }
}

O que dá para fazer

  • Comentar com a própria conta logo após o post.
  • Colocar hashtags ou um texto de apoio fora da legenda.
  • Desativar os comentários depois da publicação com instagram.comments_disabled.
  • Usar em posts de imagem, carrossel e reels, nas contas instagram e instagram_business.

Regras e limites

  • first_comment aceita até 2200 caracteres.
  • Só vale em format feed e reels. Story não aceita.
  • O comentário é publicado pela própria conta, logo após o post.
  • A resposta é 202: a publicação roda em segundo plano. Acompanhe pelo GET /posts/{uuid}.
  • external_reference é obrigatório e Idempotency-Key evita 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.
instagram.first_commentstringNãoComentário publicado pela própria conta logo após o post, até 2200 caracteres. Só em feed e reels.
instagram.comments_disabledbooleanNãoDesativa os comentários depois da publicação. Só em feed e reels.

Para quem

  • Hashtags fora da legenda

    O SaaS publica a legenda limpa e envia as hashtags no primeiro comentário.

  • Chamada para ação

    Uma loja publica o produto e comenta o link de compra ou o cupom logo em seguida.

  • Agente de IA

    Um agente gera legenda e comentário separados e publica os dois em uma só chamada.

Funciona com

  • Instagram Business
  • Instagram

Perguntas frequentes

Quem publica o primeiro comentário?

A própria conta conectada, logo após o post.

Posso usar em stories?

Não. first_comment só vale em feed e reels.

Qual o tamanho máximo?

Até 2200 caracteres.

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.