Follow these simple steps to create your gated chat. Setup usually takes about 5 minutes.
Open Telegram and create a private group chat.
Open “Manage group” and change “Chat history for new members” to Visible.
Open group settings and select Manage group
Change the chat history setting to visible and save.
In settings, open permissions and disable the “Add members” permission.
Invite microcosmbotdotxyz_bot
to your group by following the invite link https://t.me/microcosmbotdotxyz_bot?startgroup=true
and selecting your chat in the prompt.
Add the bot with the default Admin permissions. The bot requires at least “Ban users” and “Invite users via link” permissions.
Adding an admin with default permissions is sufficient.
Now setup your token gate rules by opening DM to the bot https://t.me/microcosmbotdotxyz_bot
Type in /settings
A list of active chat groups will appear. Click on your chat group, and open link to configure your group.
Don’t share this link with anyone.
Choose the chain your group is associated with. A group can be associated with only one chain. To request support for your chain, DM me on twitter @microcosmbot.
Select a chain with the chain dropdown. The current chain has a green check.
Add an access rule to your group. You can create a Hodl, Staked, or Native Token rule. Hodlr Rules are for SG721 token gating. Staked rules are for Dao Dao staked NFT token gating. Native token rules are for gating based on native denomination and osmosis token factory balance.
Click on Add access rule near the bottom of the page
Select the access rule type. Multiple rules can be combined to customize your gating.
To create a Hodl rule, click Hodl. Enter your NFT SG721 contract address and the number of tokens required to enter the group. Save.
To create a Dao Dao rule, click Staked. Enter your Dao Dao contract address. Your dao must be configured for NFT voting. If so, you will see the name of your NFT voting collection appear next to a green check.
Enter your Dao Dao contract address. It must use a stargaze NFT collection in the voting module.
To create a Native Token rule, click Native Token. Enter your native token denom name and minimum balance and optional maximum balance. Example ustars with minimum of 25000 stars could be used to create a telegram chat for users with at least 25000 ustars. Native Tokens rules include staked amount in the balance. Note: only a limited number of
Token Factory Denomination Name must be the fully qualified name.
Add more access rules if desired. If adding more than one rule, decide if you want to support “Match any”. When Match any is unchecked (default) users must pass all rules in order to gain access to your chat. When Match any is selected, chat users only need to pass at least one rule to gain access to your telegram chat. An example for using Match Any— you have a Dao Dao for your NFT collection, and you want to invite members who stake their NFT OR members who just hold the NFT without staking. You can add two access rules and select Match Any to invite both groups of members.
You’re all done setting up your chat. Get your group chat invite link by sending /invite
in chat in your new group chat to @microcosmbot. Share this link to any potential members. To join a group, a user must following the link and verify their wallet. If they pass your access rules, they will get a personal invite link to join your group.