Node: Request CSAT
How to use the Request CSAT node to trigger a satisfaction survey on demand from a workflow.
Watch this step in the video · Conversation actions
The Request CSAT survey step (subtype request_csat) sends the satisfaction survey from a workflow, at the moment you choose. It uses the same send as the inbox button (Tools → "Send satisfaction survey") and the survey's automatic triggers, so all three behave the same and two surveys never arrive in the same conversation.
You will find it in Workflows, in the left palette, under Actions (star icon).
When to use it
- When the automatic send is not enough: e.g. one week after a case is resolved (with a wait step before it) or after a purchase completes.
- To ask for a rating under a condition: only for certain tags, teams or channels.
- For the usual case (ask on resolve or on close) you do not need a workflow: pick the trigger in Settings → Satisfaction survey.
Requirements
- A survey created and active in Settings → Satisfaction survey. There is one per workspace and the step always uses it; the panel shows which one and warns you if it is turned off.
- A trigger with a conversation (e.g. "Conversation marked as resolved", "Conversation closed" or "Message received") if you use the "In the same conversation as the trigger" channel.
Settings
- Survey: read-only, "Uses the workspace survey". There is no selector anymore; if an old workflow had a survey picked, it is ignored and the workspace survey is used.
- Channel:
- In the same conversation as the trigger (default): the survey goes out in that conversation, even if it is already resolved or closed, and does not reopen it.
- On a specific channel: uses an open conversation on the chosen channel or opens one (the contact must be linked to that channel).
- Start a new conversation on a channel: always opens a new conversation to send it (proactive CSAT).
What happens in each case
- Sent: the step result has
sent: trueand the message id. - Skipped, no error: if a survey was already sent in that conversation or the customer already answered. The workflow continues.
- Fails with the reason: survey turned off or missing, voice channel, blocked contact, or 24-hour window closed.
24-hour window
On WhatsApp, Instagram, Messenger and TikTok it is only sent within 24 hours of the customer's last message. The survey is a free-form message: outside that window WhatsApp only allows approved templates, so the step fails with that reason. A long wait before the step may let the window close.
Troubleshooting
Open the workflow and click Trace to see what each step did and the exact reason.
- "The satisfaction survey is turned off": turn it on in Settings → Satisfaction survey ("Survey active"). Turning it off stops every send, including manual and workflow ones.
- "The trigger does not provide an active conversation for the contact": the trigger has no conversation; switch the channel to "On a specific channel" or "Start a new conversation on a channel".
- "More than 24 hours have passed since the customer's last message": you can send it once the customer writes again.
- Skipped: it had already been sent (by the button, a trigger or another workflow) or the customer already answered.
Related articles
-
Build your first workflow
Omnifox workflows automate your operation: a trigger starts the automation and action nodes do the work. Build a welcome message in minutes.
-
Workflow triggers catalog
Learn which events can start a workflow automatically in Omnifox.
-
Workflows complete guide
Workflows in depth, in 54 chapters: triggers, nodes, variables, testing, history, templates, import and export, with every setting explained and a real workflow end to end.
-
Action nodes available in workflows
Discover the actions a workflow can run automatically.
-
Conditions and branching (if/then) in a workflow
Make your flows take decisions and follow different paths based on each contact data.