SMS Providers

Ring2All Platform — SMS Provider Configuration

Parent Module: SMS Messaging

---

Overview

SMS Providers are external carrier services (Twilio, Telnyx, Bandwidth, etc.) that handle the actual delivery of text messages. Each provider requires specific API credentials and can be configured with rate limits and priority for routing.

Navigation

---

Configuration Fields

Supported Provider Types

Twilio

1. Create Twilio account at https://twilio.com
2. Copy Account SID and Auth Token from Console
3. Purchase or port a phone number
4. Configure webhook URL for inbound messages

Telnyx

1. Create Telnyx account at https://telnyx.com
2. Generate API Key in Portal → Auth
3. Create Messaging Profile with webhook URL
4. Assign phone numbers to the profile

Bandwidth

SignalWire

Generic HTTP

For custom or unsupported carriers that have an HTTP API.

Priority and Routing

Providers are used in routing based on:

1. Route Matching: Routes reference specific providers
2. Priority: Lower priority number = higher preference
3. Fallback: Routes can specify a fallback provider
4. Default: Provider marked is_default handles unmatched routes

Message to +1555... 
    → Check Routes → Match "US Domestic" → Provider: Twilio
    → If Twilio fails → Fallback: Telnyx
    → If no route matches → Default Provider

---

Rate Limiting

The rate_limit_per_second field prevents overwhelming carrier APIs:

---

Troubleshooting

Database Schema

CREATE TABLE sms_providers (
    id              SERIAL PRIMARY KEY,
    uuid            UUID DEFAULT gen_random_uuid(),
    domain_id       INTEGER NOT NULL,
    name            VARCHAR(255) NOT NULL,
    provider_type   VARCHAR(50) NOT NULL,
    api_key         TEXT,
    api_secret      TEXT,
    api_endpoint    TEXT,
    account_sid     VARCHAR(255),
    webhook_url     TEXT,
    webhook_secret  TEXT,
    priority        INTEGER DEFAULT 100,
    is_default      BOOLEAN DEFAULT FALSE,
    enabled         BOOLEAN DEFAULT TRUE,
    rate_limit_per_second INTEGER DEFAULT 10,
    settings        JSONB DEFAULT '{}',
    created_at      TIMESTAMP DEFAULT NOW(),
    created_by      INTEGER,
    updated_at      TIMESTAMP,
    updated_by      INTEGER,
    UNIQUE(domain_id, name)
);

---

Glossary

Lua Script Status ℹ️

Integration Module