# VoxOne

### Introdução

O Skyone VoxOne é um *add-on de* comunicação por voz integrado ao Skyone Studio, que permite que agentes de IA interajam por telefone com clientes e usuários em tempo real.\
Com ele, é possível realizar atendimentos automatizados de forma segura, rastreável e com qualidade de áudio profissional.

#### Para que é feito

O VoxOne foi desenvolvido para dar voz aos agentes de IA criados no Skyone Studio, permitindo:

* **Conectar agentes diretamente a chamadas telefônicas;**
* **Automatizar fluxos de atendimento, cobrança, agendamento e suporte, com ramificações e fluxos avançados do agente (Advanced Agent Branching and Flows);**
* **Monitorar transcrições e métricas no painel do Studio, com armazenamento completo do histórico de conversas e gravações de áudio (Conversation History);**
* **Ampliar a eficiência operacional e reduzir custos com atendimentos humanos.**

#### Incluso no pacote:

📞 1.000 minutos mensais de ligações (ativas ou receptivas);

☎️ Número de telefone dedicado para o seu agente ou operação;

⚙️ Implantação assistida pela equipe Skyone para configuração e integração com seu fluxo de automação no Studio.

## Como navegar

### Vídeo

Para facilitar o aprendizado, disponibilizamos um vídeo explicativo que demonstra, na prática, como configurar o VoxOne no Skyone Studio.

O vídeo apresenta todo o processo,  ajudando você a compreender visualmente cada etapa e a aplicar o conhecimento de forma rápida e intuitiva.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FVTtKaZC8e28qz1JdhPsq%2FVoxOne.mp4?alt=media&token=20463b9b-855f-45b0-85b6-a845952dc4bf>" %}

### Passo a passo:

Para acessar e configurar o VoxOne:

1. Acesse o Skyone Studio.
2. No menu lateral, clique em **VoxOne**.\
   Dentro dessa tela estarão listados todos os agentes criados para interações por voz.
3. Para criar um novo agente, clique em **“+ Novo agente”**.

<figure><img src="/files/PjyGrFFJiSIIV0H4NXek" alt=""><figcaption></figcaption></figure>

4. Defina o nome do agente.&#x20;

Escolha um nome que identifique facilmente sua função.\
Exemplo: “**Atendente Financeiro”**.

<figure><img src="/files/elKBVd3RCYXrPoE70zAM" alt=""><figcaption></figcaption></figure>

5. Configure o prompt do agente.

Descreva a função do agente em texto.\
Exemplo: “**Sua função é responder perguntas sobre matemática**.”

<figure><img src="/files/OXJRUcFZPM7OgwNin4rC" alt=""><figcaption></figcaption></figure>

<br>

6. Escolha um modelo.&#x20;

<figure><img src="/files/j6uecXAgAXNdKd3INBlF" alt=""><figcaption></figcaption></figure>

7. Selecione uma das vozes disponíveis. Cada voz possui o idioma indicado ao lado do nome.

<figure><img src="/files/tzJkxUojCZg6xMdniqQL" alt=""><figcaption></figcaption></figure>

8. Defina o idioma principal: Escolha o idioma que o agente usará nas interações.

<figure><img src="/files/BvopWIhWkdeBiM7MhKmZ" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
O **VoxOne oferece suporte para 26 idiomas falados**, incluindo **árabe, chinês, espanhol, francês, japonês, português**, entre outros, reforçando o caráter global e multilíngue da ferramenta.
{% endhint %}

9. Configure a mensagem de tempo limite atingido

Essa mensagem é exibida quando o tempo máximo da chamada é alcançado.\
Exemplo: “**Infelizmente, terei que encerrar a ligação**.”

10. Escolha o tempo máximo da ligação

* Opções: 5, 10, 15, 20, 30 minutos ou 1 hora.

11. Defina a temperatura da IA

* Ajuste o nível de criatividade das respostas conforme o tipo de atendimento.

<figure><img src="/files/DzUKT3kYJEiy8p0vE0vl" alt=""><figcaption></figcaption></figure>

***

#### Gerencie as mensagens de inatividade

1. Escreva mensagens para quando o cliente ficar inativo.\
   Exemplo: “Você ainda está aí?”<br>
2. Defina o tempo de inatividade: 15s, 30s, 1m, 2m, 3m, 4m, 5m ou 10m.

{% hint style="info" %}
É possível adicionar mais de uma mensagem de inatividade.
{% endhint %}

3. Escolha o comportamento de encerramento

**Opções:**

* **Não especificado**
* **Desligar suavemente**
* **Desligar imediatamente**

<figure><img src="/files/16a7Kj1Yylmuom629i8x" alt=""><figcaption></figcaption></figure>

***

#### Gerencie a transferência de chamadas

O agente VoxOne pode realizar a transferência da ligação, conforme instruções definidas.

**Gerenciamento de Transferência**

Ao habilitar a funcionalidade de Transferência de Chamadas, passa a existir um campo específico para inserir instruções sobre como a transferência deve ocorrer.

Essa funcionalidade permite:

* Transferir a ligação para outro agente VoxOne;
* Transferir a ligação para um número de telefone externo previamente cadastrado.

{% hint style="warning" %}
&#x20;ramais ainda não são suportados nesta versão.
{% endhint %}

#### Atalhos para Transferência

Para facilitar o uso durante o atendimento, foram criados dois atalhos no VoxOne:

{% tabs %}
{% tab title="@ " %}
**Transferência para agentes**

* Lista todos os agentes VoxOne disponíveis;
* Usado quando o objetivo é transferir a ligação para outro agente;
* Exemplo de uso: transferência para um agente responsável por abrir ou continuar um ticket.
  {% endtab %}

{% tab title="/" %}
**Transferência para números telefônicos**

* Lista todos os números cadastrados no VoxOne;
* Permite transferir a ligação para um telefone específico (ex: atendente humano);
* Novos números podem ser cadastrados previamente no sistema.
  {% endtab %}
  {% endtabs %}

Durante a transferência:

* O agente informa o cliente;
* O sistema realiza o processo de transferência;
* Pode haver um pequeno tempo de espera enquanto a ligação é redirecionada.

<figure><img src="/files/804Ui21zi0cdfB7CBSdG" alt=""><figcaption></figcaption></figure>

***

#### Gerencie o seu RAG

Nesta seção, você define qual RAG (Retrieval-Augmented Generation) será utilizado pelo agente para responder com base em conteúdos personalizados.

Ao associar um RAG ao agente, ele passa a consultar os documentos e URLs cadastrados nesse RAG antes de responder, garantindo respostas mais precisas e alinhadas ao seu conteúdo.

1. Localize a seção **Gerencie seu RAG**.
2. Clique em **Selecione um RAG**.
3. Escolha um **RAG** já criado.&#x20;

<figure><img src="/files/MCnfjBUm8FBVSfMBpMRg" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Para entender melhor como funciona o RAG e aprender a criar, gerenciar e testar seus conteúdos, acesse a página de "[Uso do RAG no VoxOne](/skyone-studio/inteligencia-artificial/voxone/uso-do-rag-no-voxone.md)" e explore todas as possibilidades da funcionalidade.
{% endhint %}

***

#### Gerencie suas tools&#x20;

Selecione as tools que o agente poderá utilizar durante a conversa. As tools permitem que o agente acesse APIs, funcionalidades externas e recursos da plataforma para executar ações e buscar informações.

1. Localize a seção **Gerencie suas tools**
2. Clique em **Selecione uma Tools.**&#x20;

<figure><img src="/files/t878RGVWyjX6Uzhzi6to" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Para entender melhor como funcionam as tools e como criar ou configurar novas ferramentas, acesse a página de  "[Tools no VoxOne](/skyone-studio/inteligencia-artificial/voxone/tools-no-voxone.md)" e veja todas as possibilidades disponíveis.
{% endhint %}

***

#### Configurações da mensagem inicial

1. **Configure a mensagem inicial**

Exemplo: “Olá! Aqui é o agente VoxOne, tudo bem?”

2. **Delay**

Escolha se haverá atraso antes do início da fala (sem delay, 1s, 2s, 3s, 5s, 10s, 15s, 20s, 30s, 45s ou 60s).

3. **Defina se o agente pode ser interrompido durante a ligação**

* Marque a flag correspondente para permitir ou não interrupções.

<figure><img src="/files/gqYQUMSWSbyAKOe7PNJa" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Leia também: [Como usar o módulo VoxOneCall em um fluxo de integração](/skyone-studio/integracoes/fluxos/modulos-ferramentais/modulo-voxonecall.md).
{% endhint %}

***

### Recursos

Contamos com recursos aprimorados que potencializam a experiência de atendimento:

* **Suporte Multilíngue Extenso** — amplia o reconhecimento e a síntese de voz para múltiplos idiomas e sotaques.
* **Histórico da Conversa (Conversation History)** — permite revisitar interações anteriores e acompanhar o contexto das chamadas.
* **Estágios de Chamada (Call Stages)** — possibilitam controlar e visualizar as etapas do atendimento em tempo real.

***

### FAQ — Perguntas Frequentes

<details>

<summary><strong>Quantos minutos estão inclusos no plano VoxOne?</strong></summary>

O plano inclui 1.000 minutos mensais de ligações.

</details>

<details>

<summary><strong>Posso usar o mesmo número para vários agentes?</strong></summary>

Não. Cada agente ou operação recebe um número dedicado.

</details>

<details>

<summary><strong>É possível personalizar a voz do agente?</strong></summary>

Atualmente é possível escolher entre as vozes pré-disponíveis em diferentes idiomas.

</details>

<details>

<summary><strong>O que é “temperatura” e como ela afeta o agente?</strong></summary>

A temperatura controla a variação das respostas.\
Valores baixos (ex: 0.2) geram respostas mais previsíveis; valores altos (ex: 0.8) geram respostas mais criativas.

</details>

<details>

<summary><strong>O que acontece se o cliente ficar em silêncio?</strong></summary>

O agente enviará mensagens de inatividade configuradas até encerrar a chamada conforme o tempo definido.

</details>

<details>

<summary><strong>Posso alterar o tempo máximo da ligação depois de criada?</strong></summary>

Sim, é possível editar o agente a qualquer momento e ajustar a duração máxima.

</details>

### Termos importantes (Glossário)

| Termo                       | Descrição                                                                           |
| --------------------------- | ----------------------------------------------------------------------------------- |
| **Prompt**                  | Texto que define o comportamento e a função do agente.                              |
| **Temperatura**             | Grau de variação nas respostas do agente (0 = mais previsível / 1 = mais criativo). |
| **Mensagem de inatividade** | Mensagem enviada quando o cliente fica em silêncio por determinado tempo.           |
| **Delay**                   | Tempo de espera antes do agente começar a falar.                                    |
| **Conversation History**    | Registro completo de interações anteriores entre o agente e o usuário.              |
| **Call Stages**             | Fases do atendimento que indicam o progresso e o status da chamada.                 |

O **Skyone VoxOne** transforma agentes de IA em atendentes por voz, conectando sua automação diretamente a pessoas, de forma simples e escalável.\
Dê voz à sua operação e aproveite todo o potencial do **Skyone Studio**.


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.skyone.cloud/skyone-studio/inteligencia-artificial/voxone.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.