3
Commands
Telegram Integration
Telegram bot integration is included in your codebase.
ShipAI.today ships a production-ready Telegram bot setup out of the box: webhook route, DMs and group mentions, slash commands, file attachments, and billing-aware upgrade flows.
Webhook-drivenBilling-aware
4
Capabilities
4
Outcomes
Slash Commands
Built-in/upgrade
Get a secure payment link to upgrade your plan
/plan
Show your current subscription and renewal period
/usage
Display usage vs limits: chats, searches, storage
Bot Capabilities
ActiveDM & Group support
Responds to DMs directly; groups on @mention
Attachment processing
Upload files, images - injected into AI context
Billing integration
Signed upgrade links tied to your Telegram identity
Payment success notify
Bot sends confirmation when checkout completes
Outcomes You Get In Production
Same AI, any channel
Telegram bot reuses buildChatStream - identical AI power via webhook, no separate pipeline.
Identity-mapped users
Telegram accounts map to internal users via DB-backed providerId - full billing context preserved.
Secure upgrade flow
HMAC-signed upgrade links with expiry - tamper-proof payment path triggered directly in chat.
Payment notifications
Successful checkout sends a Telegram message - users know the moment their plan activates.
End-to-end flow
- 1
Telegram sends update to POST /api/webhooks/telegram
- 2
Webhook validates secret token and resolves mapped internal user
- 3
Message is processed through shared buildChatStream execution
- 4
Slash commands (/upgrade, /plan, /usage) return account-aware results
- 5
Billing events generate signed and expiring upgrade links
- 6
Checkout success triggers a Telegram confirmation message
Security guarantees
- Webhook authenticity enforced via secret token validation
- Identity mapping persisted with providerId=telegram
- Upgrade links are HMAC-signed and expiration-protected
- Chat path reuses internal server-side pipeline and auth checks