Agentes de Voz IA
Guia completo para criar e gerir agentes de voz IA
Os agentes de voz IA são o núcleo da plataforma Hanc.AI — assistentes virtuais com inteligência artificial que gerem conversas telefónicas com os seus clientes. Esta secção cobre tudo o que precisa de saber sobre criar, configurar e gerir agentes de voz IA.
O Que é um Agente de Voz IA?
Um agente de voz IA é um programa IA que:
- Atende chamadas telefónicas automaticamente, 24/7
- Entende fala em linguagem natural
- Responde com voz usando fala de som natural
- Segue as suas instruções definidas no prompt
- Usa a sua informação da base de conhecimento
- Realiza ações como marcar compromissos ou transferir chamadas
Arquitetura do Agente
Criar um agente
A Partir do Painel
- Navegue até Agentes de voz na barra lateral.
- Clique em Criar agente de voz.
- A janela Como você quer começar? oferece três caminhos:
| Opção | O que obtém |
|---|---|
| Começar com um único prompt | Escolha um modelo pronto ou escreva o seu próprio prompt — a forma mais rápida de ter um agente a atender chamadas. Os modelos e Começar do zero estão dentro desta opção |
| Começar com um workflow | Construa a conversa como um workflow com passos e ramos — a partir de um pronto ou de uma tela vazia |
| Criar no HANC Studio | Descreva o seu negócio num chat e o Studio constrói toda a conversa por si, passos e ramos incluídos. €5 por agente, com um pacote Studio — consulte Criação de agentes |
- Configure o agente e teste-o. As alterações são guardadas automaticamente.
Templates Disponíveis
A Hanc.AI inclui 24 templates de papéis prontos a usar organizados em dois grupos — customer-facing (Agente de vendas, Recepcionista, Agente de suporte, Consultor, Agente de pedidos, Roteador de chamadas, Agente de lembretes, Agente de feedback, Agente de cobrança, Qualificador de leads, Guia, Promotor, Atendente automático, Apresentador) e employee-facing (Secretário, Recrutador, Agente de onboarding, Coordenador, Controlador, Helpdesk interno, Coletor de dados, Agente de aprovações, Agente de compras, Despachante). Cada template está disponível em todos os idiomas do agente, por isso escolher um Agente de vendas em alemão dá-lhe a mesma estrutura de prompt escrita em alemão, em vez de traduzida do inglês.
Consulte a secção Papéis de Template para cada papel com a sua página de detalhe, utilização recomendada e fluxo do Assistente de configuração — e para os modelos de workflow prontos e os agentes de demonstração. Se nenhum dos 24 papéis servir, escolha Começar do zero para um agente vazio que configura manualmente.
Fluxo de Deploy
Há duas formas de criar um agente a partir de um template:
| Opção | Descrição |
|---|---|
| Implantar agente | Cria o agente instantaneamente com as definições padrão do template. Pode preencher os detalhes do seu negócio mais tarde. |
| Configuração guiada | Abre o Assistente de configuração imediatamente para que possa configurar o agente passo a passo antes de entrar em produção. |
Após o deploy, aparece um banner de sucesso com próximos passos sugeridos — como testar o agente, atribuir um número de telefone ou incorporar um widget no seu site.
Assistente de configuração
Quando cria um agente a partir de um template, aparece um ícone de varinha luminosa ao lado do nome do agente. Clique nele para abrir o Assistente de configuração, que o acompanha no preenchimento dos detalhes do seu negócio secção a secção.
- O progresso é acompanhado no topo do assistente (ex.: "2/7 secções concluídas").
- Cada secção cobre uma parte específica da configuração — info do negócio, horário, serviços, e por aí adiante.
- Pode completar as secções em qualquer ordem e regressar ao assistente a qualquer momento.
O Assistente de configuração é a forma mais rápida de deixar um agente baseado em template totalmente configurado. Complete todas as secções para garantir que o seu agente tem a informação de que precisa para gerir chamadas de forma eficaz.
Redefinir para a última versão do Assistente
Se editar manualmente o prompt, a saudação ou os ficheiros da base de conhecimento depois de criar um agente a partir de um modelo, o Assistente de configuração é desativado. Os separadores Modelo e Base de conhecimento mostram então o aviso "Edições manuais detectadas — o Assistente de configuração está desativado. Você pode redefinir para a última versão do Assistente." com o botão Redefinir para a última versão do Assistente. Este regenera o prompt e a base de conhecimento a partir das últimas variáveis guardadas do Assistente e volta a ativá-lo.
A redefinição substitui as alterações manuais feitas ao prompt e à base de conhecimento.
Configuração do Agente
Cabeçalho do agente
O cabeçalho no topo da página do agente contém o nome do agente, os seus números de telefone e as ações principais:
| Controlo | O que faz |
|---|---|
| Info | Abre uma visão rápida da configuração: voz, idioma, bases de conhecimento, ferramentas ativas e o papel do agente |
| Falar com o agente | Chamada de teste no browser, sem telefone — o painel de teste abre-se à direita com a transcrição em direto |
| Ligar para o agente | Mostra os números de teste para os quais pode ligar a partir do seu telefone verificado |
| Demo | Abre uma página de demonstração partilhável |
| Chips de números · Gerenciar / Atribuir número | Os números atribuídos ao agente (entrada / saída); atribua-os ou remova-os aqui |
| Ícones do cabeçalho | Renomear (o lápis junto ao nome), Pré-visualização completa (só em agentes de prompt único), Copiar ID do agente, Mover para o Workspace, Solicitar recurso, Excluir. Passe o rato sobre um ícone para ver o nome |
Separadores do agente
Os separadores de um agente dependem de como foi construído.
| Separador | Agente de prompt único | Agente com workflow | Conteúdo |
|---|---|---|---|
| Info | ✓ | ✓ | O "bilhete de identidade" do agente — ver abaixo |
| Painel | ✓ | ✓ | Registos de chamadas, análises, visão geral do sentimento; Exportar em XLS |
| Modelo | ✓ | — | Primeira mensagem, prompt do agente (editor Visual / Markdown), base de conhecimento, Seguir o idioma do visitante |
| Workflow | — | ✓ | O construtor visual — a chamada passo a passo com nós e ramos. Consulte Workflows |
| Base de conhecimento | ✓ | ✓ | Os ficheiros da base de conhecimento associados a este agente |
| Configurações | ✓ | ✓ | Voz e idioma, comportamento da chamada, secretária eletrônica, gravação, análise pós-chamada |
| Ações | ✓ | — | Ferramentas, ações ao vivo e pós-chamada, pre-fetch, variáveis de recolha de dados. Consulte Ações e Ferramentas |
| Gatilhos | ✓ | ✓ | Trabalho em segundo plano: reagir a um email, uma chamada, um lead, um webhook ou um horário e depois ligar. Consulte Gatilhos |
| Widgets | ✓ | ✓ | Widgets para o site, o Callback widget e as restrições de domínio |
Num agente com workflow, o prompt, a voz e as ferramentas vivem dentro dos nós do grafo: cada nó tem as suas instruções e as ferramentas entram como nós Ferramenta e Integração. Um separador Modelo ou Ações à parte não teria nada para configurar, por isso estão ocultos.
Separador Info
O separador Info é o "bilhete de identidade" do agente: idioma, voz, modelo, ID do agente e data de criação, mais três blocos editáveis — Visão geral, Principais benefícios e Capacidades. Clique em qualquer texto para o editar; as alterações são guardadas automaticamente.
Separador Modelo
A configuração principal de um agente de prompt único:
Primeira mensagem
A primeiríssima frase que o agente diz quando a chamada começa:
Hello! Thank you for calling ABC Company. How can I assist you today?
- Mantenha abaixo de 10 segundos quando falada
- Indique o nome da sua empresa
- Convide o interlocutor a falar
- Soe acolhedor
- Dizer que quem liga está a falar com um assistente de IA — consulte Segurança e RGPD
Prompt do Agente
Instruções que definem o comportamento do agente. O editor tem dois modos — Visual e Markdown — que editam o mesmo prompt. Consulte Engenharia de prompts para orientação detalhada.
Base de conhecimento
Escolha as bases de conhecimento que o agente usa nas respostas. Os ficheiros são geridos no separador Base de conhecimento e na secção Base de conhecimento.
Seguir o idioma do visitante
Nas chamadas web, o agente cumprimenta e escuta no idioma do browser do visitante. Consulte Idiomas e vozes.
Aviso de Template
Quando um agente foi criado a partir de um modelo, os separadores Modelo e Base de conhecimento mostram um aviso: editar manualmente o prompt, a saudação ou a base de conhecimento desativa o Assistente de configuração. Consulte Redefinir para a última versão do Assistente.
Aba Settings
Configure o comportamento do agente na aba Configurações:
| Definição | Descrição |
|---|---|
| Região, Idioma | A região do agente e o idioma da saudação (o agente adapta-se ao idioma de quem liga) |
| Idiomas do reconhecimento de fala | Até 10 idiomas para o reconhecimento de fala; vazio = deteção automática |
| Voz, Volume, Velocidade | Escolha e afinação da voz |
| Encerrar chamada após silêncio | Termina a chamada automaticamente se ninguém falar — exclui os lembretes |
| Tempo para lembrete (seg), Máx. de lembretes | Voltar a chamar a atenção de quem está em silêncio antes de terminar a chamada |
| Gravação de chamadas | Gravar o áudio de cada chamada |
| Som de fundo | Som de fundo opcional — seis ambientes com volume próprio |
| Duração máx. da chamada | Limite fixo da duração da chamada |
| Secretária eletrônica | Só chamadas de saída: o que fazer quando uma chamada cai na caixa postal |
| Análise de sentimento, Resumo da chamada | Análise pós-chamada |
Consulte Definições para cada campo e Idiomas e vozes para os idiomas.
Ações e Ferramentas
As ferramentas e ações alargam o que o seu agente pode fazer para além da conversa. Num agente de prompt único estão no separador Ações; num workflow, as mesmas capacidades são nós Ferramenta e Integração.
Adicionar ferramenta agrupa tudo por fase — Pre fetch, Post call e Live call — e, dentro de Live call, por fornecedor:
| Grupo | Ferramentas |
|---|---|
| Google Calendar, Gmail, Google Drive, Google Contacts, Google Tasks | |
| Microsoft | Outlook Calendar, Outlook Mail |
| Caixa de correio (IMAP/SMTP) | |
| CRM e serviços | HubSpot CRM, CallRail, monday.com, GoHighLevel, Kommo, Servidores MCP, Ferramenta de API RAG |
| Reservas | Reserva de mesa (resmio), Agendamento de compromissos eTermin |
| Chamada e mensagens | Encaminhamento de chamada, Transferência de agente, Retornar ligação depois, Email ao vivo, SMS ao vivo |
Email ao vivo e SMS ao vivo disparam durante a chamada, por isso quem liga recebe um SMS ou email ainda em linha. Pre fetch corre antes de a chamada começar e injeta no prompt o que encontra; as ações Post call (Enviar e-mail, Enviar SMS, Enviar WhatsApp, Chamada de API) correm depois de a chamada terminar. As variáveis de recolha de dados — os dados que a IA extrai de cada conversa — estão no mesmo separador.
Consulte Ações e Ferramentas para cada ferramenta e ação, e Google, Email e Ferramentas CRM para as ligações.
Widgets de Website
Incorpore o seu agente em qualquer site. Aceda através da aba Widgets. A Hanc.AI oferece cinco tipos de widget:
| Widget | O Que Faz |
|---|---|
| Floating | Botão orbe a flutuar no canto. Clique para iniciar uma chamada de voz no browser. |
| Pill | Botão compacto em forma de pill colocado inline no seu conteúdo — mesma experiência de chamada que o Floating, menor pegada. |
| Pill Floating | A forma compacta de pill, mas a flutuar com a página como o widget Floating. |
| Inline | Botão em tamanho completo incorporado diretamente no conteúdo da sua página. |
| Callback | Formulário que recolhe o número de telefone do visitante; o seu agente liga-lhes de volta automaticamente. |
Veja Widgets de Website para os widgets no browser e a página dedicada Widget de Callback para o fluxo de callback telefónico.
No cabeçalho do agente, clique em Copiar ID do agente. O ID também aparece no separador Info.
Gerir o Seu Agente
Os ícones no cabeçalho do agente e o menu de três pontos de cada cartão de agente na lista Agentes de voz oferecem as ações para gerir os seus agentes no dia a dia.
Renomear
Clique no lápis (Renomear) junto ao nome do agente no cabeçalho. O novo nome aplica-se de imediato em toda a plataforma.
Duplicar
Abra o menu de três pontos de um cartão de agente na lista Agentes de voz → Duplicar. O agente é clonado com todas as definições — prompt, base de conhecimento, ferramentas, ações e configuração — para que o possa usar como ponto de partida de um novo agente.
Pré-visualização completa
Pré-visualização completa — um ícone no cabeçalho de um agente de prompt único — mostra numa janela a primeira mensagem, o prompt de sistema e as bases de conhecimento ligadas, útil para rever um agente sem abrir cada separador.
Eliminar
Clique em Excluir no cabeçalho do agente ou use o menu do cartão do agente. A eliminação usa uma confirmação em dois passos: tem de escrever o nome do agente para confirmar. Isto evita remoções acidentais.
Organizar Agentes em Pastas
Assim que tem uma mão-cheia de agentes, uma lista plana torna-se ruidosa. As pastas permitem-lhe agrupar agentes por propósito, cliente ou etapa — e filtrar a lista com um clique.
Barra de pastas na página Agentes de voz:
| Mosaico | O que faz |
|---|---|
| Todos os agentes | Mostra todos os agentes no workspace atual (vista padrão) |
| Nome da pasta | Mostra apenas os agentes dentro dessa pasta, com um badge de contagem |
| Sem pasta | Mostra agentes que ainda não estão em nenhuma pasta (só aparece quando existem alguns) |
| Nova pasta | Cria uma nova pasta escrevendo um nome |
Colocar um agente numa pasta:
- Abra a lista Agentes de voz
- Clique no menu de três pontos num cartão de agente
- Selecione "Set folder"
- Escolha uma pasta existente ou escreva uma nova e guarde
- O cartão desliza para a pasta escolhida; o badge de contagem atualiza
Remover uma atribuição de pasta:
Abra o mesmo modal "Set folder" e clique em "Clear folder" (o botão só aparece quando uma pasta está atualmente definida). O agente regressa ao balde sem pasta. As pastas sem agentes lá dentro desaparecem da barra automaticamente; não há um passo separado de "eliminar pasta".
Dica: os rótulos de pasta são texto livre, por isso pode usá-los como quiser — Active, Drafts, Acme Project, Q3 launch são todos válidos.
Mover um Agente para um Workspace Diferente
Se tem vários workspaces e o agente acabou no errado (ou quer entregar um agente construído a um workspace de cliente), pode movê-lo sem perder nada — prompt, voz, base de conhecimento, ferramentas, histórico viajam todos juntos.
- Abra a lista Agentes de voz e clique no menu de três pontos do cartão do agente — ou clique em Mover para o Workspace no cabeçalho do agente
- Selecione "Mover para workspace"
- Escolha o workspace de destino na lista pendente
- Confirme — o agente desaparece da lista de origem e aparece no destino
Após a mudança:
- O agente mantém o seu nome, configuração e histórico de chamadas
- Quaisquer números de telefone que estavam atribuídos ao agente movem-se com o agente para o novo workspace — sem necessidade de reassociação manual
- Os membros da equipa que só têm acesso ao workspace de origem deixarão de ver o agente
Chamada de Demo
Clique no botão "Demo" no cabeçalho do agente para abrir uma página de demo partilhável. Partilhe este link com colegas ou stakeholders para lhes permitir testar o agente sem precisarem de acesso à plataforma.
Chamada de Teste
Clique em "Talk to Agent" para uma chamada de teste no browser usando WebRTC (sem telefone necessário), ou use um número de telefone ligado para ligar diretamente ao agente.
Gestão de Telefone
Os números de telefone atribuídos aparecem como chips no cabeçalho do agente. Clique em "Gerenciar" (ou em "Atribuir número" quando ainda não há nenhum atribuído) para atribuir ou remover números diretamente na página do agente e alternar cada número entre entrada e saída.
Pedir Funcionalidade
Clique em Solicitar recurso no cabeçalho do agente para enviar um pedido de funcionalidade diretamente à equipa da Hanc.AI.
Testar Agentes
Botões de teste no cabeçalho do agente
| Botão | Descrição |
|---|---|
| Falar com o agente | Teste no browser (WebRTC) — sem telefone |
| Ligar para o agente | Mostra os números de teste para os quais pode ligar a partir do seu número verificado |
| Demo | Abre uma página de demonstração partilhável |
Teste no browser (Falar com o agente)
- Clique em "Falar com o agente" no cabeçalho do agente — o painel de teste abre-se à direita e mostra a transcrição enquanto fala
- Permita o acesso ao microfone no seu browser
- Aguarde a saudação do agente
- Fale naturalmente e teste cenários. Se o agente recolher dados com campos marcados como Exibir no formulário, o painel de teste mostra o mesmo formulário que um visitante do site vê no widget, preenchido enquanto fala — consulte Recolher dados da chamada
- Clique em terminar chamada quando concluído
Cenários de Teste
Percorra estes cenários:
| Cenário | O Que Dizer | Resultado Esperado |
|---|---|---|
| Saudação | (Apenas ouvir) | O agente cumprimenta adequadamente |
| Pergunta simples | "Qual é o vosso horário?" | Horário de funcionamento correto |
| Consulta de serviço | "Que serviços oferecem?" | Lista de serviços |
| Marcação | "Gostava de marcar um compromisso" | O fluxo de marcação inicia |
| Tópico desconhecido | "Como está o tempo?" | Desvio educado |
| Frustração | (Soar irritado) | Resposta empática |
| Pedido de transferência | "Quero falar com um humano" | Transferência iniciada |
Teste todos os cenários que importam para o seu negócio antes de entrar em produção. Preste especial atenção aos casos-limite e aos gatilhos de escalonamento.
Registos de Chamadas de Teste
Após testar, reveja:
- Transcrição completa
- Tempos de resposta
- Quaisquer erros ou problemas
- Análise de sentimento
Gerir Vários Agentes
Quando Usar Vários Agentes
| Cenário | Recomendação |
|---|---|
| Departamentos diferentes | Agentes separados (Vendas, Suporte, Faturação) |
| Idiomas diferentes | Agentes separados por idioma |
| Marcas diferentes | Agentes separados por marca |
| Negócio simples | Um agente trata de tudo |
Organização de Agentes
Use convenções de nomenclatura claras:
[Departamento] - [Função] - [Idioma]
Exemplos:
- Sales - Inbound - EN
- Support - Tier 1 - DE
- Reception - Main - EN
Analítica do Agente
Acompanhe o desempenho do agente:
O que mostra o separador Painel do agente
- Os cartões Total de chamadas, Duração total das chamadas e Duração média das chamadas para o período escolhido
- O resumo de sentimento — quantas chamadas foram positivas, neutras e negativas
- Os registos de chamadas deste agente, com a transcrição, a gravação, o resumo e o motivo pelo qual cada chamada terminou
Ver Analítica
- Vá a Painel na barra lateral para a visão geral de todos os agentes
- Abra o separador Painel de um agente para as suas estatísticas e registos de chamadas
- Clique numa chamada do registo para a transcrição, a gravação e a análise; Exportar em XLS descarrega o registo. Consulte Análises
Boas Práticas
- Mantenha os prompts claros e específicos
- Teste exaustivamente antes de implementar
- Atualize a base de conhecimento regularmente
- Monitorize os registos de chamadas à procura de problemas
- Itere com base em conversas reais
- Defina gatilhos de escalonamento apropriados
- Tornar os prompts demasiado longos ou complexos
- Implementar sem testar
- Ignorar padrões de sentimento negativo
- Deixar a base de conhecimento tornar-se desatualizada
- Prometer capacidades que o agente não tem
- Saltar caminhos de escalonamento
Guias Nesta Secção
Engenharia de prompts
Escreva prompts eficazes que definem o comportamento do agente
Ações e Ferramentas
Encaminhamento de chamadas, Google Calendar, servidores MCP, ações pós-chamada
Gatilhos
Trabalho em segundo plano: reagir a emails, chamadas, leads, webhooks ou um horário e depois ligar
Workflows
Construa fluxos de conversa multi-passo visualmente com nós e ramos
Widgets de Website
Incorpore agentes de voz no seu site
Widget de Callback
Recolha números de telefone de visitantes e faça o seu agente ligar-lhes de volta
Definições
Voz, comportamento de chamada, duração máxima de chamada, análise pós-chamada
Idiomas e vozes
23 idiomas, mudança de idioma durante a chamada, idiomas de reconhecimento