Perguntas Frequentes
Encontre respostas às 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 alimentados por IA que conseguem tratar chamadas telefónicas automaticamente. O seu agente de voz pode responder a perguntas de clientes, marcar consultas, transferir chamadas e muito mais -- 24 horas por dia, 7 dias por semana, sem intervenção humana.
A Hanc.AI é o núcleo de um ecossistema mais amplo que inclui também o Hanc Studio (um arquiteto de IA que constrói um agente a partir de uma descrição simples), o Hanc Voice (síntese e clonagem de voz) e o Hanc Phone (um telefone no browser com um agente de IA ao vivo). Consulte O Ecossistema Hanc.
Quer dar uma vista de olhos antes de se inscrever? Uma demonstração interativa apenas de leitura permite-lhe explorar o painel sem criar uma conta.
Preciso de competências técnicas para usar a Hanc.AI?
Não. A plataforma foi concebida para utilizadores de negócio sem experiência de programação. Configura os agentes através de uma interface visual, escreve instruções em linguagem simples e carrega documentos para criar uma base de conhecimento.
Que idiomas a Hanc.AI suporta?
A interface da plataforma está disponível em 14 idiomas:
- Inglês (EN), Alemão (DE), Checo (CS), Espanhol (ES), Francês (FR), Húngaro (HU), Italiano (IT), Cazaque (KK), Polaco (PL), Português (PT), Russo (RU), Turco (TR), Ucraniano (UK), Chinês (ZH)
Os agentes de voz suportam 25 idiomas. Pode definir o idioma para cada agente de forma independente. O agente também pode mudar de idioma automaticamente durante uma chamada para corresponder ao autor da chamada.
Como a IA compreende os autores das chamadas?
Você fala, a IA compreende as suas palavras, processa o significado e responde naturalmente com voz. A plataforma trata de toda a complexidade nos bastidores para que as conversas soem naturais e fluidas.
Conta e Faturação
Como crio uma conta?
O registo é primeiro por telefone — o seu número de telefone é o seu identificador principal:
- Visite o site da Hanc.AI
- Clique em "Registar" ou "Começar"
- Introduza o seu número de telefone
- Verifique-o com o código enviado por SMS. Se o seu número for uma linha fixa que não consegue receber SMS, o código é entregue por uma chamada de voz automática
- Adicione o seu email e complete o seu perfil
Se o seu número não puder ser usado de todo (consulte Por que o meu número de telefone foi rejeitado?), ser-lhe-á pedido que tente outro.
Que planos estão disponíveis?
A Hanc.AI oferece cinco níveis de plano:
- Free -- Dotação de créditos única, limite de 1 agente. Ideal para testar.
- Starter -- Créditos mensais, agentes ilimitados. Para pequenas empresas.
- Pro -- Mais créditos, tarifas por minuto mais baixas. Para empresas em crescimento.
- Business -- Dotação de créditos elevada, suporte prioritário, SLA de 99.9%. Para empresas estabelecidas.
- Enterprise -- Preços personalizados, gestor dedicado, white-label, SSO/SAML. Para grandes organizações.
A faturação anual está disponível com um desconto face à mensal. Visite Definições > Faturação para os preços atuais.
Como funciona a faturação baseada em 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 de widget (tarifa tipicamente mais baixa)
- Créditos de mensagem de texto -- Por SMS enviado como ação pós-chamada
- Créditos de reencaminhamento de chamada -- Por chamada reencaminhada para um humano
- Créditos de número de telefone -- Custo mensal por número de telefone ativo
Os preços são apresentados na sua moeda regional (não apenas em USD ou EUR). Os créditos não utilizados transitam para o período de faturação seguinte.
Posso mudar de plano?
Sim. Os upgrades produzem efeito imediatamente (proporcional). Os downgrades produzem 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 utilizados transitam?
Sim. Os créditos não utilizados passam para o período de faturação seguinte. Nunca expiram enquanto a sua conta estiver ativa.
Agentes de Voz
O que é um agente de voz?
Um agente de voz é um assistente virtual alimentado por IA que trata conversas telefónicas. Atende chamadas, compreende o que os autores das chamadas precisam, fornece informação da sua base de conhecimento e pode executar ações como marcar consultas 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 se devem comportar da mesma forma.
Posso ter agentes diferentes para propósitos diferentes?
Sim. Muitas empresas usam agentes separados para:
- Consultas de vendas
- Suporte ao cliente
- Marcação de consultas
- Receção fora de horas
Posso duplicar um agente?
Sim. Use a função de duplicar para clonar um agente existente com todas as suas definições, prompt e configuração. Isto é útil para criar variações ou testar alterações.
Como testo o meu agente antes de o pôr em produção?
- Use o botão "Falar com o Agente" no painel
- Permita o acesso ao microfone no seu browser
- Fale naturalmente e teste vários cenários
- Reveja a transcrição após cada chamada de teste
Os autores das chamadas percebem que estão a falar com uma IA?
Os agentes de voz modernos soam muito naturais, mas recomendamos ser transparente com os autores das chamadas. Muitas empresas incluem uma breve menção na saudação: "Olá, contactou 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 de o agente enviar um lembrete quando o autor da chamada está em silêncio (predefinição: 30 segundos)
- Máximo de lembretes -- Número máximo de lembretes antes de o agente terminar a chamada (predefinição: 3)
- Terminar chamada após silêncio -- Terminar automaticamente a chamada após silêncio prolongado (predefinição: 10 segundos, deve ser explicitamente ativado)
- Análise de sentimento -- Analisar o sentimento do autor da chamada durante a chamada (desligado por predefinição)
- Resumo de chamada -- Gerar um resumo após a chamada (desligado por predefinição)
- Gravação -- Gravar a chamada (desligada por predefinição, verifique a legislação local sobre consentimento)
- Idioma -- Definir o idioma principal do agente
- Excluir armazenamento de dados sensíveis -- Opção de privacidade para dados sensíveis
O que são os campos de recolha de dados?
Os campos de recolha de dados permitem que o seu agente extraia informação estruturada das conversas. Tipos suportados:
- Texto -- Texto livre (ex.: nome do autor da chamada)
- Número -- Valores numéricos (ex.: orçamento, quantidade)
- Email -- Um endereço de email validado
- Telefone -- Um número de telefone validado
- Seletor -- Escolha de entre opções predefinidas (ex.: produto preferido)
- Caixa de Verificação -- Valores sim/não (ex.: "interessado numa demonstração?")
Os dados extraídos ficam disponíveis nos registos de chamadas 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 autores das chamadas 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)
Qual pode ser a dimensão da 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 mudarem
- O horário de funcionamento mudar
- Forem adicionados novos produtos/serviços
- As políticas forem atualizadas
- Notar que o agente dá 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. Consulte Importar Base de Conhecimento para detalhes.
Por que o meu agente não está a usar a base de conhecimento?
Verifique estes problemas comuns:
- A base de conhecimento não está ligada ao agente (Definições do Agente > Base de Conhecimento)
- A informação não está claramente estruturada
- O conteúdo não corresponde à forma como os clientes fazem as perguntas
- O carregamento 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:
- Comprar um número -- Adquirir diretamente através da plataforma
- Importar um número existente -- Ligar números de telefone que já possui
- Ligar SIP -- Usar 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 o Free. Ligue o seu PBX ou sistema de telefonia existente via SIP.
Por que o meu número de telefone foi rejeitado?
Para sua segurança, a Hanc.AI bloqueia tipos de número que são comummente abusados para fraude tarifária. Se vir "este número não pode ser usado, tente outro," o número é um dos seguintes:
- Números de tarifa premium ou custo partilhado (ex.: números do estilo 0900 / 0180) — sempre bloqueados
- Números estruturalmente inválidos — comprimento ou formato errado para o país
- Algumas linhas fixas que falham uma consulta de operadora
A solução é simplesmente tentar um número diferente — um número de telemóvel ou uma linha fixa padrão quase sempre funcionam. As linhas fixas que não conseguem receber SMS são verificadas com uma chamada de voz automática, e o código de verificação chega no idioma da sua interface.
As chamadas são gravadas?
A gravação é opcional e configurável por agente (definição recording_enabled, desligada por predefinição). Se ativada:
- As gravações são armazenadas com segurança
- Pode aceder a elas nos Registos de Chamadas
- Verifique a legislação local sobre o consentimento para gravação de chamadas
O que acontece se o agente não conseguir ajudar?
Pode configurar regras de escalonamento:
- Transferir para um operador humano (ferramenta de Reencaminhamento de Chamadas)
- Recolher uma mensagem para retorno de chamada
- Fornecer informações de contacto alternativas
- Marcar uma consulta
Widget de Site
Que tipos de widget estão disponíveis?
Estão disponíveis cinco tipos de widget:
- Widget de chamada flutuante (
hanc-ai-floating-call) -- Um botão flutuante na página - Widget de chamada pílula (
hanc-ai-pill-call) -- Um botão compacto em forma de pílula - Widget de chamada pílula flutuante -- A mesma forma compacta de pílula que a Pílula, mas segue o visitante com a página como o widget Flutuante
- Widget de chamada inline (
hanc-ai-inline-call) -- Incorporado 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 — coloca uma chamada telefónica de saída real em vez de iniciar uma chamada de voz no browser. Consulte a secção Widget de Callback abaixo.
Que temas de cor 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 do 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 ligação LiveKit muda. Estados:idle,connecting,connected,agent-connected,disconnecting,disconnected,errorcall-start-- Dispara quando uma chamada começacall-end-- Dispara quando uma chamada terminastate-change-- Dispara quando o estado do widget muda. Estados:idle,connecting,active,ending,errorerror-- Dispara em errosaudio-track-- Dispara quando uma faixa de áudio remota é recebidalocal-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
Por que preciso de um plano pago para o Widget de Callback?
O Widget de Callback coloca chamadas telefónicas de saída reais — cada callback consome minutos de saída do seu plano. O plano Free não inclui chamadas de saída, pelo que não pode executar callbacks. Todos os outros tipos de widget (Flutuante, Pílula, Inline) correm no browser e continuam gratuitos.
Que países o seletor de país suporta?
O seletor cobre a Europa (UE + DACH + Reino Unido), a América do Norte (EUA + Canadá) e um conjunto selecionado de países adicionais amplamente suportados. Cada país mostra uma bandeira, o nome e um marcador de posição de exemplo em formato nativo na entrada de telefone. Se um país de que precisa não estiver listado, envie um email para support@hanc.ai — a cobertura é expandida com base na procura.
O que acontece se um visitante submeter, recarregar a página e submeter o mesmo número novamente?
O widget deteta que já existe um callback ativo para esse número para este agente e volta a associar-se silenciosamente a ele. Sem marcação duplicada. O visitante vê o seu estado existente continuar de onde parou.
Por que o widget diz "Recarregue a página para fazer outro callback"?
O widget bloqueia-se após uma submissão bem-sucedida. 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 novamente em branco. O botão explícito "Cancelar" no ecrã de espera liberta o bloqueio sem recarregar.
Por que o meu callback está a mostrar "Fila cheia"?
Um único agente trata até 10 callbacks ao mesmo tempo. Se a fila estiver na capacidade máxima, as novas submissões esperam até que um lugar fique livre — o widget mostra uma mensagem amigável do tipo "entraremos em contacto em breve". A capacidade recupera à medida que as chamadas em curso terminam.
Como mudo o idioma da interface do widget?
De duas formas:
- Predefinição por agente — Abra o separador Widgets do agente → secção do widget de Callback → Idioma do widget. Escolha de entre 14 idiomas suportados.
- Substituição por página — Adicione
locale="de"(ou qualquer código suportado) na etiqueta<hanc-ai-callback>. A substituição prevalece sobre a predefinição do agente.
O idioma do widget só afeta o que o visitante lê na página — a conversa de voz efetiva acontece no idioma em que o agente está configurado para falar.
Posso fazer o agente ligar de volta num idioma diferente do da interface do widget?
Sim. O idioma da interface do widget e o idioma de fala do agente são independentes. Um widget em francês numa landing page multilíngue pode ser emparelhado com um agente que fala inglês, ou vice-versa.
O que a definição de Duração Máxima da Chamada faz aos callbacks?
Se definir uma Duração Máxima da Chamada no agente que seja inferior ao teto de segurança do callback (10 minutos), a sua definição mais curta prevalece. Se definir uma superior a 10 minutos, o teto 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?
| Ferramenta | Finalidade | Planos |
|---|---|---|
| Reencaminhamento de Chamadas | Transferir para um humano | Todos os planos |
| Google Calendar / Outlook | Verificar disponibilidade e marcar consultas | Todos os planos |
| API Tool RAG | Obter dados em tempo real de APIs | Todos os planos |
| HubSpot CRM | Ler/escrever contactos e negócios do HubSpot a partir da chamada | Todos os planos |
| Transferência de Agente | Passar a chamada para outro agente de voz da sua conta | Todos os planos |
| Servidores MCP | Expor ferramentas dos seus servidores MCP registados — consulte Servidores MCP | Todos os planos |
Que ações os agentes podem executar após as chamadas?
| Ação | Finalidade |
|---|---|
| Enviar Email | Notificação por email com dados da chamada |
| Enviar SMS | Mensagem de texto com dados da chamada |
| Enviar WhatsApp | Mensagem de WhatsApp com dados da chamada |
| Chamada de API | Enviar dados para sistemas externos (CRM, webhooks) |
O agente pode marcar consultas?
Sim. Ligue o seu Google Calendar e ative a ferramenta Google Calendar. O agente verificará a sua disponibilidade e marcará consultas diretamente durante a chamada. Disponível em todos os planos.
As definições do Google Calendar incluem:
- Durações dos horários: 15, 30, 45, 60, 75, 90, 105 ou 120 minutos
- Horário de trabalho: Horas de início e fim configuráveis (predefinição 09:00-18:00)
- Dias de trabalho: Configuráveis (predefinição segunda a sexta-feira)
- Fuso horário: Configurável por calendário
O agente pode marcar num sistema de reservas dedicado?
Sim. Além do Google e do Outlook Calendar, a Hanc.AI liga-se a serviços de reservas de propósito específico — eTermin (agendamento geral de consultas) e resmio (reservas de restaurantes e hotelaria). Depois de ligado, o agente verifica a disponibilidade e marca diretamente nesse sistema durante a chamada, tal como faz com um calendário.
O agente pode enviar mensagens de WhatsApp?
Sim. Adicione uma ação "Enviar WhatsApp" ao seu agente. Configure o modelo de mensagem, os números de destinatário e as condições de disparo. As mensagens de WhatsApp podem incluir variáveis de recolha extraídas da conversa.
CRM
A Hanc.AI tem um CRM integrado?
Sim. A Hanc.AI inclui um CRM integrado para que as suas chamadas se transformem automaticamente em registos estruturados. Acompanha:
- Contactos — as pessoas com quem os seus agentes falam, com os seus detalhes e histórico
- Negócios — oportunidades a avançar por um pipeline de fases
- Lembretes — tarefas de seguimento ligadas a um contacto ou negócio
- Sugestões — recomendações de próximos passos geradas por IA com base nas suas conversas
Os agentes podem ler e escrever no CRM durante e após as chamadas, para que uma marcação ou um lead qualificado atualize os seus registos sem introdução manual de dados. Este CRM integrado é separado da integração opcional HubSpot CRM, que sincroniza com uma conta externa do HubSpot.
Prompts e Configuração
O que é um prompt?
Um prompt é o conjunto de instruções que dizem ao seu agente como se comportar. Define a personalidade, que informação fornecer, como lidar com situações e que ações executar.
Qual deve ser o comprimento do meu prompt?
- Mínimo: 10 caracteres (mínimo do sistema)
- Máximo: 15.000 caracteres (máximo do sistema)
- Recomendado: 500-1.000 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 normalmente melhores.
Posso mudar a voz do agente?
Sim. Pode selecionar de entre várias vozes:
- Masculina ou feminina
- Diferentes idades e estilos
- Vários sotaques
- Diferentes velocidades de fala
Faça corresponder a voz à personalidade da sua marca.
Integrações
Que integrações estão disponíveis?
| Integração | Estado | Planos |
|---|---|---|
| Números de Telefone | Disponível | Todos |
| SIP Trunk | Disponível | Todos — requer aprovação de conformidade |
| Google Calendar | Disponível | Todos |
| Outlook Calendar | Disponível | Todos |
| HubSpot CRM | Disponível | Todos |
| Servidores MCP | Disponível | Todos |
| Chaves de API | Disponível | Todos |
| Webhooks | Disponível | Todos |
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:
- O agente está definido para o estado "Ativo"
- O número de telefone está atribuído ao agente
- A ligação telefónica (ou SIP trunk) está ativa
- A primeira mensagem está configurada
- O seu saldo de créditos tem fundos
O agente dá informação errada
Soluções:
- Verifique se a base de conhecimento contém a informação correta
- Confirme se a BC está ligada ao agente
- Acrescente instruções explícitas no prompt para usar apenas a BC
- Baixe a definição de temperatura (0.3-0.5)
A qualidade da chamada é fraca
Experimente estas correções:
- Verifique a sua ligação à internet (recomendado 5+ Mbps)
- Verifique a página de estado da plataforma
- Experimente uma opção de voz diferente
- Para testes no browser, use uma ligação com fios
Não consigo iniciar sessão na minha conta
Passos para resolver:
- Confirme o endereço de email correto
- Experimente "Esqueci-me da palavra-passe" para repor
- Limpe a cache e os cookies do browser
- Experimente o modo incógnito/privado
- Contacte o suporte se os problemas persistirem
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 por telefone
Quem pode aceder às minhas gravações de chamadas?
Apenas os utilizadores com as permissões adequadas na sua organização podem aceder às gravações. Você controla o acesso através das definições de gestão de equipa e das permissões baseadas em funções (Proprietário, Administrador, Membro).
A plataforma está em conformidade 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 excluir o armazenamento de dados sensíveis
Posso eliminar os meus dados?
Sim. Pode:
- Eliminar gravações de chamadas individuais
- Limpar o conteúdo da base de conhecimento
- Eliminar agentes
- Solicitar a eliminação completa 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?
- Esta documentação
- Guias de Configuração e Modelos -- guias descarregáveis
- Tutoriais em vídeo (quando disponíveis)
- Dicas e guias na aplicação
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?
Consulte o site da Hanc.AI para recursos e atualizações da comunidade.
Referência Rápida
Definições Recomendadas para Casos de Uso Comuns
| Caso de Uso | Temperatura | Comprimento da Resposta | Estilo de Voz |
|---|---|---|---|
| Suporte ao Cliente | 0.3-0.4 | Curto | Calmo, prestável |
| Vendas | 0.5-0.6 | Médio | Enérgico, amigável |
| Consultas | 0.3-0.4 | Curto | Profissional |
| Receção | 0.3-0.5 | Muito curto | Acolhedor |
Lista de Verificação: Antes de Ir Para Produção
- O prompt do agente está completo e testado
- A base de conhecimento está carregada e ligada
- A primeira mensagem soa natural
- As regras de escalonamento 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 o acesso adequado
Tópicos Relacionados
- Primeiros Passos -- Comece a usar a plataforma
- Agentes de Voz -- Guia completo do agente
- Base de Conhecimento -- Gerir informação
- Resolução de Problemas -- Resolver problemas