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.
Máximo de caracteres que uma legenda pode ter pela API do Instagram.
Máximo de hashtags que a Central de Ajuda do Instagram permite hoje em um post, na legenda ou nos comentários.
Máximo de hashtags por legenda na referência da API da Meta, que ainda traz o número antigo.
Máximo de marcações @ em uma legenda; ultrapassar retorna o código 100, subcódigo 2207040.
Subcódigo de erro, dentro do código 36004, para uma legenda maior do que o Instagram permite.
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.
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