EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Erro 10 do Facebook: permissão negada ou mensagem fora da janela permitida

O erro 10 do Facebook significa que a Meta recusou a chamada por motivo de permissão, com uma mensagem como Application does not have permission for this action. No Messenger, o mesmo código cobre uma resposta enviada tarde demais: subcódigo 2018278, This message is sent outside of allowed window. Uma permissão ausente exige uma nova autorização; uma janela fechada exige uma nova mensagem da pessoa.

easyCoexistence conecta cada Página com pages_messaging e as permissões das quais ela depende, e responde DMs do Messenger com send_social_dm pelo Claude, pelo ChatGPT ou pelo seu próprio código enquanto a janela estiver aberta.

10

O nome do código na Graph API é API Permission Denied: a permissão não foi concedida ou foi removida.

2018278

O subcódigo do código 10 cuja mensagem diz: This message is sent outside of allowed window.

24 hours

Por quanto tempo dura a janela padrão de mensagens para a maioria das ações do usuário.

7 days

Por quanto tempo a janela pode durar após a primeira mensagem enviada depois de um clique em um anúncio Click-to-Messenger.

1893063

O subcódigo do código 10 para uma Página temporariamente restrita de enviar mensagens pelas Políticas de Mensagens da Meta.

O que significa o erro 10?

A Meta recusou a chamada por motivo de permissão. O guia de erros da Graph API nomeia o código 10 como API Permission Denied, explicado da mesma forma que explica a faixa 200: a permissão não foi concedida ou foi removida. A referência de códigos de erro da Meta traz a mensagem Application does not have permission for this action e, para envios pelo Messenger, o guia diz para garantir que o app tenha a permissão pages_messaging e um token de acesso válido da Página.

O que significa This message is sent outside of allowed window?

É o código 10 com o subcódigo 2018278: a Página enviou uma mensagem do Messenger quando nenhuma janela de mensagens estava aberta com aquela pessoa. Não há nada errado com as permissões da Página nem com o texto; o problema é o momento, já que respostas e atualizações devem ser enviadas durante o que a Meta chama de janela padrão de mensagens:

  • Uma mensagem da pessoa para a Página a abre por 24 horas, como acontece com a maioria das ações do usuário.
  • Uma primeira mensagem enviada após um clique em um anúncio Click-to-Messenger pode mantê-la aberta por até 7 dias a partir dessa mensagem.
  • Reagir a uma mensagem, tocar em um botão Get Started ou abrir uma conversa existente por um link m.me também a abrem.
  • Cada nova mensagem da pessoa a abre de novo, então o prazo conta a partir da mensagem mais recente dela.

Como alcançar a pessoa depois que a janela fecha?

Espere que ela tome uma ação. Uma nova mensagem da pessoa reabre a janela, e responder logo mantém a conversa dentro dela. As tags de mensagem permitem que uma Página envie fora da janela em casos de uso aprovados, nunca para conteúdo promocional, e a tag Human Agent permite que um representante da empresa responda manualmente dentro de um período de 7 dias. Para quem comentou na publicação da Página, uma resposta privada é outro caminho: uma mensagem por comentário, em até 7 dias da criação da publicação ou do comentário.

Quais outras recusas do Messenger compartilham o código 10?

Várias, cada uma com um subcódigo próprio. A tabela de erros do Messenger da Meta lista estes junto com o 2018278:

  • 2018108: They can't receive your messages right now. (a pessoa não pode receber suas mensagens agora)
  • 1893063: You are temporarily restricted from sending messages, because of activity that doesn't follow Meta's Messaging Policies. A Meta envia a explicação por e-mail para a Caixa de Entrada de Suporte da Página.
  • 2018300: The message failed to send because another app controls the conversation. Aguarde um evento messaging_handovers que contenha pass_thread_control.

Como corrigir uma permissão ausente?

Verifique o token e depois autorize de novo. Um token de Página usado para o Messenger precisa de pages_messaging, que a Meta lista como dependente de pages_manage_metadata e pages_show_list, e a referência de respostas privadas da Meta exige um token solicitado por alguém que possa executar a tarefa MESSAGING na Página. Se a pessoa nunca concedeu a permissão ou a removeu depois, ela deve autorizar de novo e concedê-la.

Erros comuns

  • Tratar todo código 10 como problema de permissão. No Messenger, o subcódigo pode significar uma janela fechada, uma Página restrita ou outro app com a conversa, e uma nova autorização não resolve nenhum deles.
  • Repetir um envio recusado por causa da janela. Esperar não a reabre; uma ação da pessoa, como uma nova mensagem, reabre.
  • Agendar um acompanhamento para o dia seguinte. Após mais de 24 horas da última mensagem da pessoa, ele falha, a menos que ela tenha escrito de novo.
  • Usar tag em uma mensagem promocional para passá-la. A Meta não permite tags para conteúdo promocional, e usá-las fora dos casos de uso aprovados pode restringir o envio de mensagens da Página.
Fazendo isso com o EasyCoexistence

Novas mensagens podem ser encaminhadas ao seu endpoint conforme chegam, para que seu sistema saiba quando uma janela abre, e as automações verificam a janela de 24 horas antes de responder, interrompendo uma execução cuja janela já fechou em vez de enviar. Quando a Meta recusa um envio com o código 10, a ferramenta devolve o código e a mensagem da Meta. 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

O que significa Application does not have permission for this action?

É a mensagem da Meta para o erro 10, API Permission Denied: a chamada exige uma permissão que não foi concedida ou foi removida.

O que significa o subcódigo 1893063?

A Página está temporariamente restrita de enviar mensagens pelas Políticas de Mensagens da Meta.

Uma Página pode enviar a primeira mensagem para alguém no Messenger?

Não com uma resposta comum. A pessoa precisa enviar mensagem para a Página primeiro, ou comentar na publicação dela, o que permite uma resposta privada em até 7 dias.

O que é o subcódigo 2018300?

Outro app controla a conversa, como o Meta Business AI, por exemplo. A solução da Meta é aguardar um evento de webhook messaging_handovers que contenha pass_thread_control.

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