Skip to main content

Message Template - FAQs

Getting Started & Navigation

Q1: How do I access the Message Template Management feature in Smart360? A: To access the template management system:

  • Navigate to the Communication Hub section in Smart360
  • Click on "Templates" from the left sidebar navigation menu
  • You'll see the template library showing all available templates organized by category
  • View template cards displaying key information like name, description, tags, and creation details

Q2: What is the Message Template Management System and what problems does it solve? A: The Template Management System provides a centralized solution for creating, organizing, and managing communication templates across multiple channels. It solves several key problems:

  • Standardization: Ensures consistent messaging across all customer communications
  • Efficiency: Eliminates the need to create templates from scratch for routine communications
  • Compliance: Maintains brand guidelines and regulatory requirements across all channels
  • Organization: Provides searchable, categorized template library for quick access

Q3: Which user roles can access and manage templates? A: Several user roles have access with different permission levels:

  • Utility Administrator: Full access to create, edit, approve, and manage all templates and categories
  • CSO Manager/Call Center Representative: Can use, suggest edits, and create draft templates requiring approval
  • Customer Service Executive: Can use templates and suggest improvements
  • Billing Manager: Full access to billing-related templates within their domain
  • Meter Manager: Full access to meter-related templates within their domain

Understanding Template Structure & Categories

Q4: What communication channels are supported for templates? A: Smart360 supports templates for four communication channels:

  • Email: Supports plain text, rich text, and HTML formatting with dynamic content
  • SMS: Plain text format with character limit monitoring (typically 160 characters)
  • WhatsApp: Plain text format optimized for WhatsApp messaging
  • In-App Notifications: Rich text format for notifications within the Smart360 application

Q5: What template categories are available and how should I use them? A: Template categories help organize templates by purpose:

  • Reports: Monthly usage reports, energy consumption summaries
  • Billing: Payment confirmations, invoice notifications, billing reminders
  • Notifications: Service outages, maintenance alerts, system updates
  • Onboarding: Welcome messages, account setup instructions, getting started guides
  • Alerts: Usage alerts, unusual consumption patterns, emergency notifications
  • Reminders: Appointment reminders, payment due dates, scheduled maintenance

Q6: What are the different template formats available? A: Three template formats are supported:

  • Plain Text: Simple text without formatting, ideal for SMS and basic notifications
  • Rich Text: Text with basic formatting (bold, italic, links) suitable for in-app notifications
  • HTML: Full HTML formatting with images, styling, and complex layouts for email communications

Creating New Templates

Q7: How do I create a new message template? A: To create a new template:

  • Click the "+ New Template" button in the top-right corner of the Templates page
  • Select your communication channel (Email, SMS, In-App, WhatsApp)
  • Choose template format (Plain Text, Rich Text, HTML)
  • Enter template name and description
  • Select or create a category for organization
  • Add relevant tags for searchability
  • Compose your template content using the editor
  • Insert placeholders using the "Insert Placeholder" button for dynamic content
  • Save as draft or create the final template

Q8: What information is required when creating a template? A: Required information for template creation includes:

  • Template Name: Must be unique within the same category and channel combination
  • Communication Channel: Must select exactly one channel (Email, SMS, WhatsApp, In-App)
  • Template Format: Must choose appropriate format for the selected channel
  • Category: Must be assigned to one of the predefined categories or create a new one
  • Description: Clear explanation of the template's purpose and use case
  • Content: Template message content with appropriate formatting

Q9: How do I use placeholders for dynamic content in templates? A: To add dynamic content placeholders:

  • Click the "Insert Placeholder" button while composing your template
  • Common Placeholders: {{customer.firstName}}, {{customer.lastName}}, {{account.number}}
  • Billing Placeholders: {{bill.amount}}, {{bill.dueDate}}, {{payment.confirmationNumber}}
  • Service Placeholders: {{service.type}}, {{appointment.date}}, {{outage.duration}}
  • Company Placeholders: {{company.name}}, {{company.phone}}, {{company.website}}
  • Example usage: "Dear {{customer.firstName}}, your bill of ${{bill.amount}} is due on {{bill.dueDate}}"

Q10: What are tags and how should I use them for template organization? A: Tags are keywords that help categorize and find templates:

  • Purpose Tags: "payment", "confirmation", "reminder", "welcome"
  • Department Tags: "billing", "service", "technical", "customer-care"
  • Urgency Tags: "urgent", "routine", "emergency", "scheduled"
  • Customer Type Tags: "residential", "commercial", "new-customer", "existing"
  • Usage: Add multiple relevant tags separated by commas when creating templates
  • Benefits: Enable quick filtering and searching across large template libraries

Finding & Managing Existing Templates

  • Use the search bar at the top of the Templates page
  • Search by Keywords: Enter template names, content keywords, or description terms
  • Search by Tags: Enter tag names to find templates with specific categories
  • Search by Creator: Find templates created by specific team members
  • Search by Content: Search within template content for specific phrases or terms
  • Results update automatically as you type for quick discovery

Q12: What filtering options are available for organizing templates? A: Multiple filtering options help narrow down template results:

  • Channel Filter: Show only Email, SMS, In-App, or WhatsApp templates
  • Status Filter: Display Published or Draft templates
  • Category Filter: Filter by Reports, Billing, Notifications, Onboarding, Alerts, or Reminders
  • Combined Filtering: Apply multiple filters simultaneously for precise results
  • Clear Filters: Reset all filters to view the complete template library

Q13: How do I view complete template details before using them? A: To review template information:

  • Click the "View" button on any template card
  • Review Template Details: See creation date, last update, tags, and category
  • Check Content: View complete message content with formatting
  • See Usage Statistics: Review how often the template has been used
  • Verify Placeholders: Confirm dynamic content fields are appropriate for your needs
  • Check Character Count: Ensure content fits within channel limits (especially for SMS)

Q14: How do I edit an existing template? A: To modify existing templates:

  • Locate the template using search or filtering
  • Click the "Edit" button on the template card
  • For Published Templates: System may show confirmation about where templates are being used
  • Make Changes: Modify content, category, tags, or placeholders as needed
  • Update Formatting: Adjust formatting for different channels if needed
  • Save Changes: Templates may require approval depending on your role and the template status
  • Version Control: System tracks who made changes and when for audit purposes

Template Usage & Best Practices

Q15: How do I use templates in my communications? A: To use templates for customer communications:

  • Select the appropriate template for your communication need during message composition
  • System Population: Smart360 automatically populates customer-specific data into placeholders
  • Review Content: Check that personalized content appears correctly
  • Make Adjustments: Customize any content that needs specific modifications
  • Send Communication: Deliver through the selected channel
  • Track Usage: System records the communication in customer history for future reference

Q16: What are character limits for different channels and how are they managed? A: Character limits vary by communication channel:

  • SMS: Typically 160 characters for single message (longer messages may be split)
  • WhatsApp: Optimal length under 1000 characters for best engagement
  • Email: No strict character limit, but shorter content often performs better
  • In-App Notifications: Character limit depends on display area and notification type
  • Visual Indicators: Template editor shows character count with warnings when limits are exceeded
  • Example: "Character count: 438/160 (limit exceeded)" for SMS templates

Q17: How do I create effective templates for different customer scenarios? A: Best practices for scenario-specific templates:

  • Welcome Messages: Include clear next steps, contact information, and helpful resources
  • Payment Reminders: Be polite but clear about amounts, due dates, and payment options
  • Service Outages: Provide specific timeframes, affected areas, and alternative contact methods
  • Appointment Confirmations: Include date, time, location, and preparation requirements
  • Usage Alerts: Explain the alert reason and provide actionable steps for customers
  • Test Templates: Preview with sample data to ensure clarity and completeness

Q18: How do I ensure my templates comply with brand guidelines and regulations? A: To maintain compliance:

  • Use Approved Language: Follow company tone and style guidelines
  • Include Required Elements: Add necessary legal disclaimers, opt-out instructions, or contact information
  • Character Limits: Respect channel-specific restrictions to ensure proper delivery
  • Placeholder Accuracy: Verify dynamic content fields populate correctly
  • Review Process: Submit templates for approval when required by your role
  • Regular Updates: Keep templates current with policy changes and rate updates

Template Collaboration & Workflow

Q19: How do draft templates work and when should I use them? A: Draft templates provide a staging area for template development:

  • Save as Draft: Use when template isn't ready for publication or needs approval
  • Collaboration: Allow team members to review and suggest improvements
  • Testing: Test templates with sample data before making them available
  • Approval Workflow: Submit drafts for review by authorized approvers
  • Revision Process: Make changes based on feedback before final publication
  • Draft Access: Only creators and authorized reviewers can see draft templates

Q20: Can I create variations of existing templates? A: Yes, template duplication helps create variations:

  • Duplicate Function: Create new templates based on existing ones as starting points
  • Variation Examples: Different versions for residential vs. commercial customers
  • A/B Testing: Create multiple versions to test effectiveness
  • Channel Adaptation: Adapt email templates for SMS or WhatsApp format
  • Seasonal Updates: Create time-specific versions of standard templates
  • Customization: Modify duplicated templates while maintaining consistent base messaging

Q21: How do I suggest improvements to existing templates? A: To contribute to template improvement:

  • Feedback Mechanism: Use comment and feedback features on templates
  • Create Variations: Develop improved versions as new draft templates
  • Document Issues: Note specific problems with current templates (clarity, effectiveness, errors)
  • Share Usage Data: Report on customer responses and template performance
  • Collaborate: Work with template owners and managers to implement improvements
  • Test Suggestions: Validate improvements with sample scenarios before recommending changes

Performance & Analytics

Q22: How can I track template performance and usage? A: Template analytics provide valuable insights:

  • Usage Statistics: See how often each template is used across the organization
  • Effectiveness Metrics: Track customer response rates and resolution success
  • Channel Performance: Compare how templates perform across different communication channels
  • User Adoption: Identify which templates are most popular with staff
  • Template Age: Review how long templates remain useful before needing updates
  • Department Usage: See which departments rely on specific template categories

Q23: How do I identify which templates need updating or replacement? A: To maintain template relevance:

  • Review Usage Data: Identify templates that are rarely used and may be outdated
  • Check Creation Dates: Focus on older templates that may need content updates
  • Monitor Performance: Replace templates with poor customer response rates
  • Gather Feedback: Collect input from users about template effectiveness
  • Regulatory Changes: Update templates when policies or regulations change
  • Technology Updates: Refresh templates when new features or services are available

Q24: What reports can I generate about template usage? A: Available reporting capabilities include:

  • Usage Reports: Show which templates are used most frequently by department or user
  • Performance Reports: Track success rates and customer satisfaction by template
  • Compliance Reports: Document template approval status and version history
  • Channel Analysis: Compare template effectiveness across communication channels
  • Trend Analysis: Identify patterns in template usage over time
  • ROI Assessment: Measure time savings and efficiency gains from template usage

Troubleshooting & Error Handling

Q25: Why am I getting validation errors when creating templates? A: Common validation issues and solutions:

  • Duplicate Names: Choose unique template names within the same category and channel
  • Missing Required Fields: Ensure all mandatory fields (name, description, category, content) are completed
  • Character Limits: Reduce content length to fit within channel-specific limits
  • Invalid Placeholders: Use correct placeholder syntax with proper formatting
  • Format Mismatch: Ensure template format is appropriate for selected channel
  • Create Button Disabled: Complete all required fields before the create button becomes active

Q26: What should I do if I can't edit a published template? A: Published template editing restrictions:

  • Version Control: Published templates require creating new versions rather than direct editing
  • Usage Warning: System shows where templates are currently being used before allowing changes
  • Approval Process: Template modifications may require approval based on your role
  • Impact Assessment: Consider how changes affect existing workflows and communications
  • Alternative Approach: Create a new version or draft copy for major changes
  • Coordination: Work with template administrators for system-wide template updates

Q27: How do I handle templates that exceed character limits? A: When templates are too long for channel constraints:

  • Content Editing: Remove non-essential words and phrases while maintaining message clarity
  • Channel Alternative: Consider using email format for longer content instead of SMS
  • Message Splitting: Break long templates into multiple shorter communications
  • Link Usage: Replace long explanations with links to detailed information
  • Placeholder Optimization: Ensure dynamic content doesn't cause length issues
  • Preview Testing: Use sample data to verify final message length stays within limits

Integration & Advanced Features

Q28: How do templates integrate with workflows and automated communications? A: Template integration enhances automation:

  • Workflow Selection: Choose templates when creating automated communication workflows
  • Dynamic Population: System automatically fills placeholders with relevant customer data
  • Multi-Channel Coordination: Use consistent templates across different channels in workflows
  • Trigger Integration: Templates activate based on specific customer actions or time-based triggers
  • Performance Tracking: Monitor how templates perform in automated vs. manual communications
  • Template Suggestions: System may recommend appropriate templates based on workflow context

Q29: Can I export or import templates for backup or sharing purposes? A: Template data management capabilities:

  • Export Functions: Download template content for backup or external analysis
  • Sharing Options: Share templates with team members or across departments
  • Backup Creation: Maintain copies of critical templates for disaster recovery
  • Template Libraries: Import approved templates from corporate template libraries
  • Version Archives: Export template versions for compliance and audit purposes
  • Cross-System Integration: Export templates for use in external communication systems

Q30: What are the best practices for organizing a large template library? A: Effective template library management:

  • Consistent Naming: Use descriptive, standardized naming conventions
  • Category Structure: Organize templates into logical categories that match business processes
  • Tag Strategy: Implement comprehensive tagging system for multiple search approaches
  • Regular Cleanup: Archive or delete outdated templates to maintain library quality
  • User Training: Ensure staff understand how to find and use templates effectively
  • Documentation: Maintain guides for template creation, approval, and usage processes
  • Performance Monitoring: Regularly review template usage and effectiveness metrics
  • Governance: Establish clear ownership and approval processes for template management
Back to top