Actions3
Link
AI-generatedSummary
Link a Telegram user to a bot, upserting user, bot, channel and creating an empty campaign record.
Inputs
- tgChatId (required) — Telegram chat ID to link (e.g., from parsed payload)
- tgBotId (required) — Telegram bot ID to link
- userFirstName — User's first name
- userLastName — User's last name
- userUsername — User's Telegram username
- userLanguageCode — User's language code
- userSharedContact — User's shared contact phone number
- botUsername — Bot's username
- strapiCampaignId — Strapi campaign documentId to reuse existing campaign (e.g., from Campaign Select Message: meta.campaign_documentId)
- channelId — Channel/chat ID (e.g., Telegram channel external_id) to store in user_bot_interactions
- channelTitle — Optional channel/chat title to store in channels.title
- channelType — Optional chat type to store in channels.chat_type: 'private', 'group', 'supergroup', or 'channel'
Output shape
array of objects each containing json (the retrieved interaction details) and pairedItem (input index)
Each element corresponds to one input item; the array is returned even for a single processed item.
Examples
Example 1: Link a new user to a bot using Telegram chat and bot IDs
Provide tgChatId and tgBotId, optionally fill user name fields and channel info, then run the node with operation=Link.
Example 2: Link using an existing Strapi campaign ID
Set strapiCampaignId to reuse a campaign, fill required chat and bot IDs, then execute with operation=Link.