> ## Documentation Index
> Fetch the complete documentation index at: https://brokeros.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# SMS Marketing and Communication Suite

> Send compliant SMS broadcasts to thousands of leads, manage 2-way team text inboxes, build visual automation flows, deploy multi-gateway sender pools, and track click engagement.

## Enterprise Real Estate SMS Platform

With open rates exceeding 90% within three minutes of delivery, SMS is the most immediate communication channel available to real estate developers and brokerage firms. Whether announcing limited-phase price revisions, reminding prospects of weekend property tours, or following up on missed sales calls, text messages command immediate buyer attention.

BrokerOS delivers an enterprise SMS marketing suite directly tied to the core CRM database. Outbound mass broadcasts, multi-gateway sender pooling, automated DND and regulatory compliance (DLT & 10DLC), visual automation flows, and a 2-way collaborative team inbox operate within a single unified workspace.

***

## Unified SMS Architecture

```mermaid theme={null}
sequenceDiagram
    autonumber
    actor Marketer as Marketing & Sales Teams
    participant App as Web Dashboard (Next.js)
    participant API as BrokerOS SMS API
    participant Queue as BullMQ Delay & Dispatch Queue
    participant Worker as SMS Workers (9 Gateways)
    actor Lead as Homebuyer Mobile Handset
    participant Inbound as Inbound Webhook Parse Engine

    Note over App,Worker: Outbound Broadcast & Drip Flow
    Marketer->>App: Launch Campaign (Multi-Sender Pool + Tracked Short Link)
    App->>API: POST /api/marketing/sms/campaigns
    API->>Queue: Enqueue Rate-Limited Recipient Batches
    Worker->>Queue: Dequeue & Calculate GSM-7 / Unicode Segments
    Worker->>Lead: Deliver Outbound Text via Gateway (Twilio / Gupshup / Sinch)
    
    Note over Lead,Inbound: Inbound Text & Team Inbox Flow
    Lead->>Inbound: Inbound Text Reply ("Yes, send me Tower B pricing")
    Inbound->>API: Parse Payload & Resolve Contact Record
    API->>API: Sync to 2-Way Team Inbox Thread
    API-->>Marketer: Live WebSocket Alert in Inbox Workspace
```

***

## Core SMS Modules

> **[2-Way Team Inbox](https://brokeros.mintlify.site/marketing/sms/team-inbox.md)**
>
> Collaborative shared text inbox with real-time thread continuity, sales agent assignment, character counters, and AI smart reply drafting.

> **[Automation Flows](https://brokeros.mintlify.site/marketing/sms/sms-flows.md)**
>
> Visual drag-and-drop canvas for automated SMS journeys, keyword auto-replies (`YES`, `PRICE`, `VISIT`), Groq AI Concierge responses, and branching conditions.

> **[Campaign Wizard](https://brokeros.mintlify.site/marketing/sms/campaign-wizard.md)**
>
> Step-by-step broadcast builder with multi-gateway sender pools, phone mockup preview, DND compliance scrubbing, and scheduling.

> **[Sender Pools & Pre-Flight](https://brokeros.mintlify.site/marketing/sms/preflight-and-sender-pools.md)**
>
> Multi-gateway sender pooling across virtual numbers to prevent carrier throttling, pre-flight segment calculations, and cost estimation.

> **[Template Registry & DLT](https://brokeros.mintlify.site/marketing/sms/template-registry.md)**
>
> Regulatory template management supporting Indian DLT (Entity ID, Header ID, Template ID) and US A2P 10DLC compliance.

> **[Tracked Short Links](https://brokeros.mintlify.site/marketing/sms/short-links.md)**
>
> High-density branded URL shortener (`https://brk.os/s/{token}`) with sub-second redirection, individual lead click attribution, and CRM score boosts.

> **[AI Assistant & Settings](https://brokeros.mintlify.site/marketing/sms/ai-assistant-and-settings.md)**
>
> Configure Groq language models (`openai/gpt-oss-120b`), 160-character single-segment constraints, carrier diagnostics, and CRM tags.

> **[Gateway Integrations](https://brokeros.mintlify.site/marketing/sms/gateway-integrations.md)**
>
> Direct connectors for 9 enterprise telecom aggregators: Twilio, AWS SNS, Gupshup, Sinch, Infobip, Telnyx, Plivo, Vonage, and Bird.

***

## Real-Time Performance Benchmarks

Every SMS broadcast tracks carrier receipts and link interaction to measure deliverability and customer intent:

| Metric | Operational Definition | Target Enterprise Benchmark |
| :- | :- | :- |
| **Delivered Rate** | Percentage of sent text messages successfully confirmed on recipient handsets. | $\ge 97.0\%$ |
| **Unique Click Rate** | Proportion of delivered recipients who tapped the embedded short link. | $10\%$ to $18\%$ |
| **Direct Reply Rate** | Inbound text replies received on Virtual Long Numbers within 72 hours. | $4\%$ to $8\%$ |
| **Failed / Undelivered** | Invalid phone numbers or carrier network rejections automatically logged. | $< 1.5\%$ |
| **Opt-Out Rate** | Unsubscribe keywords (`STOP`, `UNSUB`) processed automatically. | $< 0.15\%$ |

***

## Multi-Channel Lead Progression

Interactions within the SMS suite feed directly into sales rep workflows:

* **Short Link Tap**: Clicking a digital brochure short link automatically adds 10 points to the lead's CRM qualification score.
* **Inbound Text Response**: Replying to an SMS notification immediately routes the conversation into the Team Inbox and notifies the assigned sales executive via push notification.
* **Automated Fallback to Voice**: If an urgent unit hold or appointment reminder remains unacknowledged after 4 hours, BrokerOS can automatically trigger a companion AI Voice call.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.