> For the complete documentation index, see [llms.txt](https://docs.skyone.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.skyone.cloud/skyone-studio/integracoes/fluxos/modulos-ferramentais/modulo-voxonecall.md).

# Módulo VoxOneCall

### Definição

O módulo **VoxOneCall** permite que suas chamadas sejam acionadas automaticamente dentro de fluxos, rotinas e automações.

### Para que serve essa nova funcionalidade

A integração do VoxOne ao fluxo permite:

* Acionar uma ligação automática dentro de uma automação.
* Registrar e acompanhar o status da ligação diretamente no histórico do agente.
* Passar contextos e dados ao agente antes da ligação, personalizando o atendimento.
* Conectar chamadas do VoxOne ao fluxo completo do Studio, criando automações completas e inteligentes.

{% hint style="warning" %}
Para utilizar este módulo, você precisa ativar o recurso de Inteligência Artificial do **Skyone Studio**. Entre em contato com time comercial pelo e-mail <comercial@skyone.solutions>.
{% endhint %}

***

### Vídeo Demonstrativo

Para facilitar o entendimento da configuração do VoxOne no módulo de Integrações, disponibilizamos um vídeo que mostra todo o processo de forma prática, desde a localização da ferramenta VoxOneCall até o teste da chamada e visualização do histórico.&#x20;

Assista ao vídeo antes de iniciar a configuração para garantir que cada etapa seja seguida corretamente.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FzmZE88A9qvDla4o2JXya%2FVoxOne%20-%20Integra%C3%A7%C3%B5es.mp4?alt=media&token=eb8af225-4fa2-44bc-80d2-60cdfa116b7a>" %}

***

### Adicionar módulo VoxOneCall

O módulo "**VoxOneCall**" aparece na opção Ferramentas da edição de um fluxo. Após clicar para adicioná-lo, o modal de configuração inicial será exibido.

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

{% hint style="info" %}
[Saiba sobre o Cabeçalho do Módulo aqui](https://docs.skyone.cloud/skyone-studio/integracoes/cabecalho-dos-modulos).
{% endhint %}

1. **Selecione um agente do VoxOne:** No campo **"Agente"**, escolha um agente que já tenha sido criado anteriormente.
2. **Informe o número de telefone para realizar a ligação**

Digite o número de celular contendo:

* Código do país
* Discagem direta à distância (DDD)
* Número

**Exemplo:** `+55 11 9-2233-4455`

<figure><img src="/files/2PBiK5gP028GkGNRkH2P" alt=""><figcaption></figcaption></figure>

3. **Aguardar finalização da conversa:** Se a flag estiver ativada, o fluxo irá aguardar que o usuário finalize a conversa.&#x20;
4. **Configure o contexto Inicial (Opcional):**&#x20;

O **Contexto Inicial** permite orientar o agente antes da chamada, definindo qual comportamento, instrução ou informação ele deve considerar logo no início da interação.

Você pode definir um **contexto de sistema** (instruções técnicas e regras gerais) ou um **contexto de usuário** (o que o "usuário" está dizendo antes da ligação acontecer).

Utilize o botão "+" para criar uma [SMOP](/skyone-studio/integracoes/operacoes-de-dados/smop-pequenas-operacoes.md).

5. **Informar multi contextos?**

* **Flag ativada**\
  A tela exibirá os campos:

  * **Regra** → Define qual é o tipo de contexto (ex.: sistema, usuário).
  * **Mensagem** → Texto que será enviado ao agente antes da ligação.

  Você pode adicionar quantos blocos de contexto desejar utilizando o botão **“+”**.

  *Exemplo:*

  * Regra: Sistema
  * Mensagem: “Você deve ajudar o cliente a entender os planos disponíveis.”<br>
* **Flag desativada**

É necessário enviar manualmente a estrutura de mensagens iniciais no formato JSON:

```json
"initialMessages": [
  {
    "role": "MESSAGE_ROLE_USER",
    "text": "coloque um texto"
  }
]
```

Esse formato permite que a integração envie mensagens já estruturadas para o agente antes da ligação iniciar.<br>

6. **Teste a ligação**\
   Após configurar, clique em "**Próximo**" e, em seguida, "**Testar**".&#x20;

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

O telefone informado irá tocar. Ao atender, o agente VoxOne iniciará a interação automaticamente.<br>

7. **Acompanhe o histórico**

a) No menu do VoxOne, clique no seu **Agente**.

b) Abra a aba **Histórico**.

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

Lá você verá:

* **Status**
* **Origem**
* **Última atualização**
* **Horário de início e fim**
* **Duração**

<figure><img src="/files/2YiHML5aQ1vq0s8Z8MW2" alt=""><figcaption></figcaption></figure>

### Termos importantes dessa funcionalidade

| Termo               | Descrição                                                                |
| ------------------- | ------------------------------------------------------------------------ |
| Vox One Call        | A ferramenta dentro dos fluxos que permite executar ligações via VoxOne. |
| Gatilho             | Evento que inicia o fluxo (ex.: webhook).                                |
| Contexto            | Informações adicionais enviadas ao agente antes da ligação.              |
| Histórico do Agente | Área onde ficam registradas todas as ligações realizadas via fluxo.      |

### FAQ —  Integração VoxOne

<details>

<summary>É possível programar chamadas automáticas para listas de números?</summary>

Sim, desde que a lógica da integração envie os números ao fluxo (via webhook, API ou tabela).

</details>

<details>

<summary>Consigo ver no histórico qual fluxo originou a ligação?</summary>

Sim. O histórico exibe a origem (ex.: “Teste Fluxo”).

</details>

<details>

<summary> Posso chamar o VoxOne várias vezes no mesmo fluxo?</summary>

Sim, o fluxo pode possuir várias etapas envolvendo chamadas.

</details>


---

# 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 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/integracoes/fluxos/modulos-ferramentais/modulo-voxonecall.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.