nmdc-telegramfrontend/README.txt

43 lines
1.3 KiB
Plaintext
Raw Normal View History

2018-06-03 06:24:08 +00:00
A bot to synchronise chat between an NMDC/ADC hub and a Telegram supergroup.
2018-06-03 03:27:50 +00:00
2018-06-03 06:24:08 +00:00
Tags: NMDC
Written in Go
## FEATURES
- NMDC/ADC support
- Exclude messages from multiple hub nicks (e.g. hub-security, any helper bots that are unnecessary given telegram's features)
2018-06-03 06:24:08 +00:00
- Standalone binary
## SETUP
2018-06-03 03:27:50 +00:00
2018-06-03 06:24:08 +00:00
Create a new telegram bot
2018-06-03 03:27:50 +00:00
- Use BotFather to create a new bot
2018-06-03 06:24:08 +00:00
- Use BotFather to disable its privacy mode for group chats
2018-06-03 07:15:16 +00:00
- Use BotFather to add commands. Recommendation:
`
setup - List available commands
userlist - List native online users
quit - Leave the group chat
`
2018-06-03 03:27:50 +00:00
2018-06-03 06:24:08 +00:00
Create a telegram group
2018-06-03 03:27:50 +00:00
- Manually create a group chat and add the bot to it
- Convert group chat to supergroup
- Grant bot to be an administrator (including ability to add more administrators)
- Settings > "Who can add members" > Only administrators
- Create an invite link
2018-06-03 06:24:08 +00:00
Handover to nmdc-telegramfrontend
2018-06-03 03:27:50 +00:00
- Run this bot with no -GroupChatID, to learn the groupchat ID
- Post a test message in the group chat, to discover the groupchat ID
2018-06-03 06:24:08 +00:00
- Leave the group chat (long press on mobile, can't do it on desktop)
2018-06-03 03:27:50 +00:00
- Run this bot with -GroupChatID for normal operation
2018-06-03 06:24:08 +00:00
## USAGE
Chat with the bot to enter/leave the synchronised channel.
Sometimes the telegram invite links can take a few minutes to activate, especially if there has been unusual activity (e.g. frequent join/parts)