Collecting details

Most actions need a few details from the visitor — a date, an order number, an email. You define these as data inputs, and the chatbot collects them conversationally before running the action.

Defining inputs

For each input, set:

• Name — a short identifier (letters, numbers, underscores), e.g. preferred_date.
• Type — text, number, or yes/no.
• Description — what it is, e.g. "The date the visitor would like".

Using inputs in the request

Insert any input into your URL, headers, or body with double curly braces:

https://api.yourtool.com/appointments?date={{preferred_date}}

Values are URL-encoded in the URL and safely escaped in JSON bodies, so special characters won't break the request.

Reserved names

verified_email and verified_user_id are reserved — they're filled in by IntegrioChat from a verified identity and can't be collected from the visitor. This is what stops the model being tricked into using someone else's identity.