Pular para o conteúdo principal
DocumentationAPI ReferenceVideo Tutorials

Perguntas Frequentes

Encontre respostas para as perguntas mais comuns sobre a plataforma Hanc.AI.

Perguntas Gerais​

O que é a Hanc.AI?​

A Hanc.AI é uma plataforma para criar agentes de voz IA com inteligência artificial que conseguem lidar com chamadas telefónicas automaticamente. O seu agente de voz IA pode responder a perguntas de clientes, marcar compromissos, transferir chamadas e muito mais — 24/7, sem intervenção humana.

Preciso de competências técnicas para usar a Hanc.AI?​

Não. A plataforma foi desenhada para utilizadores de negócio sem experiência em programação. Configura agentes através de uma interface visual, escreve instruções em linguagem natural e carrega documentos para criar uma base de conhecimento.

Que línguas a Hanc.AI suporta?​

A UI da Plataforma está disponível em:

  • Inglês (EN)
  • Alemão (DE)
  • Espanhol (ES)
  • Francês (FR)
  • Italiano (IT)
  • Húngaro (HU)

Os agentes de voz IA suportam mais de 25 línguas. Pode definir a língua para cada agente de forma independente. O agente pode também trocar de língua automaticamente durante uma chamada para corresponder ao interlocutor.

Como é que a IA entende os interlocutores?​

Você fala, a IA entende as suas palavras, processa o significado e responde naturalmente com voz. A plataforma trata de toda a complexidade nos bastidores para que as conversas pareçam naturais e fluidas.

Conta e Faturação​

Como crio uma conta?​

  1. Visite o website da Hanc.AI
  2. Clique em "Sign Up" ou "Get Started"
  3. Introduza o seu email e crie uma palavra-passe
  4. Verifique o seu número de telefone via SMS
  5. Complete o seu perfil

Que planos estão disponíveis?​

A Hanc.AI oferece cinco escalões de plano:

  • Free — Atribuição única de crédito, limite de 1 agente. Ideal para testar.
  • Starter — Créditos mensais, agentes ilimitados. Para pequenas empresas.
  • Pro — Mais créditos, taxas por minuto mais baixas. Para empresas em crescimento.
  • Business — Atribuição alta de crédito, suporte prioritário, SLA de 99,9%. Para empresas estabelecidas.
  • Enterprise — Preço personalizado, gestor dedicado, white-label, SSO/SAML. Para grandes organizações.

A faturação anual está disponível com desconto em comparação com a mensal. Visite Definições > Faturação para preços atuais.

Como funciona a faturação por créditos?​

Cada plano inclui créditos mensais (package_credits). Toda a utilização é deduzida do seu saldo de créditos nestas categorias:

  • Créditos de chamada telefónica — Cobranças por minuto para chamadas telefónicas
  • Créditos de chamada web — Cobranças por minuto para chamadas via widget (tipicamente taxa mais baixa)
  • Créditos de mensagem de texto — Por SMS enviado como ação pós-chamada
  • Créditos de encaminhamento de chamada — Por chamada encaminhada para um humano
  • Créditos de número de telefone — Custo mensal por número de telefone ativo

A plataforma suporta as moedas USD e EUR. Os créditos não usados transitam para o período de faturação seguinte.

Posso mudar de plano?​

Sim. As subidas têm efeito imediato (proporcionalmente). As descidas têm efeito no ciclo de faturação seguinte. Vá a Definições > Faturação para mudar de plano.

Que métodos de pagamento são aceites?​

  • Cartões de Crédito/Débito (Visa, Mastercard, American Express) — via Stripe
  • Transferência bancária (apenas Enterprise)

Os créditos não usados transitam?​

Sim. Os créditos não usados transitam para o período de faturação seguinte. Nunca expiram enquanto a sua conta estiver ativa.

Agentes de Voz IA​

O que é um agente de voz IA?​

Um agente de voz IA é um assistente virtual com inteligência artificial que gere conversas telefónicas. Atende chamadas, percebe o que os interlocutores precisam, fornece informação da sua base de conhecimento e pode realizar ações como marcar compromissos ou transferir chamadas.

Quantos agentes posso criar?​

  • Plano Free: 1 agente
  • Planos pagos (Starter, Pro, Business, Enterprise): Agentes ilimitados

Um agente pode tratar vários números de telefone?​

Sim. Pode atribuir vários números de telefone a um único agente se todos devem comportar-se da mesma forma.

Posso ter agentes diferentes para fins diferentes?​

Sim. Muitas empresas usam agentes separados para:

  • Pedidos de venda
  • Suporte ao cliente
  • Marcação de compromissos
  • Receção fora de horas

Posso duplicar um agente?​

Sim. Use a função de duplicar para clonar um agente existente com todas as definições, prompt e configuração. Isto é útil para criar variações ou testar alterações.

Como testo o meu agente antes de ir para produção?​

  1. Use o botão "Falar com o Agente" no painel
  2. Permita acesso ao microfone no seu browser
  3. Fale naturalmente e teste vários cenários
  4. Reveja a transcrição após cada chamada de teste

Os interlocutores conseguem perceber que estão a falar com uma IA?​

Os agentes de voz IA modernos soam muito naturais, mas recomendamos transparência com os interlocutores. Muitas empresas incluem uma breve menção na saudação: "Olá, ligou para o nosso assistente virtual..."

Que definições de chamada posso configurar?​

Cada agente tem definições de chamada configuráveis:

  • Gatilho de lembrete — Tempo antes do agente enviar um lembrete quando o interlocutor está em silêncio (padrão: 30 segundos)
  • Máximo de lembretes — Número máximo de lembretes antes do agente terminar a chamada (padrão: 3)
  • Terminar chamada após silêncio — Termina automaticamente a chamada após silêncio prolongado (padrão: 10 segundos, deve ser explicitamente ativado)
  • Análise de sentimento — Analisa o sentimento do interlocutor durante a chamada (desligado por defeito)
  • Resumo de chamada — Gera um resumo após a chamada (desligado por defeito)
  • Gravação — Grava a chamada (desligado por defeito, verifique a legislação local sobre consentimento)
  • Língua — Define a língua principal do agente
  • Opt-out de armazenamento de dados sensíveis — Opção de privacidade para dados sensíveis

O que são campos de recolha de dados?​

Os campos de recolha de dados permitem ao seu agente extrair informação estruturada das conversas. Tipos suportados:

  • Texto — Texto livre (ex.: nome do interlocutor, email)
  • Número — Valores numéricos (ex.: orçamento, quantidade)
  • Booleano — Valores sim/não (ex.: "interessado em demo?")
  • Seletor — Escolha de opções predefinidas (ex.: produto preferido)

Os dados extraídos estão disponíveis nos registos de chamada e podem ser enviados para sistemas externos via ações pós-chamada.

Base de Conhecimento​

O que é uma base de conhecimento?​

Uma base de conhecimento é uma coleção de informação que o seu agente usa para responder a perguntas. Contém os detalhes do seu negócio, FAQs, informação de produtos, políticas, e qualquer outra coisa sobre a qual os interlocutores possam perguntar.

Que formatos de ficheiro posso carregar?​

Formatos suportados:

  • PDF (.pdf)
  • Documentos Word (.docx, .doc)
  • Ficheiros Excel (.xlsx, .xls)
  • Ficheiros de texto (.txt)
  • Markdown (.md)
  • HTML (.html)
  • CSV (.csv)
  • RTF (.rtf)
  • JSON (.json)

Que tamanho pode ter a minha base de conhecimento?​

  • Ficheiros individuais: até 10 MB cada
  • Até 10 ficheiros por base de conhecimento

Com que frequência devo atualizar a minha base de conhecimento?​

Atualize a sua base de conhecimento sempre que:

  • Os preços mudam
  • O horário de funcionamento muda
  • São adicionados novos produtos/serviços
  • As políticas são atualizadas
  • Repara que o agente está a dar informação desatualizada

Posso importar bases de conhecimento em massa?​

Sim. Use a funcionalidade de importação ZIP para carregar vários ficheiros de base de conhecimento de uma só vez. Veja Importar Base de Conhecimento para detalhes.

Porque é que o meu agente não está a usar a base de conhecimento?​

Verifique estes problemas comuns:

  1. A base de conhecimento não está ligada ao agente (Definições do Agente > Base de Conhecimento)
  2. A informação não está claramente estruturada
  3. O conteúdo não corresponde à forma como os clientes fazem as perguntas
  4. O upload do ficheiro falhou ou ainda está a processar

Números de Telefone e Chamadas​

Preciso do meu próprio número de telefone?​

Tem três opções:

  1. Comprar um número — Adquira diretamente através da plataforma
  2. Importar um número existente — Ligue números que já possui
  3. Ligar SIP — Use o seu fornecedor de SIP trunk existente

Posso usar SIP trunks?​

Sim. A integração de SIP trunk está disponível em todos os planos, incluindo Free. Ligue o seu PBX existente ou sistema de telefonia via SIP.

As chamadas são gravadas?​

A gravação é opcional e configurável por agente (definição recording_enabled, desligado por defeito). Se ativada:

  • As gravações são armazenadas em segurança
  • Pode aceder-lhes nos Registos de Chamadas
  • Verifique a legislação local sobre consentimento de gravação de chamadas

O que acontece se o agente não conseguir ajudar?​

Pode configurar regras de escalação:

  • Transferir para um operador humano (ferramenta de Encaminhamento de Chamada)
  • Tirar uma mensagem para callback
  • Fornecer informação de contacto alternativa
  • Marcar um compromisso

Widget do Site​

Que tipos de widget estão disponíveis?​

Estão disponíveis quatro tipos de widget:

  • Widget de chamada flutuante (hanc-ai-floating-call) — Um botão flutuante na página
  • Widget de chamada em pill (hanc-ai-pill-call) — Um botão compacto em forma de pílula
  • Widget de chamada inline (hanc-ai-inline-call) — Embebido diretamente no layout da sua página
  • Widget de callback (hanc-ai-callback) — Um formulário que recolhe o número de telefone do visitante; o seu agente liga-lhe de volta. Diferente dos outros — faz uma verdadeira chamada telefónica outbound em vez de iniciar uma chamada de voz no browser. Veja a secção Widget de Callback abaixo.

Que temas de cores estão disponíveis?​

O widget suporta 12 temas de cor configuráveis a partir do painel:

Default, Purple, Blue, Cyan, Emerald, Amber, Tangerine, Rose, Ember, Black, White, e Tangerine Neon.

Defina o tema através do atributo theme no elemento de widget ou através das definições de widget do agente no painel.

Que eventos o widget emite?​

O widget emite eventos que pode escutar para integração:

  • status-changed — Dispara quando o estado interno da conexão LiveKit muda. Estados: idle, connecting, connected, agent-connected, disconnecting, disconnected, error
  • call-start — Dispara quando uma chamada começa
  • call-end — Dispara quando uma chamada termina
  • state-change — Dispara quando o estado do widget muda. Estados: idle, connecting, active, ending, error
  • error — Dispara em erros
  • audio-track — Dispara quando uma faixa de áudio remota é recebida
  • local-audio-track — Dispara quando a faixa de áudio local é criada

Quais são os requisitos técnicos do widget?​

O widget requer:

  • WebGL 2.0 (para a animação do orbe)
  • Web Audio API
  • WebRTC (para comunicação de voz em tempo real)

Widget de Callback​

Porque preciso de um plano pago para o Widget de Callback?​

O Widget de Callback faz chamadas telefónicas outbound reais — cada callback consome minutos outbound no seu plano. O plano Free não inclui chamadas outbound, por isso não pode executar callbacks. Todos os outros tipos de widget (Flutuante, Pill, Inline) correm no browser e mantêm-se gratuitos.

Que países o seletor de país suporta?​

O seletor cobre a Europa (UE + DACH + Reino Unido), América do Norte (EUA + Canadá) e um conjunto curado de países adicionais amplamente suportados. Cada país mostra uma bandeira, nome e um placeholder de exemplo em formato nativo na entrada de telefone. Se um país que precisa não está listado, envie email para support@hanc.ai — a cobertura é expandida com base na procura.

O que acontece se um visitante submete, recarrega a página e submete o mesmo número novamente?​

O widget deteta que já existe um callback ativo para esse número para este agente e silenciosamente reanexa-se. Sem chamada duplicada. O visitante vê o seu estado existente a continuar de onde parou.

Porque é que o widget diz "Recarregue a página para fazer outro callback"?​

O widget bloqueia-se a si próprio após um envio bem-sucedido. Isto evita submissões duplicadas acidentais enquanto uma chamada está a caminho. Se o visitante quiser fazer um segundo callback (número diferente, segunda tentativa após uma chamada perdida, etc.), recarrega a página e o formulário fica fresco novamente. O botão explícito "Cancelar" no ecrã de fila liberta o bloqueio sem recarregar.

Porque é que o meu callback mostra "Fila cheia"?​

Um único agente trata até 10 callbacks ao mesmo tempo. Se a fila estiver na capacidade, as novas submissões aguardam até que um slot fique livre — o widget mostra uma mensagem amigável "entraremos em contacto em breve". A taxa de processamento recupera à medida que as chamadas em curso terminam.

Como mudo a língua da UI do widget?​

Duas formas:

  • Padrão por agente — Abra a aba Widgets do agente → secção do widget de Callback → Língua do widget. Escolha entre 14 línguas suportadas.
  • Sobreposição por página — Adicione locale="de" (ou qualquer código suportado) na tag <hanc-ai-callback>. A sobreposição prevalece sobre o padrão do agente.

A língua do widget afeta apenas o que o visitante lê na página — a conversa de voz real acontece em qualquer língua que o agente esteja configurado para falar.

Posso ter o agente a ligar de volta numa língua diferente da da UI do widget?​

Sim. A língua da UI do widget e a língua de fala do agente são independentes. Um widget em francês numa landing page multilingue pode ser emparelhado com um agente que fala inglês, ou vice-versa.

O que a definição Max Call Duration faz aos callbacks?​

Se definir um Max Call Duration no agente que seja inferior ao limite de segurança do callback (10 minutos), a sua definição mais curta prevalece. Se definir um superior a 10 minutos, o limite de 10 minutos do callback continua a aplicar-se. A maioria dos cenários de callback beneficia de um limite de 3-5 minutos para manter o custo previsível.

Ações e Ferramentas​

Que ferramentas os agentes podem usar durante as chamadas?​

FerramentaFinalidadePlanos
Encaminhamento de ChamadaTransferir para um humanoTodos os planos
Google Calendar / OutlookVerificar disponibilidade e marcar compromissosTodos os planos
API Tool RAGObter dados ao vivo a partir de APIsTodos os planos
HubSpot CRMLer/escrever contactos e negócios do HubSpot a partir da chamadaTodos os planos
Transferência de AgentePassar a chamada para outro agente de voz IA na sua contaTodos os planos
Servidores MCPExpor ferramentas dos seus servidores MCP registados — ver Servidores MCPTodos os planos

Que ações os agentes podem executar após as chamadas?​

AçãoFinalidade
Enviar EmailNotificação por email com dados da chamada
Enviar SMSMensagem de texto com dados da chamada
Enviar WhatsAppMensagem WhatsApp com dados da chamada
Chamada de APIEnviar dados para sistemas externos (CRM, webhooks)

O agente pode marcar compromissos?​

Sim. Ligue o seu Google Calendar e ative a ferramenta Google Calendar. O agente verifica a sua disponibilidade e marca compromissos diretamente durante a chamada. Disponível em todos os planos.

As definições do Google Calendar incluem:

  • Durações de slot: 15, 30, 45, 60, 75, 90, 105 ou 120 minutos
  • Horário de trabalho: Horas de início e fim configuráveis (padrão 09:00-18:00)
  • Dias de trabalho: Configuráveis (padrão segunda a sexta)
  • Fuso horário: Configurável por calendário

O agente pode enviar mensagens WhatsApp?​

Sim. Adicione uma ação "Enviar WhatsApp" ao seu agente. Configure o template da mensagem, números de destinatário e condições de gatilho. As mensagens WhatsApp podem incluir variáveis de recolha extraídas da conversa.

Prompts e Configuração​

O que é um prompt?​

Um prompt é o conjunto de instruções que diz ao seu agente como se comportar. Define personalidade, que informação fornecer, como lidar com situações e que ações tomar.

Que comprimento deve ter o meu prompt?​

  • Mínimo: 10 caracteres (mínimo do sistema)
  • Máximo: 15.000 caracteres (máximo do sistema)
  • Recomendado: 500-1000 palavras para um comportamento abrangente

A qualidade importa mais do que o comprimento. Seja específico e claro.

O que é a "temperatura" nas definições do agente?​

A temperatura controla quão criativas ou previsíveis são as respostas do agente:

  • Baixa (0,1-0,3): Respostas mais consistentes e determinísticas
  • Média (0,4-0,6): Equilibrada (recomendada para a maioria dos usos)
  • Alta (0,7-1,0): Respostas mais variadas e criativas

Para uso empresarial, temperaturas mais baixas são geralmente melhores.

Posso mudar a voz do agente?​

Sim. Pode selecionar entre várias vozes:

  • Masculinas ou femininas
  • Diferentes idades e estilos
  • Vários sotaques
  • Diferentes velocidades de fala

Corresponda a voz à personalidade da sua marca.

Integrações​

Que integrações estão disponíveis?​

IntegraçãoEstadoPlanos
Números de TelefoneDisponívelTodos
SIP TrunkDisponívelTodos
Google CalendarDisponívelTodos
Chaves de APIDisponívelTodos

Quantas chaves de API posso criar?​

Pode criar até 3 chaves de API por utilizador.

Resolução de Problemas​

O meu agente não está a responder às chamadas​

Verifique estes passos:

  1. O agente está com o estado "Ativo"
  2. O número de telefone está atribuído ao agente
  3. A conexão telefónica (ou SIP trunk) está ativa
  4. A primeira mensagem está configurada
  5. O seu saldo de créditos tem fundos

O agente dá informação errada​

Soluções:

  1. Verifique se a base de conhecimento contém informação correta
  2. Verifique se a KB está ligada ao agente
  3. Adicione instruções explícitas no prompt para usar apenas a KB
  4. Baixe a definição de temperatura (0,3-0,5)

A qualidade da chamada é fraca​

Experimente estas correções:

  1. Verifique a sua ligação à internet (recomenda-se 5+ Mbps)
  2. Verifique a página de estado da plataforma
  3. Tente uma opção de voz diferente
  4. Para teste no browser, use uma ligação por cabo

Não consigo iniciar sessão na minha conta​

Passos para resolver:

  1. Verifique o endereço de email correto
  2. Tente "Esqueceu a Palavra-Passe?" para repor
  3. Limpe a cache e cookies do browser
  4. Experimente o modo incógnito/privado
  5. Contacte o suporte se o problema persistir

Segurança e Privacidade​

Os meus dados estão seguros?​

Sim. A plataforma usa:

  • Encriptação AES-256 em repouso
  • Encriptação TLS 1.3 em trânsito
  • Infraestrutura cloud segura (data centers na UE)
  • Auditorias de segurança regulares
  • Autenticação Firebase com verificação telefónica

Quem pode aceder às minhas gravações de chamada?​

Apenas utilizadores com permissões adequadas na sua organização podem aceder às gravações. Você controla o acesso através das definições de gestão da equipa e permissões por função (Proprietário, Administrador, Membro).

A plataforma é compatível com o RGPD?​

Sim. A plataforma cumpre os requisitos do RGPD:

  • Acordos de processamento de dados disponíveis
  • Direito ao apagamento suportado
  • Exportação de dados disponível
  • Controlos de privacidade para gravações
  • Opção de opt-out de armazenamento de dados sensíveis

Posso eliminar os meus dados?​

Sim. Pode:

  • Eliminar gravações de chamada individuais
  • Limpar conteúdo da base de conhecimento
  • Eliminar agentes
  • Solicitar a eliminação total da conta

Obter Ajuda​

Como contacto o suporte?​

  • Email: support@hanc.ai
  • Resposta padrão: Em 24 horas
  • Resposta Pro/Business: Em 4 horas

Onde posso encontrar tutoriais?​

Posso pedir novas funcionalidades?​

Sim! Envie pedidos de funcionalidades para support@hanc.ai. Consideramos ativamente o feedback dos utilizadores para o desenvolvimento do produto.

Existe uma comunidade ou fórum?​

Verifique o website da Hanc.AI para recursos da comunidade e atualizações.

Referência Rápida​

Definições Recomendadas para Casos de Uso Comuns​

Caso de UsoTemperaturaComprimento da RespostaEstilo de Voz
Suporte ao Cliente0,3-0,4CurtoCalmo, prestável
Vendas0,5-0,6MédioEnergético, amigável
Compromissos0,3-0,4CurtoProfissional
Receção0,3-0,5Muito curtoAcolhedor

Checklist: Antes de Ir para Produção​

  • O prompt do agente está completo e testado
  • A base de conhecimento foi carregada e está ligada
  • A primeira mensagem soa natural
  • As regras de escalação estão configuradas
  • O número de telefone está atribuído
  • As chamadas de teste foram concluídas com sucesso
  • Os membros da equipa têm acesso adequado

Tópicos Relacionados​