Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Mensagens diretas do Instagram através da API e a janela das 24 horas

Através da API do Instagram, uma conta profissional pode responder a qualquer pessoa que lhe tenha enviado uma mensagem direta, dentro de uma janela de mensagens predefinida que dura 24 horas na maioria das conversas. A pessoa tem de escrever primeiro, e a conta tem de ativar Permitir acesso a mensagens na app do Instagram antes de qualquer aplicação poder ler ou enviar as suas mensagens diretas.

easyCoexistence responde a 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 à medida que chegam.

24 hours

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

7 days

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

1,000 bytes

O texto mais longo 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

Período de inatividade após o qual uma conversa na pasta Pedidos deixa de ser devolvida pela API.

Com quem pode a conta enviar mensagens através da API?

Com quem tiver escrito à conta. As conversas só começam quando uma pessoa escreve para a conta, a partir do Feed, de uma publicação, de uma menção em Stories ou noutro sítio, e a partir daí uma aplicação pode responder-lhe. Quem comenta uma publicação também pode receber uma resposta privada, explicada abaixo.

A API não permite enviar a primeira mensagem, e as conversas de grupo não são suportadas: cada conversa é entre a conta e uma só pessoa.

Quanto dura a janela de mensagens?

24 horas na maioria das conversas. A Meta chama-lhe janela de mensagens padrão, e a ação que a abre define a duração: uma mensagem da pessoa abre 24 horas, e a seguinte volta a abri-la. Quando a primeira mensagem vem de alguém que tocou num anúncio Click-to-Direct, a janela pode durar até 7 dias.

A Meta tem ainda uma janela Human Agent separada, de 7 dias, para respostas escritas por uma pessoa e marcadas com human_agent por uma aplicação com essa funcionalidade, 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 definição da app do Instagram que permite às ferramentas ligadas ler e enviar as mensagens diretas da conta. O guia da Meta coloca-a em Definições, Mensagens e respostas a Stories, Controlos de mensagens, Ferramentas ligadas, e a conta tem de a ativar antes de qualquer aplicação poder gerir as suas DMs. Enquanto estiver desativada, os envios falham com o código 200, subcódigo 2534041: o titular da conta desativou o acesso às mensagens diretas do Instagram.

Como funcionam as respostas privadas aos comentários?

Uma conta profissional pode enviar uma mensagem a quem comentou a sua publicação, Reel ou Story, no prazo de 7 dias após o comentário, ou numa Live apenas durante a transmissão. A mensagem chega à caixa de entrada da pessoa se ela seguir a conta, e aos pedidos se não a seguir, e inclui uma ligação para a publicação. Um seguimento tem de esperar que a pessoa responda, e depois é enviado no prazo de 24 horas após a resposta dela.

Onde aparecem as conversas da API na app?

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

  • As novas conversas de seguidores começam em Principal; as de pessoas que não seguem a conta, em Pedidos.
  • Uma conversa respondida através de uma aplicação passa para a pasta Geral, independentemente das definições da caixa de entrada.
  • As mensagens entregues a uma aplicação não ficam marcadas como lidas na app do Instagram até ser enviada uma resposta.
  • Os pedidos sem atividade durante 30 dias deixam de ser devolvidos pela API.

Com que rapidez pode uma conta enviar?

A Meta define os limites de envio por conta profissional do Instagram, separadamente das restantes chamadas da API da app:

  • Texto, ligações, reações e autocolantes: 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 pode conter uma mensagem?

Texto, ligações, imagens, áudio, vídeo, ficheiros PDF, autocolantes, reações, templates e publicações da própria conta. O texto tem de estar em UTF-8 e ter no máximo 1 000 bytes, o que cabe em menos caracteres quando há acentos e emojis. As imagens podem ser PNG ou JPEG até 8 MB, e os ficheiros de áudio, vídeo e PDF 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 o ative na app.
  • Contar caracteres em vez de bytes. As letras com acento ocupam dois bytes em UTF-8, e a maioria dos emojis, quatro, por isso um texto que passa uma verificação de 1 000 caracteres pode ainda assim ser recusado.
  • Enviar uma segunda resposta privada ao mesmo comentário. A Meta permite uma só; a seguinte espera até que a pessoa responda.
  • Contar a janela a partir da primeira mensagem da conversa. Conta a partir da última mensagem da pessoa, por isso cada resposta dela dá mais tempo à conta.
Fazer isto com a EasyCoexistence

As automatizações podem responder por conta própria, com um texto fixo ou com IA, e as regras de comentário para DM enviam respostas privadas a qualquer hora. De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias grátis.

Perguntas frequentes

Uma empresa pode enviar a primeira DM no Instagram?

Não através da API. A pessoa tem de enviar uma mensagem à conta ou comentar uma das suas publicações, o que permite uma única resposta privada no prazo de 7 dias.

O que acontece quando passam as 24 horas?

A API recusa o envio até que a pessoa volte a escrever, o que abre uma nova janela. As respostas escritas por uma pessoa podem usar a janela Human Agent de 7 dias da Meta, 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. Os acentos e os emojis ocupam mais de um byte cada, por isso uma mensagem com eles cabe em menos de 1 000 caracteres.

As mensagens lidas pela API aparecem como lidas na app?

Não. Uma mensagem entregue a uma aplicação fica por ler na caixa de entrada do Instagram até ser enviada uma resposta.

Continue a ler

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

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

Verificado em