TGCampaigner user guide

Create new session

• Enter a session name and phone number (international format).
• Click Send code to start sign-in.
• Enter Telegram code, then add 2FA password if required.
• Click Verify to finish. Session appears in the list.

Rename, delete, import

• Rename: choose existing session, type new name, click Rename.
• Delete: choose session, click Delete (local removal from your machine).
• Import: provide a folder path containing session files, click Import.

Telegram API credentials

• Open Sessions → API Setup.
• Paste API_ID and API_HASH from your Telegram developer app.
• Click Save API credentials.
• The app restarts the local backend automatically and keeps this on your machine.

If credentials are missing, TGCampaigner shows a yellow warning and asks you to complete API Setup.

Session proxy

• Select session, proxy type, host, and port.
• Add username/password when your proxy requires authentication.
• For MTProxy, add the proxy secret.
• Click Save proxy (the app runs a connectivity check before accepting it).
• Use Remove proxy to detach proxy from the selected session.

CSV Merge (Dedupe)

• Enter comma-separated CSV paths (example: data/a.csv,data/b.csv).
• Choose output file name (example: merged.csv).
• Click Merge to combine and remove duplicates.

Gather users

• Select the source session first.
• Enter a group / channel / discussion reference to scan.
• Choose output file name and click Gather Users.
• The exported CSV can be reused in Single, Multi, or workflow actions.

AI profiles

• Add one or more AI profiles (provider, model, API key, label).
• Use Fetch models to load the available model list from OpenAI, Gemini, or Groq.
• You can still type a model manually if you want a custom override.
• Use Set default for your main profile.
• Edit or delete profiles anytime from the same panel.
• Warmup actions use these profiles for reply/message modes.

DM preset

• Used by DM, Invite DM, Bulk Add, and Forward.
• Choose user limits, interval, and rate-limit behavior.
• Set safety caps (flood waits, consecutive errors).
• Enable strict timing when you need deterministic delays.

Warmup preset

• Set total messages and min/max delay range.
• Choose warmup modes: React, Reply, Message.
• Select context size and optional AI profile.
• Set an editable AI prompt template (default template is prefilled).
• Use Use conversation context to enable or disable history usage.
• Set Max words to control response length (default: 35).
• Use this preset in Single Warmup, Multi Warmup, or loop warmup nodes.

How to use presets well

• Create at least one conservative preset and one aggressive preset.
• Name presets clearly (for example: Low Risk 30m).
• Use one preset consistently for a test cycle before changing variables.

Create a loop

• Click New, set loop name (and loop id if needed).
• Add a Session node first (required start node).
• Add action nodes (Wait, DM, Invite, Bulk Add, Forward, Warmup).
• Link nodes in the desired run order.

Inspector usage

• Select any node to open its fields in the Inspector panel.
• Set preset and action inputs per node (CSV, message, targets, links, etc.).
• For Wait node, define min/max seconds between steps.

Save and execute

• Click Save before Start.
• Use Start to run and Stop to halt active loop execution.
• Use Saved loops to load or delete existing workflows.
• CSV behavior in loops: if two nodes use the same CSV, consumed users are shared and not reused in later nodes. Different CSV files stay independent.

Direct Message

• Pick preset, CSV file, and message text.
• Optional: media path, Spintax, AI Spintax variations.
• Click Start DM.

Invite Link DM

• Set CSV + invite URL + optional message/media.
• You can use [invite] token in message templates.
• Click Start Invite DM.

Bulk Add

• Set CSV and target group/channel reference.
• Choose preset and click Start Bulk Add.

Forward Message

• Set CSV + source peer, and either message ID or message link.
• Optional: drop author / contains media flags.
• Click Start Forward.

Profile Rotation

• Update first name, last name, bio, and/or photo path.
• Click Update Profile.

Warmup

• Add group targets and select a warmup preset.
• Prompt, context toggle, and max words are taken from that warmup preset.
• Run with Start Warmup.
• Targets should be groups, not personal chats.

Multi DM / Invite DM

• Set CSV + message (and invite URL for Invite mode).
• Optional media and Spintax options.
• Use Start Multi DM or Start Multi Invite DM.

Multi Bulk Add / Forward

• Bulk Add: CSV + target group.
• Forward: CSV + source peer + message link/id.
• Start with the matching Multi action button.

Multi Profile Rotation

• Set profile fields to apply across selected sessions.
• Set delay between sessions for safer pacing.
• Click Start Multi Profile.

Multi Warmup

• Set group targets and choose warmup preset.
• Prompt, context toggle, and max words are taken from that warmup preset.
• Run with Start Multi Warmup.

Operational snapshot

• See session count and currently running jobs.
• Use Refresh all for immediate state sync.
• Use stop buttons to halt running jobs from the UI.

Job tracking

• Review job status, job id, and any error message.
• Pick a specific job in Log Source to filter logs.
• Use Latest to watch newest activity.

Actions vs Audit

• Actions Log: run activity and operational steps.
• Audit Log: accountability-focused events and changes.

What you can see

• Current machine license key.
• Customer email and token expiry.
• Status (Active / Inactive).

Desktop updates

• Use Check now to see whether a newer app build is available.
• Use Install update inside the app when an update is offered.
• Relaunch after install so the app can finish its local integrity checks.

Clear local data (keep license)

• Recommended for troubleshooting.
• Removes local sessions/logs/runtime state.
• License stays active, so no reactivation needed.

Factory reset (clear data + license)

• Use only when you intentionally want a full clean machine state.
• After reset, you must activate license again.