ContentRunner Interaction icon

ContentRunner Interaction

Link user+bot (creates empty campaign), Get state, or Update state

Actions3

Get State

AI-generated

Summary

Retrieves a user–bot interaction’s state from PostgreSQL, optionally restricted to a campaign. Identify the interaction by Telegram chat and bot IDs or by their UUIDs.

Inputs

  • Identify By (required) — Choose tg_chat_id + tg_bot_id or user_id + bot_id (UUID) to identify the interaction.
  • Telegram Chat ID (required) — Used when identifying by Telegram IDs; defaults to parsed.from_id, parsed.chat_id, or tg_chat_id from the input item.
  • Telegram Bot ID (required) — Used when identifying by Telegram IDs; defaults to botId or bot.id from the input item.
  • User ID (required) — User UUID, used when identifying by UUIDs; defaults to the input item's user_id.
  • Bot ID (required) — Bot UUID, used when identifying by UUIDs; defaults to the input item's bot_id.
  • Campaign ID — Optional campaign UUID to narrow the lookup. If omitted, the query returns the first matching interaction.
  • Continue On Not Found — Defaults to true. When no interaction is found, returns { found: false }; when false, raises an Interaction not found error.

Output shape

One output item per input item, containing the interaction record with found: true, or a not-found result.

The record includes interaction fields plus joined user, bot, and channel details; channel fields may be null. Lookup errors can also be returned as { error: ... } when the node's Continue On Fail setting is enabled.

Links

Discussion