ContentRunner Interaction (Stage) icon

ContentRunner Interaction (Stage)

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

Actions3

Update State

AI-generated

Summary

Update an existing ContentRunner interaction state with cursor and timing fields identified by Telegram chat+bot or by user+bot UUID.

Inputs

  • identifyBy — Method to identify the interaction: 'tg' (Telegram chat_id + bot_id) or 'uuid' (user_id + bot_id).
  • tgChatIdGet (required) — Telegram chat ID used to locate the interaction.
  • tgBotIdGet (required) — Telegram bot ID used to locate the interaction.
  • userId (required) — User ID (UUID) used to locate the interaction when identifyBy is 'uuid'.
  • botId (required) — Bot ID (UUID) used to locate the interaction when identifyBy is 'uuid'.
  • campaignIdFilter — Optional UUID to restrict the state query to a specific campaign.
  • continueOnNotFound — If true, the operation resolves instead of throwing when the interaction is not found.
  • currentCursorWelcome — Index of the last sent welcome message (updates cursor).
  • currentCursorMain — Index of the last sent main message (updates cursor).
  • welcomeLastPushedAt — Timestamp of the last sent welcome message (updates).
  • mainLastPushedAt — Timestamp of the last sent main message (updates).
  • nextWelcomePushAt — Planned time for the next welcome message.
  • nextMainPushAt — Planned time for the next main message.
  • welcomeEndedAt — End timestamp of the welcome sequence.
  • mainEndedAt — End timestamp of the main sequence.
  • leftAt — Timestamp when the user left the chat.
  • blockedAt — Timestamp when the bot was blocked.
  • welcomeLastMessageTelegramId — Telegram message ID of the last welcome message.
  • welcomeStrapiPushDocumentId — Strapi document ID for the welcome message.
  • mainLastMessageTelegramId — Telegram message ID of the last main message.
  • mainStrapiPushDocumentId — Strapi document ID for the main message.

Output shape

an array of interaction objects representing the updated user_bot_interactions record

If no fields are set the unchanged record is returned; the operation throws unless continueOnFail is true; errors are captured by Sentry.

Examples

Example 1: Update state for a Telegram interaction, setting next welcome push time

identifyBy=tg, tgChatIdGet=123456, tgBotIdGet=98765, nextWelcomePushAt=2025-04-01T12:00:00Z

Links

Discussion