Skip to main content

Admin Messages

Automated scheduling system for recurring community messages. Create templates and schedule them for delivery across your communities.

🎯 Overview​

The Admin Messages system allows group administrators to:

  • Create message templates with custom content and scheduling
  • Assign templates to multiple groups with independent timing
  • Share templates between communities
  • Track delivery statistics and manage assignments
Admin Only Feature

Admin Messages commands are only available to Telegram group administrators. Regular users cannot create or manage templates.

📋 Command Reference​

Template Management​

/createtemplate​

Create a new admin message template for your group.

Syntax:

/createtemplate "Title" "Content" hours [type]

Parameters:

  • Title - Template name (in quotes)
  • Content - Message content (in quotes)
  • hours - Send interval (1-8760 hours)
  • type - Optional category (general, quest, announcement, etc.)

Examples:

# Daily community reminder
/createtemplate "Daily Quest" "🎯 Complete your daily tasks!" 24

# Weekly announcement
/createtemplate "Weekly Update" "📅 Community updates and news" 168 announcement

# Social media promotion
/createtemplate "Follow Us" "🐦 Follow us on X: https://x.com/yourproject" 72 social

/listtemplates​

View all templates available for your group.

/listtemplates

Shows templates created for your group plus any you've created in other groups, with assignment status.

Assignment Management​

/assigntemplate​

Assign a template to your current chat.

Syntax:

/assigntemplate <template_id> [custom_hours]

Parameters:

  • template_id - ID from /listtemplates
  • custom_hours - Optional custom interval (overrides template default)

Examples:

# Use template's default interval
/assigntemplate 1

# Override with custom 12-hour interval
/assigntemplate 1 12

/unassigntemplate​

Remove a template assignment from your chat.

/unassigntemplate <template_id>

/listassignments​

View all active assignments for your current chat.

/listassignments

Shows which templates are scheduled for this chat, their intervals, and management options.

Testing​

/testtemplate​

Send a template message immediately for testing.

/testtemplate <template_id>

Sends the template content right away without affecting the regular schedule.

🔐 Permission System​

Who Can Do What​

Group Administrators Can:

  • ✅ Create templates for their group
  • ✅ Assign templates created FOR their current group
  • ✅ Assign templates THEY created in any other group
  • ✅ Manage and edit templates they created
  • ✅ Test templates in groups they admin

Cannot Do:

  • ❌ Assign templates created by OTHER admins in OTHER groups
  • ❌ Edit templates they didn't create
  • ❌ Access templates from groups they're not admin in
Why These Restrictions?

This permission model prevents unauthorized template sharing while still allowing legitimate use cases. Admins maintain control over content they create, and communities can't have external templates imposed without consent.

Template Sharing Rules:

  • Templates belong to the group where they were created
  • Admins can assign templates created FOR their current group
  • Admins can assign templates THEY created in any other group
  • Admins CANNOT assign templates created by OTHER admins in OTHER groups
  • Only creating group's admins can edit/delete templates

Permission Examples​

# Admin Alice in Community A creates template
/createtemplate "Daily Reminder" "Stay active!" 24
✅ Template 1 created for Community A

# Any admin in Community A can assign this template
/assigntemplate 1
✅ Template 1 assigned to Community A

# Admin Alice moves to Community B and can assign HER template
/assigntemplate 1  
✅ Template 1 assigned to Community B (Alice created it)

# Admin Bob in Community B CANNOT assign Alice's template
/assigntemplate 1
❌ Permission denied: Cannot assign this template

# But Bob can assign templates created FOR Community B
# (even if Alice created them while she was in Community B)

🕒 Scheduling System​

How Timing Works​

  • Independent Schedules: Each chat tracks its own timing per template
  • Flexible Intervals: 1 hour to 1 year (8760 hours) supported
  • Custom Overrides: Assignments can override template defaults
  • Smart Delivery: Uses existing bot selection logic

Scheduling Examples​

# Template with 24-hour default
/createtemplate "Daily" "Daily message" 24

# Assign with default timing (24h)
/assigntemplate 1

# Assign with custom timing (12h)  
/assigntemplate 1 12

💡 Best Practices​

Effective Template Content​

Clear and Engaging:

# Good: Specific and actionable
/createtemplate "Daily Quest" "🎯 Complete today's tasks:
• Check token price
• Share on social media  
• Invite a friend
Rewards reset in 24 hours! 🚀" 24

# Avoid: Vague or generic
/createtemplate "Update" "Things are happening" 24

Use Markdown Formatting:

  • Bold text for emphasis
  • Code blocks for addresses/commands
  • Links for external resources
  • Emojis for visual appeal

Optimal Scheduling​

Recommended Intervals:

  • Daily Reminders: 24 hours
  • Weekly Updates: 168 hours (7 days)
  • Social Promotion: 48-72 hours
  • Event Announcements: 12-24 hours

Avoid Spam:

  • Don't schedule more than 2-3 active templates per chat
  • Use intervals ≥ 6 hours to prevent message fatigue
  • Monitor community feedback and adjust timing

Template Organization​

Use Descriptive Titles:

# Good
"Daily Quest Reminder"
"Weekly Community Update" 
"Social Media Links"

# Avoid
"Template 1"
"Message"
"Update"

Categorize by Type:

  • quest - Gaming/task-related content
  • social - Social media promotion
  • announcement - Important updates
  • general - General community messages

🔄 Template Portability​

Moving Templates Between Communities​

Admin Messages supports moving your own templates between communities:

  1. Create templates in any community you admin
  2. Move between communities and assign your own templates
  3. Collaborate with other admins by creating templates for their groups
  4. Customize intervals per group as needed

Sharing Example​

# Admin Alice creates template in Community A
Community A: /createtemplate "Partnership Update" "🤝 Weekly partner highlights" 168
Community A: ✅ Template 5 created

# Alice moves to Community B and can assign her own template
Community B: /assigntemplate 5
Community B: ✅ Template 5 assigned (Alice created this template)

# Admin Bob in Community B cannot assign Alice's template
Community B: /assigntemplate 5  
Community B: ❌ Permission denied: Cannot assign this template

# But Alice can create a template FOR Community B that Bob can then assign
Community B: /createtemplate "Bob's Daily" "Content for Bob's group" 24
Community B: ✅ Template 6 created for Community B
# Now Bob can assign template 6 since it was created FOR his group

📊 Monitoring and Management​

Track Template Performance​

# View all assignments for current chat
/listassignments

# See available templates and their status
/listtemplates

# Test before going live
/testtemplate 1

Delivery Information​

Each assignment tracks:

  • Last Sent Time: When message was last delivered
  • Send Count: Total messages sent
  • Bot Used: Which bot instance delivered the message
  • Next Send: Calculated next delivery time

🚨 Troubleshooting​

Common Issues​

Template Not Sending

  1. Check if template is assigned: /listassignments
  2. Verify template is active: /listtemplates
  3. Confirm bot has send permissions in chat
  4. Check interval hasn't elapsed yet

Permission Denied

  • Only group administrators can manage templates
  • You can only edit templates created for your group
  • You can assign any template TO your group

Template Not Found

  • Use /listtemplates to see available template IDs
  • Templates may be deactivated by their creators
  • Cross-check template ID spelling/numbers

Getting Help​

Commands for Diagnostics:

/listtemplates     # See what's available
/listassignments   # See what's active
/testtemplate 1    # Test immediate delivery

Support Channels:

🎯 Real-World Examples​

Gaming Community Setup​

# Daily engagement
/createtemplate "Daily Quests" "🎮 Today's challenges:
• Complete 3 raids
• Share your best play
• Help a guild member
Rewards reset at midnight! 🏆" 24

# Weekly events
/createtemplate "Weekend Tournament" "⚔️ Weekend PvP Tournament!
Registration closes in 24 hours.
Prize pool: 1000 tokens 💰" 168

# Social growth
/createtemplate "Follow Friday" "📱 Follow Friday!
Help grow our community:
🐦 Twitter: @YourProject
📺 YouTube: YourChannel
💬 Discord: discord.gg/YourServer" 168

Token Community Setup​

# Price tracking reminder
/createtemplate "Check Charts" "📈 Time to check the charts!
Current price updates and analysis:
• DexScreener: [Link]
• Community discussion in main chat
• Remember: HODL and stay strong! 💎🙌" 12

# Community activities
/createtemplate "Community Goals" "🎯 Weekly community goals:
• 100 new Twitter followers
• 50 new Telegram members  
• 25 Discord participants
Let's hit these targets together! 🚀" 168

Development Community Setup​

# Development updates
/createtemplate "Dev Progress" "👨‍💻 Development Update:
This week's progress and upcoming milestones.
• Code reviews completed
• New features in testing
• Community feedback incorporated
Stay tuned for release notes! 🔧" 168

# Community contributions
/createtemplate "Contribution Call" "🤝 Community Contributions Welcome!
Help improve our project:
• Report bugs and issues
• Suggest new features
• Share feedback and ideas
• Contribute code or documentation
Together we build better! 💪" 72

Next Steps​