Automations · Nodes · action

Ask WhatsApp interactive

action.whatsapp_ask_interactive · action

Send reply buttons or a list, wait for the tap, then continue on the matching option port.

When to use

  • Offer reply buttons or a list and continue on the matching option port.
  • Prefer Ask over send + wait when the answer should branch the workflow.
  • This is Automations interactive messaging — not Meta WhatsApp Flows.

Configuration

FieldRequiredNotes
accountIdnoChannel account; leave empty to use context when available
interactiveTypenobutton (reply buttons) or list
bodyTextnoMessage body; expressions allowed
headerTextnoOptional header (list); expressions allowed
footerTextnoOptional footer (list); expressions allowed
listButtonLabelnoCTA label on the list message
buttonsnoReply buttons: id (static) + title (max 3)
sectionsnoList sections with rows: id (static), title, optional description
interactivenoOptional power override — prefer buttons/sections in the portal
timeoutSecondsnoWait timeout in seconds (default 86400)

Inputs

Upstream node output and execution context (contact, account, variables).

Outputs

After the customer taps (or timeout): replyId, replyTitle, interactiveType, inboundMessageId, outboundMessageId / messageId, timedOut. Insert value paths use nodes.{id}.*.

Execute step (editor)

Eligible?Notes
DisabledNeeds multi-branch or wait/resume context — use a full Test run.

See Test, Execute, debug, listen and limitations.

Common errors

SymptomCauseFix
Interactive wait never resumesCustomer sent free text, or wrong contact/outbound correlationOnly button_reply / list_reply resume; set expected outbound message id when using wait-only.
INTERACTIVE_WAIT_CONFLICTAnother interactive wait is already open for this contactWait for the other run to finish or time out before opening another Ask/wait.
Send failed on Test/RunOutside window, bad template, or missing contactUse template outside window; ensure contact/account in context.
Execute succeeds but nothing deliveredExecute is dry-run for channel sendsUse full Test run / Run now.

Example

Message-received trigger → Ask interactive (2+ option ids) → connect each option / default / timeout → Publish → customer taps a button.

Related