Troubleshooting

A practical guide for when the setup looks right but the result is still wrong.

Use this guide to troubleshoot the most common issues teams hit while configuring actions, flows, variables, message output, and AI chat behavior.

Automation

When an automation does not run as expected

  • Check that the endpoint URL is correct.
  • Check that the method matches the tenant API.
  • Check that auth is complete.
  • Check that the customer details are being sent to the correct place in the request.
Flows

When a flow does not produce the value you expected

  • Check that the step actually saves a value under the name you expect.
  • Check that later steps use the same saved name.
  • Check input mapping if the flow variable name and action field name differ.
  • Check output mapping if later steps depend on specific returned values.
Messages

When placeholders show up literally instead of being replaced

If the customer sees something like {{final_order_status}} in the message, the flow probably never saved that value under that name or the placeholder spelling does not match the saved variable exactly.

Returned Values

When custom returned values do not work

The current implementation supports simple dot-path access only. Use paths like normalized.data.status or response.detail. Do not assume advanced JSONPath syntax is supported.