{
"error": {
"message": "<Error Message>",
"type": "<Exception Type>",
"code": <Exception Code>,
"fbtrace_id": "<Trace ID>"
}
}
| Código | Descrição | Soluções possíveis | Código de status HTTP |
|---|---|---|---|
100Parâmetro inválido | A chamada à Graph API que você está fazendo tem um parâmetro inválido. | Os detalhes exatos do erro serão listados na seção error_data da carga de resposta.Se o erro for relacionado à validação de SDP, o problema específico será incluído nos detalhes. | 400Solicitação incorreta |
613O limite da API de Buscar permissão de ligação para número de telefone do consumidor foi atingido | Limite atingido para solicitações à API de status de permissão de ligação busca. | Tente novamente mais tarde ou reduza a frequência ou a quantidade de solicitações à API que o app está fazendo. | 429Número excessivo de solicitações |
131009 | O tipo de mensagem interativa, voice_call não é compatível. Tipos compatíveis [button, list] | Verifique se o remetente está em um dos países compatíveis. | 400Solicitação incorreta |
131030 | O número de telefone do destinatário não está na lista de permissão. O erro é gerado para tentativas de ligações e solicitações de permissão de ligação. Isso só acontece quando você usa números de teste público (PTNs). | Adicione um número de telefone do destinatário à lista de destinatários e tente novamente. | 400Solicitação incorreta |
138000Ligações não habilitadas | As APIs de Ligações não estão habilitadas para esse número de telefone. | As ligações não estão habilitadas no número de telefone comercial. | 401Não autorizado |
138001Não é possível ligar para o destinatário | O destinatário não consegue receber ligações. Os motivos podem ser os seguintes:
| Verifique com o destinatário se ele permitiu que você entre em contato com ele por WhatsApp e está usando a versão mais recente do app. | 400Solicitação incorreta |
138002Limite de ligações simultâneas | Limite atingido para o máximo de ligações simultâneas (1.000) para o número fornecido. | Tente novamente mais tarde ou reduza a frequência ou a quantidade de chamadas à API que o app está fazendo. | 429Número excessivo de solicitações |
138003Ligação duplicada | Uma ligação já está em andamento com o destinatário. | Tente novamente quando a chamada em ligação for encerrada. | 400Solicitação incorreta |
138004Erro de conexão | Erro ao conectar a ligação | Tente novamente mais tarde ou investigue os parâmetros de conexão fornecidos à API. | 500Erro no servidor |
138005Limite de taxas de ligações excedido | O limite de ligações que podem ser iniciadas pelo número de telefone comercial foi atingido. | Tente novamente mais tarde ou reduza a frequência ou a quantidade de chamadas à API que o app está fazendo. | 429Número excessivo de solicitações |
138006Nenhuma permissão de ligação aprovada encontrada | Nenhuma permissão de ligação aprovada do destinatário | Verifique se o consumidor aceitou a permissão de ligação. | 401Não autorizado |
138007Erro de tempo limite de conexão | Não foi possível completar a ligação devido ao tempo limite. | A empresa não aplicou a oferta/resposta SDP da API de Nuvem a tempo. A API de Conexão não foi invocada com o SDP de resposta a tempo. | 500Erro no servidor |
138009O limite de solicitações de permissão de ligação foi atingido | O limite de envios de solicitações de permissão de ligação foi atingido para o par de empresas e consumidor fornecido. | Quando uma empresa envia mais solicitações de permissão de ligação do que o limite permitido por período, essas solicitações são submetidas à limitação de volume. Uma ligação conectada com um consumidor redefinirá os limites. | 400Solicitação incorreta |
138012O limite de ligações iniciadas pela empresa foi atingido | O limite máximo de ligações iniciadas pela empresa em 24 horas foi atingido. No momento, cinco ligações iniciadas pela empresa conectada são permitidas em 24 horas. | Os detalhes exatos do erro serão listados na seção error_data da carga de resposta.Esses detalhes incluirão um registro de data e hora de quando a próxima ligação for permitida. | 400Solicitação incorreta |
138013As ligações iniciadas pela empresa não estão disponíveis. | Não é possível fazer ligações iniciadas pela empresa usando esse número de telefone comercial. | Confirme se as ligações iniciadas pela empresa estão disponíveis para este número de telefone comercial na seção Disponibilidade aqui. | 400Solicitação incorreta |
138014As ligações estão temporariamente desabilitadas | As APIs de Ligações desse número do WhatsApp Business foram temporariamente desabilitadas por apresentarem baixa qualidade. | Garanta que seu contato com os usuários seja relevante e não spam. Tente realizar a ação novamente depois que as restrições da conta forem suspensas. | 400Solicitação incorreta |
138015Não é possível habilitar as ligações | As APIs de Ligações não podem ser habilitadas para esse número de telefone. | Verifique se o limite de mensagens do seu número de telefone é igual ou superior a 2 mil. | 400Solicitação incorreta |
138017Não é possível enviar o pedido de permissão para ligação porque já existe uma permissão permanente. | Não é possível enviar o pedido de permissão para ligação porque o usuário já aprovou uma permissão permanente para o número de telefone da conta comercial. | Não é necessário enviar pedidos de permissão para ligação. | 400Solicitação incorreta |
138018Não é possível habilitar as ligações do WhatsApp Business porque os pré-requisitos técnicos não foram atendidos. | Consulte pré-requisitos para saber mais. | Configure o SIP ou verifique se existe pelo menos um app inscrito na conta do WhatsApp Business que também tenha assinatura do campo calls do webhook. | 400Solicitação incorreta |
138019Falha na configuração da ligação | O cliente do WhatsApp não conseguiu configurar a ligação. Esse erro é enviado no webhook de encerramento da ligação. | Tente novamente mais tarde. | 400Solicitação incorreta |
138020Falha na conexão de retransmissão | O cliente do WhatsApp não estabeleceu uma conexão com o servidor de retransmissão. Esse erro é enviado no webhook de encerramento da ligação. | Tente novamente mais tarde. | 400Solicitação incorreta |
138021Tempo limite de recebimento de mídia | O cliente do WhatsApp encerrou a ligação porque não recebeu mídia por um longo período. Esse erro é enviado no webhook de encerramento da ligação. | Verifique se a mídia da ligação está sendo enviada para o servidor de retransmissão e tente novamente. | 400Solicitação incorreta |
138022Tempo limite de transmissão de mídia | O cliente do WhatsApp encerrou a ligação porque não transmitiu mídia por um longo período. Esse erro é enviado no webhook de encerramento da ligação. | Tente novamente mais tarde. | 400Solicitação incorreta |
138023Ligação aceita, mas encerrada sem sinais de mídia | A ligação foi aceita, mas encerrada sem sinal de conexão de mídia. A API de Nuvem não conseguiu determinar se a ligação foi conectada. Esse erro é enviado no webhook de encerramento da ligação. | Tente novamente mais tarde. | 400Solicitação incorreta |
131044 | Um webhook de erro é enviado em ligações iniciadas pelo usuário quando não há nenhuma forma de pagamento válida anexada. | Isso é semelhante ao erro “Problema de pagamento referente à qualificação da empresa” em mensagens. | 400Solicitação incorreta |
131055 | Método não permitido. As chamadas à Graph API não são permitidas para números habilitados para SIP. | Use SIP para números comerciais habilitados para SIP. | 400Solicitação incorreta |
| Origem da ligação | Erro | Descrição | Soluções possíveis |
|---|---|---|---|
Iniciadas pela empresa | O servidor de SIP foo.com do INVITE não corresponde a nenhum servidor de SIP configurado para a identificação de número de telefone [ID] | Seu SIP INVITE (convite SIP) para a Meta tem "foo.com" no cabeçalho From (por exemplo, 15555551234@foo.com). Entretanto, não há servidor SIP com esse nome de host configurado no número de telefone comercial. | Verifique a configuração do SIP e confirme que ela corresponde ao domínio usado no cabeçalho From. O hostname na configuração do SIP deve corresponder ao domínio no cabeçalho From do seu SIP INVITE. Também é válido que a configuração de SIP hostname seja um subdomínio do domínio no cabeçalho From. Por exemplo: o servidor de SIP configurado é bar.foo.com, e o cabeçalho De é 15555551234@foo.com. |
Iniciadas pela empresa | Nenhuma permissão de ligação aprovada encontrada: nenhuma permissão de ligação aprovada do destinatário | As empresas precisam da permissão do usuário do WhatsApp para poderem fazer uma ligação | Há várias maneiras de obter a permissão do usuário. Para mais informações, consulte Obter permissões de ligação do usuário . |
Iniciadas pela empresa | O app [APP_ID] configurado para o servidor de SIP example.com não está autorizado para a identificação de número de telefone [ID] | Quando você configura o servidor de SIP em um telefone comercial, extraímos a identificação do app do token de acesso e armazenamos um mapeamento do servidor de SIP para essa identificação do app. Quando você envia um SIP INVITE, consultamos esse mapeamento para saber qual app está fazendo a solicitação. Esse erro significa que o app não tem permissão whatsapp_business_messaging no telefone comercial. | Verifique se você está usando o app certo e confira se ele tem permissões no telefone comercial. Se você conseguir enviar uma mensagem usando o token de acesso do app, isso significa que o app tem a permissão certa. Caso contrário, pode ser necessário excluir e adicionar o servidor de SIP com o app correto e tentar fazer novamente o SIP INVITE. Consulte Como configurar as definições do SIP. |
Iniciadas pela empresa | O limite diário de ligações iniciadas pela empresa conectada foi atingido | O limite máximo de ligações iniciadas pela empresa em 24 horas foi atingido. No momento, cinco ligações iniciadas pela empresa conectada são permitidas em 24 horas. | Saiba mais sobre os limites e ajuste sua taxa de ligações de acordo. |
| Problema | Descrição | Soluções possíveis |
|---|---|---|
A ligação é encerrada após 20 segundos | No início da ligação, se não houver mídia fluindo da empresa para o usuário do WhatsApp por 20 segundos, o cliente do WhatsApp desconectará a ligação devido à falta de mídia |
|
Não é possível ouvir o áudio, e a ligação é encerrada após 30 segundos | Depois que a ligação for conectada e estabelecida, se não houver um pacote de mídia da empresa para o usuário do WhatsApp por 30 segundos, o cliente do WhatsApp desconectará a ligação devido à falta de recepção de mídia |
|
(Clique com o botão direito do mouse na imagem e escolha "Abrir em uma nova aba" para ampliar a imagem)