Quando algo não estiver funcionando, esta é a primeira página a consultar. Os sintomas estão listados por onde você os notaria — comece pela seção que corresponde ao que você está vendo.
Primeiro, não entre em pânico. A maioria dos problemas é de configuração, não bugs. A plataforma foi feita para que você não consiga quebrar nada importante — pause a implantação, corrija o problema, retome. Mesmo um problema feio raramente custa mais do que algumas chamadas de teste desperdiçadas.
Se você não encontrar seu problema aqui: escreva para [email protected] com o ID da implantação, o ID da chamada (se aplicável) e uma descrição do que você esperava versus o que aconteceu. Inclua capturas de tela se for algo visual.
Chamadas de teste
"Minha chamada de teste nunca chegou."
| Causa provável | O que verificar |
|---|
| Formato do número de telefone incorreto | Inclua o código do país. EUA: +15551234567. Índia: +919876543210. A plataforma mostra uma prévia "formato testado: …" antes de disparar. |
| Crédito de avaliação esgotado | Configurações → Plano e cobrança → Uso. Contas novas recebem US$ 25 em crédito. |
| Número na lista global de supressão | Configurações → Compliance → Lista de Não Perturbe → pesquise seu número. |
| Rejeição da operadora | Algumas operadoras (especialmente internacionais) bloqueiam chamadas de números novos. Tente outro número de origem. |
| Bloqueador de spam no seu telefone | Os filtros de spam da Apple/Google às vezes bloqueiam silenciosamente. Tente outro número de origem. |
"A chamada de teste chegou, mas o Finn ficou em silêncio / estranho."
| Causa provável | O que verificar |
|---|
| Mensagem de boas-vindas definida como defined, mas o campo está vazio | Editar Finn → Mensagem de Boas-Vindas → confirme que há texto no campo ou mude para dynamic |
| Voz não atribuída corretamente | Editar Finn → Voz → selecione novamente. Algumas vozes exigem correspondência de região. |
| Serviço de LLM mal configurado (avançado) | Editar Finn → Configuração do Serviço de IA → restaure o padrão |
| Problema de permissão de microfone do lado do Finn | Atualize a página e tente de novo. Se persistir: contate o suporte. |
Criando / editando um Finn
"Não consigo salvar meu Finn — o botão Salvar está esmaecido."
| Causa provável | O que verificar |
|---|
| Campo obrigatório vazio | Procure rótulos em vermelho — geralmente Nome, Voz ou Idioma. |
| Erro de validação no fluxo de trabalho | Se estiver usando a aba Workflow, verifique se há nós com borda vermelha. |
| Sessão do navegador expirada | Atualize a página, faça login novamente e tente de novo. Suas edições são salvas como rascunho automaticamente. |
"Meu Finn não está seguindo o roteiro que escrevi."
| Causa provável | O que corrigir |
|---|
| Campo de identidade vago demais | Seja específico. "Você é a Maya, uma recepcionista simpática" funciona melhor que "Você é um assistente de IA". |
| Diretrizes de segurança perdidas entre muitas outras instruções | Mova as diretrizes críticas para um campo dedicado (Estilo e Diretrizes). |
| Instruções conflitantes entre campos | Revise Identidade + Estilo + Boas-vindas + Fluxo de trabalho em busca de contradições. |
| A base de conhecimento contém informações contraditórias | Abra a aba Conhecimento no Data Extractor Sidebar em uma chamada de exemplo para ver o que foi recuperado. Remova as contradições da base de conhecimento. |
| Formato livre quando você precisa de estrutura | Se você tem um fluxo com ordem obrigatória, use Workflows. |
"O Finn fala demais / fala de menos."
| Sintoma | Correção |
|---|
| Fala demais | Adicione às Diretrizes de Resposta: "Mantenha as respostas em até duas frases, salvo se pedirem mais detalhes." |
| Muito breve | Adicione às Diretrizes de Resposta: "Dê respostas completas, com exemplos quando fizer sentido." |
| Interrompe o interlocutor | Ajuste Configurações → Configurações de Chamada → Sensibilidade a Interrupções (menor = mais paciente) |
| Silêncios longos e constrangedores | Reduza max_idle_duration (ex.: 5s em vez de 10s) |
"Meu Finn fica repetindo a mesma pergunta."
| Causa provável | Correção |
|---|
| A resposta do interlocutor não correspondeu ao formato esperado | Flexibilize o parser do nó Ask ou reformule a pergunta |
| O LLM não registrou a resposta na memória | Adicione às Diretrizes de Resposta: "Depois que uma pergunta for respondida, não a repita." |
| Erro de loop no fluxo de trabalho | Abra o fluxo de trabalho → verifique se há uma conexão que retorna ao nó Ask |
Base de Conhecimento
"O Finn não responde perguntas que eu sei que estão nos documentos."
| Causa provável | O que verificar |
|---|
| Documentos ainda não indexados | Aba Base de Conhecimento → verifique o status. Deve indicar Indexado. Clique em Reindexar Agora se estiver travado. |
| Documento é PDF apenas com imagens | PDFs digitalizados não passam por OCR. Converta para texto primeiro (por exemplo, com o Adobe ou uma ferramenta de OCR online). |
| Documento muito longo, a recuperação não encontra a seção relevante | Divida o documento em arquivos menores e mais focados. |
| A formulação da pergunta não corresponde à do documento | Abra Data Extractor Sidebar → aba Knowledge em uma chamada de exemplo → veja o que foi recuperado. Se voltaram trechos errados, a KB precisa de mais cobertura semântica. |
| Arquivo acima do limite de 25 MB | Comprima ou divida. |
"O Finn está dando respostas desatualizadas."
| Causa provável | Solução |
|---|
| Versão antiga do documento ainda na KB | Knowledge Base → exclua o arquivo antigo, envie o novo |
| A importação do site tem conteúdo em cache desatualizado | Knowledge Base → Website Imports → [URL] → Re-crawl Now |
| Resultado de consulta em cache (raro) | Clique em Re-index Now para forçar a atualização |
Implantações
"Cliquei em Launch, mas nenhuma chamada está saindo."
| Causa provável | O que verificar |
|---|
| Fora da janela de horário de chamadas | As implantações só discam durante a janela de horário configurada, no fuso local de quem recebe. Se você iniciar às 8h PT com horário de chamadas das 9h às 18h, a primeira chamada só sai às 9h. |
| Público vazio | Abra o público e confirme que há registros. Problemas de sincronização podem deixá-lo vazio. |
| Todos os números suprimidos | Settings → Compliance → Do Not Call List. Se você suprimiu sua lista de teste sem querer, remova-os. |
| Número de origem não registrado | Números dos EUA sem registro de identificação de chamada falham silenciosamente. Verifique Settings → Phone numbers → [Número] → Registration Status. |
| Limite de gastos atingido | Live Deployments → o painel de integridade mostrará "Cap reached." Aumente o limite ou aguarde o próximo período. |
| Implantação pausada | Live Deployments → clique na implantação → verifique o status. |
| Causa provável | Solução |
|---|
| Identificação de chamada exibindo "SPAM LIKELY" | Registre a identificação de chamada. Sem registro, as operadoras dos EUA marcam suas chamadas como spam e as taxas de atendimento despencam. |
| A mensagem de boas-vindas soa como spam | Melhore a abertura. "Olá, aqui é [nome], da [nome reconhecível da empresa], sobre [motivo que a pessoa esperaria]." O "sobre" faz diferença — aberturas genéricas levam a desligamentos. |
| Ligações em horários ruins | Verifique se a janela de horários permitidos para ligações está sendo aplicada. |
| Lista fria (sem relacionamento prévio) | Não é um problema do Finn — é um problema de lista. Listas frias sempre têm baixas taxas de atendimento e permanência na chamada. |
"A implantação está pausada, mas não sei por quê."
Implantações ao Vivo → clique na implantação → role até Motivo da Pausa. Motivos comuns:
| Motivo | O que significa |
|---|
| Limite de gastos atingido | O limite configurado por implantação foi atingido. Aumente o limite ou encerre a implantação. |
| Público esgotado | Todos os contatos foram chamados (incluindo novas tentativas). Conclua a implantação ou adicione mais contatos. |
| Buffer esvaziado | O dispatcher ficou momentaneamente sem trabalho. Normalmente se recupera sozinho em um minuto. |
| Pausa manual | Você ou alguém da equipe clicou em Pausar. Confira o log de auditoria. |
| Indisponibilidade da operadora | Problema no provedor de telefonia. Retoma quando a indisponibilidade terminar. |
| Limite do plano atingido | Você usou toda a cota mensal de chamadas do seu plano. Faça upgrade ou aguarde o próximo ciclo. |
Análises
"As análises mostram zero chamadas, mas sei que houve chamadas."
| Causa provável | Solução |
|---|
| Olhando para a implantação errada | Confira o menu de implantações — é fácil acabar em outra |
| Cache desatualizado | Clique em Atualizar (o botão aparece quando o selo "Em cache" está visível) |
| Chamadas com menos de 5 segundos | Algumas métricas filtram chamadas muito curtas (tratadas como não atendidas). Consulte o log completo de chamadas. |
"Os campos da análise pós-chamada estão em branco."
| Causa provável | Solução |
|---|
| Campos adicionados depois do início da implantação | A análise pós-chamada só é executada em chamadas concluídas depois que o campo foi adicionado. As novas chamadas serão preenchidas. |
| A pergunta do campo é vaga demais | Reformule. "O cliente demonstrou interesse?" é melhor que "Nível de interesse?" |
| A transcrição é curta demais | Se uma chamada durou 5 segundos, não há nada para extrair. |
| Erro de extração do LLM | Raro. Verifique o Status de Extração da chamada na barra lateral. |
"O sentimento parece errado nas chamadas."
A análise de sentimento não é perfeita. É um indicador útil, não um veredito. Se houver erros de classificação recorrentes, adicione um campo pós-chamada personalizado com uma pergunta mais específica (por exemplo, "O interlocutor pareceu satisfeito com a resolução?") e use esse campo no lugar dela.
Números de telefone
"Comprei um número, mas não consigo usá-lo."
| Causa provável | O que verificar |
|---|
| Verificação de conformidade pendente | Alguns países (Índia, França, Alemanha) exigem KYC. Configurações → Números de telefone → [Número] → Status de Conformidade. |
| Identificador de chamadas não registrado (EUA) | As chamadas de saída falham com "operadora rejeitou" até o registro ser feito. |
| Tronco SIP mal configurado (BYO) | Configurações → Conta de Telefonia → teste o tronco. Comum: incompatibilidade de codec, credenciais erradas. |
| Número não atribuído a um Finn (entrada) | Configurações → Números de telefone → [Número] → Finn de Entrada Padrão → atribua um. |
| Causa | Solução |
|---|
| Identificador de chamadas não registrado (EUA/Canadá) | Configurações → Números de telefone → [Número] → Registro de Identificador de Chamadas |
| O país de destino exige verificação do remetente | KYC em Configurações → Números de telefone → Conformidade |
| O número de origem não tem capacidade de voz | Compre um número com capacidade de voz; números apenas de SMS não fazem chamadas |
| A operadora está filtrando remetentes com má reputação | Teste outro número de origem; números antigos às vezes entram na lista negra das operadoras |
Integrações
| Causa provável | Solução |
|---|
| Frequência de sincronização muito baixa | Configurações → Integrações → [CRM] → defina para a cada 15 min ou por hora |
| Token do CRM expirado | Reautorize a integração |
| O filtro exclui novos contatos | Abra o filtro de CRM do público e verifique os critérios |
| API do CRM com limite de taxa atingido | Aguarde e tente novamente. Sincronizações pesadas podem acionar limites do lado do CRM. |
"Meu webhook não está recebendo eventos."
| Causa provável | O que verificar |
|---|
| URL inacessível pela internet | Use uma URL pública, não localhost. Para testes locais, use um túnel (ngrok, Cloudflare Tunnel). |
| Retorno de resposta fora da faixa 2xx | A plataforma espera 200-299. 3xx/4xx/5xx aciona nova tentativa. |
| Endpoint excedendo o tempo limite | Deve responder em até 10s. Para lógica demorada, aceite o webhook rapidamente e processe de forma assíncrona. |
| Assinatura HMAC divergente | Verifique se sua implementação de assinatura corresponde à nossa especificação — consulte Integrações → Webhooks. |
"As reservas não aparecem na minha agenda."
| Causa provável | Correção |
|---|
| Agenda errada selecionada | Configurações → Integrações → Agenda → verifique a agenda selecionada |
| Permissões revogadas no provedor de agenda | Reautorize a integração |
| A reserva foi para uma agenda que você não visualiza | Muitas pessoas têm várias agendas; a reserva está em algum lugar. Use a visualização "todas as agendas". |
| Título do evento na agenda é enganoso | As reservas usam por padrão "Appointment via Finn" — busque por esse termo |
Faturamento
"Minha fatura está maior que o esperado."
Configurações → Plano e faturamento → Uso → Sinalizações de anomalia. Procure itens acima de 2x da sua média dos últimos 30 dias. Causas comuns:
- Um Finn atuou sobre um público hostil e ficou preso em chamadas longas (defina
limit_call_duration).
- Uma implantação foi lançada sem limite de gastos e discou para uma lista muito maior que a pretendida.
- Voz premium ou modelo premium foi ativado (Configurações → Plano).
- Um novo país foi adicionado — tarifas de telefonia internacional podem ser de 10 a 50x as tarifas dos EUA.
"Quero reembolso por uma implantação desperdiçada."
Envie um e-mail para [email protected] com o ID da implantação e uma explicação. Problemas causados por bugs costumam ser reembolsados. Erros de configuração do usuário normalmente não, mas entre em contato mesmo assim — avaliamos caso a caso.
Conta e acesso
"Não consigo fazer login."
| Causa provável | O que tentar |
|---|
| Senha esquecida | Clique em "Esqueci minha senha" na página de login |
| Conta bloqueada após muitas tentativas malsucedidas | Aguarde 15 minutos e tente novamente |
| E-mail não confirmado | Verifique a pasta de spam para encontrar o e-mail de confirmação |
| Conta de equipe, mas você não foi convidado | Peça ao seu administrador para convidá-lo em Configurações → Equipe |
| SSO não está funcionando | Se sua organização usa SSO, você deve fazer login pelo link de SSO, não por e-mail/senha |
"Perdi o acesso à minha conta / perdi meu dispositivo de 2FA."
Envie um e-mail para [email protected] com comprovante de titularidade da conta (e-mail de cobrança, últimos 4 dígitos do meio de pagamento etc). Ajudaremos você a recuperar o acesso.
Desempenho / qualidade
"A latência está muito alta — Finn demora demais para responder."
Meta: <800 ms entre o fim da fala do usuário e o início da resposta do Finn.
| Causa | Solução |
|---|
| Voz premium selecionada | Mude para uma voz padrão (-100-200 ms) |
| Região distante | Defina a região da conta no cadastro como a mais próxima de quem recebe as chamadas |
| Problemas de rede na operadora | Geralmente passageiro — aguarde alguns minutos |
| Fluxo de trabalho complexo com aninhamento profundo | Simplifique; recolha os subfluxos |
| Base de conhecimento grande + recuperação lenta | Configurações → Conhecimento → reindexe ou reduza o tamanho da base |
"Finn soa robótico / pouco humano."
| Causa | Solução |
|---|
| Categoria de voz padrão | Experimente uma voz premium |
| Incompatibilidade de idioma | Confirme que o idioma principal da voz corresponde ao que você está falando |
| Diretrizes de resposta restritivas demais | "Mantenha as respostas em uma frase" deixa o tom seco. Flexibilize. |
| Fluxo de trabalho impondo roteiro rígido | Mude para formato livre ou use os nós Say com mais moderação |
Quando nada mais funcionar
- Pause a implantação — interrompe as chamadas, sem custos adicionais.
- Analise uma chamada que falhou recentemente — abra a Barra Lateral do Extrator de Dados para ver o contexto completo.
- Pesquise nesta página de solução de problemas com Ctrl+F usando palavras-chave do seu erro.
- Envie um e-mail para o suporte — [email protected] com o ID da implantação, o ID da chamada e sua descrição.
- Use o Finn no balão de chat — canto inferior direito — ele foi treinado com esta documentação e costuma resolver problemas na hora.
- Para clientes Enterprise — seu CSM dedicado está no seu canal do Slack.
Próximo
- FAQ → — perguntas que não são exatamente solução de problemas.
- Conformidade → — situações que falham por questões legais ou regulatórias.
- Glossário → — definições de termos que você não conhece.