RAW Action icon

RAW Action

Envia actions de volta para o RAW via callbackUrl.

Register Transaction

AI-generated

Summary

Register an external transaction for a chat by POSTing a REGISTER_TRANSACTION action to the RAW callback endpoint. RAW can route the session to the configured next step when the result arrives; an optional waiting message is included while it is pending.

Inputs

  • Callback URL / Environment (required) — For node version 1, provide the callback URL, defaulting to meta.callbackUrl from the input item. For version 2, choose Automatic (uses the input item’s meta.callbackUrl), Homologation, Production, or Custom (provide the complete callback URL).
  • Client ID (required) — Identifies the RAW client; defaults to meta.clientId from the input item.
  • Chat ID (required) — Identifies the chat; defaults to meta.chatId from the input item.
  • Bot ID — Optional bot identifier; when provided, RAW uses that bot’s configuration.
  • Next Step — Optional session step update sent with the action; it does not navigate the session. The transaction’s required Next Step is separately used when the result arrives.
  • Next Sub Step — Optional session substep update sent with the action.
  • External URL (required) — URL of the external service to call for the transaction.
  • Payload (JSON) — JSON payload sent with the transaction; defaults to {}.
  • Next Step (transaction result) (required) — Step RAW calls when the transaction result arrives.
  • TTL (Seconds) — Transaction time to live in seconds; defaults to 300.
  • Waiting Message — Optional message sent to the user while waiting for the transaction result.

Output shape

One output item per input item, containing the RAW callback response.

On success, each item has { "ok": true, "operation": "registerTransaction", "response": ... }; a null callback response is represented as null. With Continue On Fail enabled, errors produce { "error": "..." }; otherwise execution fails for the affected item. The node sends a POST request to the resolved callback URL with client and chat identifiers and a REGISTER_TRANSACTION action.

Links

Discussion