Quando um contato é acionado para se inscrever em um fluxo, mas não consegue avançar, isso geralmente ocorre devido a informações ausentes, problemas de permissão ou limitações do sistema.
Este artigo explica os erros mais comuns de inscrição em fluxos que você pode encontrar no Flow Builder Avançado, o que cada erro significa e como resolvê-lo para que seu fluxo de trabalho funcione corretamente.
⚠️ Se o erro continuar após aplicar as etapas sugeridas, entre em contato com nossa equipe de suporte e inclua a mensagem exibida em Observações para agilizar a análise do problema.
💡 Os erros de inscrição em fluxos são exibidos em Observações, com explicações adicionais disponíveis nos Logs do fluxo, ajudando a identificar por que um contato ou ação específica não conseguiu continuar no fluxo.
Abaixo estão os detalhes de cada erro:
Informações inválidas ou ausentes
| Erro em Observações | O que significa | Possível solução |
| Formato de número de telefone inválido | O número de telefone não segue o formato exigido ou está sem código do país. | Certifique-se de que o número inclua o código do país (por exemplo, +1 555 123 4567). |
| Formato de endereço de e-mail inválido | O formato do e-mail não é válido. |
Certifique-se de que o e-mail esteja em um formato válido (por exemplo, nome@exemplo.com ). |
| Valor obrigatório ausente | Um campo obrigatório está vazio ou ausente. | Certifique-se de que o campo obrigatório contenha um valor antes de continuar. |
| Número de telefone ou e-mail ausente | O contato não possui número de telefone ou e-mail para identificá-lo. | Certifique-se de que o contato tenha um número de telefone ou e-mail. |
| Formato do campo inválido | O valor inserido não corresponde ao formato exigido. | Certifique-se de que o valor corresponda ao formato esperado. |
| Valor do campo não pode ser processado | O tipo de valor não corresponde ao esperado pelo sistema (por exemplo, texto em vez de número). | Certifique-se de que o campo esteja usando o tipo de dado correto. |
| Formato de data/hora inválido | O formato de data não é compatível. | Certifique-se de que a data/hora utilize um formato compatível (por exemplo, YYYY-MM-DD ou MM/DD/YYYY). |
| Tipo de mídia não compatível | O tipo ou tamanho do arquivo não é compatível com o canal selecionado. | Certifique-se de que o tipo e o tamanho do arquivo sejam compatíveis com o canal selecionado. |
| Número de telefone ausente | O contato não possui o número de telefone necessário para a ação. | Certifique-se de que o contato tenha um número de telefone válido. |
| Formato inválido | A expressão da variável contém sintaxe inválida ou operadores não compatíveis. | Certifique-se de que a expressão da variável esteja escrita em um formato compatível. |
Dados referenciados não encontrados
| Erro em Observações | O que significa | Possível solução |
| Contato não encontrado | O contato não existe mais ou foi excluído. | |
| Membro da equipe não encontrado | O membro da equipe atribuído está inativo ou foi excluído. | |
| Equipe não encontrada | A equipe selecionada foi excluída ou desativada. | |
| Canal não encontrado | O canal de mensagens foi desconectado ou removido. | Certifique-se de que o canal de mensagens ainda esteja conectado nas configurações de Canais. |
| Conversa não encontrada | A conversa não existe mais. | Certifique-se de que exista uma conversa para esse contato no canal selecionado. |
| Tipo de chamado não encontrado | A categoria ou modelo de chamado foi excluído. | |
| Registro de objeto personalizado não encontrado | O registro do objeto personalizado referenciado não existe mais. | |
| Registro externo não encontrado | O registro não existe no sistema externo conectado ou não há permissão de acesso relacionada. | Certifique-se de que o registro externo exista e que a integração tenha permissão para acessá-lo. |
| AI agent não encontrado | O AI agent foi excluído ou redefinido. | Certifique-se de que o AI agent ainda esteja configurado e disponível nas configurações de IA. |
| Destinatário não encontrado | O contato não possui uma conversa existente nesse canal (por exemplo, Facebook ou Instagram). | Certifique-se de que o contato tenha uma conversa existente nesse canal. |
Regras do fluxo atingidas
| Erro em Observações | O que significa | Possível solução |
| Número de telefone já existe | O número de telefone já está sendo usado por outro contato. | |
| Endereço de e-mail já existe | O e-mail já está associado a outro contato. | |
| Registro já existe | Um valor de campo único já existe. | |
| Contato já inscrito | O contato já entrou neste fluxo e múltiplas inscrições não são permitidas. | Certifique-se de que as configurações de inscrição do fluxo permitam nova inscrição caso o mesmo contato precise entrar novamente. |
| Possível loop detectado | As mesmas etapas estão sendo acionadas repetidamente em um curto período de tempo. | Revise a lógica do fluxo para evitar que etapas acionem umas às outras repetidamente. |
Problemas de autenticação ou permissão
| Erro em Observações | O que significa | Possível solução |
| Falha na autenticação | As credenciais de conexão são inválidas. | Verifique se a conta conectada ainda está autenticada e autorizada a executar esta ação. |
| Permissões insuficientes | A conta conectada não tem permissão para executar a ação. | Verifique se a conta conectada possui todas as permissões necessárias para esta ação. |
| Token de acesso expirado | A conexão expirou. | A conexão pode precisar de permissões adicionais para concluir esta ação. |
| Permissões obrigatórias ausentes | As permissões obrigatórias não foram concedidas durante a conexão. | Verifique se a conexão da integração ainda está ativa e se precisa ser renovada. |
| Endereço IP bloqueado | A plataforma externa bloqueou solicitações desse endereço IP. | Verifique se as solicitações da SleekFlow são permitidas pela plataforma externa (por exemplo, pode ser necessário configurar allowlist de IP). |
Problemas com serviços de terceiros
| Erro em Observações | Mensagem nos logs do fluxo | Possível solução |
| Serviço de terceiros indisponível | O serviço externo está temporariamente indisponível. | Verifique o status do serviço externo e tente novamente mais tarde. |
| Tempo de solicitação esgotado | O serviço externo demorou muito para responder. | Tente novamente mais tarde. |
| Serviço temporariamente ocupado | As solicitações estão sendo limitadas pela plataforma externa. | Tente novamente mais tarde ou reduza a frequência com que esta ação é acionada. |
Problemas temporários do sistema
| Erro em Observações | O que significa | Possível solução |
| Erro interno do sistema | Ocorreu um problema temporário no sistema. | Tente novamente mais tarde. Se o problema persistir, entre em contato conosco para obter suporte. |
Limites do plano ou de uso atingidos
| Erro em Observações | Mensagem nos logs do fluxo | Possível solução |
| Limite de créditos de IA atingido | O uso de créditos de IA excedeu o limite do plano. | Verifique se o seu plano atual inclui créditos de IA suficientes para esse uso. |
| Limite de inscrições atingido | O número máximo de inscrições foi alcançado. | Verifique se o seu plano suporta o volume atual de inscrições. |