> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/pt/zoom-workplace/zoom-phone/expert-insights/zoom-virtual-agent-receptionist-start-guide.md).

# Guia de Início do Recepcionista do Zoom Virtual Agent

Elaborado por: Megan McGaughey e Nate Raper

### **Introdução**

Zoom Virtual Agent Receptionist (ZVA Receptionist) traz tratamento da chamada inteligente para o seu sistema de telefonia empresarial. Usando IA conversacional, o ZVA Receptionist atende chamadas Recebidas, fornece informações de uma Base de Conhecimento configurada, encaminha quem liga para a pessoa ou departamento certo e agenda compromissos sem exigir intervenção humana. Antes conhecido como AI Concierge ou ZVA Concierge, o ZVA Receptionist é configurado e gerenciado por meio do AI Studio no Portal web do Zoom.

Este guia aborda o processo completo de configuração e quatro casos de uso principais: criar uma Base de Conhecimento, configurar o roteamento de chamadas para destinos do Zoom Phone, ativar o Roteamento por nome e adicionar agendando de compromissos com o Zoom Scheduler. Ele também aborda o ajuste fino do agente de voz, a publicação e os testes e a otimização contínuos.

### **O que você precisa saber antes de começar**

#### <mark style="color:azul;">**Pré-requisitos**</mark>

Confirme o seguinte antes de iniciar a configuração:

**Função:** Proprietário da conta ou administrador **Licenças:**

* Zoom Phone ou central de contato Zoom
* licença do Zoom Virtual Agent (ZVA)
* licença do Zoom Scheduler (necessária apenas para o caso de uso de agendando de compromissos)

**Acessar:** Portal web do Zoom com o AI Studio habilitado

**Opcional:** Zoom Canvas ou um site acessível para o conteúdo da base de conhecimento

#### <mark style="color:azul;">**Conceitos-chave do ZVA Receptionist**</mark>

**Base de conhecimento:** O repositório de informações que o agente utiliza para responder às perguntas de quem liga. O conteúdo é adicionado por meio do carregamento de arquivos ou da vinculação de URLs. **Habilidades:** Recursos individuais adicionados ao agente, além das respostas a perguntas sobre a base de conhecimento. As habilidades definem ações de Roteamento, o comportamento da discagem por nome e como o agente deve atuar ao lidar com pessoas agendando compromissos. **Orientações do agente:** A seção de Configurações onde você define a personalidade, o tom, os objetivos e os limites do agente. Esta é a seção mais importante para personalizar o agente de acordo com sua empresa. **AI Studio:** A interface do portal Zoom onde o Recepcionista do ZVA é criado, configurado e publicado. **Recepcionista automático:** O componente do Zoom Phone que conecta um número de telefone para chamadas Recebidas ao Recepcionista do ZVA publicado.

#### <mark style="color:azul;">**Recursos adicionais**</mark>

* **Etapas de configuração:** [Configurar o Recepcionista do Zoom Virtual Agent](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0084960)
* **Análises:** [Visualizar as análises do Virtual Agent](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0080984)

### **Configurando o seu ZVA Receptionist**

Em um nível geral, configurar o ZVA Receptionist envolve cinco etapas:

1. **Criar uma base de conhecimento:** Carregue documentos ou vincule um site.
2. **Criar o Virtual Agent:** Escolha uma forma de configuração e defina a saudação, a voz e as orientações do agente.
3. **Adicionar habilidades:** Defina o que o agente pode fazer além de responder a perguntas (Roteamento, discagem por nome e auxílio a pessoas agendando compromissos).
4. **Configurar as Configurações do agente de voz:** Ajuste a temperatura, as palavras de preenchimento e outros controles de comportamento.
5. **Publicar e Atribuir:** Conecte o agente a um número do Zoom Phone por meio do recepcionista automático.

{% stepper %}
{% step %}
**Criar uma Base de conhecimento**

Sua Base de conhecimento é a base do ZVA Receptionist. Ela fornece as informações que o agente usa para responder às perguntas dos chamadores. Duas decisões importantes moldam a estratégia da sua Base de conhecimento.

<mark style="color:azul;">**Precisão versus atualização: arquivos ou URLs**</mark>

* **Escolha arquivos quando precisar de precisão:** Vincule o Zoom Canvas ou carregue PDFs, documentos do Word, planilhas ou outros formatos de arquivo compatíveis quando quiser ter controle total sobre o que o agente sabe. Os arquivos são mais adequados para políticas, tabelas de preços ou procedimentos que mudam com pouca frequência. O agente consulta apenas o que você fornece explicitamente.
* **Escolha URLs quando precisar de informações atualizadas:** Vincule seu site, Central de ajuda ou base de conhecimento quando o conteúdo for atualizado regularmente. O agente obtém automaticamente as informações mais recentes, para que você não precise carregar arquivos novamente a cada alteração. As URLs são mais adequadas para catálogos de produtos, perguntas frequentes ou serviços oferecidos.

<mark style="color:azul;">**Amplitude versus profundidade: cobertura abrangente ou conhecimento especializado focado**</mark>

Recomendamos que não tente carregar toda a wiki da sua empresa na implementação inicial. Comece com 3 a 5 documentos que respondam às suas perguntas mais comuns (por exemplo: horário comercial, políticas de devolução, informações de localização). Após a sua primeira semana de chamadas, reveja as transcrições das conversas para identificar lacunas e, depois, adicionar conteúdo com base nos padrões reais de chamadas.

{% hint style="info" %}
**Nota**

O ZVA pode suportar muitos documentos (100+), documentos longos e sites web com milhares de páginas de detalhes. A recomendação acima destina-se a ajudar a manter o seu Agente virtual focado nos casos de chamada mais comuns e a expandir conforme necessário.==
{% endhint %}

![Gestão da Biblioteca de Conhecimento no portal de administração da Zoom](https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/9ZVJOU0DkABBVWBvbpYU/TPNSA3iyT%20Cl_x3bIgstdA)

![Opções Disponível para importar conteúdo para uma Base de conhecimento](https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/CjZ5r7ePkEaKHyW7B2Fw/m_wTH2xyRWWjzoK0t1EdXQ)

![Importar um ficheiro](https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/OwCenk7h2W5T2q5cdF5o/yPlN%20P%20gQWGkqSMQ448ObA)

![Ligar a um website](https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/5osIqTIBYmQOuK0zpI7c/eDNajkYaSzKXwMzBAY_1nQ)
{% endstep %}

{% step %}
**Construa o seu Agente virtual**

Quando a sua Base de conhecimento estiver pronta, crie o agente virtual que irá interagir com quem liga. Dois caminhos de configuração estão Disponível: o Assistente de recepcionista ZVA para casos de uso diretos e Modelos baseados em instruções para configurações mais complexas ou específicas de um setor.

<mark style="color:azul;">**Assistente de recepcionista ZVA**</mark>

O assistente guia-o pela configuração inicial completa num único fluxo de trabalho, incluindo:

* Cumprimento e escolha da voz
* Biblioteca de Conhecimento (uma ou mais fontes)
* Roteamento para Zoom Phone
* Transferência por nome (marcação por nome)
* Agendamento usando Zoom Scheduler
* Criar um novo recepcionista automático ou Conectando-se a um existente

O assistente é o ponto de partida recomendado. O agente resultante pode ser editado e depois personalizado após a conclusão do assistente.

![Assistente de configuração e lista de verificação do recepcionista ZVA](https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/Nmcuz5ITp8niLwtL6aKb/w3nDvphDR7CfpJXUj89p4A)

<mark style="color:azul;">**Modelos baseados em instruções**</mark>

Estes modelos foram concebidos para casos de uso corporativos e setoriais específicos, com integrações de ferramentas básicas e avançadas. Ao usar um Modelo baseado em instruções, é melhor usar os que têm "Zoom Phone" no nome e concentrar-se nas seguintes decisões estratégicas.

{% hint style="info" %}
**Nota**

Depois de criar o Agente virtual usando o Modelo, terá de o ligar manualmente a um recepcionista automático ou defini-lo como overflow a partir de uma fila de chamadas, grupo de linha compartilhada, usuário, etc.
{% endhint %}

**Seleção do modelo e da voz:** Escolha um modelo adequado às expectativas de quem liga. Clientes do varejo geralmente esperam interações rápidas e cordiais; pessoas que ligam para serviços de Saúde podem precisar de respostas mais detalhadas e tranquilizadoras. Selecione uma voz que reflita a personalidade da sua marca: acolhedora e informal para atendimento ao cliente, profissional e eficiente para ambientes B2B.

**Elaboração da saudação:** Mantenha a saudação breve (menos de 10 segundos) e orientada à ação. Diga quem você é e convide imediatamente a pessoa a falar. Evite menus longos ou jargões corporativos. Exemplo: "Obrigado por ligar para a Omzo Hardware. Como posso ajudar você hoje?"

**Orientações do agente:** Esta seção define a personalidade, o tom, os objetivos e os limites do agente. Descreva o contexto da sua empresa, defina o tom e especifique quando encaminhar o atendimento a uma pessoa (por exemplo, em caso de problemas complexos, pessoas frustradas ou solicitações fora do escopo da base de conhecimento). Os modelos oferecem boas sugestões iniciais para cada componente; planeje dedicar bastante tempo à personalização desta seção para suas necessidades específicas.

A secção de Orientação do Agente inclui os seguintes componentes:

* **Personalidade:** Define como o agente virtual trata quem liga. O agente é profissional ou informal? Comunicativo ou direto?
* **Ambiente:** Descreve por que os clientes ligam e o que o agente deve fazer para ajudar. As expectativas de quem liga para uma loja são diferentes das de quem liga para um consultório médico.
* **Tom:** Complementa a personalidade para descrever o caráter do agente. O agente deve evitar jargões técnicos e fornecer respostas curtas ou usar terminologia precisa para um público técnico?
* **Objetivo:** Descreve o que o agente deve realizar em cada ligação. O agente deve consultar todas as fontes disponíveis da base de conhecimento e usar todas as habilidades disponíveis antes de encaminhar o atendimento ou encaminhá-lo após uma ou duas tentativas?
* **Limites:** Define o que o agente deve e não deve fazer. Por exemplo: exigir a verificação de quem liga antes de consultar encomendas ou marcações.

![Modelos de Agente de Voz Disponível no AI Studio](https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/4uFfsLgQpK1dTTbS2rBD/hGvblalVScuKSHb8vSYv1Q)
{% endstep %}

{% step %}
**Adicionar competências**

As competências definem o que o seu recepcionista ZVA pode fazer além de responder a perguntas da Base de conhecimento. Os três casos de uso mais comuns são descritos abaixo.

<mark style="color:azul;">**Caso de uso 1: Encaminhar para Zoom Phone**</mark>

**Objetivo:** Encaminhar quem liga para o destino certo no Zoom Phone.

Ao configurar o roteamento de chamadas, concentre-se em três decisões principais:

1. **Tipo de destino:** Escolha com base nas necessidades de quem liga e na estrutura da equipa. Encaminhe para uma fila de chamadas quando vários agentes puderem tratar do pedido (suporte geral, questões de vendas). Encaminhe para um usuário quando se tratar de pedidos especializados que exijam uma pessoa específica. Use o recepcionista automático para encaminhamento em vários níveis ou atendimento fora do horário comercial e o grupo de linhas compartilhadas quando precisar de chamadas simultâneas para toda a equipa.
2. **Clareza dos acionadores:** Defina condições precisas que ativem cada competência de encaminhamento. Seja específico quanto à intenção de quem liga: «quer falar com o departamento de faturamento» é mais claro do que «tem uma pergunta». A precisão ajuda o agente a distinguir pedidos semelhantes e a encaminhá-los corretamente.
3. **Cobertura do encaminhamento:** Planeie vários cenários: horário comercial, fora do horário comercial, necessidades específicas de cada departamento e vias de escalonamento. Considere criar competências de encaminhamento separadas para períodos de pico e períodos fora do horário comercial, para que quem liga chegue ao recurso certo.

{% hint style="info" %}
**Nota**

Comece com 2 a 3 caminhos principais de Roteamento com base nos seus tipos de chamadas mais comuns e, depois, expanda à medida que aprende com os padrões de chamadas.
{% endhint %}

![Habilidade adicionada dentro da janela de configuração do Virtual Agent.](https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/P3ltjIpv0YEBKIV0OaiA/ri_Z%20wgFT5645j9LuGCLbg)

![Habilidade criada com o Nome e a descrição da chave de gatilho. As Instruções contêm a Ferramenta usada para ligar a chamada ao Zoom Phone](https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/HcEkFEA80ps0DpF5lxrG/P0BQm4FjT56y0jV8wq6sJA)

![Visualização da Ferramenta em que a fila de chamadas foi escolhida primeiro e, depois, Selecionar a fila de chamadas de Vendas como o destino final de Roteamento.](https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/w1MytWvKz6vxDwt3zZAv/rlK_qyaXRp2UOyted59QbA)

<mark style="color:azul;">**Use Case 2: Diretório de discagem por nome**</mark>

**Objetivo:** Permitir que quem liga diga ou soletre um nome para contactar um usuário ou departamento específico do Zoom Phone.

Ao configurar o Roteamento do Diretório de discagem por nome, concentre-se em três decisões principais:

1. **Âmbito do diretório:** Inclua apenas funções que lidam com clientes: representantes de vendas, gestores de contas, especialistas de suporte e chefes de departamento que interagem regularmente com pessoas externas. Exclua cargos exclusivamente internos (equipa de TI, pessoal de RH, operações de retaguarda) para impedir encaminhamentos incorretos e proteger os fluxos de trabalho internos.
2. **Flexibilidade da pesquisa:** Decida se quem liga pode pesquisar pelo nome próprio, apelido ou ambos. Os clientes atuais podem saber o nome completo; os novos potenciais clientes podem lembrar-se apenas do nome próprio. Equilibre a acessibilidade com o tamanho do diretório para evitar confusão.
3. **Casos de utilização adequados:** A marcação por nome funciona melhor quando quem liga já tem uma relação com alguém da sua organização: clientes que ligam novamente para falar com o seu gestor de conta, clientes que fazem o acompanhamento com um consultor ou potenciais clientes que retomam o contacto com um vendedor. É menos eficaz para quem liga pela primeira vez e não conhece ninguém pelo nome.

{% hint style="info" %}
**Nota**

Comece com um diretório focado de 10 a 15 membros-chave da equipe que têm contato direto com os clientes. Expanda gradualmente com base nos padrões de ligar e no Feedback/feedback.
{% endhint %}

![Habilidade adicionada dentro da janela de configuração do Virtual Agent.](https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/FF89Upvvayc1Fn0lwqMX/SKC%20Awi7TPq1fx5fqWFBaw)

![Skill criada com o Nome e a descrição da chave Trigger. As Instruções contêm a Ferramenta usada para acionar o Zoom Phone de discagem por nome](https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/iaOUsgKktAGrTXOsmX28/6Qmsvz2jS%20iP2dPVj8Ea4g)

![Opções Disponível para Adicionar na ferramenta Dial-by-Name](https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/9eiWjbij0djDQOCxxpYp/0WpufyDKTt6yUH1BBp%20uxw)

![Vista da Ferramenta onde o usuário foi selecionado e foram marcados apenas 3 usuários específicos, deixando 9 não selecionados.](https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/k0BFxtHGE0fkdsaWBR4Z/KZw5EKWRSbqm3uah0jEu%20w)

<mark style="color:azul;">**Caso de uso 3: agendando compromissos com Zoom Scheduler**</mark>

**Objetivo:** Permitir que quem liga marque compromissos diretamente através do Zoom Scheduler.

Ao configurar agendando de compromissos, foque em três decisões principais:

1. **Candidatos à automatização:** Identifique os tipos de compromisso que mais consomem o tempo da equipa quando são agendados manualmente. Entre os melhores candidatos estão consultas de rotina (demonstrações de vendas, chamadas de integração), marcações de serviços (visitas de manutenção, sessões de suporte) e reservas recorrentes (reuniões semanais, reuniões de acompanhamento). Automatize-os primeiro para libertar a equipa para interações complexas que exigem discernimento humano.
2. **Estratégia para as ligações do Scheduler:** Escolha entre ligações compartilhadas pela equipa e ligações individuais com base na prestação do serviço. Use ligações do Scheduler com qualquer anfitrião quando qualquer membro qualificado da equipa puder tratar do compromisso (consultas iniciais, demonstrações de produtos, suporte geral). Use ligações individuais quando a continuidade for importante: relações existentes com clientes, necessidade de conhecimentos especializados ou compromissos de acompanhamento com o mesmo representante.
3. **Clareza dos acionadores:** Defina condições precisas que ativem o agendamento. Seja específico quanto à intenção de quem liga e ao tipo de compromisso: «quer marcar uma demonstração de produto» ou «precisa de marcar um serviço», em vez de expressões genéricas como «quer agendar alguma coisa». Isto ajuda o agente a distinguir os tipos de compromisso e a encaminhar para a ligação correta do Zoom Scheduler.

{% hint style="info" %}
**Nota**

Comece por automatizar os seus tipos de compromisso com maior volume e menor complexidade (consultas iniciais, visitas de serviço padrão). Expanda para compromissos especializados assim que o fluxo de trabalho for validado.
{% endhint %}

![Habilidade adicionada dentro da janela de configuração do Virtual Agent.](https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/Hq2kBWXlwHyg7WxbnBXK/WjG8erMuQaCbyCaI49FfeA)

![Competência criada com a descrição de Nome e chave do acionador. Esta competência permite o agendando para 2 links diferentes do Zoom Scheduler para grupos diferentes.](https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/4Y5U1ySeq50A90tkgKXv/FDq10HqOQUCWIlRUDZlrkg)

![Página do Zoom Scheduler com 2 páginas de reserva diferentes](https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/U0GnmXngw5NNbyPN76ej/qlxx3bmHQWCec%20%20cVtX7aw)

![Detalhes da página de reserva com o link necessário para o Rececionista ZVA](https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/mJKKNOYVYedswCJryklH/1wNEfVc%20TtqbmDMbAX1tTg)

![Vista da ferramenta onde foi adicionado um dos 2 links do Zoom Scheduler.](https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/uQ9R54jNYtBGcDOE3ow1/9MXVsjlsQY%20I1qHQ_pT7uQ)
{% endstep %}

{% step %}
**Configurar Configurações do Agente de Voz**

Além da configuração principal, o ZVA Receptionist inclui Configurações avançadas que controlam como seu agente virtual soa e se comporta durante as chamadas. Pense nisso como ajustes de personalidade: ao ajustá-los, você altera como o agente fala, responde e lida com incertezas. As duas Configurações mais comumente configuradas são descritas abaixo.

<mark style="color:azul;">**Controle de Temperatura**</mark>

**O que faz:** Controla o grau de criatividade ou previsibilidade das respostas do agente.

* **Temperatura mais baixa (0,0 a 0,5):** Respostas mais previsíveis e consistentes. O agente mantém-se estreitamente alinhado com o conteúdo da Base de Conhecimento e usa formulações semelhantes em cada interação.
* **Temperatura mais alta (0,6 a 1,0):** Respostas mais variadas e naturais. O agente parafraseia e adapta a linguagem com maior liberdade.

**Quando ajustar:**

* **Use uma temperatura mais baixa** em setores sujeitos a requisitos de conformidade (saúde, finanças, área jurídica), onde a consistência e a precisão são essenciais.
* **Use uma temperatura mais alta** em situações de atendimento ao cliente, onde a variedade na conversa ajuda a tornar as interações mais naturais.
* **A definição padrão (0,5)** funciona bem para a maioria das empresas, equilibrando a precisão com uma conversa natural.

{% hint style="info" %}
**Nota**

Exemplo: um consultório médico pode usar 0,3 para que as políticas de agendamento sejam declaradas exatamente como escritas. Uma loja de varejo pode usar 0,7 para fazer com que as recomendações de produtos soem mais conversacionais, em Áudio.
{% endhint %}

<mark style="color:azul;">**Palavras e frases de preenchimento**</mark>

**O que faz:** Acrescenta padrões naturais da fala, como «hum», «deixe-me ver» ou «só um momento», enquanto o agente processa informações.

**Por que é importante:** Estas pequenas pausas fazem com que o agente soe mais humano e dão a quem liga um momento para processar o que ouviu. Sem elas, respostas rápidas e sucessivas podem parecer robóticas ou difíceis de acompanhar.

**Quando habilitar ou desabilitar:**

* **Habilite** para funções que lidam com clientes, nas quais é importante manter um tom cordial e conversacional: vendas, suporte e consultas gerais.
* **Desabilite** em cenários que priorizam a eficiência, nos quais quem liga valoriza a rapidez mais do que a cordialidade, como consultas sobre o estado de encomendas ou pesquisas de contas.
* **Teste ambas as opções:** Ligue para o seu agente com esta definição ativada e desativada para ouvir a diferença. Algumas empresas consideram que as palavras de preenchimento tornam o agente mais acessível; outras preferem uma comunicação direta, sem elas.

![](https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/Hs004jm9J4f2NBFkA8m0/qfyp3ZxOSu67yBAT8ZyCRQ)

![](https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/ZhWvODWyN8RV9cv1laem/U58Uvp8oTda_8N38S_mcHA)
{% endstep %}

{% step %}
**Publicar e Atribuir a um Número de Telefone**

Depois que o seu recepcionista automático ZVA estiver configurado, publique-o e conecte-o ao seu sistema de telefonia Zoom Phone. A publicação é uma passagem em duas etapas: ative o agente no AI Studio e, em seguida, conecte-o a um número de telefone por meio de um recepcionista automático do Zoom Phone.

**Publicando o Agente**

1. No AI Studio, navegue até a configuração do seu recepcionista automático ZVA.
2. Revise a sua configuração e clique em Publicar.

{% hint style="info" %}
**Nota**

As alterações feitas no AI Studio não entram em vigor até você clicar em Publicar. Se o seu agente não responder como esperado após fazer edições, verifique se a versão mais recente foi publicada.
{% endhint %}

**Atribuir a um Número de Zoom Phone**

1. No Portal web do Zoom, abra [Centro de administração](https://zoom.com/account) → Configuração do produto → Sistema de telefonia.
2. Selecione o recepcionista automático que você deseja conectar ao agente.

![](https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/3uIJszbJJElCsdvDYD8O/ZgkDzKoeSBmAI0NrhcfF2A)

3. Nas Configurações do recepcionista automático, selecione sua unidade e o Agente virtual correto.

![](https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/Sg22AHa1BmjQGEkdbVOj/2LUrWH5QQsihTsj2o3TNOQ)

4. Confirme se há um número de telefone atribuído ao recepcionista automático. O agente virtual não receberá chamadas até que um número de telefone seja explicitamente atribuído.
   {% endstep %}
   {% endstepper %}

### **Testes e Otimização**

#### <mark style="color:azul;">**Testando o Seu Agente Virtual**</mark>

Teste exaustivamente o seu recepcionista automático ZVA após a publicação para confirmar que ele lida com as chamadas como esperado antes que os clientes o encontrem. Use a seguinte abordagem:

1. **Ligue para o número atribuído:** Utilize o número de telefone associado à sua rececionista automática e interaja com o agente como faria um verdadeiro interlocutor.
2. **Teste cada caso de utilização:** Verifique se todas as competências configuradas funcionam corretamente: faça perguntas com base na sua base de conhecimento, solicite o encaminhamento para diferentes departamentos ou utilizadores, experimente a marcação por nome com vários formatos de nomes e tente agendar um compromisso.
3. **Teste os casos-limite:** Experimente cenários que possam confundir o agente: perguntas não abrangidas pela sua base de conhecimento, pedidos de encaminhamento para utilizadores ou departamentos indisponíveis, linguagem pouco clara ou ambígua e interrupções ao agente enquanto responde.
4. **Analise os detalhes da conversa:** Após cada chamada de teste, analise a interação no AI Studio para perceber o desempenho do agente.

#### <mark style="color:azul;">**Analisando Detalhes da Conversa**</mark>

O AI Studio fornece insights detalhados sobre cada chamada tratada pelo seu agente virtual. Acesse os detalhes da conversa navegando até o AI Studio, selecionando o seu ZVA Receptionist e abrindo a aba de Transcrições. Selecione qualquer chamada para analisar. Ao revisar uma conversa, foque em três áreas principais:

* **O que o interlocutor pretendia:** Reconhecimento da intenção e pontuações de confiança
* **Como o agente respondeu:** Transcrição e consultas à base de conhecimento
* **Para onde foi encaminhada a chamada:** Ações e resultados do encaminhamento

Use os detalhes da conversa para identificar padrões e oportunidades de melhoria:

* **Identifique lacunas de conhecimento:** Procure perguntas a que o agente não conseguiu responder. Se vários interlocutores perguntarem «Disponibilizam financiamento?» e o agente disser que não tem essa informação, adicione uma pergunta frequente sobre financiamento à sua base de conhecimento.
* **Melhore o reconhecimento de intenções:** Se os interlocutores disserem «Preciso de ajuda com a minha fatura», mas o agente encaminhar a chamada para o suporte geral em vez de Faturamento, atualize o acionador da competência de encaminhamento para incluir expressões como «fatura», «recibo» e «pagamento».
* **Melhore a qualidade das respostas:** Se os interlocutores perguntarem frequentemente «O que significa isso?» depois de o agente responder, a resposta poderá ser demasiado técnica. Simplifique o conteúdo da base de conhecimento ou adicione exemplos.
* **Acompanhe os padrões de escalonamento:** Se vários interlocutores escalarem a chamada ao perguntar sobre um tema específico, adicione à sua base de conhecimento uma secção dedicada com informações claras sobre esse tema.

{% hint style="info" %}
**Nota**

Revise pelo menos 10 a 20 conversas da sua primeira semana de implantação. Esse tamanho de amostra ajuda você a identificar problemas comuns em vez de casos extremos isolados.
{% endhint %}

![Detalhes da conversa e análises](https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/H0Bb423pQAcsRbhib1ti/O8xsj7Q6TG2qxb%20H6T5AIA)

![Transcrição e análises do Agente de uma chamada](https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/OoURVfRGOPQm7jybTmMR/Q%203pw3qtRKuNH%20mUU6hisg)

#### <mark style="color:azul;">**Melhores práticas de otimização contínua**</mark>

Testar não é uma atividade única. Refine continuamente seu agente virtual com base no desempenho no mundo real:

* Mantenha as saudações curtas e amigáveis: menos de 10 segundos é o ideal.
* Revise semanalmente as transcrições de ligar no AI Studio para identificar problemas recorrentes.
* Atualize regularmente os documentos da Base de Conhecimento à medida que seu negócio muda.
* Refine a orientação do agente com base em mal-entendidos comuns ou padrões de escalonamento.
* Use análises para acompanhar as taxas de desvio de ligar, o tempo médio de atendimento e a satisfação do cliente.
* Teste após cada alteração importante (Alterar): novas habilidades, conteúdo atualizado da Base de Conhecimento ou lógica de Roteamento modificada.

#### <mark style="color:azul;">**Métricas principais a monitorar**</mark>

| Métrica                                | Descrição                                                                          |
| -------------------------------------- | ---------------------------------------------------------------------------------- |
| Taxa de contenção                      | Porcentagem de ligações resolvidas sem transferência para um humano                |
| Duração média de ligar                 | Tempo que os chamadores interagem com o agente                                     |
| Precisão no reconhecimento de intenção | Com que frequência o agente identifica corretamente as solicitações dos chamadores |
| Taxa de acerto da Base de Conhecimento | Porcentagem de perguntas respondidas a partir da Base de Conhecimento              |
| Taxa de escalonamento                  | Com que frequência os chamadores solicitam ou precisam de assistência humana       |

Para obter mais informações, consulte [Ver as análises do agente virtual](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0080984).

### **Solução de problemas e Perguntas frequentes**

#### <mark style="color:azul;">**Meu agente virtual não está atendendo chamadas**</mark>

Confirme se o agente foi publicado no AI Studio e se aparece como Ativo. Verifique se foi atribuído explicitamente um número de telefone à rececionista automática associada ao agente. Se estiverem configuradas restrições de horário comercial, confirme se está a fazer o teste durante esse horário. No [centro de administração](https://zoom.com/account), aceda a Configuração do produto → Sistema de telefonia → [Registos](https://zoom.com/pbx/page/telephone/callLog#/call-log-new) para rastrear o percurso completo da chamada e confirmar se esta chegou à rececionista automática.

#### <mark style="color:azul;">**Publiquei as alterações, mas o agente ainda não está respondendo como esperado**</mark>

As alterações no AI Studio não entram em vigor até você clicar em Publicar. Abra o agente no AI Studio e confirme que a versão atual reflete suas edições; em seguida, publique novamente. Depois de publicar, aguarde alguns minutos antes de testar.

#### <mark style="color:azul;">**Os chamadores denunciam que as ligações estão sendo roteadas para o destino errado**</mark>

Abra a configuração do agente no AI Studio e revise os gatilhos da skill de Roteamento. Verifique se a linguagem do gatilho é específica o suficiente para distinguir entre diferentes caminhos de Roteamento. Verifique as Configurações do recepcionista automático para confirmar se a unidade e o agente virtual corretos estão selecionados. Revise as transcrições recentes de ligar no AI Studio para determinar se o problema de Roteamento é uma incompatibilidade de gatilho ou um problema de configuração.

#### <mark style="color:azul;">**Meu agente fornece respostas generalizadas em vez de usar minha Base de Conhecimento**</mark>

Adicione uma restrição na seção de orientação do agente. Por exemplo: "Não forneça recomendações generalizadas às solicitações dos clientes. Forneça apenas detalhes explicitamente contidos na Base de Conhecimento." Depois de adicionar a restrição, publique o agente atualizado e teste novamente.

#### <mark style="color:azul;">**Os chamadores não conseguem encontrar alguém usando Dial-by-Name**</mark>

Confirme que o usuário de destino está incluído na configuração da skill Dial-by-Name. Verifique se as Configurações de flexibilidade de pesquisa correspondem ao formato de nome que seus chamadores provavelmente usarão (apenas o primeiro nome, apenas o sobrenome ou o nome completo). Teste a skill ligando para o número e tentando alcançar um usuário pelo nome usando formatos diferentes.

#### <mark style="color:azul;">**O agente virtual não está agendando compromissos corretamente**</mark>

Verifique se os links do Zoom Scheduler configurados na skill de Agendar estão corretos e ativos. Confirme se a linguagem do gatilho da skill é específica o suficiente para corresponder à forma como o chamador se expressa. Teste ligando para o número e tentando agendar cada tipo de compromisso. Revise as transcrições da conversa para ver se o agente está reconhecendo a intenção de agendar, mas não consegue concluir a reserva, ou se o reconhecimento de intenção não está acionando a skill.

#### <mark style="color:azul;">**O agente não consegue responder a perguntas que estão na minha Base de Conhecimento**</mark>

Revise a fonte da Base de Conhecimento no AI Studio para confirmar que o conteúdo está atualizado. Se você usou uploads de arquivos, verifique se o arquivo foi processado com êxito e se o conteúdo relevante está incluído. Se você usou uma URL, confirme se a URL ainda está acessível e se o conteúdo da página não mudou significativamente. Considere fazer upload de um documento de Perguntas frequentes direcionado que responda diretamente às perguntas mais comuns.

#### <mark style="color:azul;">**Os chamadores frequentemente dizem que não entendem as respostas do agente**</mark>

Revise as transcrições da conversa para identificar quais respostas estão causando confusão. Simplifique o conteúdo da Base de Conhecimento para esses tópicos: use frases mais curtas, linguagem simples e exemplos concretos. Se o agente estiver lendo de documentação complexa, considere criar um documento separado de Perguntas frequentes com linguagem amigável para o chamador e adicioná-lo como fonte da Base de Conhecimento.

#### <mark style="color:azul;">**Muitos chamadores estão escalando em um tópico específico**</mark>

Adicione uma seção dedicada à sua Base de Conhecimento cobrindo esse tópico em detalhe. Se o escalonamento estiver acontecendo porque o agente não consegue concluir a tarefa (e não apenas porque o chamador prefere falar com uma pessoa), reveja se uma skill precisa ser adicionada ou reconfigurada. Atualize a orientação do agente para esclarecer quando o escalonamento é apropriado para esse cenário.

#### <mark style="color:azul;">**O reconhecimento de intenção do agente não está correspondendo ao que os chamadores dizem**</mark>

Atualize as descrições dos gatilhos da skill de Roteamento ou da skill de Agendar para incluir as frases, sinônimos e variações específicos que seus chamadores realmente usam. Revise as transcrições da conversa para identificar a linguagem exata que os chamadores estão usando e incorpore essas frases nas descrições dos gatilhos. Se os chamadores usarem consistentemente linguagem informal, ajuste o gatilho de acordo.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://library.zoom.com/technical-library/pt/zoom-workplace/zoom-phone/expert-insights/zoom-virtual-agent-receptionist-start-guide.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
