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 motivos 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 em falta exige um novo início de sessão; uma janela fechada exige uma nova mensagem da pessoa.
A easyCoexistence liga cada Página com pages_messaging e as permissões de que depende, e responde a mensagens diretas no Messenger com send_social_dm a partir do Claude, do ChatGPT ou do seu próprio código enquanto a janela estiver aberta.
O código da Graph API chamado 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*.
Quanto tempo dura a janela padrão de mensagens para a maioria das ações do utilizador.
Quanto tempo pode durar a janela após a primeira mensagem enviada depois de um clique num anúncio Click-to-Messenger.
O subcódigo do código 10 para uma Página temporariamente restringida de enviar mensagens, ao abrigo das Políticas de Mensagens da Meta.
O que significa o erro 10?
A Meta recusou a chamada por motivos de permissão. O guia de erros da Graph API identifica o código 10 como API Permission Denied, explicado da mesma forma que explica a série 200: a permissão não foi concedida ou foi removida. A referência de códigos de erro da Meta apresenta a mensagem como *Application does not have permission for this action*. Para envios no Messenger, o guia indica que a aplicação tenha a permissão pages_messaging e um token de acesso válido à 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 não havia nenhuma janela de mensagens aberta com essa pessoa. Não há nada de errado com as permissões da Página nem com o texto; o problema é o momento, uma vez que as respostas e atualizações têm de ser enviadas durante o que a Meta chama de janela padrão de mensagens:
- Uma mensagem da pessoa para a Página abre a janela durante 24 horas, como acontece na maioria das ações do utilizador.
- Uma primeira mensagem enviada após um clique num anúncio Click-to-Messenger pode mantê-la aberta até 7 dias a contar dessa mensagem.
- Reagir a uma mensagem, tocar num botão Get Started ou abrir uma conversa existente através de uma ligação m.me também a abrem.
- Cada nova mensagem da pessoa volta a abri-la, por isso o prazo conta a partir da mais recente.
Como chegar à pessoa depois de a janela fechar?
Aguarde que a pessoa atue. Uma nova mensagem da pessoa reabre a janela, e responder em tempo útil mantém a conversa dentro dela. As etiquetas de mensagem permitem que uma Página envie fora da janela em casos de utilização aprovados, nunca para conteúdo promocional, e a etiqueta Human Agent permite que um representante da empresa responda manualmente durante um período de 7 dias. Para quem comentou na publicação da Página, uma resposta privada é outra via: uma mensagem por comentário, no prazo de 7 dias após a criação da publicação ou do comentário.
Que outras recusas do Messenger partilham o código 10?
Várias, cada uma com um subcódigo próprio. A tabela de erros do Messenger da Meta lista estes ao lado de 2018278:
- 2018108: *They can't receive your messages right now.*
- 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 email para a Support Inbox da Página.
- 2018300: *The message failed to send because another app controls the conversation.* Aguarde por um evento
messaging_handoversque contenhapass_thread_control.
Como resolver uma permissão em falta?
Verifique o token e volte a iniciar sessão. Um token de Página usado para o Messenger precisa de pages_messaging, que a Meta indica depender de pages_manage_metadata e pages_show_list, e a referência de respostas privadas da Meta exige um token pedido por alguém que possa executar a tarefa MESSAGING na Página. Se a pessoa nunca concedeu a permissão ou a removeu entretanto, deve voltar a iniciar sessão e concedê-la.
Erros comuns
- Tratar todos os códigos 10 como um problema de permissão. No Messenger, o subcódigo pode significar uma janela fechada, uma Página restringida ou outra aplicação com a conversa, e um novo início de sessã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, sim.
- Pôr em fila um seguimento para o dia seguinte. Passadas mais de 24 horas desde a última mensagem da pessoa, o envio falha, a menos que ela tenha escrito de novo.
- Usar uma etiqueta para fazer passar uma mensagem promocional. A Meta não permite etiquetas para conteúdo promocional, e usar etiquetas fora dos casos de utilização aprovados pode restringir o envio de mensagens da Página.
As novas mensagens podem ser reencaminhadas para o seu endpoint à medida que chegam, para que o 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. A partir de US$ 9 por ligação por mês, descendo para US$ 0,75 à medida que se adicionam ligações, com os primeiros 3 dias gratuitos.
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 precisa de uma permissão que não foi concedida ou foi removida.
O que significa o subcódigo 1893063?
A Página está temporariamente restringida de enviar mensagens ao abrigo das Políticas de Mensagens da Meta.
Uma Página pode enviar primeiro uma mensagem a alguém no Messenger?
Não através de uma resposta normal. A pessoa tem de enviar primeiro uma mensagem à Página ou comentar na sua publicação, o que permite uma resposta privada dentro de 7 dias.
O que é o subcódigo 2018300?
Outra aplicação controla a conversa, como o Meta Business AI, por exemplo. A solução da Meta é aguardar um evento webhook messaging_handovers que contenha pass_thread_control.
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