# Módulo VoxOneCall

#### **Definición**

El módulo **VoxOneCall** permite que sus llamadas se activen automáticamente dentro de flujos, rutinas y automatizaciones.

#### **Para qué sirve esta funcionalidad**

La integración del VoxOne al flujo permite:

* Activar una llamada automática dentro de una automatización.
* Registrar y acompañar el estado de la llamada directamente en el historial del agente.
* Enviar contextos y datos al agente antes de la llamada, personalizando la atención.
* Conectar las llamadas del VoxOne al flujo completo del Studio, creando automatizaciones completas e inteligentes.

{% hint style="warning" %}
Para utilizar este módulo, debe activar la función de Inteligencia Artificial de Skyone Studio. Póngase en contacto con el equipo comercial a través del correo electrónico [comercial@skyone.solutions](mail:comercial@skyone.solutions).
{% endhint %}

***

### **Agregar módulo VoxOneCall**

El módulo "**VoxOneCall**" aparece en la opción Herramientas de la edición de un flujo. Después de hacer clic para agregarlo, se mostrará el modal de configuración inicial.

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

{% hint style="info" %}
[Conozca más sobre el Encabezado del Módulo aquí](/espanol/skyone-studio/integraciones/encabezado-de-los-modulos.md).
{% endhint %}

1. **Seleccione un agente de VoxOne:** En el campo "**Agente**", elija un agente que haya sido creado previamente.
2. **Ingresa el número de teléfono para realizar la llamada**

Escribe el número incluyendo:

* Código del país
* Código de área
* Número

Ejemplo: **+55 11 9-2233-4455**

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

3. **Esperar finalización de la conversación:** Si la casilla (flag) está activada, el flujo esperará a que el usuario finalice la conversación.
4. **Configurar el Contexto Inicial (Opcional)**

El Contexto Inicial permite orientar al agente antes de que la llamada comience, definiendo qué comportamiento, instrucción o información debe considerar al inicio de la interacción.

Puedes definir un **contexto del sistema** (instrucciones técnicas y reglas generales) o un **contexto del usuario** (lo que el “usuario” está diciendo antes de que la llamada ocurra).

Utilice el botón "+" para crear una [SMOP](/espanol/skyone-studio/integraciones/operaciones-de-datos/smop-pequenas-operaciones.md).

5. **Informar multi contextos?**

* **Flag activada**

La pantalla mostrará los campos:

* **Regla →** Define el tipo de contexto (ej.: sistema, usuario).
* **Mensaje →** Texto que será enviado al agente antes de la llamada.

Puedes agregar tantos bloques de contexto como necesites usando el botón **“+”**.

**Ejemplo:**

* **Regla:** Sistema

* **Mensaje:** “Debes ayudar al cliente a entender los planes disponibles.”

* **Flag desactivada**

Es necesario enviar manualmente la estructura de los mensajes iniciales en formato JSON:

```json
"initialMessages": [
  {
    "role": "MESSAGE_ROLE_USER",
    "text": "ingresa un texto"
  }
]
```

Este formato permite que la integración envíe mensajes predefinidos al agente antes de que la llamada inicie.

6. **Probar la llamada**

Después de configurar, haga clic en "**Siguiente**" y, luego, en "**Probar**".

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

El número informado recibirá la llamada. Al contestar, el agente VoxOne iniciará la interacción automáticamente.

7. **Ver el historial**

En el menú del VoxOne, haz clic en tu **Agente**.\
Abre la pestaña **Historial de llamadas**.

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

Allí verás:

* Estado
* Origen
* Última actualización
* Horarios de inicio y fin
* Duración

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

***

### **Términos importantes de esta funcionalidad**

| Término                  | Descripción                                                                         |
| ------------------------ | ----------------------------------------------------------------------------------- |
| **VoxOne Call**          | La nueva herramienta dentro de los flujos que permite ejecutar llamadas vía VoxOne. |
| **Disparador**           | Evento que inicia el flujo (ej.: webhook).                                          |
| **Contexto**             | Información adicional enviada al agente antes de la llamada.                        |
| **Historial del Agente** | Área donde se registran todas las llamadas realizadas por el flujo.                 |

### FAQ —  Integración VoxOne

<details>

<summary>¿Es posible programar llamadas automáticas para listas de números?</summary>

Sí, siempre que la lógica de la integración envíe los números al flujo (vía webhook, API o tabla).

</details>

<details>

<summary>¿Puedo ver en el historial qué flujo originó la llamada?</summary>

Sí. El historial muestra el origen (p. ej.: “Prueba de Flujo”).

</details>

<details>

<summary>¿Puedo llamar a VoxOne varias veces en el mismo flujo?</summary>

Sí, el flujo puede tener varias etapas que involucren llamadas.

</details>


---

# 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/espanol/skyone-studio/integraciones/flujos/modulos-de-herramientas/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.
