Iniciar sessãoIniciar teste gratuito
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 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.

10

O código da Graph API chamado 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

Quanto tempo dura a janela padrão de mensagens para a maioria das ações do utilizador.

7 days

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

1893063

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_handovers que contenha pass_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.
Fazer isto com a EasyCoexistence

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