Voca JSON Body Converter

📘 Voca JSON Body Converter — Help & Instructions

This tool converts JSON payloads into escaped strings for use inside the
HTTP Block in the Voca Flow Designer.


────────────────────────────────────────────────────────
1) Basic Usage
────────────────────────────────────────────────────────

Step 1: Paste your JSON into the "Input JSON" panel.

Example:
{
    "Name": "Yarin",
    "Last_Name": "Ben Aharon"
}

Step 2: Click "Convert".

Step 3: Copy the output from the right panel and paste it into:
Flow Designer → HTTP Block → Body field.


────────────────────────────────────────────────────────
2) Using Variables in JSON
────────────────────────────────────────────────────────

To insert dynamic values from Flow Designer, use:

    ${variableName}

Examples:
{
    "callerName": "${callerName}",
    "city": "${detectedCity}"
}

You can also include variables inside sentences:

"Caller said: ${speech}"

Or mix multiple variables:
"The user ${name} from ${city} requested help."


────────────────────────────────────────────────────────
3) Output Example
────────────────────────────────────────────────────────

Input:
{
    "Name": "${callerName}"
}

Output:
"{
    \"Name\": \"" + ${callerName} + "\"
}"


────────────────────────────────────────────────────────
4) Supported Features
────────────────────────────────────────────────────────

✔ Variables anywhere inside strings  
✔ Multiple variables in the same string  
✔ Complex JSON (large GPT prompts)  
✔ Preserves indentation and formatting  
✔ Handles escaped quotes and newlines  
✔ Automatically escapes dangerous characters  
✔ Converts tabs → spaces for consistent indentation  


────────────────────────────────────────────────────────
5) Rules for Valid Variables
────────────────────────────────────────────────────────

Variables MUST:
- Use the format: ${variable}
- Be inside a JSON string
- Use Flow Designer variable names
- Not contain spaces

Correct:
    "Name": "${firstName}"

Incorrect:
    "Name": ${firstName}
    "Name": "$firstName"
    "Name": "{{firstName}}"



────────────────────────────────────────────────────────
7) Notes
────────────────────────────────────────────────────────

This tool was developed by the Voca Product Team.
It is specifically designed for converting JSON bodies
before using them inside the Voca Flow Designer HTTP Block.

If your JSON does not convert correctly, verify:
- All quotes are double quotes
- JSON is properly formatted
- Variables follow ${varName} syntax

────────────────────────────────────────────────────────
Voca JSON Body Converter

Developed by the Voca Product Team

Input JSON

Escaped Output
