Belong CheckIn
Telegram Bot & Mini App
Create events, browse hubs, link groups, and open the Belong Mini App from Telegram.
Overview
Belong's public Telegram bot lets organizers create event workspaces from chat, browse public events and hubs, link Telegram groups to hubs, configure event-week alerts, and open the Belong Mini App for app-level editing and signing.
Command reference
Private bot chat
| Commands | What you can do |
|---|---|
/start, /help, /status | See bot help, account state, active workspace, and chat ID |
/login you@example.com, /code 123456, /link YOURCODE, /unlink | Link or unlink a Belong account for organizer actions |
/events, /discover <search>, /hubs <search> | Browse public events and hubs |
/createevent <details>, /new-event, /wizard free, /wizard paid | Create an event from text, voice, media, or guided setup |
/switch, /miniapp, /spaces | Switch active workspace, open the Mini App, or link Telegram spaces |
/myevents, /myhubs, /campaigns [days], /eventstats EVENT_ID, /referral [EVENT_ID] | Linked-account organizer workflows |
/venue [HUB_ID], /approve | Review venue check-in status and pending approvals |
Linked hub group
| Commands | What you can do |
|---|---|
/chatid, /help, /hubinfo, /events, /checkin | Link a group to a hub and show hub/event/check-in guidance |
Event-week group
| Commands | What you can do |
|---|---|
/eventweek, /eventweek SLUG, /eventweek now, /eventweek off, /eventmap | Link a group to an event week, post overview/map updates, and disable alerts |
Telegram command menus can't contain hyphens, so menu entries use
/createevent. Aliases like /new-event still work when typed manually.The Mini App
/miniappsends a button that opens the Belong Mini App, signs you into Belong, and loads your Telegram workspace.- Post-create prompts include a link to the new event plus a button to open the Mini App.
- The Mini App is where app-level editing and signing happen from inside Telegram.
Linking a group to a hub
Hub operators can connect a Telegram group so the bot can post hub events and check-in guidance:
- Add the bot to your Telegram group
- Run
/chatidin the group - Save that chat ID in the hub's Telegram settings card
For event-week alerts, the person linking the group must be a group admin and must have linked a Belong account in private chat first.