Pular para o conteúdo principal
Agentes

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​

  1. Navegue até Agentes de voz na barra lateral.
  2. Clique em Criar agente de voz.
  3. A janela Como você quer começar? oferece três caminhos:
OpçãoO que obtém
Começar com um único promptEscolha 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 workflowConstrua a conversa como um workflow com passos e ramos — a partir de um pronto ou de uma tela vazia
Criar no HANC StudioDescreva 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
  1. 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çãoDescrição
Implantar agenteCria o agente instantaneamente com as definições padrão do template. Pode preencher os detalhes do seu negócio mais tarde.
Configuração guiadaAbre 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.
dica

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.

aviso

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:

ControloO que faz
InfoAbre uma visão rápida da configuração: voz, idioma, bases de conhecimento, ferramentas ativas e o papel do agente
Falar com o agenteChamada de teste no browser, sem telefone — o painel de teste abre-se à direita com a transcrição em direto
Ligar para o agenteMostra os números de teste para os quais pode ligar a partir do seu telefone verificado
DemoAbre uma página de demonstração partilhável
Chips de números · Gerenciar / Atribuir númeroOs números atribuídos ao agente (entrada / saída); atribua-os ou remova-os aqui
Ícones do cabeçalhoRenomear (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.

SeparadorAgente de prompt únicoAgente com workflowConteú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
Porque é que um agente com workflow não tem os separadores Modelo e Ações

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?
Boas práticas para a primeira mensagem
  • 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çãoDescrição
Região, IdiomaA região do agente e o idioma da saudação (o agente adapta-se ao idioma de quem liga)
Idiomas do reconhecimento de falaAté 10 idiomas para o reconhecimento de fala; vazio = deteção automática
Voz, Volume, VelocidadeEscolha e afinação da voz
Encerrar chamada após silêncioTermina a chamada automaticamente se ninguém falar — exclui os lembretes
Tempo para lembrete (seg), Máx. de lembretesVoltar a chamar a atenção de quem está em silêncio antes de terminar a chamada
Gravação de chamadasGravar o áudio de cada chamada
Som de fundoSom de fundo opcional — seis ambientes com volume próprio
Duração máx. da chamadaLimite fixo da duração da chamada
Secretária eletrônicaSó chamadas de saída: o que fazer quando uma chamada cai na caixa postal
Análise de sentimento, Resumo da chamadaAná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:

GrupoFerramentas
GoogleGoogle Calendar, Gmail, Google Drive, Google Contacts, Google Tasks
MicrosoftOutlook Calendar, Outlook Mail
E-mailCaixa de correio (IMAP/SMTP)
CRM e serviçosHubSpot CRM, CallRail, monday.com, GoHighLevel, Kommo, Servidores MCP, Ferramenta de API RAG
ReservasReserva de mesa (resmio), Agendamento de compromissos eTermin
Chamada e mensagensEncaminhamento 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:

WidgetO Que Faz
FloatingBotão orbe a flutuar no canto. Clique para iniciar uma chamada de voz no browser.
PillBotão compacto em forma de pill colocado inline no seu conteúdo — mesma experiência de chamada que o Floating, menor pegada.
Pill FloatingA forma compacta de pill, mas a flutuar com a página como o widget Floating.
InlineBotão em tamanho completo incorporado diretamente no conteúdo da sua página.
CallbackFormulá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.

Encontrar o ID do Seu Agente

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:

MosaicoO que faz
Todos os agentesMostra todos os agentes no workspace atual (vista padrão)
Nome da pastaMostra apenas os agentes dentro dessa pasta, com um badge de contagem
Sem pastaMostra agentes que ainda não estão em nenhuma pasta (só aparece quando existem alguns)
Nova pastaCria uma nova pasta escrevendo um nome

Colocar um agente numa pasta:

  1. Abra a lista Agentes de voz
  2. Clique no menu de três pontos num cartão de agente
  3. Selecione "Set folder"
  4. Escolha uma pasta existente ou escreva uma nova e guarde
  5. 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.

  1. 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
  2. Selecione "Mover para workspace"
  3. Escolha o workspace de destino na lista pendente
  4. 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ãoDescrição
Falar com o agenteTeste no browser (WebRTC) — sem telefone
Ligar para o agenteMostra os números de teste para os quais pode ligar a partir do seu número verificado
DemoAbre uma página de demonstração partilhável

Teste no browser (Falar com o agente)​

  1. 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
  2. Permita o acesso ao microfone no seu browser
  3. Aguarde a saudação do agente
  4. 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
  5. Clique em terminar chamada quando concluído

Cenários de Teste​

Percorra estes cenários:

CenárioO Que DizerResultado 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
dica

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árioRecomendação
Departamentos diferentesAgentes separados (Vendas, Suporte, Faturação)
Idiomas diferentesAgentes separados por idioma
Marcas diferentesAgentes separados por marca
Negócio simplesUm 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​

  1. Vá a Painel na barra lateral para a visão geral de todos os agentes
  2. Abra o separador Painel de um agente para as suas estatísticas e registos de chamadas
  3. 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​

A Fazer
  • 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
A Evitar
  • 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​


Tópicos Relacionados​