O Seu Primeiro Agente
Este tutorial leva-o pelo processo de criar, configurar e testar o seu primeiro agente de voz IA. No final, terá um agente funcional capaz de responder a perguntas sobre o seu negócio.
O Que Vamos Construir
Um agente de voz IA que:
- Recebe os interlocutores profissionalmente
- Responde a perguntas usando a informação do seu negócio
- Fornece horário de funcionamento e dados de contacto
- Sabe quando transferir para um humano
Tempo estimado: 15-20 minutos
Pré-requisitos
Antes de começar, certifique-se de que tem:
- Criada a sua conta Hanc.AI (Configuração da Conta)
- Iniciou sessão na plataforma
- Informação básica sobre o seu negócio pronta
Passo 1: Criar um Novo Agente
Há dois caminhos para criar um agente: Baseado em template (recomendado para iniciantes) ou A partir do zero.
Caminho A: Baseado em Template (Recomendado)
Os Template Roles fornecem configurações pré-construídas que o fazem arrancar rapidamente. A Hanc.AI oferece 24 templates de função prontos a usar em duas categorias.
1.1 Navegar para Voice Agents
- Clique em "Voice Agents" na barra lateral esquerda
- Se for a primeira vez, um tour de onboarding irá guiá-lo pela interface passo a passo
1.2 Iniciar a Criação do Agente
Clique no botão "Create Voice Agent". Aparece um modal com duas opções:
- Start from Scratch — cria um agente em branco que você configura manualmente (ver Caminho B abaixo)
- Template Roles — 24 templates de função organizados em duas categorias
1.3 Explorar Template Roles
Os Template Roles estão organizados em duas categorias:
Voltados para o Cliente (14 funções):
| Template | Melhor Para |
|---|---|
| Sales Agent | Chamadas de vendas, apresentação de oferta, fecho de negócios |
| Receptionist | Acolhimento de interlocutores, encaminhamento, pedidos gerais |
| Consultant | Chamadas de descoberta, avaliação de necessidades, consultoria |
| Support Agent | Suporte ao cliente, troubleshooting, resolução de problemas |
| Order Agent | Colocação de pedidos, rastreamento, modificações |
| Call Router | Encaminhar interlocutores para o departamento ou pessoa certa |
| Reminder Agent | Lembretes de compromisso, seguimentos, notificações |
| Feedback Agent | Recolher feedback de clientes e inquéritos |
| Collection Agent | Lembretes de pagamento, seguimento de faturas |
| Lead Qualifier | Qualificar leads inbound, recolher informação de prospect |
| Guide | Instruções passo a passo, onboarding, walkthroughs |
| Promoter | Sensibilização para o produto, campanhas, envolvimento de topo de funil |
| Auto-Answerer | Atendimento automático de chamadas, entrega de informação básica |
| Presenter | Apresentações de produtos ou serviços, demos |
Voltados para o Colaborador (10 funções):
| Template | Melhor Para |
|---|---|
| Secretary | Gestão interna de chamadas, agendamento, tomar mensagens |
| Recruiter | Triagem de candidatos, agendamento de entrevistas |
| Onboarder | Onboarding de novos colaboradores, orientação |
| Coordinator | Coordenação de equipa, agendamento de reuniões |
| Controller | Monitorização de processo, atualizações de estado, verificações de conformidade |
| Internal Helpdesk | Suporte de IT, FAQ interno, assistência a colaboradores |
| Data Collector | Recolher dados estruturados de membros da equipa |
| Approval Agent | Encaminhar aprovações, recolher autorizações |
| Procurement Agent | Pedidos de compra, consultas a fornecedores |
| Dispatcher | Atribuição de tarefas, alocação de recursos, despacho |
Para este tutorial: Selecione qualquer template que corresponda ao seu caso de uso.
Os Template Roles incluem prompts pré-escritos, mensagens de saudação e protocolos de conversação otimizados para funções específicas. Pode personalizar tudo após a criação.
1.4 Ver Detalhes do Template
Clique em qualquer cartão de template para abrir uma vista detalhada que mostra:
- Descrição da função e do que o agente faz
- Benefícios de usar este template
- Capacidades que o agente terá
- Seletor de língua — primeiro escolhe uma língua (ex. English, Deutsch), depois uma variante regional (ex. United States, Áustria, Suíça) e a voz correspondente
- Download as Word document — exporta as perguntas do Setup Wizard como um ficheiro
.docxna língua que escolheu, para que a sua equipa o possa preencher offline. Uma vez preenchido, o mesmo assistente Guided Setup pode ler o documento de volta e preencher automaticamente cada campo correspondente — ver Preenchimento via documento Word abaixo
Cada template é entregue em 20 línguas suportadas com prompts de qualidade nativa e opções de voz para cada uma. A função Receptionist em alemão usa uma baseline alemã real, não uma tradução de um template em inglês.
Preenchimento via documento Word
Se preferir recolher a informação de negócio offline (ou dividir o trabalho entre colegas de equipa), use o caminho via documento Word:
- Clique em Download as Word document no modal de detalhe da função — recebe um
.docxque corresponde à função e língua que escolheu. - Preencha tantas secções quantas tiver respostas para. Pule o que não souber.
- Clique em Guided Setup para abrir o assistente para a mesma função.
- Dentro do assistente, clique em Upload filled document e selecione o ficheiro. O assistente analisa as suas respostas e mostra uma confirmação como "12 de 18 campos preenchidos a partir do documento."
- Reveja e ajuste os campos pré-preenchidos, depois continue através do assistente normalmente.
Pode voltar a carregar o documento a qualquer momento — cada upload atualiza os campos correspondentes com os valores mais recentes do seu ficheiro.
1.5 Escolher Como Criar
A partir da vista de detalhe do template, tem dois botões:
- Deploy Agent — Cria o agente instantaneamente com os valores padrão do template. Pode preencher os detalhes do seu negócio mais tarde usando o Setup Wizard. Esta é a forma mais rápida de começar.
- Guided Setup — Abre um assistente passo a passo onde preenche os detalhes do seu negócio (nome da empresa, serviços, dados de contacto, etc.) antes do agente ser criado.
Deploy Agent é ótimo se quiser explorar o agente primeiro e configurá-lo mais tarde. Guided Setup é melhor se tiver a informação do seu negócio pronta e quiser um agente mais completo desde o início.
1.6 Guided Setup (se escolhido)
Se clicou em Guided Setup, um assistente guia-o no preenchimento de detalhes específicos do seu negócio:
- Nome da empresa, serviços, dados de contacto
- Horário de funcionamento, localização, preços
- Instruções e políticas específicas
Importante: Pode saltar campos ou secções inteiras que não se aplicam ao seu negócio. No entanto, pelo menos uma secção tem de estar totalmente completa para poder prosseguir.
Depois de completar o assistente, o seu agente é criado com todos os detalhes que forneceu.
Caminho B: A Partir do Zero
Para controlo total desde o início:
- Clique em "Create Voice Agent"
- Selecione "Start from Scratch"
- Um agente em branco é criado com um prompt padrão
- Vai configurar tudo manualmente no próximo passo
Passo 2: Após a Criação
Uma vez criado o seu agente, verá um banner de sucesso com sugestões de próximos passos. Um tour de onboarding irá guiá-lo pelas abas de configuração do agente, destacando definições e funcionalidades-chave.
O seu agente vem com duas variáveis de recolha por defeito — Email e Phone — para que possa recolher informação de contacto dos interlocutores desde já. Pode personalizá-las ou removê-las na aba Actions.
O Setup Wizard
Procure o ícone de varinha brilhante ao lado do nome do seu agente — este é o Setup Wizard. Ajuda-o a preencher os detalhes restantes secção a secção.
Como funciona o Setup Wizard:
- O progresso é rastreado como "X/Y secções concluídas" para você saber sempre o que falta
- Cada secção cobre uma área diferente de configuração: Agent Configuration, Company Profile, Services, Specialists, Locations, e mais
- Pode saltar campos ou secções inteiras que não precisa (mínimo 1 campo por secção)
- Trabalhe pelas secções em qualquer ordem ao seu ritmo
Se usou Deploy Agent, o Setup Wizard é a sua forma principal de adicionar detalhes do negócio após a criação. Se usou Guided Setup, algumas secções já estarão preenchidas.
Editar manualmente o prompt ou os ficheiros da Base de Conhecimento desativa o Setup Wizard. Se isto acontecer, aparece um botão "Reset to Template" que lhe permite restaurar a funcionalidade do assistente.
Abas do Agente
A página de configuração do seu agente tem estas abas:
| Aba | O Que Contém |
|---|---|
| Dashboard | Visão geral da atividade do agente e estatísticas |
| Model | Prompt, voz, língua e definições do modelo de IA |
| Knowledge Base | Ficheiros e informação que o agente usa para responder a perguntas |
| Settings | Definições de chamada, primeira mensagem, limites de duração de chamada |
| Actions | Ações pós-chamada (email, SMS, webhooks) |
| Widgets | Configuração de widget web para embeber no seu site |
Passo 3: Configurar as Definições do Agente
3.1 Prompt
O prompt define a personalidade, comportamento e fluxo de conversa do seu agente.
Se usou um template, o prompt está pré-preenchido. Reveja-o e personalize para o seu negócio.
Se começou do zero, escreva o seu prompt:
## Função
És um assistente virtual amigável da [Nome do Seu Negócio].
Ajudas os clientes com perguntas sobre os nossos serviços, horários e marcação de compromissos.
## Estilo de Comunicação
- Fala de forma clara e concisa
- Sê educado e profissional
- Mantém as respostas curtas (1-3 frases sempre que possível)
- Faz uma pergunta de cada vez
## Regras Importantes
1. Fornece apenas informação que conheces com certeza
2. Se não souberes algo, diz "Não tenho essa informação, mas posso ligar-te à nossa equipa"
3. Nunca inventes preços, disponibilidade ou outros detalhes específicos
4. Transfere para um humano se o cliente estiver chateado ou tiver um problema complexo
Inclua sempre a instrução: "Nunca inventes informação." Isto evita que a IA invente detalhes falsos sobre o seu negócio.
3.2 Base de Conhecimento
A base de conhecimento dá ao seu agente os factos de que precisa para responder a perguntas.
- Vá à aba Knowledge Base nas definições do agente
- Crie uma nova base de conhecimento ou selecione uma existente
- Carregue ficheiros com a informação do seu negócio
Formatos de ficheiro aceites: .txt, .md, .docx, .pdf, .html, .csv
O que incluir:
- Serviços e preços
- Horário de funcionamento e localização
- Perguntas frequentes
- Políticas (cancelamento, pagamento, etc.)
- Informação da equipa
O agente SÓ sabe o que está na base de conhecimento. Se faltar informação, o agente não consegue responder a essas perguntas. Adicione todos os detalhes importantes.
3.3 Voz
Escolha uma voz que corresponda à sua marca:
- Selecione a língua
- Explore as vozes disponíveis (masculino/feminino, diferentes estilos)
- Pré-visualize vozes antes de selecionar
3.4 Definições de Chamada
Configure o comportamento da chamada:
- Primeira mensagem (saudação quando o agente atende)
- Definições de língua
- Limites de duração da chamada
3.5 Ferramentas
Adicione ferramentas que o agente pode usar durante as chamadas:
- Google Calendar para agendamento de compromissos
- Integrações de API personalizadas
3.6 Ações
Configure ações pós-chamada que são acionadas após uma conversa terminar:
- Enviar resumos por email
- Enviar notificações por SMS
- Acionar webhooks
- Fazer chamadas de API
3.7 Widget
Configure o widget web para embeber no seu site:
- Aparência e cores
- Posição e comportamento
- Branding personalizado
3.8 Guardar Definições
Clique em "Save" ou "Update" para guardar a sua configuração.
Passo 4: Testar o Seu Agente
Agora vamos ver o seu agente em ação!
4.1 Testar via Widget Web
- Encontre o seu agente na lista de Voice Agents
- Clique em "Talk to agent" ou no botão de teste/chamada
- Permita acesso ao microfone no seu browser
- Comece a falar
4.2 Testar via Número de Telefone
Se tem um número de telefone ligado:
- Atribua o seu agente ao número (nas definições de Phone Numbers)
- Ligue para o número a partir de qualquer telefone
4.3 Cenários de Teste
Teste 1: Saudação básica
- Aguarde a saudação do agente
- Diga: "Olá"
- O agente deve responder naturalmente
Teste 2: Horário de funcionamento
- Diga: "Quais são os vossos horários?"
- O agente deve fornecer os seus horários a partir da base de conhecimento
Teste 3: Pergunta sobre serviço
- Diga: "Que serviços oferecem?"
- O agente deve listar os seus serviços
Teste 4: Pergunta sobre preço
- Diga: "Quanto custa [o seu serviço]?"
- O agente deve dar o preço se estiver na base de conhecimento
Teste 5: Pergunta desconhecida
- Diga: "Qual é o sentido da vida?"
- O agente deve dizer educadamente que não tem essa informação
4.4 Terminar o Teste
Clique em "End call" ou feche a janela de teste quando terminar.
Passo 5: Refinar o Seu Agente
Com base nos testes, pode querer melhorar:
Problemas Comuns e Correções
| Problema | Solução |
|---|---|
| O agente fala demasiado | Adicione ao prompt: "Mantém as respostas em 1-2 frases" |
| O agente é demasiado formal | Ajuste o tom do prompt: "Sê amigável e conversacional" |
| O agente não conhece a informação | Verifique se a base de conhecimento tem a informação |
| O agente inventa coisas | Enfatize no prompt: "NUNCA inventes informação" |
| Língua errada | Verifique se a definição de Language corresponde às suas necessidades |
| Voz demasiado rápida/lenta | Ajuste as definições de velocidade da voz |
Iterar e Melhorar
- Testar → Identificar problemas → Ajustar prompt/definições → Testar novamente
- Adicionar mais FAQ à base de conhecimento com base nas chamadas de teste
- Refinar o prompt com base em conversas reais
Passo 6: Implementar o Seu Agente (Opcional)
Uma vez satisfeito com os testes, pode implementar o seu agente:
Opção A: Ligar um Número de Telefone
- Vá a Phone Numbers
- Compre um número ou importe um existente
- Atribua o seu agente ao número
- As chamadas para esse número passam a ser geridas pelo seu agente
Opção B: Adicionar Widget do Site
- Vá às definições do seu agente
- Encontre a aba Widgets
- Copie o código de embed
- Adicione ao seu site
Checklist: O Seu Agente Está Pronto?
Antes de ir para produção, verifique:
- A primeira mensagem é clara e acolhedora
- O prompt define o comportamento corretamente
- A base de conhecimento tem informação precisa
- O agente lida bem com perguntas comuns
- O agente admite quando não sabe algo
- A voz soa apropriada para a sua marca
- A língua está definida corretamente
- As chamadas de teste produzem bons resultados
O Que Vem a Seguir?
Parabéns! Criou o seu primeiro agente de voz IA.
Continue a aprender:
- Aprofundar Agentes de Voz IA — Configuração avançada do agente
- Boas Práticas da Base de Conhecimento — Crie melhores bases de conhecimento
- Números de Telefone — Ligue números de telefone reais
- Template Roles — Prompts e configurações prontos a usar
- Campanhas — Configure campanhas de chamadas outbound
Resolução de Problemas
O agente não inicia a chamada de teste
- Verifique as permissões de microfone do browser
- Experimente um browser diferente
- Garanta uma ligação à internet estável
O agente não responde
- Aguarde alguns segundos — pode haver atraso de processamento
- Fale de forma clara e não demasiado rápido
- Verifique se o agente não está pausado/inativo
O agente dá informação errada
- Verifique se o conteúdo da base de conhecimento está correto
- Verifique se a base de conhecimento está ligada ao agente
- Reveja o prompt em busca de instruções conflituantes
A qualidade da voz é fraca
- Verifique a sua ligação à internet
- Tente uma voz diferente
- Reduza o ruído de fundo
Precisa de Ajuda?
- Reveja o Guia de Resolução de Problemas
- Contacte support@hanc.ai