Pular para o conteúdo principal
DocumentationAPI ReferenceVideo Tutorials

Início Rápido

Lance o seu agente de voz IA em 15-20 minutos

O Que é um Agente de Voz IA?​

Um agente de voz IA é um programa que fala com os seus clientes usando voz. Um cliente liga ou clica num botão no seu site e o agente responde: cumprimenta-o, responde a perguntas e marca compromissos.

O agente funciona 24/7, nunca se cansa e nunca esquece informação. No entanto, só sabe o que você lhe carregar — por isso é importante preparar bem a sua base de conhecimento.

O Que Vai Precisar​

  • Endereço de email — irá receber uma confirmação
  • Número de telefone — para verificação durante o registo
  • Informação sobre a sua empresa (em qualquer formato: ficheiro, texto, lista de preços)
dica

Prepare a informação do seu negócio com antecedência — detalhes da empresa, serviços, preços, horário de funcionamento e FAQs. Isto torna a configuração muito mais rápida.

Passo 1: Registo na Plataforma​

Há duas formas de começar:

Opção A: Começar pela Landing Page (Recomendado)​

  1. Abra um browser e vá a hanc.ai/create-agent
  2. Selecione uma função para o seu agente (ex.: Suporte ao Cliente, Vendas, Receção)
  3. Introduza informação básica sobre o seu negócio
  4. Crie a sua conta (email, palavra-passe, verificação telefónica)

Este fluxo guiado leva-o pela criação do agente como parte do onboarding.

Opção B: Inscrever-se Diretamente​

  1. Abra um browser e vá a app.hanc.ai/signup
  2. Preencha o formulário de registo:
    • Email — o seu endereço de email para notificações
    • Palavra-passe — mínimo 8 caracteres
    • Número de telefone — em formato internacional (ex.: +43 664 123 45 67)
  3. Verifique o seu número de telefone via código SMS
  4. Complete a verificação "Não sou um robô" (reCAPTCHA)
Importante

Email e número de telefone devem ser únicos — se já se registou antes, use detalhes diferentes ou inicie sessão na sua conta existente.

Mercados de língua alemã

Se o seu agente irá operar em alemão, escolha a variante regional no registo — Alemanha, Áustria ou Suíça. Isto pré-seleciona uma voz nativa da região (Leonie para a Alemanha, Hermann para a Áustria, Heidi para a Suíça) e o locale de reconhecimento de fala correspondente para que o agente compreenda e pronuncie nomes, lugares e números como os locais. Pode alterar mais tarde nas definições de voz e língua do agente.

Após o registo bem-sucedido, irá aterrar no Painel principal.

Passo 2: Criar um Agente​

Depois de se inscrever, o seu painel mostra um estado vazio. Pode criar o seu primeiro agente via template ou do zero.

2.1. Abrir a Secção de Agentes​

  1. No menu esquerdo, encontre "Voice Agents"
  2. Clique nele

2.2. Criar um Novo Agente​

  1. Clique no botão "Create Voice Agent"

  2. Aparece um modal com duas opções:

    • Start from Scratch — cria um agente em branco que você configura manualmente
    • Cartões de template — 24 templates de função em duas categorias: Voltados para o Cliente (14 funções, ex.: Sales Agent, Receptionist, Support Agent, Lead Qualifier) e Voltados para o Colaborador (10 funções, ex.: Secretary, Recruiter, Internal Helpdesk, Dispatcher)

  3. Clique em qualquer cartão de template para ver a sua descrição, benefícios, capacidades e seletor de língua (escolha uma língua primeiro, depois uma variante regional e voz correspondente). Cada função está disponível em 20 línguas suportadas.

  4. Escolha como prosseguir:

    • Deploy Agent — cria o agente instantaneamente com os valores padrão do template. Preencha os detalhes do seu negócio mais tarde usando o Setup Wizard.
    • Guided Setup — um assistente passo a passo onde introduz os detalhes do seu negócio antes do agente ser criado.
    • Download as Word document — obtém as perguntas do assistente como um ficheiro .docx na sua língua escolhida. Preencha-o offline (sozinho ou com a sua equipa), depois abra Guided Setup e clique em Upload filled document — o assistente lê as suas respostas e preenche automaticamente os campos correspondentes. Reveja, ajuste e continue.
dica

Um template é apenas um ponto de partida. Todas as definições podem ser alteradas após a criação. Se não souber qual escolher — escolha qualquer um.

2.3. Setup Wizard​

Depois da criação, procure o ícone de varinha brilhante ao lado do nome do seu agente. Isto abre o Setup Wizard, que o ajuda a completar a configuração secção a secção (Agent Configuration, Company Profile, Services, Specialists, Locations, etc.). O progresso é registado como "X/Y secções concluídas". Pode saltar secções que não precisa.

Resultado: Agente criado! Vê a página de definições do agente.

Passo 3: Configuração do Agente​

Após a criação, configure o seu agente através destas definições:

3.1. Prompt​

O prompt define a personalidade, comportamento e instruções do seu agente. Se usou um template, está pré-preenchido — reveja e personalize para o seu negócio.

3.2. Base de Conhecimento​

Carregue ficheiros com informação sobre a sua empresa. O agente irá responder a perguntas baseando-se apenas nesta informação.

Que ficheiro carregar? Qualquer um dos seguintes serve:

  • Lista de preços da sua empresa
  • Descrições de serviços
  • Perguntas frequentes (FAQ)
  • Horário de funcionamento e informação de contacto
  • Qualquer documento de texto com informação da empresa

Formatos de ficheiro suportados: .pdf, .docx, .txt, .md, .html, .csv

Importante

O agente SÓ sabe o que está escrito na base de conhecimento. Se um cliente perguntar algo que não está no ficheiro — o agente não conseguirá responder. Adicione toda a informação importante: serviços, preços, horário de funcionamento, morada, contactos.

3.3. Voz​

Escolha uma voz para o seu agente. Pode pré-visualizar diferentes opções e selecionar uma que corresponda à sua marca.

3.4. Ferramentas​

Configure ferramentas que o agente pode usar durante as chamadas, como o Google Calendar para agendamento de compromissos.

3.5. Ações​

Configure ações pós-chamada como enviar emails, SMS ou acionar webhooks após uma conversa terminar.

3.6. Guardar Definições​

Clique em "Save" ou "Update" para guardar a sua configuração.

Resultado: O agente está configurado e pronto para testar.

Passo 4: Testar o Agente​

Antes de lançar, teste como o agente funciona.

4.1. Testar via Widget Web​

  1. No cartão do agente, encontre o botão "Talk to agent"
  2. Clique nele
  3. Permita acesso ao microfone no seu browser
  4. Comece a falar com o agente

4.2. Testar via Número de Telefone​

Se tem um número de telefone ligado:

  1. Vá a Phone Numbers na barra lateral
  2. Atribua o seu agente a um número
  3. Ligue para o número a partir de qualquer telefone

4.3. O Que Verificar​

  • O agente cumprimenta corretamente?
  • Responde a perguntas sobre serviços e preços?
  • Entende a língua corretamente?
  • Comporta-se educadamente?
dica

Se algo estiver errado — volte às definições e ajuste o prompt ou base de conhecimento.

Resultado: Agente testado e a funcionar corretamente.

Concluído!​

O seu agente de voz IA está pronto. Agora pode:

  1. Adicionar ao site — embeber um widget para os clientes falarem com o agente
  2. Ligar número de telefone — veja Números de Telefone
  3. Explorar funcionalidades avançadas — Agentes de Voz IA, Integrações

Resolução de Problemas​

ProblemaSolução
O agente não responde a perguntasVerifique se a base de conhecimento está ligada e contém a informação
Língua erradaVerifique a definição Language nas definições do agente
O agente fala demasiado rápido/devagarAjuste as definições de Voz
O agente inventa coisasMelhore o prompt — adicione restrições

Dúvidas? Contacte: support@hanc.ai