---
title: "VA Sync"
slug: "dataflow-nodes-va-sync"
updated: 2025-12-10T09:47:23Z
published: 2025-12-10T09:47:23Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.knovvu.com/llms.txt
> Use this file to discover all available pages before exploring further.

# VA Sync

Integration node for Virtual Agent (VA) Sync in-parts API. 

## Parameters
|  <div style="width:120px">name</div> | description | <div style="width:220px">default</div> |
|---|---|---|
| Address | Address of VA Orchestrator Service | http://cai-magpie-api/magpie/ext-api/messages/synchronized |
| IgnoreSslErrors | Ignore any certificate errors if address contains "https" | false |
| Credential | OAuth 2.0 Credential for reaching VA Sync API. | None
|Project Name| The name of the project defined in VA interface.| None |


## Inputs

### Audio
&emsp;none

### Events
| name | description | possible nodes this event may be received from |
|---|---|---|
| Any event that has `Data.Text` | Any Text based event such as: SR Milestone, SR Partial etc. | SR Http, SR Websocket, Translate etc. |
| [VA Activity Object](/v1/docs/events#va-activity-object) | If the user wants to send structural information that does not quite fit "Text" field. | Entry, External Relay, Custom Nodes |


## Outputs

### Audio
&emsp;none

### Events

| name | description |
|---|---|
| [VA External](/v1/docs/events#va-external) | Contains an ActivityObject field that contains the VA Activity Response, and a Text field for compatibility with all other nodes.|



## Remarks  
### Requirements  

#### "StartMessage" requirements

"StartMessage" can contain 
- "CallProperties.ExternalId": If this is provided, data flow will send this value for the external conversation id to VA.

```json
{
    "CallProperties": 
    {
      "ExternalId":"ConversationId"
    },
}
```

### Project  Structure

A simple VA Project that takes audio user input, and returns the responses can be built as such: 
![Image](https://cdn.document360.io/9bca2910-6a3b-4224-9470-43f91f9a6d57/Images/Documentation/image-O22DQEX4.png){height="" width=""}

After this, any node that manipulates or uses the `Data.Text` field can be utilized freely. 

![Image](https://cdn.document360.io/9bca2910-6a3b-4224-9470-43f91f9a6d57/Images/Documentation/image-Q92WCS8F.png){height="" width=""}


### Supported flow types 
Batch, Stream

## Release Notes 

<div style="max-height: 200px; overflow-y: auto; overflow-x: hidden"> 
    <details>
        <summary> <strong> v4.6.0</strong> </summary>
        <ul>
            <li>Introduced Node.</li>
        </ul>
    </details>    

</div>