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.
O nome do código na Graph API é API Permission Denied: a permissão não foi concedida ou foi removida.
O subcódigo do código 10 cuja mensagem diz: This message is sent outside of allowed window.
Por quanto tempo dura a janela padrão de mensagens para a maioria das ações do usuário.
Por quanto tempo a janela pode durar após a primeira mensagem enviada depois de um clique em um anúncio Click-to-Messenger.
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_handoversque contenhapass_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.
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