From bb5f56bfb765d2e1e6a12fc6d70be685e16a04db Mon Sep 17 00:00:00 2001
From: Abhishek Kumar <abhishek@a6k.me>
Date: Thu, 9 Apr 2026 22:13:31 +0530
Subject: [PATCH] chore: add documentation for template context variables

---
 docs/voice-agent/pre-call-data-fetch.mdx | 25 ++++++++++++++++++++++++
 docs/voice-agent/template-variables.mdx  | 10 ++++++++++
 2 files changed, 35 insertions(+)

diff --git a/docs/voice-agent/pre-call-data-fetch.mdx b/docs/voice-agent/pre-call-data-fetch.mdx
index 20e4dfe..2784984 100644
--- a/docs/voice-agent/pre-call-data-fetch.mdx
+++ b/docs/voice-agent/pre-call-data-fetch.mdx
@@ -111,6 +111,31 @@ Access in prompts as `{{customer.name}}` and `{{customer.address.city}}`.
 
 The request has a **10-second timeout**. If your API does not respond within this window, the call proceeds without the fetched data. Design your endpoint to respond as quickly as possible to minimize the ring-back tone duration.
 
+## Testing with Test Calls
+
+<iframe
+  src="https://www.tella.tv/video/vid_cmnrnu19v011z04l1hvwiezaz/embed?b=0&title=0&a=1&loop=0&autoPlay=false&t=0&wt=0"
+  allowFullScreen
+  allowTransparency
+  style={{ width: "100%", aspectRatio: "16/9", border: "none", borderRadius: "12px" }}
+/>
+
+When a real phone call comes in, the `caller_number` and `called_number` context variables are automatically set by the telephony provider and included in the pre-call data fetch request as `from_number` and `to_number`. However, when you make a test call — either a **web call** (WebRTC) or a **phone test call** from the workflow editor — these variables are not available by default.
+
+To simulate telephony data during testing:
+
+1. Open your workflow and go to **Settings**.
+2. Under **Context Variables**, add the following variables:
+   - `caller_number` — set to a phone number you want to simulate as the caller (e.g., `+12137771234`).
+   - `called_number` — set to the number that would be dialed (e.g., `+12137771235`).
+3. Save the settings.
+
+Now when you make a test call (web or phone), these values will be sent in the pre-call data fetch request to your endpoint, allowing you to test the full flow as if a real inbound call were coming in.
+
+<Note>
+These context variables are only used during test calls from the workflow editor. On production inbound calls and campaign outbound calls, the actual telephony data is used and these values are ignored.
+</Note>
+
 ## Example Integration
 
 A simple Node.js endpoint that looks up a customer by phone number:
diff --git a/docs/voice-agent/template-variables.mdx b/docs/voice-agent/template-variables.mdx
index 564a7ee..3db4a56 100644
--- a/docs/voice-agent/template-variables.mdx
+++ b/docs/voice-agent/template-variables.mdx
@@ -24,5 +24,15 @@ You can write your prompt to access the user's name as below
 
 Prompt: `You are Alice, who is talking to {{initial_context.user.name}}.`
 
+### Using Template Variables for Testing
+
+Template variables defined in your workflow **Settings > Context Variables** are included in test calls (both web and phone) made from the workflow editor. This is useful for simulating data that would normally come from telephony or an API trigger.
+
+For example, you can set `caller_number` and `called_number` as context variables to test [Pre-Call Data Fetch](/voice-agent/pre-call-data-fetch#testing-with-test-calls) without needing a real inbound call.
+
+<Note>
+These context variables are only used during test calls from the workflow editor. On production inbound calls and campaign outbound calls, the actual telephony data is used and these values are ignored.
+</Note>
+
 ### Nodes
 Dograh Voice Agents are composed of various nodes. These nodes can provide instructions to the voice agent, help you setup a [trigger](/voice-agent/api-trigger) where you can trigger the voice agent to call someone, or help you setup a [webhook](/voice-agent/webhook), where you can update the results of the call in your CRM or trigger a downstream workflow in n8n. In the next steps, we will be documenting the nodes that you can use in building the voice agent.
\ No newline at end of file