SMS Configuration
Configure how your Cloud-PBX handles SMS messages including routing, templates, delivery options, and user preferences.
Overview
SMS Settings control message handling, routing, templates, and delivery preferences for your text messaging system.
Key Configuration Areas:
- Phone Numbers: Manage SMS-enabled numbers
- Routing Rules: Direct messages to queues/agents
- Templates: Pre-written message templates
- Auto-Responses: Automated replies
- Delivery Options: Timing, retries, notifications
- User Preferences: Per-user SMS settings
- Compliance: Opt-out management, consent tracking
Phone Number Management
Assign Phone Numbers
Configure which phone numbers are active for SMS:
Configuration:
Phone Numbers:
+15551234567 → Sales Queue
+15559876543 → Support Queue
+18005551234 → General Inquiries
+15552468135 → After-Hours TeamSettings Per Number:
- Display Name: How number appears to agents ("Sales SMS Line")
- Default Queue: Where messages route by default
- Business Hours: Active hours for this number
- Auto-Response: Enable/disable automated replies
- MMS Enabled: Allow multimedia messages
- Recording: Log all conversations
Best Practices:
- Dedicate numbers to specific purposes (sales, support, billing)
- Use memorable numbers for marketing (vanity toll-free)
- Keep number count manageable (avoid confusion)
- Document each number's purpose
- Monitor usage per number
Individual Number Configuration
General Settings:
- Active: Enable/disable number
- Label: Internal name ("Main Support Line")
- Department: Associated department
- Status: Active, Inactive, Testing
Message Handling:
- Incoming Messages: Route to queue or agent
- Overflow: Backup destination if primary unavailable
- Business Hours: Operating schedule
- After Hours: Different routing outside hours
- Holiday Schedule: Special routing on holidays
Features:
- Two-Way SMS: Enable conversations (vs broadcast only)
- MMS Support: Allow image/video messages
- URL Shortening: Automatically shorten links
- Delivery Receipts: Track message delivery
- Read Receipts: See when customer reads (if supported)
Limits:
- Rate Limit: Maximum messages per second (carrier limit)
- Daily Cap: Max messages per day per number
- Character Limit: 160 (SMS) or 1600 (MMS)
- Attachment Size: Maximum file size for MMS
Carrier Rate Limits
Long codes typically limited to 1 message/second per number. Exceed this and messages queue or fail.
Number Pool Configuration
Use multiple numbers for high-volume sending:
Pool Setup:
SMS Pool: "Marketing Campaigns"
Numbers in Pool:
+15551111111
+15552222222
+15553333333
+15554444444
+15555555555
Distribution: Round-robin
Rate Limit: 1 msg/sec per number = 5 msg/sec total
Use Case: Promotional campaignsDistribution Methods:
- Round-Robin: Cycle through numbers sequentially
- Random: Randomly select from pool
- Least-Used: Use number with lowest recent volume
- Geographic: Match sender/recipient area code if possible
- Sticky: Same customer always gets same number
Benefits:
- Higher aggregate throughput
- Better deliverability (avoid carrier throttling)
- Redundancy if number fails
- Geographic distribution
- Regulatory compliance (separate marketing/transactional)
Configuration:
- Create pool: Settings → SMS → Number Pools → Add Pool
- Name pool: "Sales Outreach"
- Add numbers to pool
- Select distribution method
- Set pool purpose (marketing, transactional, two-way)
- Save and assign to campaigns/queues
Routing Rules
Configure intelligent message routing:
Basic Message Routing
Default Queue Assignment:
All SMS to +15551234567 → Sales Queue
All SMS to +15559876543 → Support Queue
All SMS to +18005551234 → General QueueConfiguration Steps:
- Navigate to Settings → SMS → Routing
- Select phone number
- Choose Default Destination:
- Specific Queue
- Specific Agent
- Department
- Auto-attendant (if configured)
- Set Overflow Destination (if primary unavailable)
- Save configuration
Simple Routing Example:
Phone Number: +15551234567
Primary Route: Sales Queue
Overflow: General Support Queue
After Hours: Auto-response only (no routing)Advanced Routing Rules
Keyword-Based Routing: Route based on message content:
Message contains "SALES" → Sales Queue
Message contains "SUPPORT" or "HELP" → Support Queue
Message contains "BILLING" → Billing Queue
Message contains "STOP" → Opt-out list (no routing)
Message contains "START" → Opt-in, route to General QueueSender-Based Routing: Route based on sender phone number or customer record:
Customer VIP status → Priority Queue
Existing customer → Account Manager
New number → Lead Generation Queue
Previous conversation with Agent X → Route to Agent XContent Analysis Routing: Use AI/NLP to analyze message intent:
Sentiment: Angry → Escalation Queue
Intent: Purchase → Sales Queue
Intent: Question → Support Queue
Intent: Complaint → Management Queue
Urgency: High → Priority QueueConfiguration:
- Settings → SMS → Advanced Routing
- Click Add Routing Rule
- Define conditions:
- Keyword match (exact, contains, regex)
- Sender criteria (CRM status, history)
- Time conditions
- Content analysis (if enabled)
- Set destination (queue, agent, department)
- Set priority (1-10, higher = processed first)
- Save rule
Rule Priority: Rules processed in order. First match wins:
Priority 1: VIP customers → VIP Queue
Priority 2: Contains "URGENT" → Priority Queue
Priority 3: Contains "BILLING" → Billing Queue
Priority 4: Business hours → Support Queue
Priority 5: After hours → Auto-response (no routing)
Default: General QueueTime-Based Routing
Business Hours Routing:
Monday-Friday 9 AM - 6 PM:
Route to → Sales Queue
Agents available → Distribute to available agents
All busy → Queue with position announcement
Monday-Friday 6 PM - 9 AM:
Route to → After-hours auto-response
Message: "Thanks for contacting us. We're closed but will respond tomorrow."
No human routing
Saturday-Sunday:
Route to → Weekend team
Reduced staffing
SLA: 4-hour response
Holidays:
Route to → Holiday auto-response
Message: "We're closed for [Holiday]. We'll respond on [Date]."
Urgent: Include emergency contact numberConfiguration:
- Settings → SMS → Business Hours
- Define schedules:
- Regular: Monday-Friday business hours
- Extended: Includes evenings/weekends
- 24/7: Always-on routing
- Holidays: Special days
- Assign schedule to each phone number
- Configure behavior per schedule period:
- Route to queue
- Route to specific agents
- Auto-response only
- Forward to another number
- Save configuration
Time Zone Handling:
- Use customer's time zone if known
- Default to business time zone
- Respect quiet hours (no sends before 8 AM or after 9 PM local)
Message Templates
Pre-written responses for common scenarios:
Template Categories:
Greeting Templates:
Welcome: "Hi [Name], thanks for contacting [Business]! How can we help today?"
Off-Hours: "Thanks for your message. We're currently closed but will respond during business hours (Mon-Fri 9am-6pm)."
First Contact: "Hello! We received your inquiry. An agent will respond within 15 minutes."
Response Templates:
Confirmation: "Your appointment on [Date] at [Time] is confirmed. Reply C to confirm or R to reschedule."
Shipping: "Your order #[OrderNum] has shipped! Track at [Link]. Expected delivery: [Date]"
Payment: "Payment of $[Amount] received. Thank you! Receipt sent to [Email]."
Feedback: "How was your experience? Rate us 1-5 by replying with a number."
Resolution Templates:
Solved: "Great! Is there anything else we can help with today?"
Escalated: "I've escalated your issue to our [Team] team. They'll contact you within [Time]."
Follow-up: "Checking in on your issue from [Date]. Has this been resolved?"
Closing: "Thanks for contacting us! Reply anytime if you need more help."
Compliance Templates:
Opt-In: "Reply YES to receive SMS updates from [Business]. Standard rates apply."
Opt-Out: "You've been unsubscribed from SMS. Reply START to resubscribe or visit [URL]."
Help: "For support call 555-1234 or visit [URL]. Reply STOP to unsubscribe."
Template Variables:
[Name]: Customer first name[FullName]: Customer full name[Business]: Your business name[AgentName]: Responding agent's name[Date]: Appointment/order date[Time]: Appointment/order time[OrderNum]: Order number[Amount]: Payment amount[Link]: Tracking/information URL[Phone]: Business phone number
Template Management:
-
Create Template:
- Go to Settings → SMS → Templates
- Click Add Template
- Name: "Appointment Confirmation"
- Category: Confirmations
- Content: Enter template with variables
- Save
-
Use Template:
- In message compose screen
- Click Templates button
- Search or browse categories
- Select template
- Variables auto-filled from context
- Edit if needed, send
-
Template Best Practices:
- Keep under 160 characters when possible
- Include business name
- Clear call-to-action
- Professional but friendly tone
- Test with real phone numbers
- Update regularly based on effectiveness
Auto-Responses
Automated replies to incoming messages:
Automatic Welcome Messages
First Contact Auto-Response:
Trigger: First message from new number
Response: "Hi! Thanks for contacting [Business]. An agent will respond shortly. Business hours: Mon-Fri 9am-6pm."
Delay: Immediate (0 seconds)
Follow-up: Route to queue after sendingBusiness Hours Welcome:
Trigger: Message received during business hours
Response: "Thanks for your message! You're in the queue. Current wait: ~3 minutes. Agent will respond soon."
Delay: 30 seconds (if no agent response yet)After-Hours Auto-Response:
Trigger: Message received outside business hours
Response: "We've received your message but are currently closed (Mon-Fri 9am-6pm). We'll respond when we reopen. For urgent issues, call 555-1234."
Delay: Immediate
Follow-up: Don't route to queue (no agents available)Configuration:
- Settings → SMS → Auto-Responses
- Enable Auto-Response: Toggle on
- Welcome Message: Enter text (160 char max recommended)
- Trigger Condition: First contact, business hours, after hours
- Delay: Immediate, 30s, 1min, 5min
- Apply to Numbers: Select which numbers use this auto-response
- Save
Keyword-Triggered Responses
Common Keywords:
"STOP" → "You've unsubscribed from SMS. Reply START to resubscribe or call 555-1234."
"START" → "Welcome back! You'll now receive SMS updates from [Business]."
"HELP" → "For support: Call 555-1234, email [email protected], or visit website.com/help"
"HOURS" → "We're open Mon-Fri 9am-6pm, Sat 10am-4pm. Closed Sunday."
"LOCATION" → "We're at 123 Main St, Anytown, USA. Map: [Google Maps Link]"
"MENU" → "Options: HOURS (business hours), LOCATION (address), HELP (support)"Custom Keywords:
"PRICING" → "View pricing at website.com/pricing or reply with your phone number for a quote."
"DEMO" → "Schedule a demo: website.com/demo or reply with your preferred date/time."
"STATUS" → "Check order status: website.com/orders or reply with your order number."Setup Process:
- Settings → SMS → Keyword Auto-Responses
- Click Add Keyword
- Keyword: Enter trigger word (case-insensitive)
- Match Type:
- Exact: Message must be exactly "STOP"
- Contains: Message contains "STOP" anywhere
- Starts with: Message starts with "STOP"
- Response: Enter auto-response text
- Action:
- Send response only
- Send response + route to queue
- Send response + trigger workflow
- Special actions (STOP = opt-out, START = opt-in)
- Active: Enable/disable keyword
- Save
Required Keywords
"STOP" and "HELP" keywords are required by law (TCPA compliance) in the United States.
AI-Powered Auto-Responses
Smart Auto-Response: Use AI to generate contextual responses:
Capabilities:
- Understand customer intent
- Provide relevant information from knowledge base
- Answer common questions automatically
- Escalate complex questions to humans
- Maintain conversational context
Example Interaction:
Customer: "What are your hours on Saturday?"
AI: "We're open Saturday 10am-4pm. Can I help with anything else?"
Customer: "Do you offer delivery?"
AI: "Yes, we offer delivery! Free for orders over $50, $5 for orders under $50. Delivery typically within 2 hours."
Customer: "I need to cancel my appointment"
AI: "I can help with that! To cancel, I'll need to connect you with our scheduling team. One moment please..." [Escalates to agent]Configuration:
- Settings → SMS → AI Auto-Response
- Enable AI Responses: Toggle on
- Confidence Threshold: 70% (AI only responds if 70%+ confident)
- Knowledge Base: Link to FAQ/knowledge articles
- Escalation Rules:
- Complex questions → Route to agent
- Low confidence → Route to agent
- Customer requests human → Route to agent
- After 3 AI messages → Offer human agent
- Business Context:
- Business name, hours, services
- Common questions and answers
- Policies (returns, shipping, etc.)
- Tone: Professional, friendly, casual (select style)
- Save
Best Practices:
- Start with high confidence threshold (80%+)
- Monitor AI responses regularly
- Add to knowledge base based on questions
- Have human review for first week
- Adjust confidence threshold based on accuracy
- Always allow easy escalation to human
AI Learning
AI improves over time by learning from agent responses and customer interactions.
Delivery Options
Configure message sending preferences:
Timing Options:
- Immediate: Send instantly
- Quiet Hours Respect: Don't send before 8 AM or after 9 PM local time
- Business Hours Only: Queue messages sent outside hours, deliver when open
- Scheduled: Send at specific date/time
- Optimal Time: AI determines best send time per recipient
Retry Logic:
Initial Send → Fails
Wait 1 minute → Retry
Wait 5 minutes → Retry
Wait 15 minutes → Retry
After 3 failures → Mark as failed, alert admin
Delivery Notifications:
- Sent: Message accepted by carrier
- Delivered: Message received by device
- Failed: Delivery failed (invalid number, carrier rejection)
- Undelivered: Temporary failure (device off, no signal)
URL Shortening:
- Automatically shorten long URLs
- Track click-through rates
- Branded short links (optional)
- Analytics on link performance
Character Handling:
- Auto-Split: Messages over 160 chars split automatically
- Unicode: Properly handle emojis (reduces to 70 chars per message)
- Encoding: GSM-7 (standard) vs UCS-2 (unicode/emoji)
User Preferences
Per-user SMS settings:
Agent Settings:
- SMS Notification: Desktop/mobile notification on new SMS
- Sound Alert: Audio notification
- Assigned SMS: Route SMS to specific agents
- Max Concurrent: Maximum simultaneous SMS conversations
- Auto-Assign: Automatically assign new conversations
- Signature: Append agent name to messages
Opt-Out Management:
- Opt-Out List: Numbers who requested "STOP"
- Automatic Processing: Auto-add on "STOP" keyword
- Opt-In Tracking: Record consent and opt-in date
- Expiration: Consent expires after X months (re-confirm)
- Export: Download opt-out list for compliance
Compliance Settings
TCPA Compliance (US):
- ✅ Opt-In Required: Track explicit consent
- ✅ Opt-Out Mechanism: "Reply STOP to unsubscribe"
- ✅ Identification: Include business name
- ✅ Time Restrictions: No messages before 8 AM or after 9 PM
- ✅ Consent Records: Store proof of consent
GDPR Compliance (EU):
- ✅ Data Access: Customers can request their data
- ✅ Data Deletion: Right to erasure
- ✅ Data Portability: Export customer SMS history
- ✅ Consent Management: Track and revoke consent
- ✅ Breach Notification: Alert on data breach
Configuration:
- Settings → SMS → Compliance
- Regulatory Region: US (TCPA), EU (GDPR), Canada (CASL)
- Opt-In Method:
- Double opt-in (recommended)
- Single opt-in
- Verbal consent (call recording)
- Quiet Hours: Set no-send window (e.g., 9 PM - 8 AM)
- Consent Storage: Enable consent logging
- Auto Opt-Out: Automatically process "STOP" keyword
- Retention Policy: Delete message history after X days/months
- Save
Analytics & Reporting
Metrics Tracked:
- Volume: Messages sent/received per day/week/month
- Delivery Rate: Successfully delivered messages
- Response Time: Average time to first agent response
- Resolution Time: Average conversation duration
- Customer Satisfaction: CSAT scores from post-conversation surveys
- Agent Performance: Messages handled, response times per agent
- Peak Hours: Busiest times for SMS traffic
- Conversion: Messages that led to sales/appointments
Reports Available:
- SMS Summary: Overall volume and delivery metrics
- Agent Performance: Per-agent statistics
- Number Performance: Metrics per SMS phone number
- Conversation History: Full transcript search
- Compliance Report: Opt-ins, opt-outs, consent records
- Campaign Performance: Bulk send results
- Trend Analysis: Volume trends over time
Troubleshooting
Messages Not Sending:
- Check authentication (Settings → Authentication)
- Verify phone number format (+15551234567)
- Confirm SMS credits available
- Review rate limits (not exceeding carrier limits)
- Check recipient not on opt-out list
Routing Not Working:
- Verify routing rules configured
- Check business hours settings
- Confirm queues have available agents
- Review rule priority order
- Test with manual routing
Auto-Responses Not Triggering:
- Verify auto-response enabled
- Check trigger conditions (keyword, timing)
- Confirm phone number has auto-response assigned
- Review delay settings
- Test with different keywords
Poor Delivery Rates:
- Check carrier filtering (spam detection)
- Verify phone numbers are valid and active
- Review message content (avoid spam triggers)
- Confirm sender phone number not blacklisted
- Use phone number verification
Next Steps
- Create Templates: Build library of common responses
- Configure Routing: Set up intelligent message routing in Message Queues
- Test Workflows: Send test messages through entire flow
- Train Team: Familiarize agents with SMS interface and templates
- Monitor Performance: Review analytics and adjust settings
- Launch Campaigns: Create bulk messaging in Message Campaigns