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.
A janela padrão para responder depois de uma mensagem da pessoa, para a maioria das ações do utilizador.
A janela Human Agent, separada, da Meta, para respostas que a pessoa escreve e marca com human_agent.
O texto mais longo que uma DM pode ter pela API, codificado em UTF-8.
Subcódigo de erro, sob o código 10, para uma mensagem enviada fora da janela permitida.
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.
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