EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Limites de legenda do Instagram: caracteres, hashtags e marcações @ na API

A API do Instagram publica uma legenda de até 2,200 caracteres com foto, Reel ou carrossel, com no máximo 20 marcações @. Desde novembro de 2026, a Central de Ajuda do Instagram permite 5 hashtags por post, enquanto a referência da API da Meta ainda lista 30, por isso use até 5. Contas marcadas com @ são notificadas quando o post é publicado, e uma legenda longa demais falha com o código 36004, subcódigo 2207010.

O easyCoexistence publica uma foto, carrossel ou Reel com sua legenda pela ferramenta publish_instagram_post, a partir do Claude, do ChatGPT ou do seu próprio código, definindo a legenda uma única vez em um carrossel, e list_social_posts lê de volta a legenda de cada post.

2,200

Máximo de caracteres que uma legenda pode ter pela API do Instagram.

5

Máximo de hashtags que a Central de Ajuda do Instagram permite hoje em um post, na legenda ou nos comentários.

30

Máximo de hashtags por legenda na referência da API da Meta, que ainda traz o número antigo.

20

Máximo de marcações @ em uma legenda; ultrapassar retorna o código 100, subcódigo 2207040.

2207010

Subcódigo de erro, dentro do código 36004, para uma legenda maior do que o Instagram permite.

Partial

media_publish pode ter sucesso com config_issue CAPTION_NOT_ATTACHED: o post fica no ar sem a legenda.

Quais são os limites da legenda?

Três, todos no parâmetro caption do container de mídia. A legenda pode incluir hashtags, escritas como #tag, e nomes de usuário de contas do Instagram, escritos como @username, dentro destes limites:

  • Tamanho: até 2,200 caracteres.
  • Hashtags: até 5 por post pela Central de Ajuda do Instagram, contando as dos comentários; a referência da API da Meta ainda lista 30.
  • Marcações @: até 20, e cada conta marcada é notificada quando o post é publicado.

Quais posts aceitam legenda?

Fotos, Reels e carrosséis. Em um carrossel, a legenda vai no container do carrossel, já que as imagens e vídeos dentro dele não aceitam uma, e a referência da Meta não descreve legenda para Stories; por isso, o que for destinado a um Story deve ficar na própria imagem ou vídeo.

O que acontece quando uma legenda quebra um limite?

A requisição falha com um erro que nomeia o problema. Uma legenda longa demais retorna o código 36004, subcódigo 2207010, e a correção indicada pela Meta repete os limites: no máximo 2,200 caracteres, 30 hashtags e 20 marcações @. Mais de 20 marcações @ também podem retornar o código 100, subcódigo 2207040. Encurte a legenda e envie a requisição de novo.

Quando as contas marcadas são notificadas?

Quando o container é publicado, não quando é criado. Contas marcadas com @ em uma legenda recebem uma notificação nesse momento, então um container preparado com antecedência não avisa ninguém até ir ao ar. O limite da Meta de 20 marcações @ por legenda se aplica a essas menções.

Um post pode ir ao ar sem a legenda?

Sim. media_publish pode ter sucesso com o campo config_issue definido como CAPTION_NOT_ATTACHED, o que significa que a mídia foi publicada sem a legenda. A Meta chama isso de sucesso parcial: o ID da mídia é válido, então concilie o post em vez de publicá-lo de novo.

A legenda pode ser alterada depois de publicada?

A referência de mídia da Meta documenta uma atualização para mídia publicada: ativar ou desativar comentários com POST /<IG_MEDIA_ID> e comment_enabled. Ela não lista nenhuma forma de editar a legenda, então confira o texto, as hashtags e as marcações @ antes de o container ser criado.

Erros comuns

  • Conferir só o tamanho. Uma legenda com menos de 2,200 caracteres ainda quebra os limites com mais de 5 hashtags, a regra atual do Instagram, ou mais de 20 marcações @.
  • Colocar legenda nos itens do carrossel. Só o container do carrossel aceita legenda.
  • Escrever legenda para um Story. O container de Stories não aceita nenhuma, então coloque as palavras na imagem ou no vídeo.
  • Publicar de novo após CAPTION_NOT_ATTACHED. O primeiro post já está no ar, e uma segunda publicação cria um duplicado.
Fazendo isso com o EasyCoexistence

De US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os primeiros 3 dias grátis.

O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.

Perguntas frequentes

O que significa o erro 2207040 no Instagram?

A legenda tem mais de 20 marcações @, retornadas sob o código 100. Remova marcações até restarem 20 ou menos e envie a requisição de novo.

O limite de 5 hashtags do Instagram inclui hashtags nos comentários?

Sim. A Central de Ajuda do Instagram permite até 5 hashtags em um post, contando as da legenda e as dos comentários.

Dá para desativar os comentários de um post publicado pela API?

Sim. POST /<IG_MEDIA_ID> com comment_enabled definido como false desativa os comentários, e true os reativa. É a única atualização que a referência de mídia da Meta documenta para mídia publicada.

O que significa o erro 2207010?

A legenda é maior do que o Instagram permite. Encurte-a para 2,200 caracteres ou menos e envie a requisição de novo.

Continue lendo

Conecte seu primeiro canal em dois minutos.

Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorado 24/7

Verificado em