Below is a walkthrough on how to add and configure the Collab.Land bot for your Telegram group.
Also included are a list of commands group administrators and members can use to interact with the bot.
Note: Screenshots have been taken from the Mac desktop application. The experience may be a little different on other operating systems.
Create A New Telegram Group
If you have an existing Telegram group, skip to Configure Your Group Settings.
At least one member will need to be added to your new group to proceed.
It is recommended to add the bot at a later time. If you add the bot now, you will need to manually start a conversation with it later.
Optional: Add a picture for your group icon by selecting the Camera icon.
Configure Your Group Settings
You'll need to make sure your group is set up to use the Collab.Land bot by editing your Group Settings.
If you have an existing Telegram group, start here.
Adding the Bot to your Group
Add @collablandbot to your new group. Please enter this username exactly. Others may try to imitate the bot.
The bot will need to be added after the group chat history has been set to visible. If not, it will automatically leave the group and ask to have the chat history setting updated.
Once the bot is added to your group, it will announce itself in chat as well as send a DM to provide admin options for your group.
If you have added the bot while creating the group, you will need to DM the command "/start" to @collablandbot to begin setting up admin options.
To access bot admin options, go back to your chat with @collablandbot, and either press the Start button at the bottom of the screen or type "/start" in the message composer.
When returning to the menu later this selection description will update to Group Admin.
If your group is not displayed, select Add Collab.Land To Group first.
Token Permissioned Chat
Token Permissioned Chat allows you to create an exclusive chatroom for members who hold a certain amount of your tokens.
One or more tokens can be configured in a group. When more than one token is configured, a member only needs to meet the requirement for one of the configurations. The bot continues to monitor your member's token holding in regular intervals. If a member no longer meets the requirement, for example they transfer the tokens out of their wallet, they will automatically be removed.
The group invitation link will also be displayed here. Use this link to invite members to your group after completing the setup.
Note: Token Permissioned Chat only checks to see if members have the minimum required amount of tokens in their connected wallet. We never remove these tokens from the wallet.
After a token permission has been configured, the option to delete will appear in the menu.
Simply select the configuration you wish to delete.
Update TPC Onboarding Message
Select this to update the direct message members receive from the bot when they first join the Token Permissioned Chat group.
Disable Group Welcome Message
The bot has a default message in chat when someone joins the group. You can turn this on or off from the Command Center.
Disable Group Goodbye Message
The bot has a default message in chat when someone leaves the group. You can turn this on or off from the Command Center.
Here you can set up an airdrop to distribute ERC20 tokens to your community.
Select Add Airdrop Configuration to proceed.
Save Private Key
To take back any remaining token or ETH from an Airdrop by seeing the private key to the admin wallet. You can then import the admin address into a wallet interface.
Returning to Airdrop Configuration
Once an airdrop has been configured, Selecting Air Hyperdrive (ERC20) will display an updated menu and the current configuration.
Add Airdrop Configuration
Will replace previous configuration.
Remove Airdrop Configuration (Disable)
This removes the airdrop configuration, effectively ending the event. Members can no longer claim the drop.
Reset Airdropped Users
Group members can only claim an airdrop once. This will reset the list of members who have already received the drop, allowing them to claim it once more.
Update Airdrop Message
|Connecting Your Wallet|
To leverage the Collab.Land bot, you will be asked to connect your wallet to the bot so it may verify you are the wallet owner.
For administrators, this is so your community can use Collab.Land features listed in the Admin Functions section. For members, this is so you can access Airdrops and Token Permissioned Chat.
For best results, make sure you are on your Telegram desktop app to complete these steps and you have already downloaded and setup MetaMask.
Note: MetaMask selections are to connect while on a desktop. For MetaMask Mobile please select WalletConnect.
When joining a token permission group for the first time, return to your messages from Collab.Land and select the Join Group button.
Telegram commands that you can use with the bot and in your group.
These can be accessed by typing "/" in the message composer in Telegram, or from the / button on Telegram mobile.
Commands sent to @collablandbot in DM:
Commands sent to @collablandbot in group:
Community members can send each other tips by using the “/tip” command
Enter /tip <@username> <number of tokens> <the token symbol)
The Collab.land Bot will DM the recipient to notify that a tip has been sent.
Members can DM the Bot the “/balance” command to view their total balance.
Use the “/tip tokens” command to display a list of tokens supported for tipping.
This can be entered in chat or as a DM to the bot.
Tipping Related Bot DMs
DM the bot the command "/balance" to view your current crypto balance within the community.
DM the bot the “/deposit” command to add funds to your balance without having to receive a tip.
Before sending funds from your wallet, make sure to update the depositor address by following the link.
Only transfer supported tokens all others will be lost.
Use the command /tip tokens for a list of supported tokens.
Updating the Depositor Address
This is the wallet address you will be using to send funds to your Collab.land wallet
DM the bot the “/withdraw” command to transfer funds from your balance to a wallet address.
Example: !withdraw DAI 0.5