## Visão geral

O **onboarding por voz** é o assistente do Cérebro Maestro que configura sua conta a partir de uma
conversa. Você descreve seu negócio — falando ou digitando — e o Maestro propõe uma estrutura inicial
(como departamentos e ajustes básicos). Você revisa tudo e, ao confirmar, a estrutura é provisionada.

O fluxo segue sempre três momentos: **briefing** (você conta sobre o negócio), **revisão** (você vê
a proposta) e **aplicação** (você confirma e o Maestro provisiona). Nada é criado sem a sua revisão.

## Pré-requisitos

- Conta com o **Maestro habilitado** e o **Cérebro da Conta** disponível.
- Permissão de **administrador** para aplicar o provisionamento.
- Para o ditado por voz: navegador atualizado com **permissão de microfone**. Se a voz não estiver
  disponível, você ainda pode fazer todo o onboarding por **texto**.

## Passo a passo

1. Abra a área do **Cérebro da Conta** e inicie a **configuração assistida** (onboarding).
2. No **briefing**, descreva o negócio: o que você faz, como atende, quais áreas/departamentos
   existem e quais são seus objetivos. Você pode **ditar por voz** ou digitar.
3. Deixe a conversa fluir: o assistente faz perguntas para entender melhor a operação.
4. Avance para a **revisão**: o Maestro mostra a proposta (por exemplo, departamentos sugeridos e
   configurações iniciais).
5. Ajuste o que quiser e clique em **Aplicar** para provisionar a estrutura na sua conta.
6. Após aplicar, siga conectando canais, alimentando o conhecimento e ativando módulos.

## Configurações & opções

- **Entrada por voz (ditado)**: fale em vez de digitar; útil para descrever o negócio rapidamente.
- **Entrada por texto**: alternativa completa caso a voz não esteja disponível.
- **Revisão antes de aplicar**: a proposta é sempre apresentada para a sua confirmação.
- **Provisionamento não destrutivo**: o Maestro **complementa** o que falta sem sobrescrever o que já
  existe — agentes e configurações feitos à mão são preservados.

### Chamadas por robô na próxima atualização

O ditado usado neste onboarding, as respostas por mensagem de voz (PTT) e o atendimento de uma
ligação são configurações distintas. Na próxima atualização, o editor do robô terá **Chamadas por
robô** na área de voz, com uma escolha de atendimento independente das respostas em áudio:

- **Automático**: mantém a seleção automática quando nenhum modelo de chamada é escolhido.
- **OpenAI Realtime**: escolhe o atendimento de fala em tempo real da OpenAI.
- **Gemini Live (integração em prévia)**: escolhe a integração do Maestro com Google Live; o selo
  descreve esta integração, não a versão do modelo do Google.
- **Pipeline Maestro (STT → agente → TTS)**: usa a transcrição e o agente configurados no robô, com
  a síntese de voz definida na mesma área.
- **Desabilitado**: desliga o atendimento de chamadas por IA neste robô e preserva seus ajustes de PTT.

O **modelo da chamada** é separado do modelo de síntese de voz. Em Automático, escolher um modelo
com provedor também escolhe esse provedor; deixar o campo vazio mantém o padrão. Configurações
antigas são preservadas, incluindo o atendimento legado e modelos salvos sem prefixo. Nos modos Automático,
OpenAI Realtime e Gemini Live, um modelo fora do catálogo continua visível com aviso, sem troca
silenciosa de provedor.

No pipeline, os ajustes de TTS ficam disponíveis mesmo com PTT desligado; editar a voz não ativa
respostas por mensagem de áudio. O botão de **prévia de voz** testa apenas TTS com as chaves do robô
salvo: não inicia uma ligação nem confirma OpenAI Realtime ou Gemini Live. Use as configurações de
chaves já existentes no robô e na conta. A disponibilidade do atendimento depende também do canal
e do provedor; confirme o funcionamento em uma chamada de teste autorizada antes de usá-lo.

### Modelos prontos e geração por nicho

O Studio traz **modelos prontos** de robôs verticais (e-commerce, clínica, imobiliária, restaurante,
educação, jurídico, finanças, beleza, automotivo, logística, viagem, fitness, serviços profissionais e
saúde) já no **idioma da conta**. Se o seu segmento não estiver na lista, descreva o **nicho** e o
Maestro **gera um preset sob medida** no seu idioma — persona, instruções e ferramentas — que você
aplica e ajusta como qualquer outro modelo.

## Casos de uso

- Configurar rapidamente uma conta nova com a estrutura básica de departamentos.
- Padronizar a abertura de novas operações com poucas perguntas guiadas.
- Reaproveitar o assistente para revisar e completar a estrutura de uma conta já em uso.

## Dicas, limites e boas práticas

- Quanto mais clara a descrição do negócio, melhores as sugestões.
- Fale em frases curtas e objetivas no ditado por voz; revise o texto transcrito antes de avançar.
- Revise sempre antes de aplicar — você pode ajustar tudo depois.
- O onboarding é um **ponto de partida**: aprofunde cada módulo nas categorias desta Central.

## Solução de problemas

- **O assistente não abre**: confirme se o Maestro está habilitado e se você tem permissão de
  administrador.
- **A voz/ditado não funciona**: verifique a permissão de microfone no navegador; use a entrada por
  texto como alternativa.
- **A aplicação não provisionou nada**: revise a proposta, verifique mensagens de erro no assistente
  e tente novamente. Se a conta já tem agentes/estrutura, o Maestro só complementa o que falta.

## Veja também

- [O que é o Maestro IA e o Cérebro da Conta](/hc/ajuda/articles/maestro-brain-overview-pt-br)
- [Copiloto generativo: propor, confirmar e executar](/hc/ajuda/articles/maestro-brain-copiloto-generativo-pt-br)
- [Departamentos, análise de risco e insights](/hc/ajuda/articles/maestro-brain-departamentos-risco-insights-pt-br)