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

# SMS

> Deploy your agent as an SMS chatbot. Requires 10DLC registration.

Send messages to users via SMS. Connect your agent to SMS for text-based interactions.

## Requirements

* SMS provider account
* Phone number (dedicated or virtual)
* 10DLC registration (US compliance)
* Agents attached to SMS channel

## Setup

<Steps>
  <Step title="Configure SMS Provider">
    1. Sign up for your SMS provider account
    2. Get phone number from provider
    3. Fund account as required by provider
  </Step>

  <Step title="10DLC Registration">
    Required for US SMS. Steps:

    1. Create "Brand"
    2. Register "Campaign"
    3. Get approval (24-48 hours)
    4. Assign campaign to number
  </Step>

  <Step title="Configure Webhook">
    1. Your SMS provider dashboard
    2. Phone numbers settings
    3. Messaging > Webhook URL
    4. Point to Noorle endpoint (provided in setup)
  </Step>

  <Step title="Add Channel to Agent">
    1. **Agents** > Select agent
    2. **Settings** > **Channels**
    3. Click **Add Channel**
    4. Choose **SMS**
    5. Enter your SMS provider credentials
  </Step>

  <Step title="Test">
    1. Text your SMS number
    2. Wait for response
    3. Verify it works
  </Step>

  <Step title="Deploy">
    Toggle **Enabled**. SMS active.
  </Step>
</Steps>

## SMS Features

* **160 char limit** - Auto-splits long messages
* **MMS support** - Send/receive images (paid)
* **Group SMS** - Send to multiple numbers
* **Scheduling** - Queue messages (optional)

## Character Limits

Standard SMS: 160 characters

**Workaround for long messages:**
Agent automatically splits responses:

```
Agent says: "This is a very long response..."
Delivered as:
[1/3] "This is a very long..."
[2/3] "response that is split..."
[3/3] "into multiple messages"
```

## User Identification

User identified by:

* **Phone number** (inbound message source)
* **Context** (conversation history)

Agent can personalize by number.

## MMS Support

Send images in responses (paid):

1. Enable MMS in your SMS provider
2. Agent includes image in response
3. Delivered as MMS (image message)

## Rate Limits

* 100 messages/hour per number
* Up to 1000 threads
* Burst: 10 messages allowed

Noorle enforces these automatically.

## Message Delivery Status

Track delivery status:

1. **Agents** > Select agent
2. **Activity** tab
3. See delivery status for each message

Statuses:

* **Sent** - Message delivered
* **Queued** - Waiting to send
* **Failed** - Delivery error

## 10DLC Compliance

10DLC (10-digit Long Code) required for US numbers:

* **Brand Registration** - Company info
* **Campaign Registration** - Use case
* **Compliance** - Truth in lending, government, etc.

Processing time: 24-48 hours

## Limitations

* 160 character limit (splits automatically)
* No rich formatting
* No buttons or interactive elements
* Phone number visible to all recipients (if group SMS)
* Subject line not supported

## Troubleshooting

### SMS not received

* Check phone number is correct
* Verify 10DLC approved
* Check SMS provider account is funded
* Review provider logs

### Delivery slow

* Typical: 5-30 seconds
* Check SMS provider status
* Verify agent responding
* Network latency

### Messages split incorrectly

* 160 char limit enforced
* Each split = separate SMS
* Check agent response length
* Consider shorter responses

## Costs

For current pricing, see [Pricing](https://noorle.com/pricing/).

## Privacy & Security

* Messages encrypted in transit
* Phone numbers stored for conversation context
* Compliance with SMS regulations
* Privacy policy required

## Best Practices

### Keep Responses Short

SMS has 160 char limit. Keep responses concise.

### Confirm Identity

Ask confirmation before sensitive operations.

### Rate Limiting

Implement anti-spam (5 minute cooldown between user messages).

### Opt-In/Out

Provide way for users to opt out of SMS.

## Next Steps

* [Telegram Channel](/docs/run/channels/telegram)
* [Slack Channel](/docs/run/channels/slack)
* [Creating Agents](/docs/run/agents/creating-an-agent)