Telegram Integration
Bring your own bot token (BYOB) to receive and send messages in WeKeKe.
Telegram connects through your own BotFather bot token. During connect, WeKeKe validates the token, registers a webhook for your account, and stores credentials encrypted at rest.
Prerequisites
- A Telegram account that can DM @BotFather.
- A Telegram bot created via BotFather.
- Your bot token from BotFather (for example: 123456789:AA...).
- A public HTTPS webhook base URL configured for your WeKeKe environment.
Create your bot with BotFather
Start BotFather
In Telegram search, open @BotFather and send /start.
Create bot credentials
Send /newbot, choose a display name, then choose a username ending in bot.
Copy your token
BotFather returns your API token. Copy it exactly and keep it private.
Optional: configure profile details
Use BotFather commands like /setdescription and /setuserpic so the bot is recognizable to fans.
Connect in WeKeKe
Open Integrations
Go to Integrations in the sidebar.
Click “Connect Telegram”
Paste your BotFather token in the connect modal.
Optional webhook base URL
If needed, enter a custom public origin (for example, staging domain or tunnel).
Confirm connected state
Look for a green “Connected” status and account handle in the card.
Inbound message behavior
- Telegram delivers messages to WeKeKe through the registered webhook.
- A user must start or message your bot first before the chat appears in Inbox.
- Incoming messages are stored and can trigger automation rules.
Security notes
- Bot tokens are encrypted at rest before being persisted.
- Webhook requests are validated with a secret token header.
- Disconnect removes the stored token and unregisters the webhook.
Troubleshooting
- 401 Unauthorized: rotate bot token via BotFather and reconnect.
- No inbox updates: check webhook URL reachability and secret mismatch.
- Webhook 404: verify your base URL points to the active deployment.
Account options roadmap
- Current: one connected Telegram bot account per creator.
- Planned: support additional Telegram bot accounts where operationally feasible.
- Final behavior depends on provider and webhook constraints in each environment.