Erro 2207010 do Instagram: legenda longa demais
O erro 2207010 do Instagram, retornado com o código 36004, significa que a legenda é maior do que o Instagram permite. A mensagem de erro da Meta lista os limites da legenda como 2,200 caracteres, 30 hashtags e 20 marcações @, embora a Central de Ajuda do Instagram permita só 5 hashtags por post, e hashtags e menções também entram na conta dos 2,200 caracteres. Encurte a legenda e crie o container novamente com o novo texto.
O easyCoexistence publica fotos, carrosséis e Reels com legenda pelo publish_instagram_post, a partir do Claude, do ChatGPT ou do seu próprio código.
O código de erro retornado com o subcódigo 2207010 quando a legenda passa do tamanho máximo.
Caracteres que uma legenda comporta quando a mídia é publicada pela API.
O máximo de hashtags e de marcações @ que uma legenda pode ter.
O subcódigo separado, sob o código 100, para mais do que o máximo de 20 marcações @.
O que significa o erro 2207010?
A legenda enviada com a mídia passa do limite do Instagram. A mensagem para o usuário que a Meta retorna informa o tamanho da legenda em caracteres e o máximo permitido e pede que a mídia seja enviada com uma legenda mais curta. Na correção indicada, a Meta lista os três limites da legenda juntos: 2.200 caracteres, 30 hashtags e 20 marcações @.
O erro diz respeito só à legenda, então basta alterar o texto antes de criar o container novamente.
Quais são os limites da legenda?
A referência da Meta para criação de mídia define três limites, e a legenda precisa respeitar todos eles:
- 2.200 caracteres no total, incluindo hashtags e menções @.
- 30 hashtags.
- 20 marcações @. Ultrapassar esse limite retorna o subcódigo 2207040, sob o código 100, e não o 2207010.
- As contas mencionadas com @ na legenda são notificadas quando o post é publicado.
Quais publicações têm legenda?
Fotos, Reels e carrosséis. No carrossel, a legenda é definida uma única vez no container do carrossel, e as fotos e vídeos dentro dele não têm legenda própria. A referência da Meta não prevê legenda para Stories. Assim, os limites valem uma vez por publicação, independentemente de quantos itens o carrossel tenha.
Como corrigir?
Confira antes de enviar. Verifique o tamanho da legenda em caracteres, junto com a quantidade de hashtags e de marcações @, corte o excesso e crie o container novamente com o novo texto. Se uma IA escreve as legendas, inclua os limites nas instruções dela, para que o texto já chegue dentro deles em vez de falhar na criação da publicação.
Erros comuns
- Contar palavras em vez de caracteres. O limite é de 2.200 caracteres, e uma legenda de algumas centenas de palavras pode ultrapassá-lo.
- Acrescentar hashtags depois de verificar o tamanho. Elas entram na conta dos 2.200 caracteres, além de contarem para o limite de 30.
- Tratar excesso de marcações @ como problema de tamanho. Mais de 20 marcações @ retorna 2207040, e só remover marcações resolve.
- Repetir o envio com o mesmo texto. A legenda é verificada a cada tentativa, então o erro continua até ela ficar mais curta.
Ele recusa uma legenda com mais de 2,200 caracteres antes de enviá-la, informando o tamanho, e repassa a mensagem da Meta quando o Instagram recusa uma legenda por suas marcações @, para que sua IA encurte o texto e publique de novo. 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
Qual é o limite de caracteres da legenda na API do Instagram?
2,200 caracteres, com no máximo 20 marcações @ na mesma legenda. A referência da API da Meta lista 30 hashtags, mas a Central de Ajuda do Instagram permite 5 por post, então use no máximo 5.
As hashtags contam no limite de 2.200 caracteres?
Sim. Hashtags e menções @ fazem parte do texto da legenda, então ocupam caracteres e também contam para os próprios limites.
O que acontece com mais de 20 marcações @?
A requisição falha com o código 100 e o subcódigo 2207040, e a Meta recomenda usar menos marcações @. Remova marcações até ficar com 20 ou menos.
Dá para colocar legenda em Story pela API?
Não. A referência da Meta prevê legendas para fotos, vídeos e carrosséis, e nenhuma para Stories, e o publish_instagram_post publica o Story sem legenda.
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