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

# SMS & WhatsApp Settings

> Configure how mixus handles your SMS and WhatsApp communications

## Overview

mixus integrates with SMS and WhatsApp to enable AI-powered conversations on your mobile device. You can control your messaging preferences, including which organization context the AI uses when responding to your messages.

## SMS Organization Preferences

### 🏢 **Managing Your Default Organization**

When you belong to multiple organizations in mixus, you can set a default organization for all SMS and WhatsApp communications. This ensures your AI assistant responds with the appropriate context, knowledge base, and permissions.

**To set your default SMS organization:**

1. Navigate to your **Account Settings** → **SMS Preferences**
2. In the **Default Organization** section, you'll see a dropdown of all your organizations
3. Select the organization you want to use by default for SMS/WhatsApp communications
4. Click **Save Preferences**

**Direct Link:** [SMS Settings](https://app.mixus.ai/settings/sms)

<Callout type="info">
  **Note:** This setting affects both SMS and WhatsApp messages. Email communications have a separate organization preference.
</Callout>

### 🔄 **How Organization Selection Works**

When you send an SMS or WhatsApp message to mixus, the system determines which organization context to use based on:

1. **Your Default Preference** - The organization you've set in SMS settings (highest priority)
2. **Recent Activity** - If no preference is set, mixus uses your most recently active organization
3. **First Organization** - If you haven't set a preference or have no recent activity, your first organization is used
4. **Playground** - New users without organizations are automatically assigned to the playground

<Callout type="success">
  **Pro Tip:** Set your default organization to ensure your messages are always processed in the correct context, especially if you belong to multiple organizations.
</Callout>

## Messaging Preferences

### 📱 **SMS Configuration**

Control how mixus handles your SMS messages:

* **Enable SMS Responses**: Toggle whether mixus can respond to your SMS messages
* **Response Format**: Choose between detailed or concise responses
* **Message Threading**: Control how conversations are organized
* **Rate Limiting**: Set limits on message frequency to manage costs

### 💬 **WhatsApp Settings**

Configure WhatsApp-specific preferences:

* **Media Handling**: Control how images and documents are processed
* **Voice Messages**: Enable/disable voice message transcription
* **Status Updates**: Choose whether to receive status updates via WhatsApp
* **Group Messages**: Configure behavior in WhatsApp groups (if applicable)

## Communication Settings

### 🔔 **Notification Preferences**

Configure which notifications you receive via SMS/WhatsApp:

* **AI Response Notifications**: Get notified when AI completes processing
* **System Alerts**: Important account and security notifications
* **Usage Warnings**: Alerts when approaching message limits
* **Feature Updates**: New features and improvements

### ⏱️ **Response Time Settings**

Manage AI response timing:

* **Immediate Response**: Get responses as quickly as possible
* **Batched Responses**: Group multiple responses together
* **Quiet Hours**: Set times when you don't want to receive messages
* **Time Zone**: Ensure messages are sent at appropriate times

## Advanced Settings

### 🛡️ **Privacy & Security**

* **Message Retention**: Control how long SMS conversations are stored
* **AI Training**: Opt in/out of using your messages for AI model improvements
* **Number Verification**: Manage verified phone numbers
* **Blocked Numbers**: Maintain a list of numbers that cannot message your mixus number

### 🔧 **Technical Settings**

* **Processing Model**: Choose which AI model processes your messages
* **Language Detection**: Automatic language detection and response
* **Character Encoding**: Handle special characters and emojis
* **Message Splitting**: Control how long messages are split

## Phone Number Management

### 📞 **Verified Numbers**

* View all verified phone numbers on your account
* Add new phone numbers with verification
* Remove old or unused numbers
* Set primary number for outbound notifications

### 🔄 **Number Porting**

* Transfer your mixus number to a new device
* Update carrier information
* Manage international number formats

## Troubleshooting

### Common Issues

**Messages not being processed:**

* Verify your phone number is correctly registered
* Check that SMS responses are enabled
* Ensure you haven't exceeded usage limits
* Confirm your default organization is set

**Wrong organization context:**

* Update your default organization preference
* Check that you have access to the intended organization
* Verify the organization hasn't been deactivated

**Delayed or missing responses:**

* Check your quiet hours settings
* Verify your phone has good signal/data connection
* Ensure your account is in good standing
* Check for any system-wide issues

## Frequently Asked Questions

### Can I use different organizations for SMS and Email?

Yes! mixus maintains separate organization preferences for each communication channel. You can have different default organizations for SMS/WhatsApp and email.

### How do I switch organizations temporarily?

You can switch organizations for a specific conversation by sending:

* "switch to org \[name]" - Switches to the specified organization
* The change only affects the current conversation unless you add "set as default"

### What happens if I'm removed from my default organization?

mixus will automatically fall back to your most recently used organization. You'll receive a notification to update your SMS preferences.

### Can I use multiple phone numbers?

Yes, you can verify multiple phone numbers on your account. Each number can have its own preferences and default organization.

### Are WhatsApp and SMS settings the same?

Most settings apply to both SMS and WhatsApp, but some features like media handling and voice messages are WhatsApp-specific.

## Usage Limits

### Message Quotas

* **Free Plan**: 100 messages per month
* **Pro Plan**: 1,000 messages per month
* **Business Plan**: 10,000 messages per month
* **Enterprise**: Custom limits

### Rate Limiting

To prevent abuse and manage costs:

* Maximum 60 messages per hour
* Maximum 500 messages per day
* Burst limit of 10 messages per minute

## Related Resources

* [Organization Management](/organization/overview) - Learn about managing organizations
* [WhatsApp Agent](/agents/whatsapp) - WhatsApp-specific features
* [Security Settings](/security/overview) - SMS security and privacy
* [Billing & Usage](/tokens/billing) - Message costs and billing

***

**Need help with SMS/WhatsApp settings?** Contact [support@mixus.ai](mailto:support@mixus.ai) or text HELP to your mixus number.