Unlock Guides


How to Token-gate Telegram with Unlock Protocol and Guild.xyz


Here’s how to token-gate a Telegram chat with Unlock Protocol and Guild.xyz in minutes.

In a related guide, we showed you how to token-gate a Discord server using Unlock and Guild.xyz.

Today, we’ll show you how to token-gate a Telegram chat with Unlock as well.

Before jumping into Guild and Telegram, make sure you have set up a lock from the Unlock dashboard. Remember the name of your lock.

Create a Guild

Now, create a guild on Guild.xyz. Connect your wallet, name your guild, give it a description, and select Telegram.

Telegram Setup

Now, open Telegram and start a new chat.

First, add the Guild bot (@guildxyz_bot) to your Telegram chat.

Then, in Telegram, configure the settings to allow the Guild bot to manage the chat.

Adjust the chat settings (set to Public, add a name, click “Done,” then set the chat back to Private and click “Done”).

Set the Guild bot as an admin on the chat.

After you’ve done the above, there will be a chat ID in the Telegram chat. (It’ll look something like -12345678.) Copy the chat ID, hop back over the the Guild.xyz site, paste the chat ID into the box, and save.

Ok! The Telegram side is in good shape now.

Back to Guild.xyz

Head back over the the Guild.xyz site, and set up the token gate using an Unlock lock.

Save your updates, and you should be all set!

To invite someone to the token-gated chat, direct them to the Guild site for your guild. When someone attempts to join, Guild will manage the process and, if the visitor has the correct Unlock key in their wallet, Guild will link the new member over to the Telegram chat for you, seamlessly.

That’s it! You now have a token-gated Telegram chat.


In February 2022, Guild’s Reka and Raz joined the Unlock Developer Meetup and shared more thoughts!

Was this article helpful?

Table of Contents