O que é postagem no primeiro comentário e quais APIs permitem

O que é postagem no primeiro comentário?

A prática chamada postagem no primeiro comentário consiste em publicar um comentário no seu próprio post logo depois que ele vai ao ar, para guardar hashtags ou um link que, de outra forma, ficariam na legenda. A legenda fica curta e fácil de ler. O comentário leva as tags. Ferramentas de agendamento automatizam isso disparando uma segunda chamada de API assim que a primeira devolve o ID do post.

A ideia só funciona onde a plataforma trata uma hashtag no comentário da mesma forma que uma na legenda, e só onde a API deixa um app comentar no conteúdo da própria conta. Das plataformas tratadas aqui, só o Instagram coloca essas regras por escrito, na sua Central de Ajuda.

Por que as pessoas colocam hashtags ou links no primeiro comentário?

Para manter a legenda limpa e ainda assim marcar o post. A Central de Ajuda do Instagram diz isso diretamente: "You can add hashtags in the caption or comments of your post. If you have a public account and add hashtags to a post, the post will be visible on the corresponding hashtag page."

A mesma página trata o comentário como uma forma de marcar um post depois de publicado: "If you want to add a hashtag to a post you've already uploaded, edit the caption or include your hashtag in a comment on your photo." Essa frase é o que mais se aproxima de um aval oficial ao hábito do primeiro comentário. Ela coloca legenda e comentário no mesmo patamar para levar um post a uma página de hashtag.

Links são o outro uso comum. As pessoas movem um link para o primeiro comentário pelo mesmo motivo de layout. Nenhuma das documentações de plataforma lidas para esta página afirma que um link ou uma hashtag em um comentário é ranqueado de forma diferente de um na legenda. Se você viu alguma afirmação sobre alcance em qualquer direção, ela não veio dessas documentações.

Quais APIs deixam você comentar no seu próprio post?

Instagram, Facebook e LinkedIn têm um endpoint de comentário que um app pode chamar no post da própria conta. Threads, X e Bluesky não têm um objeto de comentário separado. Nessas três, o equivalente é uma resposta ao seu próprio post, criada pelo endpoint normal de post.

Plataforma	Endpoint	Campos obrigatórios	Acesso listado na documentação
Instagram	POST /<IG_MEDIA_ID>/comments	message	instagram_manage_comments (Facebook Login) ou instagram_business_manage_comments (Instagram Login)
Facebook	POST /{object-id}/comments	Um de message, attachment_id, attachment_share_url, attachment_url ou source	pages_manage_engagement, mais uma pessoa que possa executar a tarefa MODERATE na Página
LinkedIn	POST /rest/socialActions/{shareUrn|ugcPostUrn|commentUrn}/comments	actor, message, object	w_member_social_feed ou w_organization_social_feed
Threads	POST /{threads-user-id}/threads com reply_to_id	media_type, reply_to_id	Token de acesso de usuário do Threads
X	POST /2/tweets com um objeto reply	text ou mídia, reply	Token de usuário OAuth 2.0
Bluesky	Registro app.bsky.feed.post com reply	text, createdAt, reply.root, reply.parent	A própria sessão da conta

Cada linha tem seus detalhes. A referência do Instagram lista uma limitação para criar comentários: "Comments on live video IG Media are not supported." O edge de comentários do Facebook devolve o id do novo comentário e suporta read-after-write. O LinkedIn devolve o ID do comentário no header de resposta x-restli-id e documenta um erro de throttling, 429 "Comment create throttled: creation rate limit exceeded for member", descrito como "the short term 1 minute rate limit".

As duas páginas do LinkedIn discordam sobre permissões. A página da Comments API lista w_member_social_feed e w_organization_social_feed para escrever comentários. A página da Posts API lista w_member_social e w_organization_social, cada uma descrita como capaz de "Post, comment, and like posts". Se uma chamada de comentário falha com 403 enquanto a publicação funciona, verifique qual nome de escopo o seu app realmente tem. As regras de layout e de tags do próprio post estão em como adicionar hashtags a um post no LinkedIn.

O que a documentação do Instagram diz sobre hashtags nos comentários?

Duas fontes tratam do assunto, e elas dizem coisas diferentes. A documentação para desenvolvedores cobre como publicar um comentário. A Central de Ajuda cobre o que uma hashtag nesse comentário faz.

A referência da Graph API para POST /<IG_MEDIA_ID>/comments diz que ela "Creates an IG Comment on an IG Media object" e recebe um parâmetro obrigatório, message, "The text to be included in the comment." Ela não diz nada sobre hashtags. O guia de Hashtag Search diz que a API encontra "public IG Media that has been tagged with specific hashtags" e não diz se uma tag em um comentário conta.

A Central de Ajuda preenche a lacuna, e traz o número que a maioria das configurações de primeiro comentário erra. Em "Things to keep in mind" ela diz: "You can use up to 5 tags on a post. If you include more than 5 tags on a single photo/video, your comment won't post." Um primeiro comentário com 20 hashtags não é cortado. Ele falha.

A mesma página deixa uma pergunta em aberto. Ela não diz se as 5 tags são contadas somando a legenda e os comentários, ou por trecho de texto. Até o Instagram esclarecer, a leitura segura é 5 por post no total. Isso significa que 3 tags na legenda e mais 3 no primeiro comentário já são uma a mais por essa leitura. O contexto sobre o que uma tag faz e como as páginas de hashtag reúnem posts está em o que é uma hashtag.

Qual é o custo do timing?

O post sempre fica no ar por um instante sem o comentário, porque o endpoint de comentário precisa do ID do post publicado e esse ID só existe depois da publicação. No Instagram, POST /<IG_ID>/media_publish devolve {"id": "<IG_MEDIA_ID>"}, e só então POST /<IG_MEDIA_ID>/comments pode rodar.

Para imagens, o intervalo dura uma ida e volta de API. Para vídeo, pode ser mais longo, porque o contêiner precisa terminar o processamento antes de ser publicado. O guia do Instagram recomenda "querying a container's status once per minute, for no more than 5 minutes." Uma ferramenta que espera esse status e depois comenta vai deixar um post de vídeo no ar pelo tempo que a publicação levou, mais uma chamada.

O caso de falha é pior do que o atraso. Se a chamada de comentário falha, seja por um 429 do LinkedIn, por um comentário do Instagram com mais de 5 tags ou por um token sem a permissão de comentário, o post continua no ar sem nenhuma hashtag. Hashtags na legenda não podem falhar separadamente do post. Hashtags no primeiro comentário podem.

Corrigir um comentário errado também exige mais passos do que corrigir uma legenda no Instagram. A referência de /<IG_MEDIA_ID>/comments diz "Updating: This operation is not supported." Para mudar as tags, você apaga o comentário com DELETE /<IG_COMMENT_ID> e publica um novo. O LinkedIn é diferente: a Comments API permite editar text e attributes no message de um comentário existente.

Posts agendados no Facebook levantam mais uma pergunta que a documentação não responde. Um post criado com published=false e um scheduled_publish_time devolve um ID na hora, mas nem o guia de Posts nem a referência de comentários dizem se é permitido comentar nele antes de ele ir ao ar. Coloque o comentário na fila para depois do horário de publicação em vez de depender de um comportamento que a Meta não documentou. O tratamento de comentários depois da publicação está em gestão de comentários no Facebook.

Onde fica a lacuna no Instagram

O contêiner termina de processar

media_publish devolve o ID da mídia

O post está no ar sem hashtags

A chamada do comentário roda

As hashtags aparecem, ou a chamada falha e o post fica sem elas

Você deve usar o primeiro comentário ou a legenda?

Use a legenda, a menos que tenha um motivo específico para o comentário. A legenda é publicada na mesma chamada que o post, não pode falhar separadamente e, no Instagram, pode ser editada no próprio lugar. O primeiro comentário compra uma legenda mais curta, ao custo de um instante sem tags, uma segunda chamada que pode falhar e um apagar e republicar para corrigir erros.

Se você usar o primeiro comentário, construa a ferramenta em torno do caso de falha. Confira a contagem de tags contra o limite de 5 do Instagram antes de publicar. Faça a chamada de comentário tentar de novo sozinha. Registre se ela deu certo, para que alguém veja um post que saiu sem as tags. O fluxo em torno do próprio post é o mesmo descrito em como agendar posts no Instagram.

Perguntas frequentes

Dá para publicar um primeiro comentário no Instagram pela API?

Sim. Envie POST /<IG_MEDIA_ID>/comments com um parâmetro message depois que media_publish devolver o ID da mídia. O token de acesso precisa de instagram_manage_comments com Facebook Login ou de instagram_business_manage_comments com Instagram Login. Comentários em mídia de vídeo ao vivo não são suportados.

Hashtags no primeiro comentário funcionam no Instagram?

A Central de Ajuda do Instagram diz "You can add hashtags in the caption or comments of your post", e que um post público com hashtags aparece na página de hashtag correspondente. Ela não descreve nenhuma diferença de ranqueamento entre os dois lugares.

Quantas hashtags cabem em um primeiro comentário no Instagram?

A Central de Ajuda do Instagram diz "You can use up to 5 tags on a post" e "If you include more than 5 tags on a single photo/video, your comment won't post." Ela não diz se as tags da legenda e do comentário dividem esse limite, então planeje 5 no total.

Dá para editar um primeiro comentário pela API do Instagram?

Não. A referência de /<IG_MEDIA_ID>/comments lista a atualização como "not supported". Apague o comentário com DELETE /<IG_COMMENT_ID> e publique um novo. A Comments API do LinkedIn permite editar o texto de um comentário existente.

Qual permissão uma Página do Facebook precisa para comentar no próprio post?

A referência /{object-id}/comments da Meta pede "A Page access token requested by a person who can perform the MODERATE task on the Page" e a permissão pages_manage_engagement. A requisição precisa de um message ou de um dos campos de anexo.

A postagem no primeiro comentário funciona no Threads e no X?

Os dois usam uma resposta ao seu próprio post em vez de um comentário. No Threads, crie um novo post com reply_to_id apontando para o ID do post original. No X, envie POST /2/tweets com um objeto reply que aponte para o post original.

Por quanto tempo um post fica no ar sem o primeiro comentário?

Em imagens, a lacuna dura uma ida e volta da API, porque a chamada do comentário roda assim que media_publish devolve o ID da mídia. Em vídeo pode ser mais longa, porque o contêiner precisa terminar de processar antes de ser publicado. O guia do Instagram recomenda consultar o status de um contêiner uma vez por minuto, por no máximo 5 minutos.

O que acontece se o primeiro comentário falhar?

O post continua no ar sem nenhuma hashtag. As causas possíveis são um 429 do LinkedIn, um comentário do Instagram com mais de 5 tags ou um token sem permissão de comentário. Faça a chamada tentar de novo sozinha e registre se deu certo, para que alguém perceba um post que saiu sem as tags.

As hashtags devem ir na legenda ou no primeiro comentário?

Use a legenda, a menos que você tenha um motivo específico para o comentário. A legenda sai na mesma chamada do post, não pode falhar separadamente e no Instagram dá para editar no lugar. O primeiro comentário rende uma legenda mais curta, ao custo de um momento sem tags e de uma segunda chamada que pode falhar.

Qual escopo do LinkedIn um primeiro comentário exige?

A página da Comments API do LinkedIn lista w_member_social_feed e w_organization_social_feed para escrever comentários. A página da Posts API lista w_member_social e w_organization_social, descritos como capazes de "Post, comment, and like posts". Se uma chamada de comentário retornar 403 enquanto o post funciona, confira qual escopo seu app realmente tem.