Template

Emoji Captcha Verification

Keeps bots and spam accounts out. New users of your bot, or new members of your group, must tap the right emoji before they continue. In a group, newcomers stay muted until they pass.

Who it's for: For owners of bots and Telegram groups hit by spam accounts and scripted joins. It runs inside Telegram, needs no extra service, and a real person passes in seconds.

  1. /start
  2. Press the โžก๏ธ Apple
    ๐ŸŒ๐Ÿ‡๐Ÿ’
    ๐Ÿ‹๐ŸŽ๐Ÿ‰
  3. ๐ŸŽ
  4. โœ… Verified! Welcome โ€” let's continue.
A new user proves they are human

How it works

  • Someone sends /start in a private chat, or joins your group โ€” the challenge appears immediately
  • They see a short prompt like "press the โžก๏ธ Apple" with a shuffled grid of emoji, and tap the one you asked for
  • A wrong tap shows a brand-new grid, not the same one again, so they can't just memorize it โ€” they get 3 tries
  • In your group, new members are muted the moment they join and stay muted until they pass or the 5-minute clock runs out
  • Pass, and the challenge message disappears and they move straight into your welcome message
  • Fail โ€” three wrong answers, or time runs out in a group โ€” and the bot removes them from the group automatically; in a private chat it simply stops there and they can send /start again

Setup requirements

  • For the group gate: add your bot to the group, then promote it to admin and turn on the "Restrict members" permission โ€” without it, joins are invisible to the bot and it can't mute or remove anyone.
  • Press Deploy to put the flows live on your bot.
  • Test both paths: send /start to the bot yourself in a private chat, and have a second (test) account join the group, to see the challenge and confirm a correct answer passes you through.
  • Adjust to taste: how many emoji options appear, the grid width, how many attempts are allowed, the time limit, and what happens on failure (kick, mute, or just stop there).

Details

Good to know

  • Works as two separate flows so you can use either or both: a private /start check, and a group join gate.
  • In your group, the bot needs to be an admin with the "Restrict members" permission โ€” that's what lets it mute new members while they're being checked and remove them if they fail. Without that permission, Telegram won't even tell your bot when someone joins.
  • The group gate can only run one challenge at a time per group โ€” if several people join in the same moment, they're checked one after another rather than all at once. For a very high-traffic group, the private /start version scales better.
  • In private chats there's no muting or kicking involved โ€” a failed captcha just stops there, and the person can send /start again to retry.
  • The number of emoji options, the grid width, how many attempts are allowed, the time limit, and what happens on failure are all editable settings in the visual editor โ€” no code involved.
  • The challenge text itself shows up in the visitor's own Telegram language automatically (Russian or English); you only need to touch it if you want a custom intro line.

Common questions

  • Should the captcha run in private chat, on group joins, or both?
  • How many wrong attempts should someone get before failing?
  • What should happen when someone fails: remove them from the group, mute them, or just stop them from continuing?

Keep in mind

  • Don't rely on the group gate for a very high-traffic group โ€” only one challenge runs at a time per group, so simultaneous joins queue up rather than running in parallel.
  • The group gate does nothing without admin rights: double-check "Restrict members" is granted before you count on it to protect a live group.

The flow behind this bot

This is the whole flow you get. Once you add the template, you can change any message, button or step.

Read-only preview ยท 2 flowsOpen full-screen preview โ†—

Ready to build on this?

Clone the template into your workspace and edit every message, button and action โ€” nothing is locked.