• Map JSONPath expressions from API responses to widget field keys
  • Powers cards, lists, pickers, and forms in the chat UI
  • Use the auto-map suggester to bootstrap from sample API responses

​
Why response mapping?

Raw API JSON is rarely ideal for chat UI. Mapping translates:

​
Configure mapping

1

Probe your API

Use Test or Probe API with sample parameters to capture a real response body.
2

Suggest mappings

Run Suggest response mapping: the platform proposes JSONPath rows from your widget field keys.
3

Review and save

Adjust paths manually for nested or array fields. Save and re-test in Playground.

​
Common patterns

The web embed renders mapped widgets automatically. In the React Native SDK, NavigationCard renders natively and other widgets show a JSON fallback. See Actions & UI payloads.

Skills

Webhook steps that create HTTP actions.

Actions & UI payloads

How embeds consume UI payloads.