Add custom variables to a Ringg AI agent, mention them in the prompt with @, and fill them per call by API, per contact from a campaign CSV, or from tools.
A custom variable is a named value that changes from one call to the next, such as the caller’s name, an amount due or an appointment date. You write the variable once in the agent’s prompt, and each call fills in its own value.In the dashboard: Sidebar → Assistants → open an agent → Custom Variables. On a multi-prompt agent, open Global Settings → Custom variables.Where values come from, and where they go:
Two variables are permanent: callee_name and mobile_number. The Custom Variables panel shows no remove button for them, and a new multi-prompt agent starts with both.
In the editor sidebar, click Custom Variables. The panel lists the agent’s variables in the order they were added. Type into Enter variable name: as you type, letters become lowercase and spaces become _, so “Due Date” becomes due_date.
2
Add it
Click Add or press Enter. There is no separate Save; the list is saved at once. “Variable already exists” means the name is taken; because input is lowercased, Due_Date and due_date are the same name.
You see “Variables updated successfully”. The new variable is at the bottom of the list, and it appears under Custom Variables when you type @ in the prompt.
The Custom Variables panel after adding loan_account
Remove a variable with the bin icon on its row. Sort the list alphabetically with the sort icon (tooltip Sort alphabetically); click again to return to the order they were added (tooltip Newest first).
Use short, descriptive snake_case names such as emi_amount or due_date. A campaign CSV maps columns by exact name, so the same names in your CSV save mapping work (calling list).You can also create a variable while writing the prompt: type @{{ and a new name, then choose Create ”…” from the menu (Write the prompt). That path keeps the name exactly as typed, so type it in lowercase yourself.
Type @ in the first message or any prompt section and pick the variable under Custom Variables. It appears as a chip; its text form is @{{name}}.
First message:Hello @{{callee_name}}, this is Asha from Acme Finance. Is this a good time to talk?Conversation Script:1. Confirm you are speaking to @{{callee_name}}.2. Tell them their EMI of @{{emi_amount}} is due on @{{due_date}}.3. Ask when they will pay.
Picking the new variable from the @ menu
A token that names a variable the agent does not have is shown in red with a wavy underline: add the variable or fix the spelling. Variables also work in tool parameters and in If Condition blocks.
The same variables are filled in different ways, depending on how the call starts. Values are sent as strings. Write them the way the agent should say them (15 October, not 2025-10-15), or tell the agent in the prompt how to read them.
Test assistant shows one optional field per variable (for example Due date), except mobile_number, which comes from Callee number on a phone call. See Test an agent.
Each variable is mapped to a CSV column under Map variables to CSV columns (map variables to columns), and every variable must be mapped before you can continue. Each row then fills the variables for one call:
callee_name,mobile_number,emi_amount,due_datePriya Sharma,9876543210,"₹4,500",15 October
Initiate Individual Call takes the variables in custom_args_values, an object of name: value pairs. name and mobile_number are required request fields. When you send custom_args_values, it must include every variable the agent has, or the call fails with 400 “Missing custom arguments: …”. When you leave it out, only callee_name and mobile_number are filled. Send your API key in X-API-KEY; from_number is the caller ID.
A pre-call tool runs before the call starts. It can take a variable as an input (offered as custom_args.<name>, for example to look up a customer by custom_args.mobile_number), and its selected response keys go into the prompt as @((tool_name.key)). Use this when the value lives in your system rather than in the CSV or API request. See Tools and the look-up example.
The dashboard does not stop a test call with empty variables. A variable sent as an empty string becomes empty text. A variable that isn’t sent at all stays in the prompt as written, for example @{{due_date}}, and the call goes ahead.Write the prompt so a missing value does not derail the call: “If the due date is not known, ask the customer to check their statement.” Or wrap the sentence in an If Condition block that checks the variable is not empty. That check works only when the variable is sent as an empty string: an unsent variable counts as not empty.
Edit Assistant with "operation": "edit_custom_vars" sets the agent’s variable names in custom_variables, the same list the Custom Variables panel shows. Create Agent takes custom_variables too.The list you send replaces the agent’s list, so include every variable you want to keep, callee_name and mobile_number too: an outbound agent rejects a list without them with 403. The API keeps names exactly as sent, so send them in lowercase snake_case.
The agent says the variable name, or nothing, instead of the value
The call did not receive that variable. Check the call’s Custom variables in Logs, and make sure the key in custom_args_values or the CSV column matches the variable name exactly.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Ringg AI","description":"Build AI agents that make and answer phone calls, talk on your website and chat on WhatsApp, then run them from the Ringg AI dashboard or REST API.","colors":{"primary":"#0A0A0B","light":"#FFFFFF","dark":"#0A0A0B"},"logo":{"light":"https://mintcdn.com/ringgai-0da73d20/ZLVFI55VhZ4gmYrF/logo/light.svg?fit=max\u0026auto=format\u0026n=ZLVFI55VhZ4gmYrF\u0026q=85\u0026s=053f22dbaf5140cd8e5dadb1d4d057cd","dark":"https://mintcdn.com/ringgai-0da73d20/ZLVFI55VhZ4gmYrF/logo/dark.svg?fit=max\u0026auto=format\u0026n=ZLVFI55VhZ4gmYrF\u0026q=85\u0026s=cf9075384ec572e1a19b939d5a8674af","href":"https://www.ringg.ai"},"favicon":"https://mintcdn.com/ringgai-0da73d20/ZLVFI55VhZ4gmYrF/favicon.svg?fit=max\u0026auto=format\u0026n=ZLVFI55VhZ4gmYrF\u0026q=85\u0026s=e612fcf76df43d6468baa340dc3fde50","api":{"playground":{"display":"interactive"},"examples":{"languages":["curl","python","javascript"]},"mdx":{"auth":{"method":"key","name":"X-API-KEY"},"server":"https://prod-api.ringg.ai/ca/api/v0"}},"appearance":{"default":"dark"},"background":{"decoration":"grid"},"navbar":{"links":[{"href":"/resources/learn/all-lessons","label":"Learn"},{"href":"mailto:admin@ringg.ai","label":"Contact us"}],"primary":{"type":"button","label":"Dashboard","href":"https://www.ringg.ai/dashboard"}},"footer":{"socials":{"x":"https://x.com/ringg_ai","linkedin":"https://www.linkedin.com/company/ringg","youtube":"https://www.youtube.com/@RinggAI","instagram":"https://www.instagram.com/ringg_ai","discord":"https://discord.gg/YuEnb8Vsca"},"links":[{"header":"For AI agents","items":[{"label":"llms.txt","href":"https://docs.ringg.ai/llms.txt"},{"label":"skill.md","href":"https://docs.ringg.ai/skill.md"},{"label":"OpenAPI spec","href":"https://docs.ringg.ai/api-reference/openapi.json"},{"label":"MCP server","href":"/resources/mcp-server/docs-mcp-server/mcp-for-ai-assistants"}]}]},"search":{"prompt":"Search the docs"},"seo":{"metatags":{"canonical":"https://docs.ringg.ai","og:site_name":"Ringg AI Docs","twitter:site":"@ringg_ai"},"organization":{"id":"https://www.ringg.ai/#organization","legalName":"Stoic AI Private Limited","url":"https://www.ringg.ai","logo":"https://assets.ringg.ai/images/logo/logo.svg","sameAs":["https://x.com/ringg_ai","https://www.linkedin.com/company/ringg","https://www.youtube.com/@RinggAI","https://www.instagram.com/ringg_ai","https://discord.gg/YuEnb8Vsca"]}},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","latex":false},"errors":{"404":{"redirect":false,"title":"This page doesn't exist","description":"It may have moved in the docs rebuild. The suggestions below usually have it; otherwise start from [the introduction](/get-started/ringg-ai) or search above."}},"contextual":{"options":["copy","view","chatgpt","claude","mcp","download-spec"],"display":"header"},"markdown":{"instructions":["To search or read these docs, connect the Ringg docs MCP server at https://docs.ringg.ai/mcp (no key needed; tools search_ringg_ai and query_docs_filesystem_ringg_ai) instead of browsing pages one by one. Setup for each client: https://docs.ringg.ai/resources/mcp-server/docs-mcp-server/mcp-for-ai-assistants.md","The dashboard labels agents \"Assistants\"; these docs say \"agent\". Both mean the same object, identified by agent_id.","API base URL: https://prod-api.ringg.ai/ca/api/v0. Send the workspace API key in the X-API-KEY header, from server-side code only.","Placing a call dials a real phone number and spends credits. Confirm the number with the user before calling.","To act on a Ringg workspace (place calls, edit agents, read transcripts), use the separate Ringg workspace MCP server at https://mcp.ringg.ai/mcp: https://docs.ringg.ai/resources/mcp-server/workspace-mcp-server/overview.md"]},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ringgai-0da73d20","hasAudioNarration":false,"actualSubdomain":"ringgai-0da73d20","customDomains":["docs.ringg.ai"],"gitSource":{"type":"github","owner":"stonkr","repo":"ringg-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true,"edits":true,"issues":true},"entitlements":{},"buildId":"6adb52e21a579503f2299e23","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"default","tag":"Documentation","count":90},{"language":"default","tag":"API reference","count":52},{"language":"default","tag":"Build agents","count":37},{"language":"default","tag":"Resources","count":34},{"language":"default","tag":"Learn","count":27},{"language":"default","tag":"Inventory","count":23},{"language":"default","tag":"Deploy","count":22},{"language":"default","tag":"Customize agent behaviour","count":19},{"language":"default","tag":"Agents","count":17},{"language":"default","tag":"Calling","count":15}],"searchSettings":{"showContentSnippets":true,"maxResults":8}},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":false}},"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"img.nav-logo{height:1.375rem!important;width:auto!important}.figure-card{display:flex;flex-direction:column;margin:0.5rem 0;overflow:hidden;border:1px solid rgb(10 10 11 / 0.08);border-radius:1rem;background:#ffffff;text-decoration:none!important;transition:border-color 150ms}.figure-card:hover{border-color:rgb(10 10 11 / 0.2)}.dark .figure-card{border-color:rgb(255 255 255 / 0.08);background:rgb(var(--background-dark))}.dark .figure-card:hover{border-color:rgb(255 255 255 / 0.2)}.figure-card-panel{display:flex;justify-content:center;height:12rem;margin:0.375rem 0.375rem 0;border-radius:0.75rem;-webkit-mask-image:linear-gradient(to bottom, #000 62%, transparent);mask-image:linear-gradient(to bottom, #000 62%, transparent);background:#f6f6f7 url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='384' height='256' fill='none' stroke='%230a0a0b' stroke-opacity='0.03' stroke-width='1.5'%3E%3Ccircle cx='32' cy='32' r='25'/%3E%3Ccircle cx='96' cy='32' r='25'/%3E%3Crect x='135' y='7' width='50' height='50' rx='8'/%3E%3Ccircle cx='224' cy='32' r='25'/%3E%3Ccircle cx='288' cy='32' r='25'/%3E%3Ccircle cx='352' cy='32' r='25'/%3E%3Ccircle cx='32' cy='96' r='25'/%3E%3Ccircle cx='96' cy='96' r='25'/%3E%3Ccircle cx='160' cy='96' r='25'/%3E%3Ccircle cx='224' cy='96' r='25'/%3E%3Ccircle cx='288' cy='96' r='25'/%3E%3Ccircle cx='352' cy='96' r='25'/%3E%3Ccircle cx='32' cy='160' r='25'/%3E%3Crect x='71' y='135' width='50' height='50' rx='8'/%3E%3Ccircle cx='160' cy='160' r='25'/%3E%3Ccircle cx='224' cy='160' r='25'/%3E%3Crect x='263' y='135' width='50' height='50' rx='8'/%3E%3Crect x='327' y='135' width='50' height='50' rx='8'/%3E%3Crect x='7' y='199' width='50' height='50' rx='8'/%3E%3Ccircle cx='96' cy='224' r='25'/%3E%3Crect x='135' y='199' width='50' height='50' rx='8'/%3E%3Ccircle cx='224' cy='224' r='25'/%3E%3Crect x='263' y='199' width='50' height='50' rx='8'/%3E%3Ccircle cx='352' cy='224' r='25'/%3E%3C/svg%3E\") center / 192px 128px}.dark .figure-card-panel{background:#0f0f11 url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='384' height='256' fill='none' stroke='%23ffffff' stroke-opacity='0.025' stroke-width='1.5'%3E%3Ccircle cx='32' cy='32' r='25'/%3E%3Ccircle cx='96' cy='32' r='25'/%3E%3Crect x='135' y='7' width='50' height='50' rx='8'/%3E%3Ccircle cx='224' cy='32' r='25'/%3E%3Ccircle cx='288' cy='32' r='25'/%3E%3Ccircle cx='352' cy='32' r='25'/%3E%3Ccircle cx='32' cy='96' r='25'/%3E%3Ccircle cx='96' cy='96' r='25'/%3E%3Ccircle cx='160' cy='96' r='25'/%3E%3Ccircle cx='224' cy='96' r='25'/%3E%3Ccircle cx='288' cy='96' r='25'/%3E%3Ccircle cx='352' cy='96' r='25'/%3E%3Ccircle cx='32' cy='160' r='25'/%3E%3Crect x='71' y='135' width='50' height='50' rx='8'/%3E%3Ccircle cx='160' cy='160' r='25'/%3E%3Ccircle cx='224' cy='160' r='25'/%3E%3Crect x='263' y='135' width='50' height='50' rx='8'/%3E%3Crect x='327' y='135' width='50' height='50' rx='8'/%3E%3Crect x='7' y='199' width='50' height='50' rx='8'/%3E%3Ccircle cx='96' cy='224' r='25'/%3E%3Crect x='135' y='199' width='50' height='50' rx='8'/%3E%3Ccircle cx='224' cy='224' r='25'/%3E%3Crect x='263' y='199' width='50' height='50' rx='8'/%3E%3Ccircle cx='352' cy='224' r='25'/%3E%3C/svg%3E\") center / 192px 128px}.figure-card-panel{--hairline-plate: #f6f6f7}.dark .figure-card-panel{--hairline-plate: #0f0f11}.figure-card-panel>[data-hairline]{width:13.75rem}.figure-card-text{flex:1;padding:0.25rem 1.25rem 1.25rem}.figure-card-title{font-weight:600;color:rgb(17 24 39)}.dark .figure-card-title{color:rgb(255 255 255)}.figure-card-body{margin-top:0.25rem;font-size:0.9375rem;line-height:1.6;color:rgb(75 85 99)}.dark .figure-card-body{color:rgb(161 161 170)}"}],"page":{"pagePath":"documentation/build-agents/customize-agent-behaviour/custom-variables","slug":"/documentation/build-agents/customize-agent-behaviour/custom-variables","pageMetadata":{"title":"Custom variables","sidebarTitle":"Custom variables","description":"Add custom variables to a Ringg AI agent, mention them in the prompt with @, and fill them per call by API, per contact from a campaign CSV, or from tools.","og:title":"Use custom variables to personalise every agent call","href":"/documentation/build-agents/customize-agent-behaviour/custom-variables"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Add custom variables to a Ringg AI agent, mention them in the prompt with @, and fill them per call by API, per contact from a campaign CSV, or from tools.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Card,Check,CodeBlock,CodeGroup,Columns,Frame,Heading,Mermaid,OptimizedImage,ResponseField,Step,Steps}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Card)_missingMdxReference(`Card`,true);if(!Check)_missingMdxReference(`Check`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Columns)_missingMdxReference(`Columns`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`A custom variable is a named value that changes from one call to the next, such as the caller’s name, an amount due or an appointment date. You write the variable once in the agent’s `,_jsx(_components.a,{href:`/documentation/build-agents/customize-agent-behaviour/agent-prompt`,children:`prompt`}),`, and each call fills in its own value.`]}),`\n`,_jsxs(_components.p,{children:[`In the dashboard: `,_jsx(_components.strong,{children:`Sidebar → Assistants →`}),` open an agent `,_jsx(_components.strong,{children:`→ Custom Variables`}),`. On a `,_jsx(_components.a,{href:`/documentation/build-agents/agents/multi-prompt-agents/overview`,children:`multi-prompt agent`}),`, open `,_jsx(_components.strong,{children:`Global Settings → Custom variables`}),`.`]}),`\n`,_jsx(_components.p,{children:`Where values come from, and where they go:`}),`\n`,_jsx(Mermaid,{chart:`flowchart LR\n T[Test assistant fields] --> V[Custom variables]\n C[Campaign CSV columns] --> V\n A[API: custom_args_values] --> V\n P[Pre-call tool input] -.reads.-> V\n V --> M[Prompt and first message]\n V --> I[If Condition blocks]\n V --> TP[Tool parameters]`}),`\n`,_jsx(Heading,{level:`2`,id:`before-you-start`,children:`Before you start`}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`An agent`,icon:`bot`,href:`/documentation/build-agents/agents/create-an-agent`,horizontal:true,children:_jsxs(_components.p,{children:[`Variables belong to it and to each of its `,_jsx(_components.a,{href:`/documentation/build-agents/test-and-improve/drafts-and-versions`,children:`versions`}),`.`]})}),_jsx(Card,{title:`An API key`,icon:`key`,href:`/documentation/manage-account/api-key`,horizontal:true,children:_jsx(_components.p,{children:`Optional: only to fill or edit variables by API.`})})]}),`\n`,_jsx(Heading,{level:`2`,id:`the-two-permanent-variables`,children:`The two permanent variables`}),`\n`,_jsxs(_components.p,{children:[`Two variables are permanent: `,_jsx(_components.code,{children:`callee_name`}),` and `,_jsx(_components.code,{children:`mobile_number`}),`. The `,_jsx(_components.strong,{children:`Custom Variables`}),` panel shows no remove button for them, and a new multi-prompt agent starts with both.`]}),`\n`,_jsx(ResponseField,{name:`callee_name`,type:`string`,id:`param-callee-name`,children:_jsxs(_components.p,{children:[`The name of the person on the call. On an API call it defaults to the request’s `,_jsx(_components.code,{children:`name`}),`. Inbound calls and web calls don’t fill it unless you send it.`]})}),`\n`,_jsx(ResponseField,{name:`mobile_number`,type:`string`,id:`param-mobile-number`,children:_jsxs(_components.p,{children:[`Their phone number. On an API call it defaults to the request’s `,_jsx(_components.code,{children:`mobile_number`}),`; on an inbound call it is the caller’s number. Web calls don’t fill it.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`add-a-variable`,children:`Add a variable`}),`\n`,_jsx(Frame,{caption:`Adding a variable and using it in the prompt`,children:_jsx(`video`,{alt:`Adding a variable and using it in the prompt`,\"aria-label\":`Adding a variable and using it in the prompt`,controls:true,muted:true,playsInline:true,className:`mint-w-full mint-rounded-xl`,style:{aspectRatio:`16 / 10`},preload:`metadata`,controlsList:`nodownload noremoteplayback`,poster:`/media/agents-variables/poster.webp`,children:_jsx(`source`,{src:`https://mintcdn.com/ringgai-0da73d20/zhzhS2waLZvF8qXk/media/agents-variables/video.webm?fit=max\u0026auto=format\u0026n=zhzhS2waLZvF8qXk\u0026q=85\u0026s=8bdd89f68025cb527a02ab93f39e480f`,type:`video/webm; codecs=\"av01.0.09M.08\"`,\"data-path\":`media/agents-variables/video.webm`})})}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Type a name`,children:_jsxs(_components.p,{children:[`In the editor sidebar, click `,_jsx(_components.strong,{children:`Custom Variables`}),`. The panel lists the agent’s variables in the order they were added. Type into `,_jsx(_components.strong,{children:`Enter variable name`}),`: as you type, letters become lowercase and spaces become `,_jsx(_components.code,{children:`_`}),`, so “Due Date” becomes `,_jsx(_components.code,{children:`due_date`}),`.`]})}),_jsxs(Step,{title:`Add it`,children:[_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Add`}),` or press Enter. There is no separate Save; the list is saved at once. “Variable already exists” means the name is taken; because input is lowercased, `,_jsx(_components.code,{children:`Due_Date`}),` and `,_jsx(_components.code,{children:`due_date`}),` are the same name.`]}),_jsxs(Check,{children:[`You see “Variables updated successfully”. The new variable is at the bottom of the list, and it appears under `,_jsx(_components.strong,{children:`Custom Variables`}),` when you type `,_jsx(_components.code,{children:`@`}),` in the `,_jsx(_components.a,{href:`/documentation/build-agents/customize-agent-behaviour/agent-prompt`,children:`prompt`}),`.`]}),_jsx(Frame,{caption:`The Custom Variables panel after adding loan_account`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/ringgai-0da73d20/zhzhS2waLZvF8qXk/media/agents-variables/variables-panel.webp?fit=max\u0026auto=format\u0026n=zhzhS2waLZvF8qXk\u0026q=85\u0026s=358ccc4879ae5ca696d91eb8288707e6`,alt:`Custom Variables panel with the Enter variable name field and Add button, and the variables callee_name and mobile_number (no remove button), then due_amount, due_date and loan_account, each with a bin icon`,\"data-og-width\":`548`,width:`548`,\"data-og-height\":`632`,height:`632`,\"data-path\":`media/agents-variables/variables-panel.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/ringgai-0da73d20/zhzhS2waLZvF8qXk/media/agents-variables/variables-panel.webp?w=280\u0026fit=max\u0026auto=format\u0026n=zhzhS2waLZvF8qXk\u0026q=85\u0026s=b42bfa599a1dbffff7e9af2b40fd940e 280w, https://mintcdn.com/ringgai-0da73d20/zhzhS2waLZvF8qXk/media/agents-variables/variables-panel.webp?w=560\u0026fit=max\u0026auto=format\u0026n=zhzhS2waLZvF8qXk\u0026q=85\u0026s=75406e7f041a186633df6e07df9183f3 560w, https://mintcdn.com/ringgai-0da73d20/zhzhS2waLZvF8qXk/media/agents-variables/variables-panel.webp?w=840\u0026fit=max\u0026auto=format\u0026n=zhzhS2waLZvF8qXk\u0026q=85\u0026s=f76dbbe384201b6ed13e3245e23fdd7d 840w, https://mintcdn.com/ringgai-0da73d20/zhzhS2waLZvF8qXk/media/agents-variables/variables-panel.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=zhzhS2waLZvF8qXk\u0026q=85\u0026s=9378fe4fa1bcb17ca8188f379d0822fb 1100w, https://mintcdn.com/ringgai-0da73d20/zhzhS2waLZvF8qXk/media/agents-variables/variables-panel.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=zhzhS2waLZvF8qXk\u0026q=85\u0026s=41398804612210ece8302cf7b82a3b21 1650w, https://mintcdn.com/ringgai-0da73d20/zhzhS2waLZvF8qXk/media/agents-variables/variables-panel.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=zhzhS2waLZvF8qXk\u0026q=85\u0026s=f4269d7fe86334bb5d70d796339e54fb 2500w`})})]})]}),`\n`,_jsxs(_components.p,{children:[`Remove a variable with the bin icon on its row. Sort the list alphabetically with the sort icon (tooltip `,_jsx(_components.strong,{children:`Sort alphabetically`}),`); click again to return to the order they were added (tooltip `,_jsx(_components.strong,{children:`Newest first`}),`).`]}),`\n`,_jsx(Heading,{level:`3`,id:`naming-rules`,children:`Naming rules`}),`\n`,_jsxs(_components.p,{children:[`Use short, descriptive snake_case names such as `,_jsx(_components.code,{children:`emi_amount`}),` or `,_jsx(_components.code,{children:`due_date`}),`. A campaign CSV maps columns by exact name, so the same names in your CSV save mapping work (`,_jsx(_components.a,{href:`/documentation/deploy/campaigns/calling-list`,children:`calling list`}),`).`]}),`\n`,_jsxs(_components.p,{children:[`You can also create a variable while writing the prompt: type `,_jsx(_components.code,{children:`@{{`}),` and a new name, then choose `,_jsx(_components.strong,{children:`Create ”…”`}),` from the menu (`,_jsx(_components.a,{href:`/documentation/build-agents/customize-agent-behaviour/agent-prompt#create-a-variable-from-the-menu`,children:`Write the prompt`}),`). That path keeps the name exactly as typed, so type it in lowercase yourself.`]}),`\n`,_jsx(Heading,{level:`2`,id:`use-variables-in-the-prompt`,children:`Use variables in the prompt`}),`\n`,_jsxs(_components.p,{children:[`Type `,_jsx(_components.code,{children:`@`}),` in the first message or any prompt section and pick the variable under `,_jsx(_components.strong,{children:`Custom Variables`}),`. It appears as a chip; its text form is `,_jsx(_components.code,{children:`@{{name}}`}),`.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`First message:`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Hello @{{callee_name}}, this is Asha from Acme Finance. Is this a good time to talk?`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Conversation Script:`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`1. Confirm you are speaking to @{{callee_name}}.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`2. Tell them their EMI of @{{emi_amount}} is due on @{{due_date}}.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`3. Ask when they will pay.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Frame,{caption:`Picking the new variable from the @ menu`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/ringgai-0da73d20/zhzhS2waLZvF8qXk/media/agents-variables/variable-in-menu.webp?fit=max\u0026auto=format\u0026n=zhzhS2waLZvF8qXk\u0026q=85\u0026s=79abf997af13071457b876f1f19f4c9c`,alt:`Prompt text ending in @loan with the mention menu showing Loan Account under Custom Variables`,\"data-og-width\":`524`,width:`524`,\"data-og-height\":`308`,height:`308`,\"data-path\":`media/agents-variables/variable-in-menu.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/ringgai-0da73d20/zhzhS2waLZvF8qXk/media/agents-variables/variable-in-menu.webp?w=280\u0026fit=max\u0026auto=format\u0026n=zhzhS2waLZvF8qXk\u0026q=85\u0026s=90ffe87f616192c47fc1d51b3ecaabe8 280w, https://mintcdn.com/ringgai-0da73d20/zhzhS2waLZvF8qXk/media/agents-variables/variable-in-menu.webp?w=560\u0026fit=max\u0026auto=format\u0026n=zhzhS2waLZvF8qXk\u0026q=85\u0026s=1d21c0fe3b4f45e3bc810af225c63f4b 560w, https://mintcdn.com/ringgai-0da73d20/zhzhS2waLZvF8qXk/media/agents-variables/variable-in-menu.webp?w=840\u0026fit=max\u0026auto=format\u0026n=zhzhS2waLZvF8qXk\u0026q=85\u0026s=6771d19a2867adbb1838e6f628282df2 840w, https://mintcdn.com/ringgai-0da73d20/zhzhS2waLZvF8qXk/media/agents-variables/variable-in-menu.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=zhzhS2waLZvF8qXk\u0026q=85\u0026s=f28206b13b07c79c31607e928f245765 1100w, https://mintcdn.com/ringgai-0da73d20/zhzhS2waLZvF8qXk/media/agents-variables/variable-in-menu.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=zhzhS2waLZvF8qXk\u0026q=85\u0026s=7f7609471334765a772564340f086059 1650w, https://mintcdn.com/ringgai-0da73d20/zhzhS2waLZvF8qXk/media/agents-variables/variable-in-menu.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=zhzhS2waLZvF8qXk\u0026q=85\u0026s=b7017177cdf32efe2b52d670b50577ed 2500w`})}),`\n`,_jsxs(_components.p,{children:[`A token that names a variable the agent does not have is shown in red with a wavy underline: add the variable or fix the spelling. Variables also work in `,_jsx(_components.a,{href:`/documentation/build-agents/customize-agent-behaviour/tools/api-tools#parameter-sources`,children:`tool parameters`}),` and in `,_jsx(_components.a,{href:`/documentation/build-agents/customize-agent-behaviour/agent-prompt#if-condition-blocks`,children:`If Condition blocks`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`fill-variables-for-each-call`,children:`Fill variables for each call`}),`\n`,_jsxs(_components.p,{children:[`The same variables are filled in different ways, depending on how the call starts. Values are sent as strings. Write them the way the agent should say them (`,_jsx(_components.code,{children:`15 October`}),`, not `,_jsx(_components.code,{children:`2025-10-15`}),`), or tell the agent in the prompt how to read them.`]}),`\n`,_jsx(Heading,{level:`3`,id:`from-a-test-call`,children:`From a test call`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Test assistant`}),` shows one optional field per variable (for example `,_jsx(_components.strong,{children:`Due date`}),`), except `,_jsx(_components.code,{children:`mobile_number`}),`, which comes from `,_jsx(_components.strong,{children:`Callee number`}),` on a phone call. See `,_jsx(_components.a,{href:`/documentation/build-agents/test-and-improve/test-an-agent#test-options`,children:`Test an agent`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`from-a-campaign-csv`,children:`From a campaign CSV`}),`\n`,_jsxs(_components.p,{children:[`Each variable is mapped to a CSV column under `,_jsx(_components.strong,{children:`Map variables to CSV columns`}),` (`,_jsx(_components.a,{href:`/documentation/deploy/campaigns/calling-list#map-variables-to-columns`,children:`map variables to columns`}),`), and every variable must be mapped before you can continue. Each row then fills the variables for one call:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`callee_name,mobile_number,emi_amount,due_date`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Priya Sharma,9876543210,\"₹4,500\",15 October`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.a,{href:`/documentation/deploy/campaigns/calling-list`,children:`calling list reference`}),` covers the CSV format and auto-mapping.`]}),`\n`,_jsx(Heading,{level:`3`,id:`from-the-api`,children:`From the API`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/api-reference/calling/individual-calls/initiate-individual-call`,children:`Initiate Individual Call`}),` takes the variables in `,_jsx(_components.code,{children:`custom_args_values`}),`, an object of `,_jsx(_components.code,{children:`name: value`}),` pairs. `,_jsx(_components.code,{children:`name`}),` and `,_jsx(_components.code,{children:`mobile_number`}),` are required request fields. When you send `,_jsx(_components.code,{children:`custom_args_values`}),`, it must include every variable the agent has, or the call fails with `,_jsx(_components.code,{children:`400`}),` “Missing custom arguments: …”. When you leave it out, only `,_jsx(_components.code,{children:`callee_name`}),` and `,_jsx(_components.code,{children:`mobile_number`}),` are filled. Send your `,_jsx(_components.a,{href:`/documentation/manage-account/api-key`,children:`API key`}),` in `,_jsx(_components.code,{children:`X-API-KEY`}),`; `,_jsx(_components.code,{children:`from_number`}),` is the `,_jsx(_components.a,{href:`/documentation/inventory/phone-numbers/inbound-agent-number#outbound-choose-the-caller-id`,children:`caller ID`}),`.`]}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`14`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`14`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://prod-api.ringg.ai/ca/api/v0/calling/outbound/individual\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-API-KEY: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$RINGG_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"name\": \"Priya Sharma\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"mobile_number\": \"+919876543210\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"agent_id\": \"00000000-0000-4000-8000-0000000000a1\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"from_number\": \"+919876540110\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"custom_args_values\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"callee_name\": \"Priya\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"emi_amount\": \"₹4,500\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"due_date\": \"15 October\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`JavaScript`,numberOfLines:`19`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`19`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://prod-api.ringg.ai/ca/api/v0/calling/outbound/individual\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` method:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"POST\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-API-KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` process`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`env`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`RINGG_API_KEY`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"application/json\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` body:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` JSON`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`stringify`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` name:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Priya Sharma\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` mobile_number:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"+919876543210\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` agent_id:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"00000000-0000-4000-8000-0000000000a1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` from_number:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"+919876540110\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` custom_args_values:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` callee_name:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Priya\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` emi_amount:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"₹4,500\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` due_date:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"15 October\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }),`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`());`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`19`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`19`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` os`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`response `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.post(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://prod-api.ringg.ai/ca/api/v0/calling/outbound/individual\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"X-API-KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: os.environ[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"RINGG_API_KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` json`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Priya Sharma\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"mobile_number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"+919876543210\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"agent_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"00000000-0000-4000-8000-0000000000a1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"from_number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"+919876540110\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"custom_args_values\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"callee_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Priya\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"emi_amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"₹4,500\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"due_date\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"15 October\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(response.json())`})]}),`\n`]})})})]}),`\n`,_jsxs(Check,{children:[`The response echoes the values the call received in `,_jsx(_components.code,{children:`data.custom_args_values`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.a,{href:`/api-reference/calling/individual-calls/initiate-individual-call-v2`,children:`number pool version`}),` takes the same field.`]}),`\n`,_jsx(Heading,{level:`3`,id:`from-pre-call-tools`,children:`From pre-call tools`}),`\n`,_jsxs(_components.p,{children:[`A pre-call tool runs before the call starts. It can take a variable as an input (offered as `,_jsx(_components.code,{children:`custom_args.\u003cname>`}),`, for example to look up a customer by `,_jsx(_components.code,{children:`custom_args.mobile_number`}),`), and its selected response keys go into the prompt as `,_jsx(_components.code,{children:`@((tool_name.key))`}),`. Use this when the value lives in your system rather than in the CSV or API request. See `,_jsx(_components.a,{href:`/documentation/build-agents/customize-agent-behaviour/tools/overview`,children:`Tools`}),` and the `,_jsx(_components.a,{href:`/documentation/build-agents/customize-agent-behaviour/tools/api-tools#example-look-up-the-customer-before-the-call`,children:`look-up example`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`when-a-value-is-missing`,children:`When a value is missing`}),`\n`,_jsxs(_components.p,{children:[`The dashboard does not stop a test call with empty variables. A variable sent as an empty string becomes empty text. A variable that isn’t sent at all stays in the prompt as written, for example `,_jsx(_components.code,{children:`@{{due_date}}`}),`, and the call goes ahead.`]}),`\n`,_jsxs(_components.p,{children:[`Write the prompt so a missing value does not derail the call: “If the due date is not known, ask the customer to check their statement.” Or wrap the sentence in an `,_jsx(_components.a,{href:`/documentation/build-agents/customize-agent-behaviour/agent-prompt#if-condition-blocks`,children:`If Condition block`}),` that checks the variable `,_jsx(_components.strong,{children:`is not empty`}),`. That check works only when the variable is sent as an empty string: an unsent variable counts as not empty.`]}),`\n`,_jsx(Heading,{level:`2`,id:`variables-by-api`,children:`Variables by API`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/api-reference/agents/edit-assistant`,children:`Edit Assistant`}),` with `,_jsx(_components.code,{children:`\"operation\": \"edit_custom_vars\"`}),` sets the agent’s variable names in `,_jsx(_components.code,{children:`custom_variables`}),`, the same list the `,_jsx(_components.strong,{children:`Custom Variables`}),` panel shows. `,_jsx(_components.a,{href:`/api-reference/agents/create-agent`,children:`Create Agent`}),` takes `,_jsx(_components.code,{children:`custom_variables`}),` too.`]}),`\n`,_jsxs(_components.p,{children:[`The list you send replaces the agent’s list, so include every variable you want to keep, `,_jsx(_components.code,{children:`callee_name`}),` and `,_jsx(_components.code,{children:`mobile_number`}),` too: an outbound agent rejects a list without them with `,_jsx(_components.code,{children:`403`}),`. The API keeps names exactly as sent, so send them in lowercase snake_case.`]}),`\n`,_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`8`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`8`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` PATCH`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://prod-api.ringg.ai/ca/api/v0/agent/v1\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-API-KEY: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$RINGG_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"operation\": \"edit_custom_vars\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"agent_id\": \"00000000-0000-4000-8000-0000000000a1\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"custom_variables\": [\"callee_name\", \"mobile_number\", \"emi_amount\", \"due_date\"]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsx(AccordionGroup,{children:_jsx(Accordion,{title:`The agent says the variable name, or nothing, instead of the value`,id:`the-agent-says-the-variable-name-or-nothing-instead-of-the-value`,children:_jsxs(_components.p,{children:[`The call did not receive that variable. Check the call’s `,_jsx(_components.strong,{children:`Custom variables`}),` in `,_jsx(_components.a,{href:`/documentation/monitor/logs#the-call-panel`,children:`Logs`}),`, and make sure the key in `,_jsx(_components.code,{children:`custom_args_values`}),` or the CSV column matches the variable name exactly.`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next steps`}),`\n`,_jsxs(Columns,{cols:3,children:[_jsx(Card,{title:`Fetch data with tools`,icon:`wrench`,href:`/documentation/build-agents/customize-agent-behaviour/tools/overview`,children:_jsx(_components.p,{children:`Look up values before the call starts.`})}),_jsx(Card,{title:`Add a knowledge base`,icon:`book-open`,href:`/documentation/inventory/knowledge-base`,children:_jsx(_components.p,{children:`Let the agent answer from your files and web pages.`})}),_jsx(Card,{title:`Prepare a calling list`,icon:`list-checks`,href:`/documentation/deploy/campaigns/calling-list`,children:_jsx(_components.p,{children:`Fill variables for every contact from a CSV.`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Custom variables","sidebarTitle":"Custom variables","description":"Add custom variables to a Ringg AI agent, mention them in the prompt with @, and fill them per call by API, per contact from a campaign CSV, or from tools.","og:title":"Use custom variables to personalise every agent call","href":"/documentation/build-agents/customize-agent-behaviour/custom-variables"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Before you start","slug":"before-you-start","depth":2,"children":[]},{"title":"The two permanent variables","slug":"the-two-permanent-variables","depth":2,"children":[]},{"title":"Add a variable","slug":"add-a-variable","depth":2,"children":[{"title":"Naming rules","slug":"naming-rules","depth":3,"children":[]}]},{"title":"Use variables in the prompt","slug":"use-variables-in-the-prompt","depth":2,"children":[]},{"title":"Fill variables for each call","slug":"fill-variables-for-each-call","depth":2,"children":[{"title":"From a test call","slug":"from-a-test-call","depth":3,"children":[]},{"title":"From a campaign CSV","slug":"from-a-campaign-csv","depth":3,"children":[]},{"title":"From the API","slug":"from-the-api","depth":3,"children":[]},{"title":"From pre-call tools","slug":"from-pre-call-tools","depth":3,"children":[]}]},{"title":"When a value is missing","slug":"when-a-value-is-missing","depth":2,"children":[]},{"title":"Variables by API","slug":"variables-by-api","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[]},{"title":"Next steps","slug":"next-steps","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/ringgai-0da73d20/45c33e65ef05fabf/hairline.js"],"dynamicCss":".mint-w-full {\n width: 100%\n}\n.mint-rounded-xl {\n border-radius: 0.75rem\n}","subdomain":"ringgai-0da73d20","siteName":"Ringg AI","title":"Use custom variables to personalise every agent call","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-13T11:53:24.615Z","originalFileLocation":"documentation/build-agents/customize-agent-behaviour/custom-variables.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Add custom variables to a Ringg AI agent, mention them in the prompt with @, and fill them per call by API, per contact from a campaign CSV, or from tools.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Ringg AI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Use custom variables to personalise every agent call\">\u003cmeta data-mint-head property=\"og:description\" content=\"Add custom variables to a Ringg AI agent, mention them in the prompt with @, and fill them per call by API, per contact from a campaign CSV, or from tools.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ringg AI Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ringg.ai/documentation/build-agents/customize-agent-behaviour/custom-variables\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ringgai-0da73d20.mintlify.site/_mintlify/api/og/v2?division=Customize+agent+behaviour\u0026amp;title=Custom+variables\u0026amp;description=Add+custom+variables+to+a+Ringg+AI+agent%2C+mention+them+in+the+prompt+with+%40%2C+and+fill+them+per+call+by+API%2C+per+contact+from+a+campaign+CSV%2C+or+from+tools.\u0026amp;theme=737b8671029ef070100737b1\u0026amp;signature=5d74801addff257ed188deb69da7ce6ed16b765edcefa794cb201ad8428bda2d\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Use custom variables to personalise every agent call\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Add custom variables to a Ringg AI agent, mention them in the prompt with @, and fill them per call by API, per contact from a campaign CSV, or from tools.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ringgai-0da73d20.mintlify.site/_mintlify/api/og/v2?division=Customize+agent+behaviour\u0026amp;title=Custom+variables\u0026amp;description=Add+custom+variables+to+a+Ringg+AI+agent%2C+mention+them+in+the+prompt+with+%40%2C+and+fill+them+per+call+by+API%2C+per+contact+from+a+campaign+CSV%2C+or+from+tools.\u0026amp;theme=737b8671029ef070100737b1\u0026amp;signature=5d74801addff257ed188deb69da7ce6ed16b765edcefa794cb201ad8428bda2d\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Ringg AI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0A0A0B\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ringg.ai/documentation/build-agents/customize-agent-behaviour/custom-variables\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/documentation/build-agents/customize-agent-behaviour/custom-variables.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.ringg.ai/#organization\",\"name\":\"Ringg AI\",\"legalName\":\"Stoic AI Private Limited\",\"url\":\"https://www.ringg.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://assets.ringg.ai/images/logo/logo.svg\"},\"sameAs\":[\"https://x.com/ringg_ai\",\"https://www.linkedin.com/company/ringg\",\"https://www.youtube.com/@RinggAI\",\"https://www.instagram.com/ringg_ai\",\"https://discord.gg/YuEnb8Vsca\"]},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ringg.ai#website\",\"name\":\"Ringg AI\",\"url\":\"https://docs.ringg.ai\",\"publisher\":{\"@id\":\"https://www.ringg.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ringg.ai/documentation/build-agents/customize-agent-behaviour/custom-variables#webpage\",\"url\":\"https://docs.ringg.ai/documentation/build-agents/customize-agent-behaviour/custom-variables\",\"name\":\"Custom variables\",\"description\":\"Add custom variables to a Ringg AI agent, mention them in the prompt with @, and fill them per call by API, per contact from a campaign CSV, or from tools.\",\"dateModified\":\"2026-10-13T11:53:24.615Z\",\"isPartOf\":{\"@id\":\"https://docs.ringg.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ringg.ai/documentation/build-agents/customize-agent-behaviour/custom-variables#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ringg.ai/documentation/build-agents/customize-agent-behaviour/custom-variables#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Build agents\",\"item\":\"https://docs.ringg.ai/documentation/build-agents/agents/agent-types\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Customize agent behaviour\",\"item\":\"https://docs.ringg.ai/documentation/build-agents/customize-agent-behaviour/agent-prompt\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Custom variables\",\"item\":\"https://docs.ringg.ai/documentation/build-agents/customize-agent-behaviour/custom-variables\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.ringg.ai/documentation/build-agents/customize-agent-behaviour/custom-variables#article\",\"headline\":\"Custom variables\",\"name\":\"Custom variables\",\"description\":\"Add custom variables to a Ringg AI agent, mention them in the prompt with @, and fill them per call by API, per contact from a campaign CSV, or from tools.\",\"url\":\"https://docs.ringg.ai/documentation/build-agents/customize-agent-behaviour/custom-variables\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ringg.ai/documentation/build-agents/customize-agent-behaviour/custom-variables#webpage\"},\"dateModified\":\"2026-10-13T11:53:24.615Z\",\"publisher\":{\"@id\":\"https://www.ringg.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ringg.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ringg AI\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Ringg AI\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/documentation/build-agents/customize-agent-behaviour/custom-variables.md","siteName":"Ringg AI","nav":{"global":null,"tabs":[{"tab":"Get started","pages":[{"title":"Get started","href":"/get-started/introduction"}]},{"tab":"Documentation","pages":[{"title":"Ringg AI documentation","sidebarTitle":"Introduction","icon":"book-open","href":"/documentation/introduction"},{"group":"Build agents","icon":"bot","pages":[{"group":"Agents","pages":[{"title":"Agent types","sidebarTitle":"Agent types","href":"/documentation/build-agents/agents/agent-types"},{"title":"Create an agent","sidebarTitle":"Create an agent","href":"/documentation/build-agents/agents/create-an-agent"},{"group":"Multi-prompt agents","pages":[{"title":"Multi-prompt agents","sidebarTitle":"Overview","href":"/documentation/build-agents/agents/multi-prompt-agents/overview"},{"title":"Node types and connections","sidebarTitle":"Node types and connections","href":"/documentation/build-agents/agents/multi-prompt-agents/node-types-and-connections"},{"title":"Multi-prompt global settings","sidebarTitle":"Global settings","href":"/documentation/build-agents/agents/multi-prompt-agents/global-settings"},{"title":"Test and convert multi-prompt agents","sidebarTitle":"Test and convert","href":"/documentation/build-agents/agents/multi-prompt-agents/test-and-convert"}]},{"group":"WhatsApp agents","tag":"NEW","pages":[{"title":"WhatsApp agents","sidebarTitle":"Overview","href":"/documentation/build-agents/agents/whatsapp-agents/overview"},{"title":"Create a WhatsApp agent","sidebarTitle":"Create an agent","href":"/documentation/build-agents/agents/whatsapp-agents/create-an-agent"},{"title":"WhatsApp Flows","sidebarTitle":"Flows","href":"/documentation/build-agents/agents/whatsapp-agents/flows"},{"title":"Build WhatsApp Flows in Ringg","sidebarTitle":"Flow builder","href":"/documentation/build-agents/agents/whatsapp-agents/flow-builder"},{"title":"WhatsApp Flows with live data","sidebarTitle":"Flows with live data","href":"/documentation/build-agents/agents/whatsapp-agents/flows-live-data"},{"title":"Live data from your server","sidebarTitle":"Live data from your server","href":"/documentation/build-agents/agents/whatsapp-agents/flows-your-server"}]}]},{"group":"Customize agent behaviour","pages":[{"title":"Agent prompt","sidebarTitle":"Agent prompt","href":"/documentation/build-agents/customize-agent-behaviour/agent-prompt"},{"title":"Voice and language","sidebarTitle":"Voice and language","description":"Choose a Ringg AI agent's languages, pick or clone a voice, set its speed from 0.7x to 1.2x, boost keywords for speech recognition, and change them by API.","href":"/documentation/build-agents/customize-agent-behaviour/voice-and-language"},{"title":"Custom variables","sidebarTitle":"Custom variables","href":"/documentation/build-agents/customize-agent-behaviour/custom-variables"},{"title":"Attach a knowledge base","sidebarTitle":"Attach a knowledge base","description":"Attach or detach knowledge bases on a Ringg AI agent, mention them in the prompt with @, add query phrases, and test that the agent answers from your data.","href":"/documentation/build-agents/customize-agent-behaviour/attach-a-knowledge-base"},{"group":"Tools","pages":[{"title":"Tools","sidebarTitle":"Overview","href":"/documentation/build-agents/customize-agent-behaviour/tools/overview"},{"title":"API tools","sidebarTitle":"API tools","href":"/documentation/build-agents/customize-agent-behaviour/tools/api-tools"},{"title":"Integration tools","sidebarTitle":"Integration tools","href":"/documentation/build-agents/customize-agent-behaviour/tools/integration-tools"},{"title":"System tools","sidebarTitle":"System tools","href":"/documentation/build-agents/customize-agent-behaviour/tools/system-tools"},{"title":"Function tools and conditions","sidebarTitle":"Function tools and conditions","href":"/documentation/build-agents/customize-agent-behaviour/tools/function-tools-and-conditions"},{"title":"Post-call tools","sidebarTitle":"Post-call tools","href":"/documentation/build-agents/customize-agent-behaviour/tools/post-call-tools"},{"title":"Workspace tools","sidebarTitle":"Workspace tools","href":"/documentation/build-agents/customize-agent-behaviour/tools/workspace-tools"},{"title":"WhatsApp tools","sidebarTitle":"WhatsApp tools","tag":"NEW","href":"/documentation/build-agents/customize-agent-behaviour/tools/whatsapp-tools"}]},{"title":"Call settings","sidebarTitle":"Call settings","href":"/documentation/build-agents/customize-agent-behaviour/call-settings"},{"title":"Advanced Analysis","sidebarTitle":"Advanced Analysis","href":"/documentation/build-agents/customize-agent-behaviour/advanced-analysis"},{"title":"Event Subscription","sidebarTitle":"Event Subscription","href":"/documentation/build-agents/customize-agent-behaviour/event-subscription"},{"group":"Webhooks","pages":[{"title":"Webhook setup and errors","sidebarTitle":"Setup and errors","href":"/documentation/build-agents/customize-agent-behaviour/webhooks/setup-and-errors"},{"title":"Call events","sidebarTitle":"Call events","href":"/documentation/build-agents/customize-agent-behaviour/webhooks/call-events"},{"title":"WhatsApp chat events","sidebarTitle":"WhatsApp chat events","tag":"NEW","href":"/documentation/build-agents/customize-agent-behaviour/webhooks/whatsapp-chat-events"},{"title":"Webhook field reference","sidebarTitle":"Field reference","href":"/documentation/build-agents/customize-agent-behaviour/webhooks/field-reference"}]}]},{"group":"Test and improve","pages":[{"title":"Test an agent","sidebarTitle":"Test an agent","href":"/documentation/build-agents/test-and-improve/test-an-agent"},{"title":"Drafts and versions","sidebarTitle":"Drafts and versions","href":"/documentation/build-agents/test-and-improve/drafts-and-versions"}]},{"group":"Workflows","pages":[{"title":"Workflows","sidebarTitle":"Overview","href":"/documentation/build-agents/workflows/overview"},{"title":"Build a workflow","sidebarTitle":"Build a workflow","href":"/documentation/build-agents/workflows/build-a-workflow"},{"title":"Test and publish a workflow","sidebarTitle":"Test and publish","href":"/documentation/build-agents/workflows/test-and-publish"},{"title":"Workflow block reference","sidebarTitle":"Block reference","href":"/documentation/build-agents/workflows/block-reference"}]}]},{"group":"Inventory","icon":"package","pages":[{"title":"Knowledge base","sidebarTitle":"Knowledge base","href":"/documentation/inventory/knowledge-base"},{"group":"Tools (integrations)","pages":[{"title":"Connect an app","sidebarTitle":"Connect an app","href":"/documentation/inventory/tools-integrations/connect-an-app"},{"title":"Connect WhatsApp","sidebarTitle":"Connect WhatsApp","tag":"NEW","href":"/documentation/inventory/tools-integrations/connect-whatsapp"}]},{"group":"Phone numbers","pages":[{"title":"Phone numbers","sidebarTitle":"Overview","href":"/documentation/inventory/phone-numbers/overview"},{"title":"Buy or import a number","sidebarTitle":"Buy or import a number","href":"/documentation/inventory/phone-numbers/buy-or-import-a-number"},{"group":"Your own telephony","pages":[{"title":"Bring your own telephony","sidebarTitle":"BYOT overview","href":"/documentation/inventory/phone-numbers/your-own-telephony/byot-overview"},{"title":"SIP trunking","sidebarTitle":"SIP trunking","href":"/documentation/inventory/phone-numbers/your-own-telephony/sip-trunking"},{"title":"Plivo","sidebarTitle":"Plivo","href":"/documentation/inventory/phone-numbers/your-own-telephony/plivo"},{"title":"Exotel","sidebarTitle":"Exotel","href":"/documentation/inventory/phone-numbers/your-own-telephony/exotel"},{"title":"Twilio","sidebarTitle":"Twilio","href":"/documentation/inventory/phone-numbers/your-own-telephony/twilio"},{"title":"Telnyx","sidebarTitle":"Telnyx","href":"/documentation/inventory/phone-numbers/your-own-telephony/telnyx"},{"title":"InTalk","sidebarTitle":"InTalk","href":"/documentation/inventory/phone-numbers/your-own-telephony/intalk"},{"title":"Ameyo","sidebarTitle":"Ameyo","href":"/documentation/inventory/phone-numbers/your-own-telephony/ameyo"},{"title":"Ozonetel","sidebarTitle":"Ozonetel","href":"/documentation/inventory/phone-numbers/your-own-telephony/ozonetel"},{"title":"New provider requirements","sidebarTitle":"New provider requirements","href":"/documentation/inventory/phone-numbers/your-own-telephony/new-provider-requirements"}]},{"title":"Number pools","sidebarTitle":"Number pools","href":"/documentation/inventory/phone-numbers/number-pools"},{"title":"Inbound agent number","sidebarTitle":"Inbound agent number","href":"/documentation/inventory/phone-numbers/inbound-agent-number"}]}]},{"group":"Deploy","icon":"rocket","pages":[{"group":"Campaigns","pages":[{"title":"Campaigns","sidebarTitle":"Overview","href":"/documentation/deploy/campaigns/overview"},{"title":"Create a campaign","sidebarTitle":"Create a campaign","href":"/documentation/deploy/campaigns/create-a-campaign"},{"title":"Workflow campaign","sidebarTitle":"Workflow campaign","href":"/documentation/deploy/campaigns/workflow-campaign"},{"title":"Campaigns by API","sidebarTitle":"Campaigns by API","href":"/documentation/deploy/campaigns/campaigns-by-api"},{"title":"Calling list","sidebarTitle":"Calling list","href":"/documentation/deploy/campaigns/calling-list"},{"title":"Manage a campaign","sidebarTitle":"Manage a campaign","href":"/documentation/deploy/campaigns/manage-a-campaign"}]},{"group":"Web and apps","pages":[{"group":"Web widget","pages":[{"title":"Web widget","sidebarTitle":"Overview","href":"/documentation/deploy/web-and-apps/web-widget/overview"},{"title":"Web widget configuration","sidebarTitle":"Configuration","href":"/documentation/deploy/web-and-apps/web-widget/configuration"},{"title":"Web widget events","sidebarTitle":"Events","href":"/documentation/deploy/web-and-apps/web-widget/events"},{"title":"Chat mode","sidebarTitle":"Chat mode","href":"/documentation/deploy/web-and-apps/web-widget/chat-mode"},{"title":"Chat components","sidebarTitle":"Components","href":"/documentation/deploy/web-and-apps/web-widget/components"},{"title":"Chat component data","sidebarTitle":"Data","href":"/documentation/deploy/web-and-apps/web-widget/data"},{"title":"Chat component recipes","sidebarTitle":"Recipes","href":"/documentation/deploy/web-and-apps/web-widget/recipes"},{"title":"Web widget styling","sidebarTitle":"Styling","href":"/documentation/deploy/web-and-apps/web-widget/styling"},{"title":"Web widget launch checklist","sidebarTitle":"Launch checklist","href":"/documentation/deploy/web-and-apps/web-widget/launch-checklist"}]},{"group":"Mobile apps","pages":[{"title":"Mobile app install","sidebarTitle":"Install","href":"/documentation/deploy/web-and-apps/mobile-apps/install"},{"title":"Mobile widget configuration","sidebarTitle":"Configuration","href":"/documentation/deploy/web-and-apps/mobile-apps/configuration"},{"title":"Mobile widget events","sidebarTitle":"Events","href":"/documentation/deploy/web-and-apps/mobile-apps/events"}]}]},{"group":"WhatsApp","tag":"NEW","pages":[{"title":"Start a conversation","sidebarTitle":"Start a conversation","href":"/documentation/deploy/whatsapp/start-a-conversation"},{"title":"WhatsApp Relay","sidebarTitle":"Relay overview","href":"/documentation/deploy/whatsapp/relay-overview"},{"title":"WhatsApp Relay integration guide","sidebarTitle":"Relay integration guide","href":"/documentation/deploy/whatsapp/relay-integration-guide"},{"title":"WhatsApp Relay troubleshooting","sidebarTitle":"Relay troubleshooting","href":"/documentation/deploy/whatsapp/relay-troubleshooting"}]}]},{"group":"Monitor","icon":"chart-line","pages":[{"title":"Logs","sidebarTitle":"Logs","href":"/documentation/monitor/logs"},{"title":"Analytics","sidebarTitle":"Analytics","href":"/documentation/monitor/analytics"},{"title":"Evals","sidebarTitle":"Evals","href":"/documentation/monitor/evals"},{"title":"Alerts","sidebarTitle":"Alerts","href":"/documentation/monitor/alerts"}]},{"group":"Manage account","icon":"settings","pages":[{"title":"Members","sidebarTitle":"Members","href":"/documentation/manage-account/members"},{"title":"API key","sidebarTitle":"API key","href":"/documentation/manage-account/api-key"},{"title":"Billing","sidebarTitle":"Billing","href":"/documentation/manage-account/billing"},{"title":"Call limits","sidebarTitle":"Call limits","href":"/documentation/manage-account/call-limits"},{"group":"Ringg Spaces","pages":[{"title":"Ringg Spaces","sidebarTitle":"Overview","href":"/documentation/manage-account/ringg-spaces/overview"},{"title":"Create and manage Ringg Spaces","sidebarTitle":"Create and manage","href":"/documentation/manage-account/ringg-spaces/create-and-manage"},{"title":"Ringg Spaces by API","sidebarTitle":"Ringg Spaces by API","href":"/documentation/manage-account/ringg-spaces/ringg-spaces-by-api"}]}]},{"group":"Ringg Labs","icon":"flask-conical","pages":[{"group":"Parrot STT","pages":[{"title":"Parrot STT Python SDK","sidebarTitle":"Python SDK","href":"/documentation/ringg-labs/parrot-stt/python-sdk"},{"title":"Parrot STT on TrueFoundry","sidebarTitle":"TrueFoundry","href":"/documentation/ringg-labs/parrot-stt/truefoundry"}]}]}]},{"tab":"Analytics platform","pages":[{"title":"Analytics platform","href":"/analytics-platform/introduction"}]},{"tab":"API reference","pages":[{"title":"API reference","href":"/api-reference/introduction/quickstart"}]},{"tab":"Resources","menu":[{"item":"MCP server","description":"Let Claude, ChatGPT or Cursor work in your workspace, or search these docs","pages":[{"title":"MCP server","href":"/resources/mcp-server/docs-mcp-server/mcp-for-ai-assistants"}]},{"item":"Learn","description":"Lessons that build a payment-reminder system end to end","pages":[{"title":"Learn","href":"/resources/learn/all-lessons"}]},{"item":"Security","description":"How Ringg protects your data, and what to do on your side","pages":[{"title":"Security","href":"/resources/security/security"}]},{"item":"Changelog","description":"New features, API changes and new guides","pages":[{"title":"Changelog","href":"/resources/changelog/changelog"}]}],"pages":[{"title":"Resources","href":"/resources/mcp-server/docs-mcp-server/mcp-for-ai-assistants"}]}]},"basePath":"","title":"Use custom variables to personalise every agent call","buildId":"dpl_596ePT575z4qnAFksq1biRW97aLY","deploymentId":"dpl_596ePT575z4qnAFksq1biRW97aLY","dynamics":["07c022d89b","a74be98ba7","a9bb46feb3"],"chunks":["Frame-BXrZabKK.js","DynamicMarkdown-CtasenyM.js","zoom-image-lightbox-C5F0mVLH.js","lightbox-handle-r17bVUz3.js","Markdown-CwLx6PAg.js","clsx-C3kuh_dz.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CmKHfscc.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-U3mI6Ljh.js"]}