ContentRunner Get State (Stage) icon

ContentRunner Get State (Stage)

Get user_bot_interactions state by tg_chat_id + tg_bot_id or by user_id + bot_id

ContentRunner Get State (Stage)

AI-generated

Summary

Fetch interaction state by user‑bot identifier, returning match info or a not‑found flag.

Inputs

  • identifyBy — Method to identify the interaction: either by Telegram chat/bot IDs (value "tg") or by internal user/bot UUID (value "uuid").
  • tgChatId (required) — Telegram chat identifier of the user.
  • tgBotId (required) — Telegram bot identifier.
  • userId (required) — Numeric Telegram user ID.
  • botId (required) — Telegram bot ID (UUID).
  • campaignId — Optional UUID to filter results to a specific campaign.
  • continueOnNotFound — If true, the node returns {found:false} when no interaction is found instead of throwing.

Output shape

an array of result items

Each result item contains a json field that is either {found:false} when no interaction matches (if continueOnNotFound true), an error object on failure, or {found:true, ...row} on success where row includes interaction and related user/bot/channel fields.

Examples

Example 1: Lookup interaction by Telegram chat ID and bot ID

identifyBy=tg, tgChatId=12345, tgBotId=67890, continueOnNotFound=true

Example 2: Lookup interaction by internal UUIDs

identifyBy=uuid, userId=111111, botId=222222, campaignId=3f4e5a6b

Example 3: Handle missing interaction gracefully

identifyBy=tg, tgChatId=123, tgBotId=456, continueOnNotFound=true (returns {found:false})

Links

Discussion