EntrarComeçar teste grátis
easyCoexistence APIs oficiais

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.

36004

O código de erro retornado com o subcódigo 2207010 quando a legenda passa do tamanho máximo.

2,200

Caracteres que uma legenda comporta quando a mídia é publicada pela API.

30 and 20

O máximo de hashtags e de marcações @ que uma legenda pode ter.

2207040

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.
Fazendo isso com o EasyCoexistence

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