Airdrop Campaign Bot

Run your own airdrop inside Telegram instead of renting an airdrop platform. A captcha keeps farm accounts out, a verified channel-join task plus X and website tasks pay points, personal referral links reward only real activity, and payout wallets are validated for your network. When the campaign ends you freeze points with one button, export the wallet list as a CSV, distribute the tokens yourself, and open claims with a second button — and the contact base stays yours.

• Invite links: set botUsername in Variables (your bot's username, without @) — personal referral links are built from it.
• Campaign links: fill channelHandle, xProfileUrl and siteUrl in Variables if you skipped them during setup.
• Channel access: make the bot an admin of your campaign channel, or the join task will always fail.
• Economics: review pointsPerTask (100 by default) and pointsPerReferral (50) and set the numbers you actually want to pay.
• Admin access: open Contacts → your own contact → set isAdmin = yes. That unlocks /stats with live participant, task and wallet counters.
• Test it: deploy the bot and walk the whole path yourself — /start → captcha → tasks → /wallet.
• Close the campaign: run the 🏁 End campaign operation. Points freeze and the snapshot announcement goes out with a last-chance wallet prompt.
• Export the payout list: give stragglers a few days, then go to Contacts, add the filter walletAddress is not empty, and press Export. You get a CSV with one row per participant — wallet address, points and referral count included.
• Distribute: send the tokens from that CSV with your own multisend or distribution tool. FlowCastle never touches the chain.
• Open claims: paste your claim link into the claimUrl variable and run the 📤 Open claims operation — every participant with a wallet on file gets notified.

• A participant sends /start and solves an emoji captcha. Farm accounts and bots stop here; everyone who passes gets a task menu and a reminder drip.
• They join your Telegram channel — this task is really verified, the bot asks Telegram whether the person is a member — and gets points for it.
• They follow your X account and visit your site. These two are honor-confirm tasks (X has no follow-check API), and they also pay points.
• They invite friends with a personal link. The inviter is paid referral points only after the friend passes the captcha and completes a real task — so self-invites and farms earn nothing.
• They submit a payout wallet. The address is validated for your network (TON, EVM or Solana), and the bot warns against exchange deposit addresses. Reminders stop as soon as a wallet is on file.
• Anyone can check their status (points, tasks, referrals, wallet), check eligibility against your snapshot list, and you can pull live campaign counters with /stats.
• You end the campaign with one button — the 🏁 End campaign operation freezes points and sends everyone the snapshot announcement with a last-chance wallet prompt.
• You export the payout list: Contacts → filter walletAddress is not empty → Export. The CSV holds each participant's wallet, points and referral count — that file is what you feed into your distribution tool.
• You distribute the tokens yourself (the bot never touches the chain), then paste your claim link into claimUrl and run 📤 Open claims — every wallet holder gets messaged.

Good to know

• Make the bot an admin of your channel — without that Telegram will not tell it who is a member, and the join task can never pass.
• The X-follow and website tasks are honor-confirm: X exposes no way to verify a follow. The channel-join task IS verified, so it carries the real anti-fraud weight.
• The bot never touches the blockchain. It collects, validates and stores addresses; you send the tokens from the exported CSV with whatever tool you already use.
• Everything the campaign collects lives on your Contacts page — points, task state, referral count and wallet are ordinary contact variables you can filter, segment, broadcast to and export at any time.
• Referral crediting is farmproof by design: captcha first, credit only after the invited person completes a real task, and one credit per person maximum.
• The endgame is two prepared one-click operations, so nothing has to be assembled by hand on the day the campaign closes.
• The eligibility checker compares a submitted wallet against your allowlist (the eligibleWallets variable) — paste your snapshot there, or point the check at your own API.

Common questions

• Can I try it before copying it? Yes — @top_airdrop_bot is a live bot running this exact template. Press start and walk the participant path yourself.
• Do participants need crypto knowledge? Only a wallet address at the end. The bot checks the address format for your network and warns people not to submit an exchange deposit address.
• How do I actually pay people? You export the wallet list from Contacts as a CSV and distribute with your own tool — the bot handles collection, verification and messaging, never the transfer.
• What do I keep when the campaign is over? The whole contact base: points, referral counts and validated wallets, all still subscribed to your bot and ready for your next announcement.
• Can I change the tasks? Yes — every message, button, point value and task is editable after you copy the template, and you can add or remove task flows.

Keep in mind

• No fake-claim mechanics — this template is for projects running their own honest campaign, so state your token terms plainly.
• Don't pay referrals on signup alone; the built-in flow credits an inviter only after the invited friend completes a real task.