FAQ: passing variables to the agent
How does a field from a V2 request get into an agent variable?
How does a field from a V2 request get into an agent variable?
data[] row:- Common fields:
phone_numberandtypenever become variables;gender_voiceandlanguagego to the agent as variables under their own names. - A schema field with no entry in the map goes as is, under the field name.
- An Into a variable entry renames the field to the selected agent variable; Do not pass means the field is not sent.
- An empty value takes the entry’s fallback value; with no fallback the key is not passed, and the agent’s default for the variable applies. Order: value from the request → fallback → agent default → empty.
foreign_idreaches the agent only through an Into a variable entry.- The core writes
rl_todaylast — the campaign day asDD.MM.YYYY; it overrides a request field with the same name.
{{name}}.Where to look: the campaign card → the contact → the expanded Contact variables row; the call panel → Data → Variables passed to the agent.The agent speaks {{amount_due}} literally or stays silent in place of the variable
The agent speaks {{amount_due}} literally or stays silent in place of the variable
amountDue vs debt_sum). What to do: add an Into a variable entry pointing to the right variable.Cause 3. The value arrived empty, there is no fallback, and the agent has no default. What to do: set a fallback value on the field (only str with a minimum length of 0) or a default for the variable in the agent.The campaign is not created and the client gets «Internal error, try again later», although the script is saved
The campaign is not created and the client gets «Internal error, try again later», although the script is saved
The agent does not see foreign_id
The agent does not see foreign_id
foreign_id is not passed to the agent. Add an Into a variable entry on the foreign_id field.The date in rl_today is «wrong»
The date in rl_today is «wrong»
rl_today is the campaign day, not the upload date. A request that arrives 5 minutes or less before the end of the campaign day creates a campaign for tomorrow, and rl_today holds tomorrow’s date.If the agent needs the date of the call itself, use the platform variables today or call_date: the platform sets them on every call.The agent uses the wrong voice and language, although gender_voice and language are passed
The agent uses the wrong voice and language, although gender_voice and language are passed
{{gender_voice}} and {{language}} or with separate agents for each option. The adapter does not switch them.The script is not saved: «field is reserved by the platform»
The script is not saved: «field is reserved by the platform»
phone, mobile, cell, msisdn, timezone, the contract group and role headers — or one of the four common fields. Rename the variable in the agent and the entry in the map.An extra or missing key in a request row
An extra or missing key in a request row