Loyalteez Documentation
Blockchain-powered loyalty rewards for chat communities — and beyond.
What is Loyalteez?
Loyalteez lets you reward your community members with LTZ tokens for engagement, participation, and loyalty. Members earn tokens for daily check-ins, voice chat, helpful contributions, and more — then spend them on perks you define.
Zero blockchain complexity — users don't need wallets or crypto knowledge. We handle everything.
Choose Your Path
I'm a Community Admin
You want to add loyalty rewards to your Discord server or Telegram group.
Discord: Setup Guide → (5 minutes)
Telegram: Setup Guide → (Coming Soon)
After setup, explore:
- Discord Admin Guides — Configure commands and events
- Telegram Admin Guides — Coming Soon
I'm a Developer
You want to build a custom integration or understand the API.
The Loyalteez API accepts HTTP POST from any platform. Discord and Telegram bots are our primary delivery, but you can integrate from anywhere.
- Platform Developers Guide — Build your own integration
- API Reference — Event handler, gas relayer, pregeneration
- MCP Server — AI-powered integration tools
Platform Roadmap
| Status | Platform | Description |
|---|---|---|
| NOW | Discord | Production-ready bot with 30+ commands, full features |
| COMING SOON | Telegram | Bot with core parity (in final testing) |
| FUTURE | HTTP POST | Games, apps, websites, shops — the API is universal |
Key Features
- Zero blockchain complexity — Users don't need wallets or crypto knowledge
- Gasless transactions — We cover all blockchain fees
- Automatic wallet creation — Wallets created on first reward
- Configurable events — Reward any action you define
- Streaks & multipliers — Encourage daily engagement
- Perks & redemption — Let users spend their tokens
- Analytics & KPIs — Track your program's performance
- Achievements — Gamified milestones beyond tokens
Discord vs Telegram
Both platforms have core feature parity:
| Feature | Discord | Telegram |
|---|---|---|
| Daily check-ins | ✅ | ✅ |
| Streak system | ✅ | ✅ |
| GM/GN detection | ✅ | ✅ |
| Leaderboards | ✅ | ✅ |
| Perks & redemption | ✅ | ✅ |
| Achievements | ✅ | ✅ |
Admin /config | ✅ | ✅ |
| Role-based bonuses | ✅ | ❌ (Telegram lacks roles) |
| Voice tracking | ✅ | ❌ (Different architecture) |
| Third-party bots | ✅ | ❌ (Discord ecosystem) |
| Reaction drops | ✅ | ❌ (Discord components) |
Architecture
Your Community (Discord/Telegram)
↓
Loyalteez Bot (detects events)
↓
Event Handler API (validates & processes)
↓
Reward Processor (creates wallets, distributes LTZ)
↓
User's Wallet (LTZ received automatically)
All powered by Cloudflare Workers for global, low-latency performance.
Getting Started Checklist
For Community Admins
- Create account at partners.loyalteez.app
- Generate Security Key in Partner Portal (Settings → Security)
- Add bot to your Discord server or Telegram group
- Run
/setupcommand with your Brand ID and Security Key - Configure events and rewards
- Create perks for users to redeem
For Developers
- Review Platform Developers Guide
- Generate Security Key in Partner Portal
- Implement HMAC signature authentication
- Test with Event Handler API
- Deploy your integration
Support
- Documentation: You're here! 📖
- Partner Portal: partners.loyalteez.app
- Discord Community: discord.gg/loyalteez
- Email: [email protected]
Next Steps
Community Admins:
- Discord Setup →
- Telegram Setup → (Coming Soon)
Developers: