CSAT survey node (request_csat)

How to automatically send a satisfaction survey to the contact from a workflow with the Request CSAT survey node.

Jun 26, 2026

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: true and 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.
Was this helpful?

Related articles

Message us on WhatsApp