# VoxOneCall module

#### **Definition**

The **VoxOneCall** module allows your calls to be triggered automatically within flows, routines, and automations.

#### **What this feature is for**

Integrating VoxOne into the flow allows you to:

* Trigger an automatic call within an automation.
* Record and track the call status directly in the agent’s history.
* Pass context and data to the agent before the call, personalizing the interaction.
* Connect VoxOne calls to the Studio’s full workflow, creating complete and intelligent automations.

{% hint style="warning" %}
To use this module, you must enable the Artificial Intelligence feature in **Skyone Studio**. Please contact the sales team at <comercial@skyone.solutions>.
{% endhint %}

***

### Adding the **VoxOneCall module**

1. The "**VoxOneCall**" module appears under the Tools option in the flow editor. After clicking to add it, the initial configuration modal will be displayed.

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

{% hint style="info" %}
[Learn more about the Module Header here](/english/skyone-studio/integrations/flows/module-header.md).
{% endhint %}

1. **Select a VoxOne agent:** In the "**Agent**" field, choose an agent that has been previously created.
2. **Enter the phone number to place the call**

Type the mobile number including:

* Country code
* Area code
* Number

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

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

3. **Wait for conversation to end:** If the flag is enabled, the flow will wait for the user to end the conversation.
4. **Configure the Initial Context (Optional)**

The **Initial Context** allows you to guide the agent before the call begins, defining what behavior, instruction, or information it should consider at the start of the interaction.

You can define a **system context** (technical instructions and general rules) or a **user context** (what the “user” is saying before the call happens).

Use the "+" button to create an [SMOP](/english/skyone-studio/integrations/flows/data-operations/smop-small-operations.md).

5. **Provide multiple contexts?**

* **Flag enabled**

The screen will display the fields:

* **Rule →** Defines the type of context (e.g., system, user).
* **Message →** Text that will be sent to the agent before the call.

You can add as many context blocks as needed using the **“+”** button.

*Example:*

* **Rule:** System

* **Message:** “You must help the customer understand the available plans.”

* **Flag disabled**

You must manually send the initial message structure in JSON format:

```json
"initialMessages": [
  {
    "role": "MESSAGE_ROLE_USER",
    "text": "enter some text"
  }
]
```

This structure allows the integration to send preconfigured messages to the agent before the call starts.

6. **Test the call**

After configuring, click "**Next**" and then "**Test**."

<figure><img src="/files/04nmRUyU2o3Z2uPKcrEO" alt=""><figcaption></figcaption></figure>

11. **See the history**

a. In the VoxOne menu, click on your **Agent**.

b. Click "**Call history"** to open the tab.

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

There you will see:

* Status
* Source
* Last update
* Start and end times
* Duration

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

***

### **Key terms for this feature**

| Term              | Description                                                    |
| ----------------- | -------------------------------------------------------------- |
| **VoxOne Call**   | A tool module that allows calls to be executed through VoxOne. |
| **Trigger**       | Event that starts the flow (e.g., webhook).                    |
| **Context**       | Additional information sent to the agent before the call.      |
| **Agent History** | Area where all flow-generated calls are logged.                |

***

### FAQ - VoxOne usage as an integration module

<details>

<summary>Is it possible to schedule automatic calls to lists of numbers?</summary>

Yes, provided the integration logic sends the numbers to the flow (via webhook, API, or table).

</details>

<details>

<summary>Can I see in the history which flow originated the call?</summary>

Yes. The history displays the source (e.g., “Flow Test”).

</details>

<details>

<summary>Can I call VoxOne multiple times within the same flow?</summary>

Yes, the flow can have multiple steps involving calls.

</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/english/skyone-studio/integrations/flows/tool-modules/voxonecall-module.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.