API Local da Plataforma do WhatsApp Business

WhatsApp Business Platform > On-Premises API

A API Local está sendo descontinuada. Consulte o documento Descontinuação da API Local para ver mais informações e saber como migrar para nossa API de Nuvem de última geração.

Mensagens de erro e status

Este documento fornece mais informações sobre os seguintes tipos de mensagens de erro e status:

Códigos de erro do cliente da WhatsApp Business API
Códigos de status HTTP

Para resolução de problemas de cadastro incorporado, acesse Erros de fluxo de cadastro incorporado.

Códigos de erro do cliente da WhatsApp Business API

Código de erro	Descrição
`400` – Erro de download de mídia	Falha ao baixar a mídia do remetente.
`402` – Elegibilidade da empresa (problema de pagamento)	Falha ao enviar mensagem devido a um ou mais erros relacionados à forma de pagamento. A conta de pagamento não está associada a uma conta do WhatsApp. A linha de crédito está acima do limite. A linha de crédito (conta de pagamento) não foi definida nem ativada. A conta empresarial do WhatsApp foi excluída. A conta foi suspensa pela nossa equipe. O fuso horário não foi definido. A moeda não foi definida. A solicitação MessagingFor – On Behalf Of (OBO) – está pendente ou foi recusada. Limite do nível gratuito de conversa excedido sem forma de pagamento válida. (Esse tipo de erro entrará em vigor em 1º de fevereiro de 2022). Verifique a configuração de pagamento no Gerenciador do WhatsApp e tente novamente.
`408` – A mensagem não é válida	Falha ao enviar a mensagem porque ela ficou pendente por muito tempo (por exemplo, mais de 1 dia). Isso pode acontecer ao reiniciar o cliente da WhatsApp Business API após mais de um dia de inatividade. Envie a mensagem novamente.
`410` – Mensagem expirada	Mensagem não enviada durante seu TTL (tempo de vida).
`429` – Limite de taxa atingido	Para mensagens enviadas: falha ao enviar a mensagem porque o número de telefone fez envios demais em um curto período. Envie as mensagens com falha novamente. Para mensagens de entrada: falha ao baixar a mídia devido à limitação de volume. Solicite ao remetente que envie a mensagem novamente.
`430` – Certificado não assinado	Falha ao enviar a mensagem porque ocorreu um erro relacionado ao certificado. Baixe o novo certificado no Gerenciador do WhatsApp e faça o registro novamente.
`432` – Incompatibilidade na identificação do certificado	Falha ao enviar a mensagem porque ocorreu um erro relacionado ao certificado. Baixe o novo certificado no Gerenciador do WhatsApp e faça o registro novamente.
`433` – Assinatura de certificado inválida	Ocorre quando uma mensagem é enviada, mas o certificado do cliente da empresa não está assinado de forma adequada com as chaves de identidade correspondentes. Isso indica que o cliente provavelmente refez o cadastro com chaves de identidade novas, mas não concluiu todo o fluxo de criação do certificado.
`470` – Mensagem de reengajamento	Falha ao enviar a mensagem porque mais de 24 horas se passaram desde a última vez que o cliente respondeu a este número. Use um modelo de mensagem para responder.
`471` – Limite de taxa de spam atingido	Falha ao enviar a mensagem porque há um limite de envios que podem ser feitos deste número de telefone. É possível que muitas mensagens anteriores tenham sido bloqueadas ou marcadas como spam. Verifique seu status de qualidade no Gerenciador do WhatsApp. Consulte a documentação sobre limites de volume com base em qualidade para obter mais informações.
`472` – O número do usuário faz parte de um experimento	Falha ao enviar a mensagem porque o número de telefone do usuário faz parte de um experimento. Não envie mensagens a esse usuário.
`480` – Possível mudança de usuário	Falha ao enviar a mensagem devido a uma possível alteração no número de telefone do usuário.
`500` – Erro genérico	Falha ao enviar a mensagem devido a um erro desconhecido. Tente novamente mais tarde.
`501` – O tipo de mensagem não é aceito no momento.	Atualmente, as mensagens de documentos com legendas não são compatíveis.
`1000` – Erro genérico
`1001` – Mensagem muito longa	O tamanho da mensagem é superior a 4.096 caracteres.
`1002` – Tipo de destinatário inválido	Tipos de destinatário válidos: `individual`
`1004` – Recurso já existente	Possível conflito de UUID para solicitações de carregamento de mídia ou UUID já existente atribuído a outra mídia.
`1005` – Acesso negado	Você está tentando registrar um número de telefone comercial para uso com a API Local, o que não é mais permitido. Consulte Descontinuação da API Local. O diretório de mídia não é gravável (solicitação de carregamento). As credenciais são inválidas. Há um erro de certificado. O app expirou e é necessário atualizar a versão. As mensagens de `button` estão desabilitadas para essa conta. O número já está cadastrado no WhatsApp. Consulte Migrar números de telefone para mais informações sobre a transferência de um número do WhatsApp para a WhatsApp Business API. Se a sua empresa envia mensagens comerciais na Índia, verifique se você preencheu todos os campos obrigatórios do perfil comercial e do item. Para saber mais, consulte https://www.facebook.com/business/help/1104628230079278.
`1006` – Recurso não encontrado	Arquivo ou recurso não encontrado.
`1007` – Destinatário bloqueado para receber mensagens (obsoleto)	O destinatário não está na lista de permissão.
`1008` – Parâmetro obrigatório ausente	Um parâmetro obrigatório está ausente. Ao enviar uma mensagem de lista, talvez você tenha ignorado a parte `title` do objeto `section` ou os `ID`s das `rows`. Se estiver tentando enviar uma mensagem de produto único ou multiproduto, talvez você tenha ignorado o `catalog_id` ou o `product_retailer_id`. Os dois campos são obrigatórios para esse tipo de mensagem.
`1009` – Valor do parâmetro inválido	O valor inserido para um parâmetro não é do tipo correto ou há outro problema. Se estiver tentando enviar uma mensagem de lista, verifique se o ID de cada linha é único. Se estiver tentando enviar uma mensagem de produto único, talvez você tenha enviado o `catalog_id` errado. Volte ao Gerenciador de Comércio e verifique novamente. Se estiver tentando enviar uma mensagem multiproduto, verifique se o `product_retailer_id` é diferente para cada seção. Além disso, verifique se os objetos `header` e `body` estão presentes e têm um valor atribuído.
`1010` – Parâmetro não obrigatório	Contém um parâmetro que não é obrigatório.
`1011` – O serviço não está pronto
`1013` – O usuário não é válido
`1014` – Erro interno	Falha no carregamento com imagem incorreta (imagem não carregada corretamente) ou ponto de extremidade não encontrado O hash fornecido não corresponde ao hash mais recente do usuário.
`1015` – Número excessivo de solicitações	O limite de taxa do cliente foi atingido.
`1016` – Sobrecarga do sistema	Se o sistema receber carga muito intensa, esse erro é retornado para permitir a recuperação do sistema.
`1017` – Mestre não primário	Esse erro ocorre quando uma solicitação somente de nível mestre (como definir ou obter configurações, importar, exportar, solicitar código, registrar, entre outros) é enviada a um nó que não é um mestre primário. Isso poderá acontecer caso o cliente da WhatsApp Business API não esteja configurado corretamente ou se houver erros internos. Em geral, refazer a solicitação corrigirá o erro. Se o problema persistir, entre em contato com o suporte.
`1018` – Coreapp não primário	Esse erro ocorre quando solicitações são enviadas a um nó do Coreapp que não é proprietário do fragmento nem está em vias de se tornar o proprietário. Você poderá ver esse erro quando estivermos fazendo failover de fragmento na configuração de multiconexão. Na maioria das vezes, refazer a solicitação corrigirá o erro. Caso contrário, entre em contato com o suporte.
`1021` – Usuário incorreto	Esse erro ocorre quando um usuário envia uma mensagem para si mesmo. Para corrigir o problema, envie a mensagem para outro número.
`1022` – URL de webhooks não configurado	Esse erro ocorrerá se o formato de webhooks da API de REST não for configurado.
`1023` – Erro de banco de dados
`1024` – Alteração de senha solicitada	É necessário alterar a senha.
`1025` – Solicitação inválida	A solicitação não é válida.
`1026` – Destinatário indisponível	Mensagem não entregue. Consulte "Por que minha taxa de entrega não é de 100%?". Perguntas frequentes.
`1028` – A notificação de sistema do tipo `user_identity_changed` exige confirmação	Você enviou uma mensagem a um usuário do WhatsApp que pode ter sido alterado. Uma notificação `user_identity_changed` do sistema foi enviada a você e aguarda confirmação.
`1031` – A conta do remetente está bloqueada	Sua conta foi bloqueada e não poderá enviar mensagens devido a uma violação da política de integridade. Consulte Aplicação da Política da Plataforma do WhatsApp Business para saber mais.
`2000` – Incompatibilidade na contagem de parâmetros do modelo	O número de parâmetros fornecidos não corresponde à quantidade esperada.
`2001` – Modelo ausente	O modelo não está com status de ativo ou não existe para um idioma e local.
`2002` – Falha na busca do modelo	O destinatário falhou ao baixar o modelo.
`2003` – Pacote de modelos ausente	Não há modelos para determinado idioma e localidade.
`2004` – Parâmetro do modelo longo demais	O parâmetro é longo demais.
`2005` – Texto hidratado do modelo longo demais	O texto traduzido é longo demais.
`2006` – Política de espaço em branco do modelo violada	A política de espaço em branco foi violada.
`2007` – Política de caracteres do formato do modelo violada	A política de caracteres do formato foi violada.
`2008` – Formato de mídia do modelo incompatível	O formato de mídia usado não é compatível.
`2009` – Componente obrigatório do modelo ausente	Um componente obrigatório do modelo não está presente.
`2010` – URL hidratado do modelo inválido	O URL no componente de botão não é válido.
`2011` – Número de telefone do modelo inválido	O número de telefone no componente de botão não é válido.
`2012` – Incompatibilidade no formato do parâmetro do modelo	O formato do parâmetro não corresponde ao do modelo criado.
`2013` – Botões do modelo incompatíveis	Os botões não são aceitos pelo destinatário.
`2014` – O namespace esperado está vazio	Esse erro ocorre quando o pacote de idiomas de um modelo de mensagem ainda não foi baixado.
`2015` – Número de seções inválido	O número de seções da solicitação de mensagem está abaixo ou acima do limite permitido. Consulte o objeto `section` para mais informações. É necessário ter no mínimo 1 objeto `section` e no máximo 10.
`2016` – Número de linhas inválido	O número de linhas não é válido. Para mensagens de lista, deve haver no mínimo um objeto `rows` por `section`.
`2017` – Política de caracteres violada	A política de caracteres do formato foi violada.
`2023` – Número inválido de produto	O objeto da seção não tem produtos ou a contagem total de produtos ultrapassou o número máximo permitido.
`2024` – Identificação de catálogo não encontrada	A identificação do catálogo fornecida não existe ou não pertence à sua conta do WhatsApp Business (WABA, pela sigla em inglês).
`2025` – Identificação de catálogo não vinculada ao número da API	A identificação de catálogo que você forneceu não está vinculada ao número de telefone usado para enviar mensagens.
`2026` – Produtos não encontrados	Alguns produtos fornecidos na sua solicitação não foram encontrados no catálogo.
`2027` – Nenhum produto encontrado	Nenhum produto foi encontrado no catálogo fornecido.
`2028` – Lista de todos os produtos com falha de conformidade	Disponível apenas para empresas na Índia. Esse erro é retornado quando uma empresa envia uma mensagem de produto único com informações de conformidade ausentes ou incompletas.
`2029` – Lista de alguns produtos com falha de conformidade	Disponível apenas para empresas na Índia. Esse erro é retornado quando uma empresa envia uma mensagem multiproduto com informações de conformidade ausentes ou incompletas.
`2030` – Lista que combina produtos inválidos e com falha de conformidade	Disponível apenas para empresas na Índia. Esse erro é retornado quando uma empresa envia uma mensagem multiproduto em que há tanto produtos inválidos quanto produtos com informações de conformidade ausentes.
`2036` – Estrutura de cabeçalho inválida	Esse erro é retornado quando a estrutura do objeto `header` é inválida.
`2050` – Informação de conformidade ausente	Disponível apenas para empresas na Índia. Esse erro é retornado quando uma empresa não fornece informações de conformidade. Veja o ponto de extremidade de conformidade da empresa.
`2060` – Modelo rejeitado	O status do modelo é `REJECTED`. Portanto, ele não pode ser enviado.
`2061` – Modelo em pausa	O status do modelo é `PAUSED`. Portanto, ele não pode ser enviado.
`2062` – Modelo desabilitado	O status do modelo é `DISABLED`. Portanto, ele não pode ser enviado.
`2064` – ID do Fluxo inválido	O fluxo com ID especificado não existe, não pertence à sua conta do WhatsApp Business ou está em estado inválido.
`2065` – Fluxo com versão inválida da mensagem	A versão da mensagem do fluxo é inválida. Veja a versão compatível atualmente no registro de alterações de fluxos.
`2066` – Fluxo com modo inválido	Retornado quando um fluxo no estado `DRAFT` é enviado com a especificação do modo rascunho ou quando um fluxo `PUBLISHED` é enviado com o modo rascunho.
`2067` – Fluxo com modo RASCUNHO não permitido	Não foi possível enviar o fluxo no modo `DRAFT`. Verifique a página de status para analisar erros em andamento e, se o problema persistir, entre em contato com o suporte.
`2068` – Fluxo bloqueado	O fluxo está no estado bloqueado. Este erro também poderá ser retornado se o fluxo usar um ponto de extremidade e a configuração necessária estiver incompleta. Por exemplo, a chave pública não foi carregada ou não é mais válida. Consulte Implementing Endpoint for Flows.
`2069` – Fluxo limitado	O fluxo está no estado limitado, e 10 mensagens usando esse fluxo já foram enviadas na última hora.
`2070` – Fluxo com versão inválida	A versão do fluxo é inválida ou expirou. Veja as versões compatíveis atualmente no registro de alterações de fluxos.

No caso de códigos de erro do Gerenciador de Comércio específicos para empresas indianas, consulte a Central de Ajuda para Empresas.

Códigos de status HTTP

Há códigos de status HTTP que podem ser usados pelo cliente da WhatsApp Business API.

Código HTTP	Descrição
`2xx`	Sucesso
`200`	Sucesso (OK)
`201`	Criado com sucesso (para solicitações POST)
`302`	Encontrado
`4xx`	Erros de cliente
`400`	Solicitação inválida
`401`	Não autorizado
`403`	Proibido
`404`	Não encontrado
`405`	Método não permitido
`412`	Falha na pré-condição
`420`	A mensagem possui limite de taxa
`429`	Número excessivo de solicitações
`5xx`	Erros de servidor
`500`	Erro de servidor interno
`504`	Tempo-limite

Plataforma do WhatsApp Business | API de Nuvem | API Local | API de Gerenciamento do WhatsApp Business