Como corrigir erros comuns?
Este erro é acionado sempre que o bot tenta enviar uma sequência para um usuário de bot cuja assinatura do bot foi cancelada.
Erros globais
Erro: “Sequence failed, Bot user unsubscribed”
Este erro é acionado sempre que o bot tenta enviar uma sequência para um usuário de bot cuja assinatura do bot foi cancelada.
O usuário precisa se inscrever novamente para receber as sequências.
Depois que o usuário do bot for inscrito novamente, você poderá usar a ação na ação básica, inscrever-se na sequência para inscrever novamente o usuário conforme a captura de tela abaixo:
Ou vá para “usuários de bot” e selecione os contatos e, em seguida, no menu suspenso “ação em massa”, selecione “inscrever-se na sequência”
Erro: “Data size is over 20000 characters”
Para o campo personalizado do usuário, o limite máximo de armazenamento é de 20.000 caracteres. Para resolver o problema, reduza o personagem que você está tentando salvar.
Se você estiver salvando o valor de webhooks de entrada ou de nossas ações de integração interna, use o pré-processamento de dados para restringir o valor que deseja salvar.
Você pode encontrar o pré-processamento de dados na configuração do webhook de entrada abaixo:
Você também pode encontrar o pré-processamento de dados na solicitação externa conforme captura de tela abaixo:
Observe que você pode precisar de habilidades de desenvolvedor para usar o recurso de pré-processamento de dados acima.
Erro: “Operation timed out after 30001 milliseconds with 0 bytes received”
Este erro geralmente é acionado por uma ação de integração OpenAI. O tempo limite padrão para openAI nativamente é de 30 segundos, após o qual o tempo limite dos servidores NicoChat é excedido. Se o servidor atingir o tempo limite antes de receber uma resposta do OpenAI, esse erro será registrado.
Para reduzir as chances de ocorrência desse erro, reduza o histórico do Chat ou otimize os prompts e mensagens do sistema para que a solicitação demore menos para ser executada. Você também pode dividir um histórico de bate-papo maior em partes menores e usar um sistema de detecção de intenções como solução alternativa. Para mais informações, consulte o vídeo:
Erro: “Data Store Error: Connection is not verified”
Este erro geralmente ocorre quando você tenta integrar seu banco de dados ao NicoChat. A conexão é estabelecida, mas o NicoChat não consegue verificar a conexão. Na maioria dos casos, a razão para isso são credenciais incorretas. Há casos em que o IP não está na lista de permissões e, portanto, a conexão não é estabelecida.
Erro: “Notification Content must not be empty”
Este erro é acionado sempre que você tenta enviar uma notificação e o corpo/conteúdo da notificação está vazio.
Para resolver isso, certifique-se de que o corpo da notificação não esteja em branco. Se o corpo consistir em um campo personalizado, verifique o usuário do bot para ver se esse campo personalizado foi preenchido corretamente.
Erro: “Broadcast failed, Bot user unsubscribed”
Este erro ocorre porque o usuário cancelou a assinatura do seu bot ao enviar a transmissão.
Se não quiser ver o erro, você pode adicionar condições no seu fluxo de transmissão, enviando a transmissão apenas para o usuário que se inscreveu no seu bot.
E você também pode optar por excluir o usuário não inscrito para manter apenas os usuários engajados em seu chatbot.
Você pode criar os gatilhos na automação: Usuário cancelado do bot e acionar um fluxo com a ação “excluir usuário” dentro.
Nossa plataforma também possui um recurso de limpeza automática, você pode encontrar as configurações em “Configurações” -> Geral -> Limpeza automática de usuários de bot (somente o proprietário pode ver esta configuração).
Erro: “Open AI not connected”
Este erro é acionado quando você tenta usar uma ação OpenAI, mas o espaço de trabalho ainda não está integrado ao OpenAI.
Para integrar OpenAI, clique em “Integração” no painel do seu espaço de trabalho, pesquise OpenAI na aba Inteligência Artificial e insira sua chave API OpenAI.
Clique em Salvar e certifique-se de que a conexão diz “Verificada”
Observação: o ID da organização é opcional, você pode deixá-lo vazio.
Você pode consultar o vídeo abaixo para obter mais orientações:
Erro: “SpreadSheet is not selected”
Este erro é acionado quando você tenta usar uma ação do Google Sheet e a planilha não 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 sua conta.
Isso pode acontecer se o seu espaço de trabalho ainda não tiver planilhas do Google integradas e, portanto, a instalação do modelo não foi capaz de instalar uma cópia da planilha do Google usada em sua conta
Certifique-se de conectar sua conta do Google em Integração -> Armazenamento de dados/arquivos e também selecione a planilha correta na ação da planilha do Google.
Erro: “Pro feature only”
Este erro é acionado quando você tenta usar uma ação que está disponível apenas para usuários do plano Pro. Para usar essas ações, você terá que atualizar seu espaço de trabalho do plano gratuito para o plano pago. Veja mais em 💳Seu Plano
Erro: “Request timeout”
Este erro é acionado quando você está usando a ação de solicitação externa e a chamada de API externa não retorna uma resposta em 15 segundos.
Os servidores NicoChat atingem o tempo limite após 15 segundos. A solução é garantir que a chamada da API seja concluída em 15 segundos. Se quiser aumentar esse limite, você pode fazê-lo adquirir entrando em contato com o suporte.
Observação: você pode lidar com esse erro em seu fluxo usando o código de resposta “0”
Se você não conseguir otimizar o tempo limite, poderá optar por adquirir o complemento de tempo limite. Você pode aumentar os limites de tempo limite em 10 segundos por 30 créditos cada.
Erro: “Message not sent because not subscribed”
Este erro é acionado sempre que o bot tenta enviar uma mensagem para um usuário do bot que não está mais inscrito no bot.
Você pode usar a ação “opt-in” no construtor de fluxo, ações → ações básicas. Você também pode inscrever novamente os usuários do bot usando a ação “Inscrever-se no bot” → ações básicas.
Erro: “Over 100 sequences subscribed in last 24 hours”
A plataforma tem limites de taxa de no máximo 100 assinaturas de sequência. Se você se inscreveu na sequência mais de 100 vezes, receberá este erro.
Você precisará otimizar sua ação “inscrever-se na sequência” em seu fluxo.
Isso geralmente acontece quando o usuário está testando fluxos ou tendo um loop infinito em algum lugar do design do fluxo. Normalmente o limite é suficiente para as automações do chatbot. Você precisa verificar sua lógica de fluxo para corrigir o problema.
Erro: “Google Sheet is not connected”
Este erro é acionado quando você tenta usar uma ação do Planilhas Google e ela não está integrada ao seu espaço de trabalho. Certifique-se de conceder toda a permissão solicitada ao conectar sua conta do Planilhas Google.
Erro: “Bot users in workspace is over limit”
Este erro significa que você atingiu os limites do plano para ambos os usuários. Portanto, as automações não continuarão.
Você precisará excluir usuários de bot manualmente ou configurar regras de exclusão automática no Canal, depois ir para configurações, depois “Geral” e, em seguida, configurar “limites de usuários de bot” e “Limpeza automática de usuários de bot”.
Observe que os limites de usuário do bot e as configurações de limpeza estão disponíveis apenas para o proprietário do espaço de trabalho. Além disso, você pode atualizar para o plano superior, que possui limites mais altos de usuários de bot.
Erro: “The rate limit has exceeded, Please retry again after some time”
Este erro geralmente é acionado quando uma transmissão está sendo enviada ou você está tendo um grande tráfego de conversa ao vivo e atinge 100 erros a cada 5 minutos para o seu bot.
A transmissão será pausada temporariamente.
O NicoChat continuará contando as mensagens de erro a cada 5 minutos. Se você tiver menos erros do que nossos limites, sua transmissão ou seu bot serão retomados.
Para resolver esse erro, certifique-se de otimizar seu fluxo para lidar com os erros.
Você pode abrir seu bot e acessar “Ferramentas” -> Logs de erros, e então se você clicar em “Nó” em seus logs de erros, ele irá redirecioná-lo para os fluxos, você poderá verificar e otimizar seu fluxo.
Nota: Se você estiver usando o recurso de limites de taxa, esse erro também será registrado se você exceder esses limites.
Erro: “Over max execution time limit of 40 seconds”
Assista esse vídeo para saber mais:
Este erro é acionado sempre que não há um bloco de interação do usuário por 40 segundos.
Por padrão, o NicoChat oferece um tempo máximo de execução de 40 segundos. Então, se você tiver um nó de pergunta (que considera a interação do usuário) acionado. e a partir deste ponto, o NicoChat avançará com sua lógica de fluxo por no máximo 40 segundos. Você precisará ter outra interação do usuário (bloco de perguntas) dentro de 40 segundos, caso contrário, você verá este erro.
Alguns exemplos de ações de interação do usuário:
- Nó de pergunta - fazendo perguntas
- Clique em botões ou respostas rápidas
- O usuário responde ao seu bot
Observe que, se você estiver usando uma ação de solicitação externa ou uma ação openAI, o tempo de resposta de terceiros também será considerado nos limites de tempo limite.
A solução é adicionar mais interação do usuário ao fluxo do chatbot. Cada interação do usuário redefinirá o tempo máximo de execução.
Além disso, você pode optar por adquirir o complemento de tempo limite máximo de execução. Você pode aumentar o limite de tempo limite em 10 segundos por 30 créditos/mês cada.
Observe que o complemento está no nível do bot. Entre em contato com o suporte do NicoChat assim que o pagamento for feito. Seja específico sobre o ID do espaço de trabalho e o nome do bot em seu e-mail.
Erro: “Over 30 steps without interaction step”
Nos designs de fluxo do NicoChat, cada nó é considerado uma etapa.
Não importa quantas ações você está usando nesse nó, mas entre uma interação do usuário e a próxima interação do usuário, você não pode ter mais de 30 etapas. Isso incluirá os fluxos em segundo plano ou paralelos que são acionados.
Alguns exemplos de ações de interação do usuário:
- Nó de pergunta - fazendo perguntas
- Clique em botões ou respostas rápidas
- O usuário responde ao seu bot
Para resolver esse erro, tente otimizar sua lógica de fluxo (como dividir automações maiores em fluxos pequenos) e evitar loops intermináveis.
Erro: “Card title is empty”
Se você estiver usando “elemento cartão” no bloco de envio de mensagem. você precisará ter certeza de que o título do cartão tem valor.
Se você estiver usando uma variável de campo personalizado do usuário no título do cartão, precisará garantir que a variável tenha o valor. você pode verificar isso observando a visão geral do usuário do bot e selecionando o usuário do bot para o qual o erro foi acionado. Certifique-se de que o campo personalizado usado para o título do cartão tenha algum valor. Caso contrário, significa que suas etapas antes deste nó apresentarem um problema que você precisa solucionar em algum lugar
Caso contrário, você verá o erro. Se você estiver usando um campo personalizado do usuário no título do cartão, poderá usar a verificação de condição antes de enviar o cartão e notificar o administrador se houver algum problema como esse.
Erro: “Quero fazer um upgrade de plano, tem reembolso do plano antigo?”
Então é assim que funciona nosso faturamento. Imagine que você comprou um plano de R$300. A fatura é gerada imediatamente.
E você está usando ele há 25 dias, digamos, e então decidiu que vai fazer upgrade para um plano de R$500.
Então, o que acontece agora é:
- Assim que você fizer o upgrade, você pagará R$500 do novo plano.
- Como você usou 15 dias, o custo seria de R$300/30 = R$ 10 por dia, portanto, 5 dias não usados seria R$50
- R$50 serão reembolsados em sua conta Stripe. observe que para sua conta Stripe, não para o cartão com o qual você pagou.
- No seu próximo pagamento ao invés de pagar R$500, será debitado R$450 (R$500 - R$50).
Portanto, se você ainda utiliza o serviço NicoChat, esses créditos serão utilizados para cobrir seu próximo pagamento mensal.
Portanto, o crédito balanceado será usado para cobrir a segunda mensalidade do novo plano.
Você não conseguirá ver o crédito no painel do NicoChat.
Erro: “Over 100 smart delay used in last 24 hour”
A ação de atraso inteligente no máximo 100 pode ser acionada para cada usuário do bot. Inspecione e modifique o nó que está causando o problema para evitar um loop infinito que aciona ações de atraso inteligente, garantindo o cumprimento do limite de 100 ações por usuário do bot em 24 horas.
Causas Possíveis:
O erro ocorre quando o usuário do bot recebeu o máximo permitido de 100 ações de atraso inteligente em 24 horas, potencialmente devido a um loop infinito acionado em seu fluxo.
Soluções possíveis:
Para resolver esse problema, inspecione o nó específico do seu fluxo que está causando o erro e verifique se você não configurou uma automação de loop infinito.
Você também pode usar o “digitando” ou “espera” para tempos menores de 10 segundos:
Modifique a lógica de automação para evitar o acionamento 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 podem levar à ultrapassagem do limite de ação do atraso inteligente.
Esses erros são vistos principalmente em canais como o WhatsApp, onde o recurso de digitação não está presente. Atualizamos nosso bloco de digitação para converter automaticamente em um atraso de espera se o canal em questão não suportar digitação. Dessa forma você não precisará mais usar o atraso inteligente e poderá resolver o seu problema.
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 de upload, se precisar de arquivos de armazenamento extra, você pode criar uma conta cloudinary ou S3 gratuita para armazená-los.
Você também pode gerenciar sua biblioteca de mídia de conteúdo acessando o painel do seu espaço de trabalho e clicando na guia Meu Conteúdo.
Erro: “Integração PostgreSQL - Tabela não está sincronizada”
Em primeiro lugar, suporte apenas as tabelas com ID de chave primária de incremento automático
Além disso, depois que a tabela é sincronizada com o NicoChat, não excluímos a tabela sincronizada, mesmo que ela seja excluída do seu banco de dados Postgresql.
Porque você ainda pode usá-los em sua ação de armazenamento de dados do chatbot. Você pode excluir manualmente a tabela do lado do NicoChat.
Observe que depois que a tabela for excluída do lado do NicoChat, mesmo se você sincronizar a mesma tabela de volta ao NicoChat, o ID do armazenamento de dados ainda poderá mudar.
Erro: “Entre em contato com o suporte (#10102)”
A mensagem de erro "Entre em contato com o suporte(#10102)" ocorre exclusivamente para parceiros NicoChat ao tentar adquirir um plano, devido ao crédito de parceiro insuficiente para cobrir o custo do plano.
Possível motivo do erro:
A ocorrência desse erro está ligada à insuficiência de crédito de parceiro disponível no momento em que seu cliente tenta adquirir um plano.
Como parceiro NicoChat, quando o saldo de crédito é insuficiente, esse erro surge, dificultando o processo de compra do plano.
Possível solução para o erro:
Para resolver esse problema, a ação sugerida é recarregar o crédito do parceiro.
Ao complementar o crédito do parceiro, haverá fundos adequados para cobrir o custo do espaço de trabalho. Esta ação facilitará um processo de compra contínuo para seus clientes, permitindo-lhes atualizar e adquirir o plano desejado sem encontrar esse erro.
Erro: “Esta equipe tem muitos membros para o plano selecionado”
O erro “Esta equipe tem muitos membros para o plano selecionado” ocorre ao tentar atualizar o plano, indicando excesso de bots ou membros no plano atual.
A solução envolve a remoção de bots ou membros excedentes para caber nos limites do plano atual antes da atualização.
Possível motivo do erro:
O erro provavelmente surge devido à limitação do plano atual quanto ao número de membros da equipe ou bots, excedendo a contagem permitida para a atualização desejada. Para resolver isso, é necessário remover membros ou bots adicionais para se adequar às restrições do plano selecionado.
Solução possível:
Para resolver o problema, antes de atualizar o plano, certifique-se de que o número de membros da equipe ou bots atenda aos limites definidos pelo plano desejado.
Isso envolve a remoção de membros em excesso por meio das configurações do espaço de trabalho e a exclusão de bots excedentes navegando até "Todos os bots", selecionando o bot específico a ser excluído e escolhendo a opção de exclusão no menu suspenso.
Assim que os membros ou bots em excesso forem removidos, prossiga com a atualização do plano e, posteriormente, adicione novamente os membros ou bots necessários de acordo.
Ou você pode atualizar para um plano superior que tenha mais limites do que o seu plano existente.
Erro: “Limites de solicitação de webhook de entrada”
Por padrão, o limite do webhook de entrada é de 500 solicitações em 24 horas, se mais solicitações forem enviadas para o URL do webhook de entrada. será ignorado.
Se você quiser verificar 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, você encontrará os limites e quantas solicitações restam.
Aumente os limites do webhook de entrada
Se o usuário precisar de webhook de entrada extra, ele poderá comprar com base nas informações abaixo:
500/dia - Incluído -› 15 mil solicitações/por mês
1.000/dia - 30 créditos por mês -› 30 mil solicitações/por mês
2.000/dia - 60 créditos por mês -› 60 mil solicitações/por mês
3.000/dia - 90 créditos por mês -› 90 mil solicitações/por mês
4.000/dia - 120 créditos por mês -› 120 mil solicitações/por mês
5.000/dia - 150 créditos por mês -› 150 mil solicitações/por mês
10.000/dia - 300 créditos por mês -› 300 mil solicitações/por mês
O complemento é por canal e para adquiri-lo você deve entrar em contato com a equipe do NicoChat.
Erro: “Import contact show strange character - For example Hebrew language
Você pode enfrentar esse problema se estiver importando contatos para a seção de usuário do bot e o valor for composto apenas por caracteres especiais. Isso geralmente acontece com idiomas RTL, como hebraico e árabe. É porque o sistema de codificação não é bem suportado pelas linguagens RTL.
Você precisará primeiro converter os arquivos de importação em codificações UTF-8.
A solução será:
(1) Abra um arquivo Excel onde você tem as informações (.xls, .xlsx)
(2) No Excel, escolha "CSV (delimitado por vírgula) (*.csv) como o tipo de arquivo e salve como esse tipo.
(3) No NOTEPAD, 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 rotulada como "Codificação Selecione UTF-8 ( ". NÃO use ANSI ou você perderá todos os acentos, etc. ). Após selecionar UTF-8,
escolha qualquer tipo em " Salvar como tipo " e salve o arquivo com um nome de arquivo ligeiramente diferente do original.
Observação importante: o título não pode ser salvo em hebraico, pois ocorrerá um erro durante a importação. Portanto salve o título no formato inglês.
Erros comuns do canal do Facebook
Erro: “Unsupported post request. Cannot be loaded due to missing permissions, or does not support this operation”
Você pode ver a mensagem de erro como esta:
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. Existe uma tela que permite dar a permissão que precisamos. certifique-se de selecionar 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, então espere a permissão da página do Facebook, você também precisará conectar seu gerenciamento de negócios do Facebook em “Integração” -> E-commerce -> Facebook Business
A solução é reconectar sua página do Facebook, selecionar a página que deseja conectar e conceder todas as permissões que nossa plataforma precisa.
Erro: “Sending payload: 2534015 (#100) Invalid message data”
De acordo com o código de meta erro, esse erro ocorre porque o tipo de dados 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. Existem ícones sociais como a captura de tela abaixo:
Você pode obter mais informações aqui: developers.facebook.com/docs/messenger-platform/error-codes/
Erro: “Sending payload: 1545041 (#551) This person isn't available at the moment”
Ou o usuário gerou muitos erros de nossa parte ou o usuário pode bloquear seu bot, então a mensagem não será entregue.
Saiba mais informações:
Erro: “You have been temporarily blocked from performing this action”
você poderá 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 para nenhuma conta que tenha sido bloqueada pelo Facebook. Aconselhamos que você consulte seu gerente de negócios do Facebook ou centro de notificação de alertas de página para obter mais informações sobre esse problema.
Erro: “Hide comment error: (#200) Users can only edit their own comments published by the same app”
Você verá esse erro se estiver usando a ação “ocultar comentários” no fluxo.
Você pode ocultar a maioria dos comentários nas postagens, 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 postagem de um usuário. A postagem é propriedade do usuário.
· comentários feitos por qualquer usuário na postagem de outro usuário na página. A postagem é propriedade do usuário.
· comentários feitos por um criador de evento. A postagem é propriedade do criador do evento.
· comentários feitos por um grupo do Facebook. O Post é propriedade do Grupo.
· comentários feitos por qualquer pessoa em uma avaliação
Saiba mais informações: developers.facebook.com/docs/graph-api/reference/v17.0/comme
Erro: “Connecting different FB pages to different workspaces using 1 FB account”
Os usuários têm alguns problemas quando conectam uma página a um espaço de trabalho específico e ela se desconecta quando adicionam outra página a um espaço de trabalho diferente.
Possível motivo do erro:
90% das vezes o motivo é porque o usuário desmarca o FB já conectado no outro espaço de trabalho durante o processo de conexão com o Facebook.
Solução possível:
Certifique-se de selecionar todas as páginas que estão conectadas à plataforma NicoChat, mesmo que mostre a mensagem de erro, como “a página xx está conectada ao espaço de trabalho xx”, isso não deve importar.
Mas você perderá a conexão da página anterior se não selecionar essas páginas para conectar. Portanto, certifique-se sempre de selecionar todas as páginas que estão se conectando à plataforma NicoChat.
Erro: “Comment reply error: You've already posted this. Posting the same content repeatedly on Facebook isn't allowed”
você não pode postar o mesmo conteúdo repetidamente.
Você pode adicionar um randomizador para enviar mensagens diferentes ou usar openAI para gerar conteúdo personalizado dinamicamente.
Erro: “Message not sent because outside 24 hours”
Este limite se aplica a meta canais (Messenger, Instagram, WhatsApp). Se o usuário não interagiu com seu bot nas últimas 24 horas.
Você não pode contatá-los diretamente. Você verá essa mensagem de erro.
Para o WhatsApp, você precisará enviar uma mensagem modelo; para o Messenger, você precisará enviar uma notificação recorrente ou única.
Para o usuário do Instagram, você pode capturar o e-mail ou número de telefone do usuário e entrar em contato com o usuário por e-mail ou SMS, mesmo que ele esteja fora da janela de 24 horas.
Mais informações aqui:
A solução é usar uma condição como a captura de tela abaixo e garantir que você esteja sempre alcançando o usuário que interage com seu chatbot nas últimas 24 horas e usando diferentes métodos para entrar em contato com o usuário que está fora da interação de 24 horas. janela.
Além disso, você pode entrar em contato com o usuário por e-mail ou SMS. Você precisa ter certeza de que o usuário optou por receber mensagens SMS e e-mail.
Erro: “Não consigo receber mensagem de solicitação de notificação recorrente”
A razão para isso é que o Facebook tem um limite de taxa de que você só pode enviar uma solicitação de adesão por semana com o mesmo título específico para uma pessoa. Isto inclui o valor padrão de "Atualizações e promoções".
Portanto, se você estiver testando a solicitação de notificação recorrente, poderá receber a mensagem quando ela for acionada pela primeira vez, mas ela poderá não ser acionada no teste seguinte.
Também,
- Não envie solicitações duplicadas de aceitação para uma pessoa. Uma solicitação de aceitação duplicada é definida como tendo o mesmo título para notificações de uma página do Facebook ou o mesmo título e image_url para 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, esta ação não abrirá uma janela de mensagens padrão
- Você só pode ver se uma pessoa optou por receber mensagens de marketing, mas não os status das solicitações de aceitação pendentes
- Se uma pessoa optou por parar de receber mensagens de marketing, suas notificações não serão mais entregues a essa pessoa e você receberá uma mensagem de erro
- Uma pessoa pode bloquear, silenciar ou denunciar suas mensagens
- Para mensagens de marketing enviadas de uma conta Instagram Professional, geralmente, até 10 solicitações de aceitação para títulos diferentes podem ser enviadas por usuário durante um período de 7 dias. Um sublimite de até 5 solicitações de aceitação pode ser enviado a um usuário por dia. No entanto, você deve considerar se os usuários provavelmente considerarão cada solicitação de aceitação relevante e valiosa antes de enviá-la.
Esses requisitos e limitações estão sujeitos a alterações, pois estamos sempre buscando a melhor experiência para o usuário e para os negócios. Mais Informações:
Erro: “1893016 Calls to this API have exceeded the rate limit”
A razão para isso é que o Facebook tem um limite de taxa de que você só pode enviar uma solicitação de adesão por semana com o mesmo título específico para uma pessoa. Isto inclui o valor padrão de "Atualizações e promoções".
Portanto, se você estiver testando a solicitação de notificação recorrente, poderá receber a mensagem quando ela for acionada pela primeira vez, mas ela poderá não ser acionada no teste seguinte.
Também,
- Não envie solicitações duplicadas de aceitação para uma pessoa. Uma solicitação de aceitação duplicada é definida como tendo o mesmo título para notificações de uma página do Facebook ou o mesmo título e image_url para 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, esta ação não abrirá uma janela de mensagens padrão
- Você só pode ver se uma pessoa optou por receber mensagens de marketing, mas não os status das solicitações de aceitação pendentes
- Se uma pessoa optou por parar de receber mensagens de marketing, suas notificações não serão mais entregues a essa pessoa e você receberá uma mensagem de erro
- Uma pessoa pode bloquear, silenciar ou denunciar suas mensagens
- Para mensagens de marketing enviadas de uma conta Instagram Professional, geralmente, até 10 solicitações de aceitação para títulos diferentes podem ser enviadas por usuário durante um período de 7 dias. Um sublimite de até 5 solicitações de aceitação pode ser enviado a um usuário por dia. No entanto, você deve considerar se os usuários provavelmente considerarão cada solicitação de aceitação relevante e valiosa antes de enviá-la.
Esses requisitos e limitações estão sujeitos a alterações, pois estamos sempre buscando a melhor experiência para o usuário e para os negócios. Mais detalhes aqui: developers.facebook.com/docs/messenger-platform/marketing-me
Erros comuns do canal WhatsApp
Erro: “Media upload Error”
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."}}]A razão é:
Este pode ser o URL que você está usando na mensagem ou o modelo de mensagem não está disponível publicamente para acesso.
Além disso, esse formato de arquivo que você está usando pode não ser compatível com o WhatsApp.
Solução:
Não foi possível fazer 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 obter mais informações sobre por que não foi possível fazer upload da mídia.
Você pode verificar o URL que está usando e certificar-se de que o URL do arquivo começa com https e termina com o formato do arquivo no final do URL, e também este arquivo de mídia deve estar sempre acessível publicamente.
Blocked by Integrity. Integrity requirements not met
Se você vir esta mensagem de erro, esta mensagem pode ser acionada se você estiver tentando usar o recurso “WhatsApp Flow”, você precisará verificar se o seu metagerente de negócios foi verificado ou não.
Para determinados recursos como o WhatsApp Flow, o meta requer um gerente de negócios verificado para obter acesso.
Erro: “Sending payload: 2018062 (#100)”
A solicitação incluía um ou mais parâmetros não suportados ou com erros ortográficos.
Você pode ver uma mensagem de erro como esta:
Erro ao enviar carga útil: 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 algumas variáveis de campo personalizado do usuário, mas algumas das variáveis não têm o valor preenchido.
Você pode adicionar uma verificação condicional sobre todas as variáveis que está prestes a usar e notificar o administrador se houver algum erro.
Você também pode ir até os logs de erros, localizar o usuário, verificar o valor da variável usada na mensagem e confirmar se todas estão com o valor 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 como esta:
[{"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, mas muitas mensagens foram bloqueadas ou sinalizadas como spam.
Portanto, a meta impôs algumas limitações ao seu número. Você precisa manter uma qualidade de conta saudável, caso contrário, sua conta ou número WABA poderá ser bloqueado.
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 como esta:
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 fundos suficientes em sua conta 360dialog. Você precisará adquirir mais créditos do 360dialog. acesse sua conta 360dialog, insights e cobranças e adicione mais créditos.
Erro: “(#200) Permissions error”
Se você vir esse erro, o motivo é: A permissão não foi concedida ou foi removida.
Ao conectar sua conta do WhatsApp, você precisa selecionar todas as permissões necessárias.
Erro: “Required parameter is missing - Error code 131008”
Você pode ver o código de erro:
(#131008) O parâmetro obrigatório está faltando O parâmetro do tipo texto está faltando o valor do texto
Razão:
A solicitação não possui um parâmetro obrigatório.
Solução:
É possível que você esteja usando algumas variáveis de campo personalizado do usuário, mas algumas das variáveis não têm o valor preenchido.
Você pode adicionar uma verificação condicional sobre todas as variáveis que está prestes a usar e notificar o administrador se houver algum erro.
Você também pode ir até os logs de erros, localizar o usuário, verificar o valor da variável usada na mensagem e confirmar se todas estão com o valor correto.
Saiba mais informações aqui: developers.facebook.com/docs/whatsapp/cloud-api/support/erro
Erro: “WhatsApp Message Template not found”
Isso significa que você usou um modelo de mensagem do WhatsApp, mas não conseguimos encontrar esse modelo de mensagem na sua conta do WhatsApp.
Pode ser que o usuário altere o modelo de mensagem ou o exclua do gerenciador de negócios do WhatsApp e as alterações não tenham sido sincronizadas de volta no NicoChat Chatbot
Erro: “Business account has been locked”
Parece que sua conta comercial do WhatsApp foi bloqueada por meta. você precisa entrar em contato com a meta para obter suporte.
Além disso, você pode ir ao seu gerenciador do WhatsApp no metagerenciador de negócios para obter quaisquer notificações relacionadas a esse erro.
Erro: “Failed to send message because this user's phone number is part of an experiment”
Você pode ver a mensagem de erro como esta:
[{"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 como 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 como esta:
[{"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 passado 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 vez que você recebeu uma mensagem iniciada pelo usuário - a sessão foi encerrada e você não pode mais usar mensagens de formato livre. Encontre uma maneira de restringir o envio de mensagens se não houver nenhuma mensagem recebida para o usuário/número de telefone fornecido em 24 horas. Alternativamente, você pode entrar em contato com o usuário usando um modelo de mensagem.
Erro: “Business Account and Consumer Account pair rate limit hit”
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 de telefone do remetente para o mesmo número de telefone do destinatário em um curto período de tempo.
Solução:
Aguarde e tente novamente a operação, caso pretenda enviar mensagens para o mesmo número de telefone. Você ainda pode enviar mensagens para um número de telefone diferente sem esperar
Saiba mais informações aqui:
Erro: “Error validating access token”
Você pode ver a mensagem de erro como esta:
Erro ao validar token de acesso: A sessão foi invalidada porque o usuário alterou sua senha ou o Facebook alterou a sessão por motivos de segurança.
Os usuários que se conectaram ao WhatsApp alteraram a senha da conta do Facebook. Como medida de segurança, o Meta desconecta todas as plataformas de terceiros, portanto, reconecte-se uma vez para estabelecer a conexão novamente e resolverá o problema.
A solução é reconectar o canal. Como o usuário pode ter alterado sua senha, o token anterior não é mais válido.
Erro: “Spam Rate limit hit”
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 seu status de qualidade no Gerenciador do WhatsApp e consulte a documentação Limites de taxa com base na qualidade para obter mais informações.
Erro: “Receiver is incapable of receiving this message”
Você normalmente verá a mensagem de erro como esta:
[{"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 é possível entregar uma mensagem. Os motivos podem incluir:
· 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 utilizando versão antiga do WhatsApp; deve usar a seguinte versão do WhatsApp ou 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:
Erro: “#200 permission error - WhatsApp Cloud API”
Este erro ocorre porque o usuário não concede permissão suficiente.
Erro: “Message not sent because outside 24 hours”
Este limite se aplica a meta canais (Messenger, Instagram, WhatsApp). Se o usuário não interagiu com seu bot nas últimas 24 horas.
Você não pode contatá-los diretamente. Para o WhatsApp, você precisará enviar uma mensagem modelo; para o Messenger, você precisará enviar uma notificação recorrente ou única.
Não há boas opções para entrar em contato com o usuário do Instagram se ele estiver fora da janela de 24 horas.
Mais informações aqui: developers.facebook.com/docs/messenger-platform/policy/polic
Erro: “Message Undeliverable”
O código de erro 131026, Mensagem não entregue
Razões possíveis:
Não é possível entregar uma mensagem. Os motivos podem incluir:
· 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 utilizando versão antiga do WhatsApp; deve usar a seguinte versão do WhatsApp ou superior:
o Android: 2.21.15.15
o SMBA: 21.2.15.15
oiOS: 2.21.170.4
oSMBI: 2.21.170.4
o KaiOS: 2.2130.10
o Rede: 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:
Erro: “Message undeliverable - Code 131026”
Não é possível entregar uma mensagem. Os motivos podem incluir:
· 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 utilizando versão antiga do WhatsApp; deve usar a seguinte versão do WhatsApp ou 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.
Erro: “Business eligibility payment issue”
O erro completo pode ser algo 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 API Cloud, canal WhatsApp.
Você precisará ir ao seu gerente de negócios do Facebook e, em seguida, ao gerente do WhatsApp, e então verificar se você tem algum problema de pagamento com seu faturamento. Como a meta cobra pela mensagem do modelo WhatApp, você precisará configurar o cartão de crédito válido na seção de cobrança do seu gerenciador do WhatsApp.
Erro: “Invalid Parameter #100”
Você pode ver a mensagem de erro como esta:
(#100) "Índice" de chave inesperado no parâmetro "template['components'][0]['parameters'][0]".
Razão:
A solicitação incluía um ou mais parâmetros não suportados ou com erros ortográficos.
Solução:
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.
Erro: “(#132001) Template name does not exist in the translation”
Este erro significa que o modelo não existe. O modelo não existe no idioma especificado ou o modelo 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.
Erro: “(#131053) Downloading media from weblink failed with https code 401, Unauthorized”
Este erro surge quando um armazenamento de terceiros (Cloudinary, S3 etc.) é integrado e um arquivo é compartilhado usando um fluxo sem as permissões necessárias, resultando na não entrega de arquivos de determinados formatos aos usuários.
Para resolver isso, desconecte sua integração de armazenamento ou ative as configurações que nos permitem compartilhar os arquivos.
Abaixo está um exemplo do cloudinary;
Erros comuns do canal do Instagram
Erro: “Message not sent because outside 24 hours”
Este limite se aplica a meta canais (Messenger, Instagram, WhatsApp). Se o usuário não interagiu com seu bot nas últimas 24 horas.
Você não pode contatá-los diretamente. Para o WhatsApp, você precisará enviar uma mensagem modelo; para o Messenger, você precisará enviar notificações recorrentes ou únicas.
Não há boas opções para entrar em contato com o usuário do Instagram se ele estiver fora da janela de 24 horas. Uma solução alternativa é reunir o e-mail do usuário e contatá-lo por e-mail.
Mais informações aqui: developers.facebook.com/docs/messenger-platform/policy/polic
Erros de webchat/omnicanal
Erro: o widget de chat na web não está aparecendo
O motivo pode ser um dos dois motivos abaixo:
· Você não colocou o domínio do seu site na lista de permissões
· Você não instalou o script em seu site ou página de destino corretamente.
Você pode encontrar a configuração “Domínio da lista de permissões” conforme a captura de tela abaixo
Para verificar o script que você precisa instalar em seu site, você pode inspecionar o código-fonte da página da web e certificar-se de que o script está na página.
Erro: “Message not sent because outside 30 days”
Os canais de chat na web usarão cookies para identificar o usuário. Estes cookies têm uma data de validade de 30 dias. Após 30 dias, se o usuário não tiver visitado seu site e atualizado os cookies, o cookie (usuário) irá expirar.
Qualquer mensagem que você esteja tentando enviar ao chat na web não poderá ser entregue ao usuário. E você verá esse erro em seus logs de erros.
Se você solicitou que o usuário usasse o SSO para fazer login no chat na web e conectar o mesmo usuário do chat na web a outros canais sociais, você ainda poderá entrar em contato com o usuário que está fora da janela de 30 dias.
Erros comuns do canal SMS
Erro: “Message not sent because outside telemarketing hours”
No canal SMS existe uma configuração de horário de telemarketing, você pode encontrar essa configuração nas configurações do canal SMS conforme imagem abaixo
Você precisa selecionar o horário de trabalho. observe a seleção do fuso horário. Se a mensagem SMS enviada não estiver dentro do horário de telemarketing, sua mensagem não será entregue.
Uma vez configurado o horário de telemarketing, todas as mensagens enviadas no canal SMS (fluxo, sequência, transmissão) serão bloqueadas caso sejam enviadas fora do horário de telemarketing.
Porém, se você estiver utilizando 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.
Erro: “Unable to create record: Attempt to send to unsubscribed recipient”
A pessoa para quem você está tentando enviar uma mensagem optou por não receber mensagens do seu número de telefone Twilio, remetente dos canais ou serviço de mensagens.
Você tentou enviar uma mensagem para um número 'Para' que respondeu com "STOP" a uma de suas mensagens anteriores. Você não poderá enviar para o número de telefone especificado no parâmetro 'Para' até que o assinante identificado pelo número de telefone responda com "INICIAR".
Razao possivel:
O aparelho do usuário final respondeu com "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.
· Solicite ao destinatário que assine novamente suas mensagens enviando uma mensagem de texto com "START" ou outra palavra-chave opcional
· Antes de enviar mensagens a um destinatário, certifique-se de que ele consentiu em receber mensagens suas.
Erros: “User is not Opt-In SMS”
Este erro geralmente ocorre quando você tenta enviar um SMS aos usuários do bot, mas o usuário não está ativado. Você pode ativar manualmente o usuário ou usar a ação “SMS Opt-in” dentro do bloco do nó de ação.
Você pode ir para “Usuários de bot”, selecionar o contato e, em seguida, selecionar a ação “Definir aceitação de SMS”.
Erros comuns do canal de voz
Erro: “Application Error”
Se você estiver ligando para seu canal de voz no NicoChat e de alguma forma ouvir “erro de aplicativo”, estes podem ser alguns motivos:
· Sua conta twilio ainda está em teste gratuito, pode haver algumas limitações na conta de teste gratuito. A solução é atualizar para uma conta twilio paga.
· Você usou algumas ações, como openAI ou conclusão de bate-papo desde o início, e leva tempo para obter uma resposta, então Twilio enfrenta o problema de tempo limite e então mostrará o erro do aplicativo. A solução é enviar uma mensagem primeiro e/ou usar “música de espera” o mais cedo possível.
Erro: “Unable to create record. Account not allowed to call xxxx”
Portanto, por padrão, o Twilio tem algumas restrições de localização geográfica se você quiser ligar ou enviar SMS internacionalmente.
então você precisará habilitar a permissão Geo para o seu número Twilio:
Eles são facilmente acessíveis no painel do Twilio.
Erros comuns do canal Telegram
Erro: “Forbidden: user is deactivated”
Você está tentando realizar uma ação em uma conta de usuário que foi desativada ou excluída pelo
Telegram.