Airdrop Campaign Bot

• 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.

• 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.

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.