SMS Numbers

Ring2All Platform — SMS Number Management

Parent Module: SMS Messaging

---

Overview

SMS Numbers are phone numbers enabled for text messaging. Each number is linked to a provider and can be assigned to extensions for User Portal SMS access.

Admin Panel → SMS → Numbers

---

Configuration Fields

Field Name	Technical Description	User-Friendly Tooltip	Example	Notes
Phone Number	E.164 format in `phone_number`.	The phone number in E.164 format.	`+15551234567`	Must include country code. Must be unique per domain.
Provider	Links to `provider_id`.	Which SMS provider manages this number.	`Twilio US`	Number will use this provider's API for sending.
Number Type	Classification in `number_type`.	Type of phone number.	`long_code`	Affects throughput limits and carrier rules.
Friendly Name	Display name in `friendly_name`.	A descriptive name for this number.	`Sales SMS Line`	Helps identify the number's purpose.
Enabled	Toggle in `enabled`.	Enable or disable this number.	`true`	Disabled numbers cannot send or receive.

---

Number Types

Type	Description	Throughput	Monthly Cost	Best For
Long Code	Standard 10-digit number	1 msg/sec	$1-2/month	Person-to-person, low volume
Short Code	5-6 digit number	100+ msg/sec	$500-1000/month	High-volume campaigns, marketing
Toll-Free	1-800 style number	3 msg/sec	$2-5/month	Customer service, moderate volume

Long Code Details

Standard 10-digit phone number
Low throughput (~1 message/second)
Requires 10DLC registration in US for A2P messaging
Best for conversational, person-to-person style messaging

Short Code Details

5-6 digit number (e.g., 12345)
Very high throughput (100+ messages/second)
6-12 week approval process
Expensive but essential for mass messaging
Carrier pre-approval required

Toll-Free Details

1-800, 1-888, etc. numbers
Moderate throughput (~3 messages/second)
Requires toll-free verification for SMS
Good balance of cost and capability

---

Extension Assignment

SMS Numbers can be assigned to extensions, allowing users to send/receive SMS from their User Portal.

How to Assign

Go to PBX → Extensions
Edit the desired extension
In General Tab, find SMS Number field
Select an available SMS number from dropdown
Save the extension

User Portal Access

When an SMS number is assigned:

User sees SMS menu item in their Portal
User can view messages sent to/from their number
User can compose and send new messages
Messages are filtered to only show their assigned number

💡 Tip: One SMS number can only be assigned to one extension at a time.

---

E.164 Format

All phone numbers must be in E.164 international format:

Country	Format	Example
USA/Canada	+1XXXXXXXXXX	+15551234567
UK	+44XXXXXXXXXX	+447700900123
Mexico	+52XXXXXXXXXX	+525512345678
Germany	+49XXXXXXXXXXX	+4915123456789

Rules:

Must start with +
Followed by country code
No spaces, dashes, or parentheses
Maximum 15 digits total

---

Provider Relationship

Each SMS number is linked to exactly one provider:

Plaintext

┌─────────────────┐         ┌─────────────────┐
│   SMS Number    │────────▶│   SMS Provider  │
│ +15551234567    │         │   Twilio US     │
└─────────────────┘         └─────────────────┘

When sending from a number:

System finds the number's provider
Uses provider's API credentials
Sends via provider's network

⚠️ Important: The phone number must exist in the provider's account. If you port a number to a new provider, update the provider link in Ring2All.

---

Troubleshooting

Issue	Cause	Solution
Number not in dropdown	Number disabled	Enable the number
"Number not found" when sending	Number doesn't exist in provider	Verify number exists in provider dashboard
Can't receive messages	Webhook not configured	Configure webhook in provider settings
Duplicate number error	Number already exists	Use existing number or remove duplicate
User doesn't see SMS menu	Number not assigned	Assign SMS number to extension

---

Database Schema

Sql

CREATE TABLE sms_numbers (
    id            SERIAL PRIMARY KEY,
    uuid          UUID DEFAULT gen_random_uuid(),
    domain_id     INTEGER NOT NULL,
    provider_id   INTEGER NOT NULL REFERENCES sms_providers(id) ON DELETE CASCADE,
    phone_number  VARCHAR(20) NOT NULL,
    number_type   VARCHAR(20) DEFAULT 'long_code',
    friendly_name VARCHAR(255),
    enabled       BOOLEAN DEFAULT TRUE,
    created_at    TIMESTAMP DEFAULT NOW(),
    created_by    INTEGER,
    updated_at    TIMESTAMP,
    updated_by    INTEGER,
    UNIQUE(domain_id, phone_number)
);

---

See also: SMS Providers | SMS Routes | Extensions (SMS Assignment)

Glossary

Term	Definition
SMS	Short Message Service (text messaging)
DID	Direct Inward Dialing number

---

Lua Script Status ℹ️

Integration Module

Component	Status	Notes
SMS Numbers	ℹ️ Configuration module	SMS routing rules applied by the main SMS handler