Os códigos de erro e mensagens listados neste artigo podem não estar atualizados. Para a lista mais atualizada de códigos de erro, visite a documentação do Meta aqui .
Aqui está uma lista de códigos de erro do Facebook Messenger, suas possíveis causas e soluções sugeridas:
| Código de erro | Subcódigo de erro | Descrição | Possível causa e solução sugerida |
| 1 | 99 | Erro desconhecido | É necessário acesso avançado, verificação comercial ou permissão |
| 1 | 1357046 | Resposta JSON inválida recebida | Erro de endpoint devido a arquivo JSON inválido. Verifique o arquivo que você incluiu na mensagem para tentar novamente. |
| 2 | / | Ocorreu um erro inesperado. Por favor, tente novamente sua solicitação mais tarde. | Ocorreu um erro inesperado ao fazer chamadas para o Meta social graph. Verifique o status da Meta Developer Platform para determinar se há problemas afetando chamadas de API. Esse erro também pode ocorrer se um cliente tiver bloqueado sua empresa de enviar mensagens a ele. |
| 2 | 2018344 | Serviço temporariamente indisponível ToS de privacidade não aceitos – Para usar a API de rótulos da caixa de entrada, você precisa aceitar os ToS de privacidade. Clique no link para aceitar: https://www.facebook.com/100841475479486/inbox/page_contact_tos/ |
O serviço está temporariamente indisponível. O administrador da página precisa aceitar os Termos de Serviço de Privacidade para Etiquetas Personalizadas. |
| 4 | / | Erro de limite de taxa: limite de solicitações do aplicativo atingido. Erro de limite de taxa: muitas solicitações de envio para números de telefone |
Limite de taxa atingido devido a muitas solicitações enviadas para números de telefone ao mesmo tempo. Pause o envio de solicitações até que as atuais fiquem abaixo do limite. |
| 4 | 2018354 | Mensagens de marketing – Deve haver um atraso mínimo entre 2 notificações para a notificação fornecida | A frequência de mensagens de marketing excede o limite definido no campo notification_messages_frequency. Por favor, acompanhe para quais clientes você enviou mensagens de acordo com a cadência acordada para evitar mensagens duplicadas enviadas. |
| 9 | 2018352 | O usuário está realizando muitas ações | O cliente excedeu o limite permitido para solicitações de aceitação de mensagens de marketing |
| 10 | / | Sem permissão para páginas. Associado a jogos instantâneos. | Nenhuma permissão para acessar Páginas associadas a Instant Games. A API de Perfil de Usuário não está disponível para PSIDs vinculados a Instant Game Pages. |
| 10 | 1404170 | O aplicativo não tem permissão para esta ação | O aplicativo não tem permissão para esta ação. Sua Página está temporariamente restrita de enviar solicitações de opt-in de Mensagem de Marketing. |
| 10 | 1893015 | (#10) Este usuário parou de receber mensagens de notificação para este tópico | Este cliente pausou mensagens de notificação para este tópico. Isso pode ocorrer quando sua Página envia uma Mensagem de Marketing após o cliente clicar em "Parar estas mensagens". |
| 10 | 2018336 | Impacto do thread do usuário | Não é possível obter uma resposta válida porque o thread do usuário foi afetado. |
| 10 | 2534022 | Esta mensagem é enviada fora da janela permitida. | Esta mensagem é enviada fora da janela de conversa permitida. Observe que você só pode enviar uma mensagem a um cliente dentro de 24 horas após receber a mensagem do cliente. |
| 10 | 2534077 | Não é possível verificar a conexão entre a conta IG, o usuário logado e a página. Tente reconectar ou verifique se o usuário precisa de autenticação de 2 fatores. | Não foi possível verificar a conexão entre a conta do Instagram, o usuário conectado e a página do Facebook. Tente reconectar a conta ou certifique-se de que o usuário tenha habilitado a autenticação de dois fatores. Você também pode tentar desvincular e realinhar a página do Facebook e a conta do Instagram para resolver esse problema. |
| 10 | 2018278 | Esta mensagem é enviada fora da janela permitida. Saiba mais sobre a nova política aqui | Esta mensagem é enviada fora da janela de conversa permitida. Observe que você só pode enviar uma mensagem a um cliente dentro de 24 horas após receber a mensagem do cliente. |
| 10 | 2018065 | Esta mensagem é enviada fora da janela permitida. Você precisa de permissão de News Messaging para poder fazer isso. | Esta mensagem é enviada fora da janela de conversa permitida. Observe que você só pode enviar uma mensagem a um cliente dentro de 24 horas após receber a mensagem do cliente. |
| 10 | 2018108 | Esta pessoa não pode receber mensagens: Esta pessoa não está recebendo mensagens suas no momento. | Este cliente não pode receber mensagens suas no momento. Tente novamente mais tarde. |
| 100 | / |
Erro de parâmetro inválido: FBID inválido. Erro de parâmetro inválido: Nenhum usuário correspondente encontrado. notification_messages_token é inválido notification_messages_token expirou |
Erro de parâmetro inválido. Isso pode ocorrer devido a FBID inválido, nenhum cliente correspondente encontrado ou notification_messages_token é inválido ou expirou. Certifique-se de que o ID ou token que você está usando seja válido. |
| 100 | 33 | Solicitação get não suportada. O objeto com ID * não existe, não pode ser carregado devido a permissões ausentes ou não suporta esta operação. | A solicitação GET não é suportada. O Objeto com o ID não existe, não pode ser carregado devido a permissões ausentes ou não suporta esta ação. Certifique-se de que o ID em sua solicitação exista e que seu aplicativo tenha as permissões necessárias para acessá-lo. |
| 100 | 2018001 | Nenhum usuário correspondente encontrado | Não foi possível encontrar o cliente correspondente. Verifique e tente novamente. |
| 100 | 2018008 | Falha ao buscar o arquivo da url. Verifique se a URL é válida, com um certificado SSL válido, tamanho de arquivo válido e se o servidor está respondendo rápido o suficiente para evitar timeouts. | Não foi possível buscar o arquivo da URL. Verifique se a URL é válida, com um certificado SSL válido. Certifique-se também de que o arquivo esteja dentro dos limites esperados e que o servidor esteja respondendo rápido o suficiente para evitar timeouts. |
| 100 | 2018014 | Não é possível enviar mensagem e estado ao mesmo tempo. | Você não pode enviar mensagem e estado ao mesmo tempo. Por favor, verifique e tente novamente. |
| 100 | 2018047 | Falha no upload do anexo. Uma maneira comum de disparar esse erro é que o tipo de mídia fornecido não corresponde ao tipo de arquivo fornecido na URL. | Não é possível carregar o anexo. Isso pode ocorrer porque o tipo de mídia fornecido não corresponde ao tipo de arquivo fornecido na URL. |
| 100 | 2018074 | Possível ID inválida ou você não é o proprietário do anexo. | O ID do anexo fornecido pode ser inválido ou você não tem propriedade do anexo. Revise a documentação da API de Upload de Anexos para garantir que você esteja fornecendo o ID correto e tenha as permissões necessárias. |
| 100 | 2018109 | O tamanho do anexo excede o limite permitido | O tamanho do arquivo anexo excede o limite permitido. Verifique e tente novamente. |
| 100 | 2018164 | ID do aplicativo incorreto. | ID do aplicativo incorreto. Verifique e tente novamente. |
| 100 | 2018294 | O upload do vídeo expirou ou o vídeo está corrompido. Observe que se o vídeo não puder ser obtido em 75 segundos, ele expirará. | O upload do vídeo expirou ou o arquivo de vídeo está corrompido. Observe que se o vídeo não puder ser obtido em 75 segundos, o upload expirará. Tente fazer o upload do vídeo novamente e certifique-se de que ele não esteja corrompido. |
| 100 | 2018320 | ID do produto inválido | ID do produto inválido. Certifique-se de que o ID do produto que você está usando em sua Equipe de Produto seja válido e que seu aplicativo tenha permissão para acessá-lo. |
| 100 | 2018328 | O modelo de produto não é compatível com versões anteriores a 8. Use a versão 8 ou superior da API para usar modelos de produto. | O modelo de produto não é compatível com versões anteriores a 8. Use a versão 8 ou superior da API para usar modelos de produto. |
| 100 | 2534013 | A página não está vinculada a uma conta do Instagram | Esta página do Facebook não está vinculada a uma conta do Instagram. O ID da página do Facebook que você usa em suas chamadas de API deve estar vinculado à sua conta do Instagram Professional. |
| 100 | 2534014 | Nenhum usuário do Instagram correspondente | Não foi possível encontrar um usuário do Instagram correspondente para este cliente. Certifique-se de que o ID que você está usando é um ID válido no escopo do Instagram. IDs de usuário do Instagram não são suportados. |
| 100 | 2534015 | Dados de mensagem inválidos | Dados de mensagem inválidos. Certifique-se de que o tipo de dados que você está enviando em sua mensagem é permitido para seu tipo de mensagem. |
| 100 | 2534025 | O comentário é inválido para uma resposta privada | Comentário inválido para uma resposta privada. Certifique-se de que o tipo de dados que você está enviando em sua resposta privada é permitido. |
| 100 | 2534029 | A empresa foi bloqueada de enviar mensagens por meio da API de mensagens do IG | Não é possível enviar mensagem via API de mensagens do Instagram. Certifique-se de que não há nenhuma violação de política que precise ser corrigida antes de poder enviar mensagens usando a plataforma Messenger. |
| 100 | 2534037 | A ação é inválida, pois não é o proprietário do tópico. | Não é possível executar esta ação, pois você não é o proprietário deste tópico de conversa. Certifique-se de que seu aplicativo tenha as permissões e tokens de acesso necessários para gerenciar esta conversa. |
| 190 | Erro de token de acesso: token de acesso OAuth inválido. | Erro de token de acesso. Token de acesso OAuth inválido. | |
| 200 | Erro de permissão: Não é possível enviar mensagens para usuários que não sejam administradores, desenvolvedores ou testadores do aplicativo até que a permissão pages_messaging seja revisada e o aplicativo esteja ativo. | Não é possível enviar mensagens para usuários que não sejam administradores, desenvolvedores ou testadores do aplicativo até que a permissão pages_messaging seja revisada e o aplicativo esteja ativo. | |
| 200 | 1545041 | Mensagem não enviada: Esta pessoa não está disponível no momento. | Sua mensagem não pode ser enviada no momento. O destinatário não está disponível no momento. |
| 200 | 2018021 | Exige que esta página pague uma taxa de acesso de correspondência telefônica, a menos que o usuário destinatário seja um administrador, desenvolvedor ou testador do aplicativo. | A taxa de acesso para correspondência por telefone deve ser paga por esta Página, a menos que o usuário destinatário seja um administrador, desenvolvedor ou testador do aplicativo. |
| 200 | 2018027 | Não é possível enviar mensagens para usuários que não sejam administradores, desenvolvedores ou testadores do aplicativo até que a permissão pages_messaging_phone_number seja revisada e o aplicativo esteja ativo. | Não é possível enviar mensagens para usuários que não sejam administradores, desenvolvedores ou testadores do aplicativo até que a permissão pages_messaging_phone_number seja revisada e o aplicativo esteja ativo. |
| 200 | 2018028 | Não é possível enviar mensagens a usuários que não sejam administradores, desenvolvedores ou testadores do aplicativo até que a permissão pages_messaging seja revisada e o aplicativo esteja ativo. | Não é possível enviar mensagens para usuários que não sejam administradores, desenvolvedores ou testadores do aplicativo até que a permissão pages_messaging seja revisada e o aplicativo esteja ativo. |
| 200 | 2534041 | O proprietário da conta desabilitou o acesso às mensagens diretas do Instagram. | Não é possível acessar o Instagram Direct Messages. Isso pode ocorrer porque o proprietário da conta do Instagram Professional revogou o acesso do seu aplicativo. |
| 551 | Erro de bloqueio de usuário: esta pessoa não está recebendo mensagens suas no momento. | Este usuário bloqueou você, por isso não pode receber mensagens suas neste momento. | |
| 551 | 1545041 | Esta pessoa não está disponível no momento. | Este destinatário não está disponível no momento. Tente novamente mais tarde. |
| 613 | 1893016 | Escopo de serviço excedido: você não pode enviar várias solicitações de opt-in com o mesmo tópico para um usuário. | Você já enviou várias solicitações de opt-in com o mesmo tópico para este usuário. Por favor, informe o usuário que uma solicitação de opt-in já foi enviada para o Messenger. |
| 613 | 2018338 | Aviso! Você está se envolvendo em um comportamento que pode ser considerado incômodo ou abusivo pelos usuários. Você deve diminuir significativamente a taxa em que está enviando mensagens usando tags de mensagem para essa pessoa. O uso indevido adicional dos recursos da API pode resultar em restrições de mensagens sendo colocadas em sua Página | Seu comportamento de mensagens pode ser considerado incômodo ou abusivo pelos usuários. Você deve diminuir significativamente a taxa em que está enviando mensagens usando tags de mensagem para essa pessoa. Mais uso indevido de recursos de API pode resultar em restrições de mensagens sendo colocadas em sua Página. |
| 613 | 2534040 | As chamadas para esta API excederam o limite de taxa. | Limite de taxa de API excedido. Pause as chamadas de API e tente novamente. |
| 2022 | / | A capacidade de enviar mensagens comerciais foi temporariamente desabilitada. Isso é resultado de um limite de recurso colocado após uma violação de política. | O recurso de envio de mensagens comerciais está temporariamente desabilitado. Isso pode ocorrer devido a um limite de recurso colocado após uma violação de política. |
| 10303 | / | Erro de vinculação de conta: account_linking_token inválido. | Token de vinculação de conta inválido |
| 24001 | / | Fluxo de pagamento cancelado pelo usuário | O cliente cancelou o fluxo de pagamento |
| 24002 | / | A solicitação de pagamento não pode ser processada devido à ausência de URL de privacidade | Não é possível processar a solicitação de pagamento porque o URL de privacidade está ausente. |
| 24005 | / | Falha ao obter ID do usuário | Não foi possível obter o ID do usuário para este cliente. Verifique e tente novamente. |
| 36103 | / | Para integrar contas de criadores durante o lançamento gradual do Instagram | Não é possível integrar contas de criadores durante o lançamento em fases do Instagram. Isso pode ocorrer quando o negócio ainda não é elegível. Chame a API de conversação com o token de acesso da página para verificar a elegibilidade. |
| 2018144 | / | Não foi possível enviar mensagem de jogo instantâneo para o usuário neste momento. Apenas 5 notificações podem ser enviadas a um usuário dentro de 10 dias desde a última vez que ele jogou. | Não é possível enviar mensagem de Jogo Instantâneo no momento. Você só pode enviar 5 notificações para um cliente dentro de 10 dias desde a última vez que ele jogou. |
| 2018154 | / | Erro inesperado nas extensões do Messenger | Ocorreu um erro inesperado nas extensões do Messenger |
| 2018163 | / | Erro de validação de parâmetro de compartilhamento inicial | Parâmetro beginShare inválido |
| 2018166 | / | Permissão inválida para chamar a API do SDK | Permissão de chamada de API do SDK inválida |
| 2018171 | / | Disponível apenas para receptores primários e secundários. | Esta ação está disponível apenas para receptores primários e secundários. |
| 2018218 | / | Nenhum perfil disponível para este usuário. | Nenhum perfil disponível para este cliente. A API de Perfil de Usuário não suporta a recuperação de informações de perfil para contas do Messenger que foram criadas usando um número de telefone. Verifique o Documento de Origem: Perfil de Usuário - Informações de Perfil na API de Perfil de Usuário e tente novamente. |
| 2018234 | / | Negar visibilidade de qualquer receptor secundário para outro receptor secundário que não ele mesmo. | Não é possível compartilhar a visibilidade de um receptor secundário com nenhum outro receptor secundário além deles mesmos. |
| 2018247 | / | Permissão insuficiente para acessar o perfil do usuário. | Não é possível acessar o perfil do usuário porque a API do Perfil do Usuário não recebeu permissões para acessar os campos solicitados. |
| 2018300 | / | A mensagem não foi enviada porque outro aplicativo está controlando este tópico agora. | Não é possível enviar mensagem porque há outro aplicativo controlando este tópico no momento |
| 2018321 | / | O chat é controlado atualmente pelo Messenger enquanto o usuário está em um fluxo automatizado de perguntas e respostas. Aguarde o fluxo terminar antes de tentar novamente. | Esta conversa é atualmente controlada pelo Messenger, pois o cliente está em um fluxo automatizado de perguntas e respostas. Aguarde o fluxo terminar antes de tentar novamente. |
| 2071010 | / | Este método SDK não é suportado neste cliente Messenger. Por favor, atualize | Este método SDK não é suportado neste cliente Messenger. Atualize e tente novamente. |
| 2071011 | / | As extensões do Messenger não estão habilitadas – pode ser que "messenger_extensions" não tenha sido definido em uma URL, o domínio não foi adicionado à lista de permissões ou esta é uma versão desatualizada do cliente do Messenger | As extensões do Messenger não estão habilitadas. Isso pode ocorrer porque "messenger_extensions" não foi definido em uma URL, o domínio não foi adicionado à lista de permissões ou esta é uma versão desatualizada do cliente do Messenger. |
| 2071014 | / | MessageContent inválido fornecido para chamada de API do SDK | Não é possível executar a chamada da API do SDK devido ao conteúdo inválido da mensagem fornecida |
| 2071015 | / | Título inválido fornecido no conteúdo da mensagem | Sequência de caracteres de título inválida no conteúdo da mensagem |
| 2071016 | / | Sequência de legenda inválida fornecida no conteúdo da mensagem | Sequência de legenda inválida na mensagem |
| 2071017 | / | URL de imagem inválida fornecida no conteúdo da mensagem | URL de imagem inválida na mensagem |
| 2071018 | / | URL do item inválido fornecido no conteúdo da mensagem | URL do item inválido na mensagem |
| 2071019 | / | Dados de botão inválidos fornecidos no conteúdo da mensagem | Dados de botão inválidos na mensagem |
| 2071020 | / | Dados de URL estão faltando no conteúdo da mensagem. Forneça item_url, button_url ou ambos | A URL é necessária na mensagem. Insira a URL do item, a URL do botão ou ambas. |
| 2071021 | / | sharingType fornecido na chamada beginShareFlow não é válido | SharingType inválido na chamada beginShareFlow |
| 2071022 | / | Anexo inválido no conteúdo da mensagem de fluxo de compartilhamento inicial | Conteúdo da mensagem beginShareFlow em anexo inválido |
| 2071023 | / | O tipo de anexo no conteúdo da mensagem deve ser definido como modelo | O tipo de anexo na sua mensagem deve ser definido como modelo |
| 2071024 | / | A carga útil não é válida no anexo de conteúdo da mensagem | Carga útil inválida anexada na mensagem |
| 2071025 | / | URL de gráfico aberto inválido fornecido no conteúdo da mensagem | URL de gráfico aberto inválido na mensagem |
| 9000001 | / | Esta mensagem foi excluída pelo usuário ou pela empresa. | Esta mensagem é apagada pelo cliente ou pela empresa |