TheVoĉoTheVoĉo

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 Team

Settings 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 campaigns

Distribution 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:

  1. Create pool: Settings → SMS → Number Pools → Add Pool
  2. Name pool: "Sales Outreach"
  3. Add numbers to pool
  4. Select distribution method
  5. Set pool purpose (marketing, transactional, two-way)
  6. 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 Queue

Configuration Steps:

  1. Navigate to Settings → SMS → Routing
  2. Select phone number
  3. Choose Default Destination:
    • Specific Queue
    • Specific Agent
    • Department
    • Auto-attendant (if configured)
  4. Set Overflow Destination (if primary unavailable)
  5. 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 Queue

Sender-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 X

Content 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 Queue

Configuration:

  1. Settings → SMS → Advanced Routing
  2. Click Add Routing Rule
  3. Define conditions:
    • Keyword match (exact, contains, regex)
    • Sender criteria (CRM status, history)
    • Time conditions
    • Content analysis (if enabled)
  4. Set destination (queue, agent, department)
  5. Set priority (1-10, higher = processed first)
  6. 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 Queue

Time-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 number

Configuration:

  1. Settings → SMS → Business Hours
  2. Define schedules:
    • Regular: Monday-Friday business hours
    • Extended: Includes evenings/weekends
    • 24/7: Always-on routing
    • Holidays: Special days
  3. Assign schedule to each phone number
  4. Configure behavior per schedule period:
    • Route to queue
    • Route to specific agents
    • Auto-response only
    • Forward to another number
  5. 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:

  1. Create Template:

    • Go to Settings → SMS → Templates
    • Click Add Template
    • Name: "Appointment Confirmation"
    • Category: Confirmations
    • Content: Enter template with variables
    • Save
  2. Use Template:

    • In message compose screen
    • Click Templates button
    • Search or browse categories
    • Select template
    • Variables auto-filled from context
    • Edit if needed, send
  3. 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 sending

Business 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:

  1. Settings → SMS → Auto-Responses
  2. Enable Auto-Response: Toggle on
  3. Welcome Message: Enter text (160 char max recommended)
  4. Trigger Condition: First contact, business hours, after hours
  5. Delay: Immediate, 30s, 1min, 5min
  6. Apply to Numbers: Select which numbers use this auto-response
  7. 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:

  1. Settings → SMS → Keyword Auto-Responses
  2. Click Add Keyword
  3. Keyword: Enter trigger word (case-insensitive)
  4. Match Type:
    • Exact: Message must be exactly "STOP"
    • Contains: Message contains "STOP" anywhere
    • Starts with: Message starts with "STOP"
  5. Response: Enter auto-response text
  6. Action:
    • Send response only
    • Send response + route to queue
    • Send response + trigger workflow
    • Special actions (STOP = opt-out, START = opt-in)
  7. Active: Enable/disable keyword
  8. 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:

  1. Settings → SMS → AI Auto-Response
  2. Enable AI Responses: Toggle on
  3. Confidence Threshold: 70% (AI only responds if 70%+ confident)
  4. Knowledge Base: Link to FAQ/knowledge articles
  5. 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
  6. Business Context:
    • Business name, hours, services
    • Common questions and answers
    • Policies (returns, shipping, etc.)
  7. Tone: Professional, friendly, casual (select style)
  8. 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:

  1. Settings → SMS → Compliance
  2. Regulatory Region: US (TCPA), EU (GDPR), Canada (CASL)
  3. Opt-In Method:
    • Double opt-in (recommended)
    • Single opt-in
    • Verbal consent (call recording)
  4. Quiet Hours: Set no-send window (e.g., 9 PM - 8 AM)
  5. Consent Storage: Enable consent logging
  6. Auto Opt-Out: Automatically process "STOP" keyword
  7. Retention Policy: Delete message history after X days/months
  8. 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:

  1. SMS Summary: Overall volume and delivery metrics
  2. Agent Performance: Per-agent statistics
  3. Number Performance: Metrics per SMS phone number
  4. Conversation History: Full transcript search
  5. Compliance Report: Opt-ins, opt-outs, consent records
  6. Campaign Performance: Bulk send results
  7. 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

  1. Create Templates: Build library of common responses
  2. Configure Routing: Set up intelligent message routing in Message Queues
  3. Test Workflows: Send test messages through entire flow
  4. Train Team: Familiarize agents with SMS interface and templates
  5. Monitor Performance: Review analytics and adjust settings
  6. Launch Campaigns: Create bulk messaging in Message Campaigns