Como corrigir erros comuns?
Este erro é acionado sempre que o fluxo tenta enviar uma sequência para um contato que cancelou a inscrição no canal.
Este erro é acionado sempre que o fluxo tenta enviar uma sequência para um contato que cancelou a inscrição no canal.
O contato precisa se inscrever novamente para voltar a receber as sequências.
Depois que o contato se inscrever novamente, use a ação Inscrever-se na sequência, em Ações básicas, para reinscrevê-lo, conforme a captura de tela abaixo:
Ou vá para “Contatos”, selecione os contatos e, no menu suspenso “Ação em massa”, escolha “Inscrever-se na sequência”.
Para o campo personalizado do contato, o limite máximo de armazenamento é de 20.000 caracteres. Para resolver o problema, reduza o número de caracteres que você está tentando salvar.
Se você estiver salvando o valor vindo de webhooks de entrada ou das nossas ações de integração internas, use o pré-processamento de dados para restringir o valor que quer salvar.
Você encontra o pré-processamento de dados na configuração do webhook de entrada, como abaixo:
Você também encontra o pré-processamento de dados na solicitação externa, conforme a captura de tela abaixo:
Observe que você pode precisar de conhecimentos de desenvolvedor para usar o recurso de pré-processamento de dados acima.
Este erro geralmente é acionado por uma ação de integração da OpenAI. O tempo limite padrão da OpenAI é de 30 segundos; passado esse tempo, os servidores do NicoChat encerram a espera. Se o servidor atingir o tempo limite antes de receber uma resposta da OpenAI, este erro é registrado.
Para reduzir as chances de esse erro ocorrer, reduza o histórico da conversa ou otimize os prompts e as mensagens de sistema, para que a solicitação demore menos para ser executada. Você também pode dividir um histórico de conversa maior em partes menores e usar um sistema de detecção de intenções como alternativa. Para mais informações, consulte o vídeo:
O NicoChat também oferece um complemento para aumentar esse limite: o Timeout Extra, contratado por canal, sobe o tempo de execução e, junto, os limites de pontuação e de etapas. Veja o detalhe em Complementos.
Este erro geralmente ocorre quando você tenta integrar o seu banco de dados ao NicoChat. A conexão é estabelecida, mas o NicoChat não consegue verificá-la. Na maioria dos casos, o motivo são credenciais incorretas. Há casos em que o IP não está na lista de permissões e, por isso, a conexão não se estabelece.
Este erro é acionado sempre que você tenta enviar uma notificação e o corpo/conteúdo da notificação está vazio.
Para resolver, certifique-se de que o corpo da notificação não esteja em branco. Se o corpo usar um campo personalizado, verifique no contato se esse campo foi preenchido corretamente.
Este erro ocorre porque o contato cancelou a inscrição no seu canal no momento do envio do disparo.
Se não quiser ver o erro, adicione condições ao fluxo do disparo e envie apenas para os contatos inscritos no seu canal.
E você também pode optar por excluir o contato não inscrito, para manter no seu chatbot apenas os contatos engajados.
Você pode criar o gatilho na automação “Contato desinscreveu” e acionar um fluxo com a ação “excluir usuário” dentro.
A nossa plataforma também tem um recurso de limpeza automática. Você encontra as configurações em “Configurações” -> Geral -> Limpeza automática de usuários de bot (somente o proprietário vê esta configuração).
Este erro é acionado quando você tenta usar uma ação da OpenAI, mas a workspace ainda não está integrada à OpenAI.
Para integrar a OpenAI, clique em “Integração” no painel da sua workspace, procure OpenAI na aba Inteligência Artificial e insira a sua Chave API da OpenAI.
Clique em Salvar e confirme que a conexão aparece como “Verificada”.
Observação: o ID da organização é opcional; você pode deixá-lo vazio.
Você pode consultar o vídeo abaixo para mais orientações:
Este erro é acionado quando você tenta usar uma ação do Planilhas Google e nenhuma planilha está selecionada.
Também pode haver vários outros motivos. Isso pode acontecer se você instalar um modelo e a planilha do Google não tiver sido copiada para a sua conta.
Isso pode acontecer se a sua workspace ainda não tiver o Planilhas Google integrado — nesse caso, a instalação do modelo não consegue instalar na sua conta uma cópia da planilha usada.
Certifique-se de conectar a sua conta do Google em Integração -> Armazenamento de dados/arquivos e de selecionar a planilha correta na ação do Planilhas Google.
Este erro é acionado quando você tenta usar uma ação disponível apenas no plano Pro. Para usar essas ações, você terá que migrar a sua workspace do plano gratuito para um plano pago. Veja mais em 💳Seu Plano
Este erro é acionado quando você usa a ação de solicitação externa e a chamada da API externa não retorna resposta em 15 segundos.
Os servidores do NicoChat encerram a espera após 15 segundos. A solução é garantir que a chamada da API termine dentro de 15 segundos. Se quiser aumentar esse limite, entre em contato com o suporte para adquiri-lo.
Observação: você pode tratar esse erro no seu fluxo usando o código de resposta “0”.
Se não conseguir otimizar o tempo de resposta, você pode contratar o complemento de Timeout Extra para o canal — cada bloco acrescenta 10 segundos ao tempo de execução. Veja em Complementos.
Este erro é acionado sempre que o fluxo tenta enviar uma mensagem para um contato que não está mais inscrito no canal.
Você pode usar a ação “opt-in” no construtor de fluxo, em Ações → Ações básicas. Também é possível reinscrever os contatos com a ação “Inscrever-se no bot”, em Ações básicas.
A plataforma tem um limite de no máximo 100 inscrições em sequência. Se você inscrever o contato na sequência mais de 100 vezes, receberá este erro.
Você precisará otimizar a ação “inscrever-se na sequência” do seu fluxo.
Isso costuma acontecer quando você está testando fluxos ou quando há um loop infinito em algum ponto do desenho do fluxo. Normalmente o limite é suficiente para as automações do chatbot. Verifique a lógica do seu fluxo para corrigir o problema.
Este erro é acionado quando você tenta usar uma ação do Planilhas Google e ele não está integrado à sua workspace. Certifique-se de conceder todas as permissões pedidas ao conectar a sua conta do Planilhas Google.
Este erro significa que você atingiu o limite de contatos do seu plano. Por isso, as automações não continuam.
Você precisará excluir contatos manualmente ou configurar regras de exclusão automática no Canal: vá em Configurações, depois “Geral”, e configure “limites de usuários de bot” e “Limpeza automática de usuários de bot”.
Observe que os limites de usuários de bot e as configurações de limpeza estão disponíveis apenas para o proprietário da workspace. Você também pode migrar para um plano superior, que tem limites maiores de contatos.
Este erro geralmente é acionado quando um disparo está sendo enviado ou quando você tem um tráfego alto de conversas ao vivo e o seu canal chega a 100 erros a cada 5 minutos.
O disparo será pausado temporariamente.
O NicoChat continua contando as mensagens de erro a cada 5 minutos. Se você tiver menos erros que os nossos limites, o disparo ou o canal são retomados.
Para resolver este erro, otimize o seu fluxo para tratar os erros.
Você pode abrir o seu canal e acessar “Ferramentas” -> Logs de erros. Se clicar em “Nó” nos logs de erros, você será redirecionado para os fluxos e poderá verificar e otimizar o fluxo.
Observação: se você estiver usando o recurso de limites de taxa, este erro também será registrado quando você exceder esses limites.
Assista a este vídeo para saber mais:
Este erro é acionado sempre que não há um bloco de interação do contato por 40 segundos.
Por padrão, o NicoChat oferece um tempo máximo de execução de 40 segundos. Ou seja, quando um nó de pergunta (que conta como interação do contato) é acionado, a partir daquele ponto o NicoChat avança com a lógica do fluxo por no máximo 40 segundos. Você precisará de outra interação do contato (bloco de perguntas) dentro desses 40 segundos; caso contrário, verá este erro.
Alguns exemplos de ações de interação do contato:
- Nó de pergunta - fazer perguntas
- Clicar em botões ou respostas rápidas
- O contato responder ao seu chatbot
Observe que, se você usar uma ação de solicitação externa ou uma ação da OpenAI, o tempo de resposta do serviço externo também entra na conta do tempo limite.
A solução é acrescentar mais interações do contato ao fluxo do chatbot. Cada interação do contato reinicia a contagem do tempo máximo de execução.
Além disso, você pode contratar o complemento de Timeout Extra, que sobe o tempo máximo de execução em 10 segundos por bloco contratado. Veja em Complementos.
Observe que o complemento é por canal. Entre em contato com o suporte do NicoChat assim que o pagamento for feito e informe no e-mail o ID da workspace e o nome do canal.
Nos desenhos de fluxo do NicoChat, cada nó conta como uma etapa.
Não importa quantas ações você usa nesse nó: entre uma interação do contato e a seguinte, você não pode ter mais de 30 etapas. Isso inclui os fluxos em segundo plano ou paralelos que forem acionados.
Alguns exemplos de ações de interação do contato:
- Nó de pergunta - fazer perguntas
- Clicar em botões ou respostas rápidas
- O contato responder ao seu chatbot
Para resolver este erro, tente otimizar a lógica do seu fluxo (dividindo automações maiores em fluxos pequenos, por exemplo) e evite loops sem fim.
Se você estiver usando o “elemento cartão” no bloco de envio de mensagem, precisa garantir que o título do cartão tenha valor.
Se você usar no título do cartão uma variável de campo personalizado do contato, precisa garantir que a variável tenha valor. Para verificar, abra a visão geral de contatos e selecione o contato para o qual o erro foi acionado. Confirme que o campo personalizado usado no título do cartão tem algum valor. Se não tiver, significa que há um problema em alguma etapa anterior a este nó, que você precisa investigar.
Caso contrário, você verá o erro. Se usar um campo personalizado do contato no título do cartão, você pode fazer uma verificação de condição antes de enviar o cartão e notificar o administrador se houver algum problema desse tipo.
O nosso faturamento funciona assim. Imagine que você contratou um plano de R$300 e a fatura foi gerada na hora.
Algum tempo depois, você decide migrar para um plano de R$500.
O que acontece a partir daí é:
- O tempo que você ainda não usou do plano atual é calculado proporcionalmente.
- Esse valor vira um desconto, não um reembolso.
- O desconto entra na primeira fatura do plano novo.
- Você paga a diferença: o preço do plano novo menos o crédito proporcional do plano anterior.
Um exemplo: num plano de R$300 com 30 dias, o dia sai por R$10. Se sobram 5 dias não usados, o desconto é de R$50 e a primeira fatura do plano de R$500 fica em R$450.
O mesmo vale para planos anuais: o tempo não usado entra como desconto proporcional na primeira anuidade do plano novo.
Você não conseguirá ver o crédito no painel do NicoChat.
Cada contato pode acionar no máximo 100 ações de atraso inteligente. Inspecione e ajuste o nó que está causando o problema para evitar um loop infinito que dispara ações de atraso inteligente, garantindo o cumprimento do limite de 100 ações por contato em 24 horas.
Causas Possíveis:
O erro ocorre quando o contato recebeu o máximo permitido de 100 ações de atraso inteligente em 24 horas, possivelmente por causa de um loop infinito acionado no seu fluxo.
Soluções possíveis:
Para resolver, inspecione o nó específico do seu fluxo que está causando o erro e verifique se você não montou uma automação em loop infinito.
Você também pode usar o “digitando” ou a “espera” para tempos menores que 10 segundos:
Ajuste a lógica da automação para evitar o disparo contínuo de ações de atraso inteligente e garantir que o limite de 100 ações não seja ultrapassado. Isso envolve ajustar o fluxo para evitar loops repetitivos ou infinitos que possam levar a ultrapassar o limite de ações de atraso inteligente.
Esses erros aparecem principalmente em canais como o WhatsApp, onde não existe o recurso de digitação. Atualizamos o nosso bloco de digitação para convertê-lo automaticamente em um atraso de espera quando o canal não suporta digitação. Assim você não precisa mais usar o atraso inteligente e o problema fica resolvido.
Erro: “Upload failed. You have reached the limit of storage size(1GB). Connect to your S3 storage to continue upload”
Permitimos 1 GB de armazenamento gratuito para os arquivos enviados. Se precisar de mais espaço, você pode criar uma conta gratuita no Cloudinary ou no S3 para guardá-los.
Você também pode gerenciar a sua biblioteca de mídia acessando o painel da sua workspace e clicando na aba Meu Conteúdo.
Em primeiro lugar, só há suporte para tabelas com ID de chave primária autoincremental.
Além disso, depois que a tabela é sincronizada com o NicoChat, nós não a excluímos, mesmo que ela seja excluída do seu banco de dados PostgreSQL.
Isso porque você ainda pode usá-la na ação de armazenamento de dados do chatbot. Se quiser, exclua a tabela manualmente do lado do NicoChat.
Observe que, depois que a tabela for excluída do lado do NicoChat, o ID do armazenamento de dados pode mudar mesmo que você sincronize a mesma tabela de volta.
A mensagem de erro "Entre em contato com o suporte (#10102)" ocorre apenas para parceiros NicoChat que tentam adquirir um plano sem crédito de parceiro suficiente para cobrir o custo.
Possível motivo do erro:
O erro está ligado à falta de crédito de parceiro disponível no momento em que o seu cliente tenta adquirir um plano.
Como parceiro NicoChat, quando o seu saldo de crédito é insuficiente, este erro aparece e impede a compra do plano.
Possível solução para o erro:
Para resolver, a ação recomendada é recarregar o crédito de parceiro.
Com o crédito de parceiro recarregado, haverá saldo suficiente para cobrir o custo da workspace. Isso deixa a compra fluida para os seus clientes, que poderão migrar de plano e adquirir o plano desejado sem encontrar este erro.
O erro “Esta equipe tem muitos membros para o plano selecionado” ocorre ao tentar mudar de plano e indica excesso de canais ou de membros no plano atual.
A solução é remover os canais ou membros excedentes para caber nos limites do plano antes de fazer a mudança.
Possível motivo do erro:
O erro costuma surgir porque o número de membros da equipe ou de canais ultrapassa o permitido pelo plano desejado. Para resolver, é preciso remover os membros ou canais extras até caber nos limites do plano selecionado.
Solução possível:
Para resolver o problema, antes de mudar de plano, certifique-se de que o número de membros da equipe ou de canais atende aos limites do plano desejado.
Isso envolve remover os membros em excesso nas configurações da workspace e excluir os canais excedentes: vá em "Canais", selecione o canal que quer excluir e escolha a opção de exclusão no menu suspenso.
Depois que os membros ou canais em excesso forem removidos, siga com a mudança de plano e, em seguida, adicione novamente os membros ou canais necessários.
Ou você pode migrar para um plano superior, com limites maiores que o do seu plano atual.
Por padrão, o limite do webhook de entrada é de 500 solicitações a cada 24 horas. As solicitações que passarem disso serão ignoradas.
Se quiser conferir os limites do webhook de entrada, basta usar uma solicitação externa para acionar o URL do webhook de entrada e verificar o cabeçalho da resposta: lá você encontra os limites e quantas solicitações restam.
Aumente os limites do webhook de entrada
Se precisar de mais webhooks de entrada, o complemento é contratado por canal:
O padrão incluído é de 500 por dia. O primeiro bloco leva o limite a 1.000 por dia, e cada bloco seguinte soma mais 1.000. Os valores aparecem na tela de complementos, e o limite vigente do seu canal está em Quais são os limites do NicoChat.
O complemento é por canal e, para adquiri-lo, você deve entrar em contato com a equipe do NicoChat.
Você pode enfrentar esse problema ao importar contatos para a seção de Contatos quando o valor é composto só de caracteres especiais. Isso costuma acontecer com idiomas RTL, como hebraico e árabe, porque a codificação não tem bom suporte para esses idiomas.
Você precisará primeiro converter os arquivos de importação para a codificação UTF-8.
A solução é:
(1) Abra o arquivo do Excel onde estão as informações (.xls, .xlsx)
(2) No Excel, escolha "CSV (delimitado por vírgulas) (*.csv)" como tipo de arquivo e salve como esse tipo.
(3) Abra o arquivo .csv salvo no Bloco de Notas
(4) Em seguida, escolha -> Salvar como... e, na parte inferior da caixa "Salvar como", há uma caixa de seleção chamada "Codificação". Selecione UTF-8 (NÃO use ANSI, ou você perderá todos os acentos e afins). Depois de selecionar UTF-8,
escolha qualquer tipo em "Salvar como tipo" e salve o arquivo com um nome um pouco diferente do original.
Observação importante: o título não pode ser salvo em hebraico, porque isso gera um erro na importação. Portanto, salve o título em inglês.
Erro: “Unsupported post request. Cannot be loaded due to missing permissions, or does not support this operation”
Você pode ver a mensagem de erro assim:
Unsupported post request. Object with ID '100343472848953' does not exist, cannot be loaded due to missing permissions, or does not support this operation. Please read the Graph API documentation at https://developers.facebook.com/docs/graph-api
Quando você conecta o canal à nossa plataforma, aparece uma tela para conceder as permissões de que precisamos. Certifique-se de marcar todas as permissões solicitadas nessa tela.
Siga este vídeo para conectar sua página do Facebook:
Como a Meta alterou o número de permissões necessárias, além da permissão da página do Facebook você também precisará conectar o seu Gerenciador de Negócios do Facebook em “Integração” -> E-commerce -> Facebook Business.
A solução é reconectar a sua página do Facebook, selecionar a página que quer conectar e conceder todas as permissões de que a nossa plataforma precisa.
Segundo o código de erro da Meta, este erro ocorre porque o tipo de dado que você está enviando não é permitido para o seu tipo de mensagem.
Se você estiver em um canal omni, verifique o canal compatível em cada elemento da mensagem. Há ícones das redes, como na captura de tela abaixo:
Você pode obter mais informações aqui: developers.facebook.com/docs/messenger-platform/error-codes/
Ou o contato gerou erros demais do nosso lado, ou ele bloqueou o seu canal; de um jeito ou de outro, a mensagem não será entregue.
Saiba mais:
Você pode ver a mensagem de erro abaixo:
Error sending payload: (#2022) You have been temporarily blocked from performing this action. It means that Facebook has issued a temporary block on your Facebook account.
Não podemos enviar mensagens para nenhuma conta bloqueada pelo Facebook. Recomendamos consultar o seu Gerenciador de Negócios do Facebook ou a central de notificações de alertas da página para mais informações sobre esse problema.
Você verá este erro se estiver usando a ação “ocultar comentários” no fluxo.
Você pode ocultar a maioria dos comentários das publicações, com as seguintes exceções:
· comentários feitos pela Página
· comentários feitos pelos administradores da Página
· comentários feitos pela Página na publicação de um usuário. A publicação pertence ao usuário.
· comentários feitos por qualquer usuário na publicação de outro usuário na Página. A publicação pertence ao usuário.
· comentários feitos pelo criador de um evento. A publicação pertence ao criador do evento.
· comentários feitos por um grupo do Facebook. A publicação pertence ao grupo.
· comentários feitos por qualquer pessoa em uma avaliação
Alguns usuários têm problemas quando conectam uma página a uma workspace e ela se desconecta ao adicionarem outra página a uma workspace diferente.
Possível motivo do erro:
Em 90% das vezes, o motivo é que o usuário desmarca a página do Facebook já conectada na outra workspace durante o processo de conexão.
Solução possível:
Certifique-se de selecionar todas as páginas conectadas ao NicoChat. Mesmo que apareça uma mensagem de erro como “a página xx está conectada à workspace xx”, isso não é problema.
Mas você perderá a conexão da página anterior se não selecionar essas páginas. Portanto, selecione sempre todas as páginas que estão conectadas ao NicoChat.
Erro: “Comment reply error: You've already posted this. Posting the same content repeatedly on Facebook isn't allowed”
Você não pode publicar o mesmo conteúdo repetidamente.
Você pode adicionar um randomizador para enviar mensagens diferentes ou usar a OpenAI para gerar conteúdo personalizado dinamicamente.
Este limite se aplica aos canais da Meta (Messenger, Instagram, WhatsApp) e vale quando o contato não interage com o seu canal há mais de 24 horas.
Nesse caso, você não pode contatá-lo diretamente e verá esta mensagem de erro.
No WhatsApp, você precisará enviar uma mensagem modelo; no Messenger, uma notificação recorrente ou única.
No caso do contato do Instagram, você pode capturar o e-mail ou o telefone dele e falar por e-mail ou SMS, mesmo fora da janela de 24 horas.
Mais informações aqui:
A solução é usar uma condição como a da captura de tela abaixo, garantindo que você sempre alcance quem interagiu com o seu chatbot nas últimas 24 horas e usando outros métodos para falar com quem está fora da janela de 24 horas.
Você também pode falar com o contato por e-mail ou SMS. É preciso ter certeza de que ele optou por receber SMS e e-mail.
O motivo é que o Facebook tem um limite: você só pode enviar uma solicitação de adesão por semana com o mesmo título para uma mesma pessoa. Isso inclui o valor padrão "Atualizações e promoções".
Portanto, se você estiver testando a solicitação de notificação recorrente, pode receber a mensagem na primeira vez em que ela for acionada, mas ela pode não ser acionada no teste seguinte.
Além disso:
- Não envie solicitações de aceitação duplicadas para uma pessoa. Uma solicitação duplicada é aquela com o mesmo título, no caso de notificações de uma página do Facebook, ou com o mesmo título e image_url, no caso de notificações de uma conta Instagram Professional
- Você só pode enviar solicitações de aceitação durante a janela de mensagens padrão
- Se uma pessoa aceitar mensagens de marketing, essa ação não abre uma janela de mensagens padrão
- Você só consegue ver se uma pessoa optou por receber mensagens de marketing, mas não o status das solicitações de aceitação pendentes
- Se uma pessoa optar por parar de receber mensagens de marketing, as suas notificações deixam de ser entregues a ela e você receberá uma mensagem de erro
- Uma pessoa pode bloquear, silenciar ou denunciar as suas mensagens
- Para mensagens de marketing enviadas de uma conta Instagram Professional, em geral podem ser enviadas até 10 solicitações de aceitação com títulos diferentes por usuário em um período de 7 dias, com um sublimite de até 5 solicitações por usuário por dia. Ainda assim, considere se cada solicitação será relevante e útil para o usuário antes de enviá-la.
Esses requisitos e limitações podem mudar, porque estamos sempre buscando a melhor experiência para o usuário e para o negócio. Mais informações:
Esse erro vem da Meta, não do NicoChat: o número de chamadas à API num intervalo curto passou do limite que ela permite.
O envio volta a funcionar sozinho quando a janela do limite se renova. Se o erro se repetir, reduza a frequência das chamadas — ele costuma aparecer em teste, quando o mesmo fluxo é disparado muitas vezes seguidas.
Você pode ver a mensagem de erro abaixo:
[{"code":131053,"title":"Media upload error","message":"Media upload error","error_data":{"details":"Sticker file could not be processed. Please choose a different file."}}]O motivo é:
O problema pode estar no URL que você está usando na mensagem ou no modelo de mensagem, que talvez não esteja acessível publicamente.
Além disso, o formato de arquivo que você está usando pode não ser compatível com o WhatsApp.
Solução:
Não foi possível fazer o upload da mídia por um ou mais motivos, como um tipo de mídia incompatível. Consulte o valor error.error_data.details para saber por que o upload não foi possível.
Verifique o URL que está usando: ele deve começar com https e terminar com a extensão do arquivo, e o arquivo de mídia precisa estar sempre acessível publicamente.
Se você vir esta mensagem de erro, ela pode ter sido acionada por uma tentativa de usar o recurso “WhatsApp Flow”. Nesse caso, verifique se o seu Gerenciador de Negócios da Meta está verificado.
Para determinados recursos, como o WhatsApp Flow, a Meta exige um Gerenciador de Negócios verificado para liberar o acesso.
A solicitação incluía um ou mais parâmetros não suportados ou escritos incorretamente.
Você pode ver uma mensagem de erro assim:
Erro ao enviar payload: 2018047 (#100)
Erro ao enviar payload: 2018062 (#100) O URL fornecido não está na lista de liberação de extensões do Messenger
É possível que você esteja usando variáveis de campo personalizado do contato e que algumas delas estejam sem valor.
Você pode adicionar uma verificação condicional para todas as variáveis que vai usar e notificar o administrador se houver algum erro.
Você também pode ir aos logs de erros, localizar o contato, verificar o valor da variável usada na mensagem e confirmar se está tudo correto.
Saiba mais informações aqui: developers.facebook.com/docs/whatsapp/cloud-api/support/erro
Erro: “Message failed to send because there are restrictions on how many messages can be sent from this phone number”
Você pode ver a mensagem de erro assim:
[{"code":131048,"title":"Message failed to send because there are restrictions on how many messages can be sent from this phone number.This may be because too many previous messages were blocked or flagged as spam.","href":"https:\/\/developers.facebook.com\/docs\/whatsapp\/cloud-api\/support\/error-codes\/"}]Isso pode ocorrer porque muitas mensagens anteriores foram bloqueadas ou sinalizadas como spam.
É porque você enviou muitas mensagens para outros usuários e muitas delas foram bloqueadas ou marcadas como spam.
Por isso, a Meta impôs limitações ao seu número. Você precisa manter uma qualidade de conta saudável; caso contrário, a sua conta ou o seu número WABA podem ser bloqueados.
Erro: “The message could not be sent. You do not have enough funds on your conversation prepaid balance to engage in any paid conversation”
Você pode ver a mensagem de erro assim:
A mensagem não pôde ser enviada. Você não tem fundos suficientes em seu saldo pré-pago de conversação para participar de qualquer conversa paga. Vá para http://hub.360dialog.com -> 'Insights & Billing' para recarregar seu saldo e, opcionalmente, ativar a renovação automática, o que evitará que você fique sem fundos no futuro.
O motivo é que você não tem saldo suficiente na sua conta 360dialog. Você precisará adquirir mais créditos: acesse a sua conta 360dialog, vá em Insights e Billing e adicione mais créditos.
Se você vir este erro, o motivo é que a permissão não foi concedida ou foi removida.
Ao conectar a sua conta do WhatsApp, você precisa selecionar todas as permissões necessárias.
Você pode ver o código de erro:
(#131008) Parâmetro obrigatório ausente. O parâmetro do tipo texto está sem o valor de texto.
Razão:
A solicitação não tem um parâmetro obrigatório.
Solução:
É possível que você esteja usando variáveis de campo personalizado do contato e que algumas delas estejam sem valor.
Você pode adicionar uma verificação condicional para todas as variáveis que vai usar e notificar o administrador se houver algum erro.
Você também pode ir aos logs de erros, localizar o contato, verificar o valor da variável usada na mensagem e confirmar se está tudo correto.
Saiba mais informações aqui: developers.facebook.com/docs/whatsapp/cloud-api/support/erro
Isso significa que você usou um modelo de mensagem do WhatsApp, mas não conseguimos encontrá-lo na sua conta do WhatsApp.
Pode ser que o modelo tenha sido alterado ou excluído no Gerenciador de Negócios do WhatsApp e as alterações não tenham sido sincronizadas de volta no NicoChat.
Parece que a sua conta comercial do WhatsApp foi bloqueada pela Meta. Você precisa entrar em contato com a Meta para obter suporte.
Você também pode ir ao seu Gerenciador do WhatsApp, dentro do Gerenciador de Negócios da Meta, para ver as notificações relacionadas a esse erro.
Você pode ver a mensagem de erro assim:
[{"code":130472,"title":"Failed to send message because this user's phone number is part of an experiment","href":"https:\/\/developers.facebook.com\/docs\/whatsapp\/cloud-api\/support\/error-codes\/"}]A mensagem não foi enviada porque faz parte de uma experiência. Consulte Experiência de mensagem de marketing.
Saiba mais aqui: developers.facebook.com/docs/whatsapp/cloud-api/support/erro
Erro: “Message failed to send because more than 24 hours have passed since the customer last replied to this number”
Você pode ver a mensagem de erro assim:
[{"code":131047,"title":"Mensagem de reengajamento","message":"Mensagem de reengajamento","error_data":{"details":"A mensagem não foi enviada porque mais de 24 horas se passaram desde a última resposta do cliente a este número."},"href":"https:\/\/developers.facebook.com\/docs\/whatsapp\/cloud-api\/support\/error-codes\/ "}]
[{"code":470,"href":"https:\/\/developers.facebook.com\/docs\/whatsapp\/api\/errors\/","title":"A mensagem não foi enviada porque mais de 24 horas se passaram desde a última resposta do cliente a este número"}]
Isso ocorre porque já se passaram mais de 24 horas desde a última mensagem iniciada pelo contato: a sessão foi encerrada e você não pode mais usar mensagens de formato livre. Encontre uma forma de restringir o envio quando não houver mensagem recebida do usuário/número de telefone nas últimas 24 horas. Como alternativa, você pode falar com o contato usando um modelo de mensagem.
Você pode ver o erro assim:
(#131056) (Business Account, Consumer Account) pair rate limit hit
O motivo deste erro:
Muitas mensagens enviadas do número do remetente para o mesmo número de destinatário em um curto período.
Solução:
Aguarde e tente de novo, caso queira enviar mensagens para o mesmo número de telefone. Você ainda pode enviar mensagens para outro número sem esperar.
Saiba mais aqui:
Você pode ver a mensagem de erro assim:
Erro ao validar o token de acesso: a sessão foi invalidada porque o usuário alterou a senha ou o Facebook encerrou a sessão por motivos de segurança.
O usuário que conectou o WhatsApp alterou a senha da conta do Facebook. Por segurança, a Meta desconecta todas as plataformas de terceiros; basta reconectar uma vez para restabelecer a conexão e resolver o problema.
A solução é reconectar o canal. Como o usuário pode ter alterado a senha, o token anterior não vale mais.
Você pode ver o erro assim:
[{"code":131048,"title":"Spam Rate limit hit","message":"Spam Rate limit hit","error_data":{"details":"Message failed to send because there are restrictions on how many messages can be sent from this phone number.This may be because too many previous messages were blocked or flagged as spam."},"href":"https:\/\/developers.facebook.com\/docs\/whatsapp\/cloud-api\/support\/error-codes\/"}]Razão:
A mensagem não foi enviada porque há restrições sobre quantas mensagens podem ser enviadas deste número de telefone. Isso pode ocorrer porque muitas mensagens anteriores foram bloqueadas ou sinalizadas como spam.
Solução:
Verifique o status de qualidade no Gerenciador do WhatsApp e consulte a documentação Limites de taxa com base na qualidade para mais informações.
Normalmente você verá a mensagem de erro assim:
[{"code":131026,"title":"Receiver is incapable of receiving this message","message":"Receiver is incapable of receiving this message","error_data":{"details":"Message Undeliverable."}}]
Razões possíveis:
Não foi possível entregar a mensagem. Os motivos podem ser:
· O número de telefone do destinatário não é um número de telefone do WhatsApp.
· O destinatário não aceitou nossos novos Termos de Serviço e Política de Privacidade.
· Destinatário usando uma versão antiga do WhatsApp; ele precisa usar esta versão do WhatsApp ou uma superior:
o Android: 2.21.15.15
o SMBA: 2.21.15.15
o iOS: 2.21.170.4
o SMBI: 2.21.170.4
o KaiOS: 2.2130.10
o Web: 2.2132.6
Solução:
Confirme com o destinatário se ele concorda em ser contatado por você pelo WhatsApp e se está usando a versão mais recente do WhatsApp.
Saiba mais informações:
Este erro ocorre porque o usuário não concedeu permissões suficientes.
Este limite se aplica aos canais da Meta (Messenger, Instagram, WhatsApp) e vale quando o contato não interage com o seu canal há mais de 24 horas.
Nesse caso, você não pode contatá-lo diretamente. No WhatsApp, você precisará enviar uma mensagem modelo; no Messenger, uma notificação recorrente ou única.
Não há boas opções para falar com o contato do Instagram fora da janela de 24 horas.
Mais informações aqui: developers.facebook.com/docs/messenger-platform/policy/polic
Código de erro 131026, Mensagem não entregue
Razões possíveis:
Não foi possível entregar a mensagem. Os motivos podem ser:
· O número de telefone do destinatário não é um número de telefone do WhatsApp.
· O destinatário não aceitou nossos novos Termos de Serviço e Política de Privacidade.
· Destinatário usando uma versão antiga do WhatsApp; ele precisa usar esta versão do WhatsApp ou uma superior:
o Android: 2.21.15.15
o SMBA: 2.21.15.15
o iOS: 2.21.170.4
o SMBI: 2.21.170.4
o KaiOS: 2.2130.10
o Web: 2.2132.6
Solução:
Confirme com o destinatário se ele concorda em ser contatado por você pelo WhatsApp e se está usando a versão mais recente do WhatsApp.
Saiba mais informações:
Não foi possível entregar a mensagem. Os motivos podem ser:
· O número de telefone do destinatário não é um número de telefone do WhatsApp.
· O destinatário não aceitou os novos Termos de Serviço e Política de Privacidade.
· Destinatário usando uma versão antiga do WhatsApp; ele precisa usar esta versão do WhatsApp ou uma superior:
Confirme com o destinatário se ele concorda em ser contatado por você pelo WhatsApp e se está usando a versão mais recente do WhatsApp.
O erro completo pode ser assim:
[{"code":131042,"title":"A mensagem não foi enviada porque houve um ou mais erros relacionados à sua forma de pagamento.","href":"https:\/\/developers.facebook.com\/ docs\/whatsapp\/cloud-api\/support\/error-codes\/"}]
Este erro geralmente acontece na Cloud API, no canal WhatsApp.
Você precisará ir ao seu Gerenciador de Negócios do Facebook, depois ao Gerenciador do WhatsApp, e verificar se há algum problema de pagamento no seu faturamento. Como a Meta cobra pelas mensagens modelo do WhatsApp, você precisa cadastrar um cartão de crédito válido na seção de cobrança do Gerenciador do WhatsApp.
Você pode ver a mensagem de erro assim:
(#100) Chave inesperada "Index" no parâmetro "template['components'][0]['parameters'][0]".
Razão:
A solicitação incluía um ou mais parâmetros não suportados ou escritos incorretamente.
Solução:
Consulte a referência do endpoint para determinar quais parâmetros são suportados e como eles são escritos.
Ao definir a chave pública comercial, certifique-se de que ela seja uma chave pública RSA válida de 2.048 bits no formato PEM.
Certifique-se de que não haja incompatibilidade entre o ID do número de telefone que você está registrando e um ID de número de telefone armazenado anteriormente.
Este erro significa que o modelo não existe: ou ele não existe no idioma especificado, ou não foi aprovado.
Certifique-se de que seu modelo tenha sido aprovado e que o nome do modelo e a localidade do idioma estejam corretos. Certifique-se de seguir as diretrizes do modelo de mensagem.
Este erro surge quando um armazenamento de terceiros (Cloudinary, S3 etc.) está integrado e um arquivo é compartilhado por um fluxo sem as permissões necessárias, o que impede a entrega de arquivos de determinados formatos aos contatos.
Para resolver, desconecte a integração de armazenamento ou ative as configurações que nos permitem compartilhar os arquivos.
Abaixo, um exemplo com o Cloudinary:
Este limite se aplica aos canais da Meta (Messenger, Instagram, WhatsApp) e vale quando o contato não interage com o seu canal há mais de 24 horas.
Nesse caso, você não pode contatá-lo diretamente. No WhatsApp, você precisará enviar uma mensagem modelo; no Messenger, notificações recorrentes ou únicas.
Não há boas opções para falar com o contato do Instagram fora da janela de 24 horas. Uma alternativa é coletar o e-mail dele e entrar em contato por e-mail.
Mais informações aqui: developers.facebook.com/docs/messenger-platform/policy/polic
O motivo pode ser um dos dois abaixo:
· Você não colocou o domínio do seu site na lista de permissões
· Você não instalou corretamente o script no seu site ou na sua página de destino.
Você encontra a configuração “Domínio da lista de permissões” conforme a captura de tela abaixo
Para conferir o script que precisa instalar no seu site, inspecione o código-fonte da página e verifique se o script está lá.
Os canais de chat no site usam cookies para identificar o contato. Esses cookies têm validade de 30 dias. Passados 30 dias sem que o contato visite o seu site e atualize os cookies, o cookie (ou seja, o contato) expira.
Qualquer mensagem que você tentar enviar pelo chat no site não poderá ser entregue, e você verá este erro nos seus logs de erros.
Se você pediu ao contato para usar o SSO ao entrar no chat do site e vinculou esse mesmo contato a outros canais sociais, ainda é possível falar com ele fora da janela de 30 dias.
No canal SMS existe uma configuração de horário de telemarketing; você a encontra nas configurações do canal SMS, conforme a imagem abaixo
Você precisa selecionar o horário de funcionamento. Atenção à seleção do fuso horário: se a mensagem SMS for enviada fora do horário de telemarketing, ela não será entregue.
Uma vez configurado o horário de telemarketing, todas as mensagens enviadas no canal SMS (fluxo, sequência, disparo) serão bloqueadas se saírem fora desse horário.
Porém, se você usar Ação -> Notificação -> Notificação por SMS ou Ação -> Ação Avançada -> Enviar Mensagem SMS, essas duas ações não são afetadas pelo horário de telemarketing.
A pessoa para quem você está tentando enviar a mensagem optou por não receber mensagens do seu número Twilio, do remetente de canais ou do serviço de mensagens.
Você tentou enviar uma mensagem para um número 'Para' que respondeu "STOP" a uma das suas mensagens anteriores. Você não conseguirá enviar para o número indicado no parâmetro 'Para' até que o assinante identificado por esse número responda "START".
Motivo possível:
O aparelho do usuário final respondeu "STOP" ou outra palavra-chave de exclusão
Soluções possíveis:
· Considere remover este número de telefone da sua lista de destinatários.
· Peça ao destinatário que volte a assinar as suas mensagens enviando "START" ou outra palavra-chave de adesão
· Antes de enviar mensagens a um destinatário, certifique-se de que ele consentiu em receber mensagens suas.
Este erro geralmente ocorre quando você tenta enviar um SMS para contatos que não deram opt-in. Você pode marcar o opt-in manualmente ou usar a ação “SMS Opt-in” dentro do bloco de nó de ação.
Você pode ir em “Contatos”, selecionar o contato e escolher a ação “Definir aceitação de SMS”.
Se você estiver ligando para o seu canal de voz no NicoChat e ouvir “erro de aplicativo”, estes podem ser alguns dos motivos:
· A sua conta Twilio ainda está no teste gratuito, e a conta de teste tem algumas limitações. A solução é migrar para uma conta Twilio paga.
· Você usou logo no início alguma ação demorada, como OpenAI ou chat completion, e a resposta demora a chegar; o Twilio atinge o tempo limite e reproduz o erro de aplicativo. A solução é enviar uma mensagem primeiro e/ou usar a “música de espera” o quanto antes.
Por padrão, o Twilio tem restrições de localização geográfica para ligações e SMS internacionais.
Você precisará habilitar as permissões geográficas do seu número Twilio:
Elas ficam acessíveis no painel do Twilio.
Você está tentando executar uma ação em uma conta de usuário que foi desativada ou excluída pelo
Telegram.