EntrarComeçar teste grátis
easyCoexistence APIs oficiais

DMs do Instagram pela API e a janela de 24 horas

Pela API do Instagram, uma conta profissional pode responder a qualquer pessoa que lhe tenha enviado uma DM, dentro de uma janela de mensagens padrão que dura 24 horas na maioria das conversas. A pessoa precisa escrever primeiro, e a conta deve ativar Permitir acesso a mensagens no app do Instagram antes que qualquer app possa ler ou enviar as suas DMs.

O easyCoexistence responde DMs do Instagram com send_social_dm a partir do Claude, do ChatGPT ou do seu próprio código, dentro da janela de 24 horas, e encaminha as novas DMs para o seu endpoint assim que chegam.

24 hours

A janela padrão para responder depois da mensagem de uma pessoa, para a maioria das ações do usuário.

7 days

A janela separada de Human Agent da Meta, para respostas que uma pessoa escreve e marca com human_agent.

1,000 bytes

O máximo de texto que uma DM pode ter pela API, codificado em UTF-8.

2534022

Subcódigo de erro, sob o código 10, para uma mensagem enviada fora da janela permitida.

30 days

Inatividade após a qual uma conversa na pasta Solicitações deixa de ser retornada pela API.

Para quem uma conta pode enviar mensagens pela API?

Qualquer pessoa que já tenha enviado mensagem para ela. As conversas começam somente quando alguém escreve para a conta, pelo Feed, por uma publicação, por uma menção em Stories ou em outro lugar, e a partir daí um app pode responder. Quem comenta em uma publicação também pode receber uma resposta privada, explicada abaixo.

A API não tem como enviar a primeira mensagem, e conversas em grupo não são suportadas: cada conversa é entre a conta e uma única pessoa.

Quanto dura a janela de mensagens?

24 horas na maioria das conversas. A Meta a chama de janela de mensagens padrão, e a ação que a abre define a sua duração: uma mensagem da pessoa abre 24 horas, e a próxima mensagem dela a abre de novo. Quando a primeira mensagem vem de alguém que tocou em um anúncio Click-to-Direct, a janela pode durar até 7 dias.

A Meta também tem uma janela separada de Human Agent de 7 dias, para respostas escritas por uma pessoa e marcadas com human_agent por um app que tenha esse recurso, destinadas a casos que a janela padrão não cobre. Um envio fora de qualquer janela aberta falha com o código 10, subcódigo 2534022.

O que é Permitir acesso a mensagens?

Uma configuração no app do Instagram que permite a ferramentas conectadas ler e enviar as mensagens diretas da conta. O guia da Meta a coloca em Configurações, Mensagens e respostas de stories, Controles de mensagens, Ferramentas conectadas, e a conta precisa ativá-la antes que um app possa gerenciar as suas DMs. Enquanto estiver desativada, os envios falham com o código 200, subcódigo 2534041: o proprietário da conta desativou o acesso às mensagens diretas do Instagram.

Como funcionam as respostas privadas a comentários?

Uma conta profissional pode enviar uma mensagem para quem comentou em sua publicação, Reel ou Story, em até 7 dias após o comentário, ou em uma Live somente durante a transmissão. A mensagem cai na caixa de entrada da pessoa se ela segue a conta, e na pasta Solicitações se não segue, e inclui um link para a publicação. Uma mensagem de acompanhamento precisa esperar que a pessoa responda e então é enviada em até 24 horas depois da resposta dela.

Onde as conversas da API aparecem no app?

Na caixa de entrada normal do Instagram da conta, com algumas diferenças que vale conhecer:

  • Novas conversas de seguidores começam em Principal; de pessoas que não seguem a conta, em Solicitações.
  • Uma conversa respondida por meio de um app vai para a pasta Geral, independentemente do que as configurações da caixa de entrada dizem.
  • Mensagens entregues a um app não são marcadas como lidas no app do Instagram até que uma resposta seja enviada.
  • Solicitações sem atividade por 30 dias deixam de ser retornadas pela API.

Qual é a velocidade de envio de uma conta?

A Meta define limites de taxa de mensagens por conta profissional do Instagram, separados das outras chamadas de API do app:

  • Texto, links, reações e figurinhas: 100 chamadas por segundo.
  • Áudio ou vídeo: 10 chamadas por segundo.
  • Respostas privadas a comentários em publicações e Reels: 750 chamadas por hora.
  • Conversations API: 2 chamadas por segundo.

O que uma mensagem pode conter?

Texto, links, imagens, áudio, vídeo, arquivos PDF, figurinhas, reações, templates e publicações que a conta é dona. O texto precisa estar em UTF-8 e ter no máximo 1,000 bytes, o que comporta menos caracteres quando há acentos e emojis. As imagens podem ser PNG ou JPEG de até 8 MB, e áudio, vídeo e arquivos PDF de até 25 MB.

Erros comuns

  • Deixar Permitir acesso a mensagens desativado. Os envios falham com o código 200, subcódigo 2534041, até que a conta ative a opção no app.
  • Contar caracteres em vez de bytes. Letras acentuadas ocupam dois bytes em UTF-8 e a maioria dos emojis quatro, então um texto que passa numa verificação de 1,000 caracteres ainda pode ser recusado.
  • Enviar uma segunda resposta privada para o mesmo comentário. A Meta permite uma; a próxima mensagem espera até que a pessoa responda.
  • Contar a janela a partir da primeira mensagem da conversa. Ela é contada a partir da última mensagem da pessoa, então cada resposta dela dá mais tempo à conta.
Fazendo isso com o EasyCoexistence

Automações podem responder sozinhas, com um texto fixo ou com IA, e regras de comentário para DM enviam respostas privadas o tempo todo. US$ 9 to 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

Uma empresa pode enviar a primeira DM no Instagram?

Não pela API. A pessoa precisa enviar mensagem para a conta ou comentar em uma de suas publicações, o que permite uma única resposta privada em até 7 dias.

O que acontece quando as 24 horas terminam?

A API recusa o envio até que a pessoa escreva de novo, o que abre uma nova janela. Respostas escritas por uma pessoa podem usar a janela separada de Human Agent da Meta, de 7 dias, com a marcação human_agent.

Qual o tamanho máximo de uma DM do Instagram enviada pela API?

Até 1,000 bytes de texto UTF-8 por mensagem. Acentos e emojis ocupam mais de um byte cada, então uma mensagem com eles comporta menos de 1,000 caracteres.

As mensagens lidas pela API aparecem como lidas no app?

Não. Uma mensagem entregue a um app continua não lida na caixa de entrada do Instagram até que uma resposta seja enviada.

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