Verify humans before they join your Telegram group using World ID.
World Guard is a tool that ensures only real, verified humans can join specific Telegram groups. It uses World ID — a privacy-preserving identity protocol by Worldcoin — to perform proof of personhood without requiring KYC, emails, or any personal data.
When a user tries to join a protected Telegram group, they are redirected to a Mini app inside the World App, where they verify their humanity. Once verified, they’re allowed into the group. If they fail verification, access is denied. If verification isn’t complete within three minutes, the user is blocked for a set amount of time to prevent spamming.
This protects Telegram communities by:
Ideal use cases include:
By combining Sybil resistance, privacy, and a smooth user experience via the World Mini app, World Guard brings trust and authenticity to Telegram groups with no friction.
We integrated the World ID Mini App Kit SDK to obtain a user’s proof of uniqueness, which is then sent to our backend for verification. On the backend, we built a Telegram bot that tracks each user’s verification status per group and listens for the event of a user joining a group.
When a new user enters a protected Telegram group, the bot will first mute them and send a verification prompt via World Guard. This prompt includes a button with a deep link to the World Guard Mini App.
Once the user verifies their humanity using World ID and submits the proof to our backend, the bot will unmute them and grant full access to the group. If the user doesn’t complete verification within 3 minutes, World Guard will automatically remove them from the group.
To ensure each verification attempt is tied to the correct user and group, we set the signal parameter in the proof as a combination of the user’s ID and the group ID.