Erros globais

Erro: “Falha na sequência, usuário do bot cancelou a inscrição”

Este erro é acionado sempre que o bot tenta enviar uma sequência para um usuário de bot que cancelou a inscrição no bot.

O usuário precisa ser inscrito novamente para receber as sequências.

Depois que o usuário do bot for reinscrito, você pode usar a ação básica, inscrever-se na sequência para reinscrever o usuário, conforme a captura de tela abaixo:

Open

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”

Open

Erro: “O tamanho dos dados é maior que 20.000 caracteres”

Para o campo personalizado do usuário, o limite máximo de armazenamento é de 20000 caracteres. Para resolver o problema, reduza o caractere 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 a captura de tela abaixo:

Observe que você pode precisar de habilidades de desenvolvedor para usar o recurso de pré-processamento de dados acima.

Erro: “Tempo limite da operação excedido após 30001 milissegundos com 0 bytes recebidos”

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 os servidores WiiChat atingem o tempo limite. Se um tempo limite do servidor expirar antes de receber uma resposta do OpenAI, este erro será registrado.

Para reduzir as chances desse erro ocorrer, reduza o histórico do Chat ou otimize os prompts e mensagens do sistema para que a solicitação leve menos tempo para ser executada. Você também pode dividir um histórico de chat maior em pedaços menores e usar um sistema de detecção de intenção como solução alternativa.

O WiiChat também oferece um add-on para aumentar os limites de tempo limite, o custo é de R$ 2000 por mês para aumentar mais 10 segundos.

Erro: “Erro de armazenamento de dados: a conexão não foi verificada”

Este erro geralmente ocorre quando você tenta integrar seu banco de dados ao WiiChat. A conexão é estabelecida, mas o WiiChat não consegue verificar a conexão. Na maioria dos casos, o motivo 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 falha ao ser estabelecida.

Insira as credenciais corretas e a conexão será verificada.

Erro: “O conteúdo da notificação não deve estar vazio”

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: “Falha na transmissão, usuário do bot cancelou a inscrição”

Este erro ocorre porque o usuário cancelou a inscrição no 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 e enviar 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 cancelado para manter apenas os usuários engajados no seu chatbot.

Você pode criar os gatilhos na automação: Usuário cancelou a inscrição no bot e disparar um fluxo com a ação “excluir usuário” dentro.

Nossa plataforma também tem 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 essa configuração).

Erro: “Open AI não conectado”

Este erro é acionado quando você tenta usar uma ação do OpenAI, mas o espaço de trabalho ainda não está integrado ao OpenAI.

Para integrar o OpenAI, clique em “Integração” no painel do seu espaço de trabalho, procure por OpenAI na aba Inteligência Artificial e insira sua chave de API OpenAI.

Clique em Salvar e certifique-se de que a conexão diz “Verificado”

Observação: o ID da organização é opcional, você pode deixá-lo em branco.

Erro: “Planilha não selecionada”

Este erro é acionado quando você tenta usar uma ação do Google Sheet e a planilha não está selecionada.

Pode haver vários outros motivos também. Isso pode acontecer se você instalou um modelo e a planilha do Google não foi copiada para sua própria conta.

Isso pode acontecer se o seu espaço de trabalho ainda não tiver o Planilhas Google integrado e, portanto, a instalação do modelo não conseguiu instalar uma cópia do Planilhas Google usado na sua conta.

Certifique-se de conectar sua conta do Google em Integração -> Armazenamento de dados/arquivos e também selecionar a planilha correta na ação Planilha do Google.

Erro: “Somente recurso Pro”

Este erro é acionado quando você tenta usar uma ação que está disponível apenas para usuários no plano Pro. Para usar essas ações, você terá que atualizar seu espaço de trabalho do plano gratuito para o plano empresarial ou de parceiro.

Erro: “Tempo limite da solicitação”

Este erro é acionado quando você está usando a ação Solicitação Externa e a chamada da API externa não retorna uma resposta em 15 segundos.

Os servidores WiiChat atingem o tempo limite após 15 segundos. A solução é garantir que a chamada da API seja concluída em 15 segundos. Se você quiser aumentar esse limite, pode fazê-lo comprando um complemento aqui: Contato WiiChat: Chatbot com Inteligência Artificial

Nota: Você pode lidar com esse erro dentro do seu fluxo usando o código de resposta “0”

Se você não puder otimizar o tempo limite, você pode escolher comprar o complemento de tempo limite. Você pode aumentar os limites de tempo limite em 10 segundos por R$ 200 cada.

Você pode testar com um carteiro para verificar quanto tempo leva para seu servidor gerar uma resposta, se você puder usar o servidor/endereço IP da Austrália para testar, isso seria mais preciso.

Você pode comprar a expansão de tempo limite aqui:

Contato WiiChat: Chatbot com Inteligência Artificial

Observe que custa R$ 200 por mês para cada 10 segundos extras. O complemento está no nível do bot. Por exemplo, se você quiser aumentar o limite em 30 segundos, altere a quantidade para 3 no link de pagamento acima e custará R$ 2000 por mês.

Erro: “Mensagem não enviada porque não inscrito”

Este erro é acionado sempre que o bot tenta enviar uma mensagem para um usuário que não está mais inscrito no bot.

Você pode usar a ação “opt-in” no flow builder, ações → ações básicas. Você também pode inscrever novamente os usuários bot usando a ação “Inscrever-se no bot” → ações básicas.

Erro: “Mais de 100 sequências inscritas nas últimas 24 horas”

A plataforma tem limites de taxa de no máximo 100 assinaturas de sequência. Se você tiver assinado a 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 no seu design de fluxo. Normalmente o limite é suficiente para as automações do chatbot. Você precisa verificar sua lógica de fluxo para corrigir o problema.

Erro: “O Planilha Google não está conectado”

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 dar todas as permissões solicitadas ao conectar sua conta do Planilhas Google.

Erro: “Usuários de bot no espaço de trabalho estão acima do limite”

Este erro significa que você atingiu os limites do seu 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 então 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.

Você também pode fazer upgrade para o plano superior, que tem limites maiores de usuários de bots.

Erro: “O limite de taxa foi excedido. Tente novamente após algum tempo”

Esse erro geralmente é acionado quando uma transmissão está sendo enviada ou você tem um grande tráfego de conversas ao vivo e ele atinge 100 erros a cada 5 minutos para seu bot.

A transmissão será pausada temporariamente.

O WiiChat 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 ir em “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ê pode verificar e otimizar seu fluxo.

Observação: se você estiver usando o recurso de limites de taxa, esse erro também será registrado se você exceder esses limites.

Erro: “Excedeu o limite máximo de tempo de execução de 40 segundos”

Este erro é acionado sempre que não há interação do usuário por 40 segundos.

Por padrão, o WiiChat 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 WiiChat 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 pergunta) dentro de 40 segundos, caso contrário, você verá este erro.

Alguns exemplos de ações de interação do usuário:

• Nó de perguntas - 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 no fluxo do seu chatbot. Cada interação do usuário redefinirá o tempo máximo de execução.

Além disso, você pode escolher comprar o add-on de tempo limite máximo de execução. Você pode aumentar o limite de tempo limite em 10 segundos por 20$/mês cada.

Por exemplo, se você quiser aumentar o limite em 30 segundos, altere a quantidade para 3 e isso custará R$ 2000/mês.

Você pode comprar a expansão de tempo limite aqui:

Contato WiiChat: Chatbot com Inteligência Artificial

Observe que o complemento está no nível do bot. Entre em contato com o suporte do WiiChat assim que o pagamento for feito, seja específico sobre o ID do workspace e o nome do bot no seu e-mail.

Erro: “Mais de 30 passos sem passo de interação”

Nos designs de fluxo do WiiChat, cada nó é considerado uma etapa.

Não importa quantas ações você esteja usando naquele 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 de segundo plano ou paralelos que são acionados.

Alguns exemplos de ações de interação do usuário:

• Nó de perguntas - 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 menores) e evitar loops infinitos.

Erro: “O título do cartão está vazio”

Se você estiver usando “elemento de cartão” no bloco de envio de mensagem, será necessário certificar-se de que o título do cartão tenha valor.

Se você estiver usando um campo personalizado do usuário - variável no título do cartão, você precisará certificar-se de que a variável tenha o valor. Você pode verificar isso olhando para a visão geral do usuário do bot e selecionar o usuário do bot que tem o erro acionado. Certifique-se de que o campo personalizado usado para o título do cartão tenha algum valor. Se não, então significa que suas etapas antes deste nó têm um problema que você precisa solucionar em algum lugar

Caso contrário, você verá o erro. Se estiver usando um campo personalizado do usuário no título do cartão, você pode usar a verificação de condição antes de enviar o cartão e notificar o administrador se houver algum problema como esse.

Erro: “Complemento comprado, exclua o bot, o que fazer a seguir?”

Então é assim que nosso faturamento funciona. Imagine que você comprou um complemento de bot extra, que custa R$ 100 por mês. A fatura é gerada imediatamente.

E você o usou por 15 dias, digamos, e então decidiu que não precisava mais desse bot e o excluiu.

Então, o que acontece agora é:

Então, se você ainda estiver usando o serviço WiiChat, esses créditos serão usados ​​para cobrir seu pagamento mensal. Digamos que seu pagamento mensal esteja chegando, deveria ser de R$ 100 por mês.

Como você ainda tem R$ 50 de crédito conosco, cobraremos apenas a diferença. Portanto, cobraremos R$ 50 pelo pagamento deste mês.

Além disso, se você decidir adicionar outro membro, o que custará R$ 100 por mês, cobraremos apenas R$ 25 por esse complemento.

Portanto, o crédito equilibrado será usado para cobrir o custo do seu complemento ou da assinatura mensal.

Infelizmente, você não poderá ver o crédito no painel do WiiChat.

Também podemos fazer isso se reembolsarmos seu cartão. Observe que serão cobradas taxas de transação de 10% para o reembolso.

Erro: “Mais de 100 atrasos inteligentes usados ​​nas últimas 24 horas”

Máximo de 100 ações de atraso inteligente podem ser acionadas para cada usuário de bot. Inspecione e modifique o nó que está causando o problema para evitar um loop infinito que acione ações de atraso inteligente, garantindo a adesão ao limite de 100 ações por usuário de bot em 24 horas.

Causas Possíveis:

O erro ocorre quando o usuário do bot recebe o máximo permitido de 100 ações de atraso inteligente em 24 horas, possivelmente devido a um loop infinito acionado em seu fluxo.

Soluções possíveis:

Para resolver esse problema, inspecione o nó específico no seu fluxo que está causando o erro e certifique-se de que você não configurou uma automação de loop infinito.

Modifique a lógica de 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 podem levar à ultrapassagem do limite de ação de 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 para um atraso de espera se o canal em questão não suportar digitação. Dessa forma, você não precisa mais usar o atraso inteligente e pode resolver o problema do seu problema.

Erro: “Falha no upload. Você atingiu o limite de tamanho de armazenamento (1 GB). Conecte-se ao seu armazenamento S3 para continuar o upload”

Permitimos 1 GB de armazenamento gratuito para os arquivos de upload. Se precisar de armazenamento extra, você pode criar uma conta gratuita no CloudInary ou no S3 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 aba Meus Conteúdos.

Erro: “Integração PostgreSQL - Tabela não sincronizada”

Em primeiro lugar, suporte apenas tabelas com ID de chave primária de incremento automático

Além disso, depois que a tabela é sincronizada com o WiiChat, não a excluímos, mesmo que ela seja excluída do seu banco de dados Postgresql.

Porque você ainda pode usá-los na sua ação de datastore do chatbot. Você pode excluir manualmente a tabela do lado do WiiChat.

Observe que, depois que a tabela for excluída do lado do WiiChat, mesmo que você sincronize a mesma tabela de volta com o WiiChat, 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 do WiiChat ao tentar comprar um plano, devido ao crédito insuficiente do parceiro para cobrir o custo do plano.

Possível motivo do erro:

A ocorrência desse erro está ligada à insuficiência de crédito do parceiro disponível no momento em que seu cliente tenta comprar um plano.

Como parceiro da WiiChat, quando o saldo de créditos é insuficiente, esse erro aparece, 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 completar o crédito do parceiro, haverá fundos adequados para cobrir o custo do espaço de trabalho. Essa ação facilitará um processo de compra perfeito para seus clientes, permitindo que eles atualizem e comprem 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 um excesso de bots ou membros no plano atual.

A solução envolve remover bots ou membros excedentes para se adequarem aos limites do plano atual antes da atualização.

Possível motivo do erro:

O erro provavelmente surge devido à limitação do plano atual no número de membros da equipe ou bots, excedendo a contagem permitida para a atualização desejada. Para resolver isso, remover membros ou bots adicionais é necessário 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 esteja de acordo com os limites definidos pelo plano desejado.

Isso envolve remover membros excedentes por meio das configurações do espaço de trabalho e excluir 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.

Depois que os membros ou bots excedentes forem removidos, prossiga com a atualização do plano e, posteriormente, adicione novamente os membros ou bots necessários.

Ou você pode fazer upgrade para um plano superior que tenha mais limites do que seu plano atual.

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 a URL do webhook de entrada, ela será ignorada.

Se você quiser verificar os limites do webhook de entrada, basta usar uma solicitação externa para acionar a URL do webhook de entrada e verificar o cabeçalho de resposta. Você encontrará os limites e quantas solicitações restam.

Aumente os limites de webhook de entrada

Se o usuário precisar de webhook de entrada extra, ele pode comprar com base nas informações abaixo:

500/dia - Incluído -› 15 mil solicitações/por mês
1000/dia - R$ 100 por mês -› 30 mil solicitações/por mês
2000/dia - R$ 200 por mês -› 60 mil solicitações/por mês
3000/dia - R$ 300 por mês -› 90 mil solicitações/por mês
4000/dia - R$ 400 por mês -› 120 mil solicitações/por mês
5000/dia - R$ 500 por mês -› 150 mil solicitações/por mês
10000/dia - R$ 1.000 por mês -› 300 mil solicitações/por mês

Link de pagamento:

Contato WiiChat: Chatbot com Inteligência Artificial

Você pode selecionar quantos complementos deseja comprar, e cada unidade significa 1.000 solicitações por dia, ao custo de R$ 100 por mês.

O limite de webhook de entrada é projetado no nível do bot, não no nível do workspace. Você precisará fornecer o flowNS ou o workspaceID e o nome do bot.

Quando o pagamento for feito, envie ao suporte o nome do bot e o ID do workspace ou e-mail. Processaremos sua solicitação em até 1 dia útil.

Erro: “Importar contato mostra caractere estranho - Por exemplo, idioma hebraico”

Você pode enfrentar esse problema se estiver importando contato para a seção de usuário do bot, e o valor for todos caracteres especiais. Isso geralmente acontece com idiomas RTL, como hebraico, árabe. É porque o sistema de codificação não é bem suportado com idiomas 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írgulas) (*.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. ). Depois de selecionar UTF-8,
escolha qualquer tipo em " Salvar como tipo " e salve o arquivo com um nome de arquivo ligeiramente diferente do original.

Nota importante, o título não pode ser salvo em hebraico, pois gerará um erro ao importar. Então salve o título no formato inglês.

Erros comuns do canal do Facebook

Erro: “Solicitação de postagem não suportada. Não pode ser carregado devido a permissões ausentes ou não suporta esta operação”

Você pode ver a mensagem de erro como esta:

Solicitação de postagem não suportada. O objeto com ID '100343472848953' não existe, não pode ser carregado devido a permissões ausentes ou não suporta esta operação. Leia a documentação da Graph API em Graph API - Documentation - Meta for Developers

Quando você conecta o canal à nossa plataforma. Há uma tela que permite que você dê a permissão que precisamos. Por favor, certifique-se de selecionar todas as permissões que são solicitadas naquela tela.

Como o 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 você deseja conectar e dar todas as permissões que nossa plataforma precisa.

Erro: “Enviando carga útil: 2534015 (#100) Dados de mensagem inválidos”

De acordo com o código de erro meta, esse erro ocorre porque o tipo de dado que você está enviando não é permitido para seu tipo de mensagem.

Se você estiver em um canal omni, você deve verificar o canal suportado em cada elemento de mensagem. Há ícones sociais como a captura de tela abaixo:

Você pode aprender mais informações aqui: https://developers.facebook.com/docs/messenger-platform/error-codes/

Erro: “Enviando carga útil: 1545041 (#551) Esta pessoa não está disponível no momento”

Ou o usuário gerou muitos erros da nossa parte ou o usuário pode bloquear seu bot, então a mensagem não será entregue.

Saiba mais informações:

https://developers.facebook.com/docs/messenger-platform/error-codes/

Erro: “Você foi temporariamente bloqueado de executar esta ação”

você pode ver a mensagem de erro abaixo:

Erro ao enviar payload: (#2022) Você foi temporariamente bloqueado de executar esta ação. Isso significa que o Facebook emitiu um bloqueio temporário em sua conta do Facebook.

não conseguimos enviar para nenhuma conta que tenha sido bloqueada pelo Facebook. Recomendamos que você verifique seu gerenciador de negócios do Facebook ou o centro de notificação de alerta de página para obter mais informações sobre esse problema.

Erro: “Erro de ocultar comentário: (#200) Os usuários só podem editar seus próprios comentários publicados pelo mesmo aplicativo”

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:

Saiba mais informações: https://developers.facebook.com/docs/graph-api/reference/v17.0/comment#hiding

Erro: “Conectando diferentes páginas do FB a diferentes áreas de trabalho usando 1 conta do FB”

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:

o vídeo abaixo foi gravado para ser enviado aos usuários que têm esse problema específico e somente a eles, pois não promovemos abertamente esse procedimento

Certifique-se de selecionar todas as páginas que estão conectadas à plataforma WiiChat, mesmo que apareça uma mensagem de erro como "xx página está conectada a xx espaço de trabalho", isso não deve importar.

Mas você perderá a conexão para a página anterior se não selecionar essas páginas para conectar. Então, certifique-se sempre de selecionar todas as páginas que estão se conectando à plataforma WiiChat.

Erro: “Erro de resposta de comentário: Você já postou isso. Não é permitido postar o mesmo conteúdo repetidamente no Facebook”

você não pode postar o mesmo conteúdo repetidamente.

Você pode adicionar um randomizador para enviar mensagens diferentes ou usar o openAI para gerar conteúdo personalizado dinamicamente.

Erro: “Mensagem não enviada porque fora de 24 horas”

Este limite se aplica a canais meta (Messenger, Instagram, WhatsApp). Se o usuário não tiver interagido 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 uma notificação única.

Para o usuário do Instagram, você pode capturar o e-mail ou número de telefone do usuário e pode contatá-lo por e-mail ou SMS, mesmo que ele esteja fora do período de 24 horas.

Mais informações aqui:

https://developers.facebook.com/docs/messenger-platform/send-messages https://developers.facebook.com/docs/messenger-platform/policy/policy-overview/

A solução é usar uma condição como a da captura de tela abaixo e garantir que você esteja sempre alcançando o usuário que interagiu com seu chatbot nas últimas 24 horas, e usar métodos diferentes para alcançar o usuário que está fora da janela de interação de 24 horas.

Você também 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 de e-mail.

Erro: “Não consigo receber mensagem de solicitação de notificação recorrente”

O motivo para isso é que o Facebook tem um limite de taxa que permite que você envie apenas uma solicitação de opt-in por semana com o mesmo título específico para uma pessoa. Isso 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 de opt-in duplicadas para uma pessoa. Uma solicitação de opt-in 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 profissional do Instagram

• Você só pode enviar solicitações de inscrição durante a janela de mensagens padrão

• Se uma pessoa optar por receber 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 opt-in pendentes

• Se uma pessoa tiver optado 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 profissional do Instagram, geralmente, até 10 solicitações de opt-in para títulos diferentes podem ser enviadas por usuário em um período de 7 dias. Um sublimite de até 5 solicitações de opt-in pode ser enviado a um usuário em um dia. No entanto, você deve considerar se os usuários provavelmente acharão cada solicitação de opt-in relevante e valiosa antes de enviar.

Esses requisitos e limitações estão sujeitos a alterações, pois estamos sempre nos esforçando para a melhor experiência de usuário e de negócios. Mais informações:

Marketing Messages - Messenger Platform - Documentation - Meta for Developers

Erro: “1893016 Chamadas para esta API excederam o limite de taxa”

O motivo para isso é que o Facebook tem um limite de taxa que permite que você envie apenas uma solicitação de opt-in por semana com o mesmo título específico para uma pessoa. Isso 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 de opt-in duplicadas para uma pessoa. Uma solicitação de opt-in 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 profissional do Instagram

• Você só pode enviar solicitações de inscrição durante a janela de mensagens padrão

• Se uma pessoa optar por receber 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 opt-in pendentes

• Se uma pessoa tiver optado 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 profissional do Instagram, geralmente, até 10 solicitações de opt-in para títulos diferentes podem ser enviadas por usuário em um período de 7 dias. Um sublimite de até 5 solicitações de opt-in pode ser enviado a um usuário em um dia. No entanto, você deve considerar se os usuários provavelmente acharão cada solicitação de opt-in relevante e valiosa antes de enviar.

Esses requisitos e limitações estão sujeitos a alterações, pois estamos sempre nos esforçando para a melhor experiência do usuário e do negócio. Mais detalhes aqui: Marketing Messages - Messenger Platform - Documentation - Meta for Developers

Erros comuns do canal WhatsApp

Erro: “Erro de upload de mídia”

Você pode ver a mensagem de erro abaixo:

A razão é:

Esta pode ser a URL que você está usando na mensagem ou o modelo de mensagem não está disponível publicamente para acesso.

Além disso, pode ser que o formato de arquivo que você está usando não seja suportado pelo WhatsApp.

Solução:

Não conseguimos carregar a mídia por um ou mais motivos, como um tipo de mídia não suportado . Consulte o valor error.error_data.details para obter mais informações sobre o motivo pelo qual não conseguimos carregar a mídia.

Você pode verificar a URL que está usando e certificar-se de que a URL do arquivo começa com https e termina com o formato do arquivo no final da URL. Além disso, esse arquivo de mídia deve estar sempre acessível publicamente.

Bloqueado por Integridade. Requisitos de integridade não atendidos

Se você vir esta mensagem de erro, ela pode ser acionada se você estiver tentando usar o recurso “WhatsApp Flow”. Você precisará verificar se seu meta gerente de negócios está verificado ou não.

Para certos recursos como o WhatsApp Flow, o meta exige um gerente de negócios verificado para obter acesso.

Erro: “Enviando carga útil: 2018062 (#100)”

A solicitação incluiu 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 personalizadas do usuário, mas algumas delas 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 acessar os logs de erros, localizar o usuário, verificar o valor da variável usada na mensagem e confirmar se todos eles têm o valor correto.

Saiba mais informações aqui: Error Codes - Cloud API - Documentation - Meta for Developers

Erro: “A mensagem falhou ao enviar porque há restrições sobre quantas mensagens podem ser enviadas deste número de telefone”

Você pode ver a mensagem de erro como esta:

Isso pode ocorrer porque muitas mensagens anteriores foram bloqueadas ou sinalizadas como spam.

Isso ocorre porque você enviou muitas mensagens para outros usuários, mas muitas mensagens foram bloqueadas ou sinalizadas como spam.

Então, o meta colocou algumas limitações no seu número. Você precisa manter uma qualidade de conta saudável, caso contrário, sua conta ou número WABA pode ser bloqueado.

Erro: “A mensagem não pôde ser enviada. Você não tem fundos suficientes no saldo pré-pago da sua conversa para participar de qualquer conversa paga”

Você pode ver a mensagem de erro como esta:

A mensagem não pôde ser enviada. Você não tem fundos suficientes no seu saldo pré-pago de conversa para participar de qualquer conversa paga. Por favor, prossiga para http://hub.360dialog.com -> 'Insights & Billing' para recarregar seu saldo e, opcionalmente, habilitar a renovação automática, o que evitará que você fique sem fundos no futuro.

O motivo é que você não tem fundos suficientes na sua conta 360dialog. Você precisará comprar mais créditos da 360dialog. Acesse sua conta 360dialog, insights e cobranças e adicione mais créditos.

Erro: “(#200) Erro de permissão”

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: “Parâmetro obrigatório ausente - Código de erro 131008”

Você pode ver o código de erro:

(#131008) Parâmetro obrigatório está faltando Parâmetro do tipo texto está faltando valor de texto

Razão:

Falta um parâmetro obrigatório na solicitação.

Solução:

É possível que você esteja usando algumas variáveis ​​de campo personalizadas do usuário, mas algumas delas 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 acessar os logs de erros, localizar o usuário, verificar o valor da variável usada na mensagem e confirmar se todos eles têm o valor correto.

Saiba mais informações aqui: Error Codes - Cloud API - Documentation - Meta for Developers

Erro: “Modelo de mensagem do WhatsApp não encontrado”

Isso significa que você usou uma mensagem modelo do WhatsApp, mas não conseguimos encontrar essa mensagem modelo na sua conta do WhatsApp.

Pode ser que o usuário tenha alterado o modelo da mensagem ou o tenha excluído do gerenciador de negócios do WhatsApp e as alterações não tenham sido sincronizadas de volta no chatbot do WiiChat

Erro: “A conta comercial foi bloqueada”

Parece que sua conta comercial do WhatsApp foi bloqueada pelo Meta. Você precisa entrar em contato com o Meta para obter suporte.

Além disso, você pode acessar seu gerenciador do WhatsApp no ​​metagerenciador de negócios para ver quaisquer notificações relacionadas a esse erro.

Erro: “Falha ao enviar mensagem porque o número de telefone deste usuário faz parte de um experimento”

Você pode ver a mensagem de erro como esta:

A mensagem não foi enviada como parte de um Experiments - Cloud API - Documentation - Meta for Developers . Veja https://developers.facebook.com/docs/whatsapp/cloud-api/guides/experiments#marketing-message-experiment .

Saiba mais aqui: Error Codes - Cloud API - Documentation - Meta for Developers

Erro: “A mensagem falhou ao enviar porque mais de 24 horas se passaram desde a última resposta do cliente para este número”

Você pode ver a mensagem de erro como esta:

[{"code":131047,"title":"Mensagem de reengajamento","message":"Mensagem de reengajamento","error_data":{"details":"A mensagem falhou ao ser enviada porque mais de 24 horas se passaram desde a última resposta do cliente para 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 falhou ao ser enviada porque mais de 24 horas se passaram desde a última resposta do cliente para 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. Como alternativa, você pode entrar em contato com o usuário usando uma Mensagem de Modelo.

Erro: “Taxa de par de contas comerciais e contas de consumidor atingida”

Você pode ver o erro assim:

(#131056) (Conta empresarial, Conta de consumidor) limite de taxa de par atingido

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, se você pretende 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:

https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes/

Erro: “Erro ao validar o token de acesso”

Você pode ver a mensagem de erro como esta:

Erro ao validar o 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.

Usuários que se conectaram ao WhatsApp alteraram suas senhas em suas contas do Facebook. Como medida de segurança, o Meta faz logout de todas as plataformas de terceiros, então reconectar uma vez para estabelecer a conexão novamente resolverá o problema

A solução é reconectar o canal. Porque o usuário pode ter alterado sua senha, então o token anterior não é mais válido.

Erro: “Limite de taxa de spam atingido”

Você pode ver o erro assim:

Razão:

A mensagem falhou ao ser enviada porque há restrições sobre quantas mensagens podem ser enviadas deste número de telefone. Isso pode ter ocorrido 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 baseados em qualidade para obter mais informações.

Erro: “O receptor não consegue receber esta mensagem”

Normalmente você verá uma mensagem de erro como esta:

[{"code":131026,"title":"O destinatário não consegue receber esta mensagem","message":"O destinatário não consegue receber esta mensagem","error_data":{"details":"Mensagem não entregue."}}]

Razões possíveis:

Não é possível entregar uma mensagem. Os motivos podem incluir:

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:

Error Codes - Cloud API - Documentation - Meta for Developers

Erro: “#200 erro de permissão - WhatsApp Cloud API”

Este erro ocorre porque o usuário não dá permissão suficiente.

Erro: “Mensagem não enviada porque fora de 24 horas”

Este limite se aplica a canais meta (Messenger, Instagram, WhatsApp). Se o usuário não tiver interagido com seu bot nas últimas 24 horas.

Você não pode contatá-los diretamente. Para o WhatsApp, você precisará enviar uma mensagem de modelo, para o Messenger, você precisará enviar uma notificação recorrente ou uma notificação única.

Não há boas opções para alcançar o usuário do Instagram se ele estiver fora do período de 24 horas.

Mais informações aqui: https://developers.facebook.com/docs/messenger-platform/policy/policy-overview/

Erro: “Mensagem não entregue”

Código de erro 131026, Mensagem não entregue

Razões possíveis:

Não é possível entregar uma mensagem. Os motivos podem incluir:

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:

Error Codes - Cloud API - Documentation - Meta for Developers

Erro: “Mensagem não entregue - Código 131026”

Não é possível entregar uma mensagem. Os motivos podem incluir:

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: “Problema de pagamento de elegibilidade empresarial”

O erro completo pode ser algo parecido com isto:

[{"code":131042,"title":"A mensagem falhou ao enviar porque houve um ou mais erros relacionados ao seu método de pagamento.","href":"https:\/\/developers.facebook.com\/docs\/whatsapp\/cloud-api\/support\/error-codes\/"}]

Esse erro geralmente acontece na API do Cloud, no canal do WhatsApp.

Você precisará ir ao seu gerenciador de negócios do Facebook e, em seguida, ao gerenciador do WhatsApp e, em seguida, verificar se você tem algum problema de pagamento com sua fatura. Como a meta cobra pela mensagem do modelo do WhatApp, você precisará configurar o cartão de crédito válido na seção de faturamento do seu gerenciador do WhatsApp.

Erro: “Parâmetro inválido nº 100”

Você pode ver a mensagem de erro como esta:

(#100) Chave inesperada "index" no parâmetro "template['components'][0]['parameters'][0]".

Razão:

A solicitação incluiu um ou mais parâmetros não suportados ou com erros ortográficos.

Solução:

Consulte a referência do ponto de extremidade 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 seja uma chave pública RSA válida de 2048 bits no formato PEM .

Certifique-se de que não haja incompatibilidade entre o número de telefone que você está registrando e um número de telefone armazenado anteriormente.

Erro: “(#132001) O nome do modelo não existe na tradução”

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 foi aprovado e que o nome do modelo e o local do idioma estão corretos. Certifique-se de seguir as diretrizes do modelo de mensagem .

Erro: “(#131053) Falha no download de mídia do link da web com código https 401, não autorizado”

Esse erro ocorre quando um armazenamento de terceiros (Cloudinary, S3 etc.) é integrado e um arquivo é compartilhado usando um fluxo sem as permissões necessárias, resultando em arquivos de determinados formatos não sendo entregues 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 no canal do Instagram

Erro: “Mensagem não enviada porque fora de 24 horas”

Este limite se aplica a metacanais (Messenger, Instagram, WhatsApp). Se o usuário não tiver interagido com seu bot nas últimas 24 horas.

Você não poderá contatá-lo diretamente. Para o WhatsApp, você precisará enviar uma mensagem de modelo, para o Messenger, você precisará enviar notificações recorrentes ou notificações únicas.

Não há boas opções para alcançar o usuário do Instagram se ele estiver fora de uma 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: https://developers.facebook.com/docs/messenger-platform/policy/policy-overview/

Erros de Webchat/Omnichannel

Erro: O widget de bate-papo da web não está aparecendo

O motivo pode ser um dos dois abaixo:

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 no seu site, você pode inspecionar o código-fonte da página e certificar-se de que o script está na página.

Erro: “Mensagem não enviada porque fora de 30 dias”

Os canais de bate-papo da Web usarão cookies para identificar o usuário. Esses cookies têm uma data de expiração 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) expirará.

Qualquer mensagem que você esteja tentando enviar via web chat não poderá ser entregue ao usuário. E você verá esse erro em seus logs de erro.

Se você solicitou que o usuário usasse o SSO para fazer login no chat da web e conectar o mesmo usuário do chat da web a outros canais sociais, você ainda poderá entrar em contato com o usuário que está fora do período de 30 dias.

Erros comuns do canal SMS

Erro: “Mensagem não enviada porque fora do horário de telemarketing”

No canal SMS, há uma configuração de horário de telemarketing, você pode encontrar essa configuração nas configurações do canal SMS conforme a captura de tela 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.

Depois de configurar o horário de telemarketing, todas as mensagens enviadas no canal SMS (fluxo, sequência, transmissão) serão bloqueadas se forem enviadas fora do horário de telemarketing.

Entretanto, se você estiver usando Ação -> Notificação -> Notificação por SMS ou Ação -> Ação avançada -> Enviar mensagem SMS, essas duas ações não serão afetadas pelo horário de telemarketing.

Erro: “Não foi possível criar registro: tentativa de enviar para destinatário cancelado”

A pessoa para quem você está tentando enviar uma mensagem optou por não receber mensagens do seu número de telefone Twilio, do remetente dos Canais ou do Serviço de Mensagens.

Você tentou enviar uma mensagem para um número 'Para' que respondeu com "PARAR" 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 tenha respondido com "INICIAR".

Razao possivel:

O aparelho do usuário final respondeu com "PARAR" ou outra palavra-chave de cancelamento

Soluções possíveis:

Erros: “O usuário não é Opt-In SMS”

Esse erro geralmente ocorre quando você tenta enviar um SMS para usuários de bot, mas o usuário não está inscrito. Você pode inscrever o usuário manualmente ou usar a ação “SMS Opt-in” dentro do bloco de nó de ação.

Você pode ir em “Usuários de bot”, selecionar o contato e então selecionar a ação “Definir opt-in de SMS”.

Erros comuns do canal de voz

Erro: “Erro de aplicação”

Se você estiver chamando seu canal de voz no WiiChat e, de alguma forma, ouvir “erro de aplicativo”, isso pode ser por alguns motivos:

Erro: “Não foi possível criar registro. Conta não tem permissão para chamar xxxx”

Então, por padrão, o Twilio tem algumas restrições de geolocalização caso você queira fazer ligações ou enviar SMS internacionalmente.

https://www.twilio.com/docs/verify/preventing-toll-fraud/verify-geo-permissions

então você precisará habilitar a permissão Geo para seu número Twilio:

https://www.twilio.com/docs/sip-trunking/voice-dialing-geographic-permissions

Eles são facilmente acessíveis no painel do Twilio.

Erros comuns do canal Telegram

Erro: “Proibido: usuário desativado”

Você está tentando executar uma ação em uma conta de usuário que foi desativada ou excluída pelo Telegram.