ReadySMS Documentation

Everything you need to set up, send, and scale your SMS campaigns.

Overview

ReadySMS is a full-featured SMS platform built for businesses that need reliable, high-volume text messaging at competitive rates. It plugs directly into your CRM so every text, reply, and opt-out is tracked in one place.

Compliant by Default

Built-in 10DLC registration, opt-in pages, privacy policies, and automatic opt-out handling.

AI-Powered Messaging

Generate high-converting SMS copy instantly with the AI Message Writer.

Smart Send Technology

Deliver each message at the optimal time for every individual contact.

Volume Pricing

Rates as low as $0.0028/segment. The more you send, the less you pay.

Built-in Power Dialer

Browser-based voice dialer with call recording, voicemail drop, and Speed-to-Lead.

Agent Management

Invite agents, assign campaigns, and monitor calls with barge/whisper/listen.

Key capabilities:

Installation

ReadySMS is available directly from the marketplace. Installation takes under two minutes.

  1. Open the marketplace and search for "ReadySMS".
  2. Click Install on the ReadySMS listing.
  3. Authorize the connection when prompted. This grants ReadySMS permission to send and receive SMS on your behalf.
  4. Select the sub-account(s) you want to connect.
  5. Once installed, ReadySMS appears in your sidebar. Click it to open the dashboard.
Free credits included. Every new account receives 2,500 free SMS credits upon installation, so you can start sending immediately.

Initial Setup

Before sending your first message, you need to complete 10DLC registration and provision a phone number. This is required by US carriers to ensure deliverability.

Step 1: Register Your Brand

Navigate to Settings → 10DLC and fill out your business details:

Cost: $35 one-time at brand submit (covers brand + campaign + phone deposit), then $10/month recurring.

Step 2: Register a Campaign

A campaign describes how you will use SMS messaging. ReadySMS simplifies this process:

Approval typically takes 1-3 business days.

Cost: Campaign registration is $20/month per campaign.

Step 3: Buy a Phone Number

Once your campaign is approved:

  1. Go to Settings → Phone Numbers.
  2. Enter your preferred area code (e.g., 657, 949, 310).
  3. ReadySMS will provision a local 10-digit number instantly.
  4. The number is automatically linked to your approved campaign.
You're ready to send! Once your number is provisioned, you can start sending SMS immediately from the Call/Text tab or via SMS Blasts.

Sending SMS

Single Message

To send a one-off text message:

  1. Go to the Call/Text tab in the dashboard.
  2. Select your From Number from the dropdown.
  3. Enter the recipient's phone number in the To field.
  4. Type your message in the composer. The character counter shows segment count in real time.
  5. Click Send Message.

Replies from the recipient appear in your Conversations inbox automatically.

Bulk Sending

For sending to multiple contacts at once, use SMS Blasts (covered in detail in the SMS Blasts section). You can also use the Call/Text tab to send to contacts selected from your CRM.

Personalization

Use merge fields to personalize each message:

Example: "Hey {first_name}, just wanted to check in about your property on Main St..."

Understanding Segments

A segment is a 160-character portion of an SMS message. Messages longer than 160 characters are split into multiple segments:

The character counter in the message composer shows the exact segment count before you send, so there are no surprises.

AI Message Writer

The AI Message Writer helps you craft high-converting SMS messages in seconds. Instead of staring at a blank screen, describe what you want to say and let AI do the writing.

How It Works

  1. Click the AI Writer button in the message composer (available in Call/Text and SMS Blasts).
  2. Describe your message intent in plain English. For example: "Follow up with a homeowner about selling their house, friendly tone, mention we buy as-is."
  3. The AI generates 3 optimized message variations with different tones and angles.
  4. Click any suggestion to use it. Edit further if needed.
Tip: The AI considers SMS best practices like keeping messages concise, using a clear call-to-action, and staying within 1-2 segments for better engagement.

Conversations

The Conversations tab is your shared inbox for all two-way SMS communication. Every inbound reply from a contact appears here in real time.

Features

Filtering Conversations

Use the filter bar to narrow conversations by:

CRM & Contacts

ReadySMS includes a built-in CRM to manage your contacts, track engagement, and keep your lists clean.

Contact Management

Pipeline

Track contacts through your sales or outreach process with a visual pipeline. Default stages include:

Drag-and-drop contacts between stages, or let automations move them based on message activity.

Lead Scoring

ReadySMS automatically scores contacts based on engagement signals:

Use lead scores to prioritize follow-ups and filter your blast recipients.

List Scrubbing

Keep your lists clean and compliant with built-in scrubbing tools:

Important: Sending to landlines or invalid numbers wastes credits and hurts your sender reputation. Run a scrub before your first blast.

SMS Blasts

SMS Blasts let you send a single message to hundreds or thousands of contacts at once. This is your tool for campaigns, announcements, and mass outreach.

Creating a Blast

  1. Go to SMS Blasts and click "+ New Blast".
  2. Name your campaign (internal only, contacts won't see this).
  3. Write your message. Use merge fields like {first_name} for personalization.
  4. Select your recipients: all contacts, specific tags, pipeline stages, or a custom filter.
  5. Choose your sending method: Send Now, Schedule for a specific date/time, or enable Smart Send.
  6. Review the estimated segment count and cost, then confirm.

Smart Send

Smart Send is ReadySMS's AI-powered delivery optimization. Instead of blasting everyone simultaneously, it learns when each contact is most likely to respond and staggers delivery into optimal windows.

Example: If John typically replies between 5-7 PM and Sarah responds best at 10 AM, Smart Send delivers John's message at 5:30 PM and Sarah's at 10:15 AM.

Result: On average, Smart Send improves reply rates by 40-50% compared to standard bulk sends.

A/B Testing

Test different message variations to find what resonates with your audience:

  1. When creating a blast, click "Add Variation" to create a B message.
  2. Write an alternative version of your message.
  3. Set the test split (e.g., 50/50 or 20/80).
  4. ReadySMS sends each variation to a portion of your list and tracks reply rates.
  5. After the test period, view results in the Blast detail page to see which version won.

Drip Sequences

Drip sequences let you send a series of automated messages over time. Set it up once, and ReadySMS handles follow-ups automatically.

Creating a Drip Sequence

  1. Go to Drip Sequences and click "+ New Sequence".
  2. Name your sequence and set the trigger (e.g., new contact added, tag applied, manual enrollment).
  3. Add messages to the sequence. For each message, set:
    • Delay — how long to wait before sending (e.g., 1 day, 3 days, 1 week)
    • Message content — the SMS to send, with merge field support
    • Send window — restrict sending to business hours only (optional)
  4. Set exit conditions: automatically stop the sequence if the contact replies, opts out, or reaches a specific pipeline stage.
  5. Activate the sequence.

Sequence Management

Best practice: Keep drip sequences to 3-5 messages. After 5 touches with no reply, further messages rarely convert and may increase opt-outs.

Power Dialer

The ReadySMS Power Dialer is a browser-based voice dialer built directly into your account. Make outbound calls to leads in a queue — no separate software or hardware required. Calls use WebRTC in your browser.

Features Included

Plans

Plan Price What's Included
Free $0/mo 1 agent (owner only), 1 line, 500 minutes/mo included, $0.06/min after. All core features.
Pro $29/agent/mo Up to 3 agents, 3 concurrent lines, unlimited minutes at $0.05/min.
Team $69/agent/mo Unlimited agents, 5 concurrent lines, $0.0375/min. Includes Speed-to-Lead.
Getting started: Click the phone icon in the bottom-right corner of your dashboard to open the dialer panel. The Free plan is available immediately.

Dial Campaigns

A dial campaign is the engine that drives your dialer queue. It defines which contacts to call, how many attempts per contact, calling hours, and which agents can work it.

Creating a Campaign

  1. Go to Campaigns → Dial Campaigns tab.
  2. Click "New Campaign".
  3. Configure the settings below and click Create Campaign.

Campaign Settings

How the Queue Works

When an agent clicks "Next Lead", the system:

  1. Finds the active campaign assigned to that agent.
  2. Queries for contacts that haven't exceeded max dials, aren't on DNC, aren't reserved by another agent, and have cooled down.
  3. Reserves the lead for 5 minutes and initiates the outbound call.

If no leads are available, the agent sees "No leads available."

Tip: You can pause and resume campaigns at any time. Deleting a campaign does not delete the contact list or call history.

Dialer Lists

Dialer lists are collections of contacts that you dial through in a campaign. A list must exist before you can attach it to a campaign.

Creating a List

  1. Go to Contacts → Lists tab.
  2. Click "New List".
  3. Give the list a name and optional description.
  4. Click Save. The list starts empty.

Importing Contacts via CSV

  1. On the Lists page, click "Import CSV".
  2. Select which list to import into.
  3. Upload a .csv file. Columns are mapped automatically.

Supported columns: phone (required), first_name, last_name, email, address, city, state, zip, source.

Note: Phone numbers are normalized to E.164 format (+1XXXXXXXXXX). Duplicate phones within your account are linked to the list rather than re-created.

Speed to Lead

Speed to Lead is a dialing mode where the newest leads in your list are called first. When a new lead comes in via webhook, they jump to the front of the call queue.

How It Works

Normally, the dialer serves leads with the fewest dial attempts first (oldest leads first). With Speed to Lead enabled, the sort order flips to newest first. When a new contact is pushed in via webhook, they become the first lead served.

If a contact already exists and comes in again, their timestamp updates — they jump back to the front.

Setup

  1. Upgrade to the Team plan ($69/agent/mo).
  2. Create or edit a dial campaign.
  3. Toggle "Speed to Lead" ON.
  4. Assign a list and set up a webhook to push leads in real time.
Example: A home seller fills out a form → your CRM fires a webhook to ReadySMS → the lead lands at position #1 → your agent clicks Next Lead within seconds → the prospect answers while still interested.

Dialer Agents

Agents are sub-users under your account who log in separately and access only the dialer-relevant parts of the dashboard.

Plan Requirements

Inviting an Agent

  1. Go to Settings → Team.
  2. Click "Invite Agent".
  3. Enter the agent's email, first name, and last name.
  4. Set permissions: Can Transfer, Can View Scripts, Max Lines.
  5. Click Send Invite. The agent receives login credentials.

What Agents Can See

What Agents Cannot See

Manager monitoring: Account owners can listen in, whisper to, or barge into any agent's active call in real time.

Caller ID

Your outbound caller ID is the phone number that appears on the prospect's phone. Caller IDs are pulled from your purchased phone numbers under Settings → Phone Numbers.

Assigning Caller IDs

  1. Create or edit a dial campaign.
  2. Expand "Advanced Settings".
  3. Select one or more numbers in the "Caller ID Numbers" field.
  4. Save. If multiple numbers are selected, the system rotates through them.
Tips: Use local numbers matching your leads' area codes for higher answer rates. Rotate across multiple numbers to prevent flagging. Numbers cost $5/month each.

Dispositions

A disposition is the outcome you assign to a call after it ends. Dispositions drive queue logic and trigger automated follow-ups.

Default Dispositions

How Dispositions Affect the Queue

Custom Dispositions

Add your own under Settings → Dialer Dispositions. Choose a name and category (success, neutral, fail, or callback).

Auto-Text on Disposition

Set up rules to automatically send an SMS when a specific disposition is selected. Uses your ReadySMS SMS credits.

Callbacks

A callback is a scheduled reminder to call a prospect back at a specific time.

How Callbacks Are Created

Managing Callbacks

Callbacks appear under Dial Campaigns → Callbacks, sorted by reminder time (soonest first). Each shows contact name, phone, scheduled time, notes, and which agent created it.

Dialer Webhooks

Push new leads directly into your dialer queue from any CRM, landing page, or automation using webhooks.

Authentication

All webhook endpoints require an API key. Generate keys under Settings → Dialer Webhooks.

Endpoints

Base URL: https://api.readysms.io

Rate limit: 100 leads per minute per API key.

Dialer DNC List

The DNC (Do Not Call) list contains phone numbers that will never be dialed by the queue.

How Contacts Get Added

Removing from DNC

Find the number in the DNC list and click remove. The contact becomes eligible for the queue again.

Important: The DNC list is per-account. Federal DNC compliance (TCPA/FTC national registry) is separate — ensure you maintain your own compliance with national Do Not Call regulations.

Analytics

ReadySMS provides detailed analytics so you can monitor performance, optimize campaigns, and maintain healthy sender reputation.

Usage Reports

The Usage Reports dashboard shows:

Number Health

The Number Health panel monitors each of your phone numbers for deliverability issues:

Warning: If a number's health drops to "Poor," reduce sending volume and review your message content. Continued sending on a poor-health number can result in carrier blocks.

Carrier Breakdown

See how your messages perform across different carriers:

This data helps you identify carrier-specific issues before they affect your overall deliverability.

Billing & Credits

Pricing Tiers

ReadySMS uses volume-based pricing. The more you send, the lower your per-segment rate:

Tier Monthly Volume Per Segment
Starter 0 - 50,000 segments/mo $0.0084
Growth 50,001 - 500,000 segments/mo $0.0059
Enterprise 500,001+ segments/mo As low as $0.0028
On a custom plan? Your rate is already set to the best discount available for your account. You can view your current rate anytime in the Billing tab. If you have questions about your pricing, just open a support ticket — we're happy to help.

One-time 10DLC setup: $35 at brand submit, covers brand + campaign + phone deposit.

Additional monthly fees:

Power Dialer Pricing

The power dialer is billed separately from SMS credits. See the Power Dialer section for full plan details.

Note: Carrier fees are passed through at cost and are not included in the per-segment rate.

Purchasing Credits

Credits can be purchased from Billing → Buy Credits. Select a package or enter a custom amount. Payment is processed via your saved card on file.

Auto-Rebill

Never run out of credits mid-campaign. Auto-Rebill automatically purchases credits when your balance falls below a threshold you set.

Configure it in Billing → Auto-Rebill:

Payment Methods

ReadySMS accepts all major credit and debit cards (Visa, Mastercard, American Express, Discover). Manage your payment methods in Billing → Payment Methods.

Sub-Accounts

If you manage multiple businesses or clients, sub-accounts let you keep everything organized under one ReadySMS login.

How Sub-Accounts Work

Managing Sub-Accounts

Agency tip: Each sub-account requires its own 10DLC brand and campaign registration. You can manage all registrations from a single dashboard.

Settings

The Settings page lets you configure your account, manage integrations, and customize your ReadySMS experience.

General

10DLC

Phone Numbers

Integrations

Compliance

Integrations

ReadySMS connects to anything — no-code tools, your own backend, or an AI agent. Pick the path that matches what you're building. The full step-by-step reference lives in docs/INTEGRATIONS.md; the highlights are below.

Use the Integration Assistant
Claude reads your account and walks you through your specific setup. It can issue API keys, subscribe to webhooks, and send a test SMS for you.
Open Assistant →

Zapier

Public Zapier app — search "ReadySMS" in Zapier. 12 triggers (new message, new contact, opt-out, delivered/failed, tag added/removed, drip completed…) and 6 actions (send SMS, create/update contact, add to drip, add/remove tag). OAuth — no API key copying.

Outbound Webhooks

Subscribe any URL to any event with one POST. We deliver flat-JSON payloads in real time, auto-disable when you delete the receiving Zap, and auto-enrich with custom fields.

REST API

Send SMS, manage contacts, enroll in drips, query phone numbers, and more — all under https://api.readysms.io. API key or OAuth. See the full API reference.

AI / MCP

Drop-in tool-call schemas for Anthropic and OpenAI function calling. Bring ReadySMS into Claude Desktop / Cursor via an MCP server. Let your agent send SMS, search contacts, and enroll leads autonomously.

Other paths covered in the full guide

Frequently Asked Questions

How long does 10DLC approval take?

Brand registration is usually approved within 24 hours. Campaign registration typically takes 1-3 business days. In some cases, carriers may request additional information, which can extend the process to 5-7 business days.

Can I send MMS (picture messages)?

ReadySMS currently supports SMS (text) messages. MMS support for images and media is on our roadmap and coming soon.

What happens if a contact replies STOP?

ReadySMS automatically handles opt-outs. When a contact texts STOP (or any configured opt-out keyword), they are immediately removed from all future messaging. Their DND (Do Not Disturb) status is updated in your CRM, and they will not receive any further messages from your account. This is required by law and cannot be overridden.

Can I use ReadySMS with my existing CRM workflows?

Yes. Once installed, ReadySMS becomes your SMS provider. All existing automations, workflows, and triggers in your CRM that send SMS will automatically use ReadySMS. No workflow changes are required.

Is there a free trial?

Every new account receives 2,500 free SMS credits upon sign-up. This lets you test the platform, send real messages, and evaluate deliverability before purchasing additional credits.

What is a segment and how is it counted?

A segment is a 160-character portion of an SMS message. Messages under 160 characters count as 1 segment. Longer messages are split: 161-320 characters = 2 segments, 321-480 characters = 3 segments, and so on. The character counter in the message composer shows the exact segment count before you send.

Do unused credits roll over?

Yes. Purchased credits never expire and roll over month to month. Your credits remain in your account until they are used.

Can I port my existing phone number?

Yes, number porting is supported. Contact our support team at support@readysms.io to initiate a port request. The process typically takes 2-4 weeks depending on your current carrier.

Is ReadySMS TCPA compliant?

ReadySMS provides the tools you need for TCPA compliance: automated opt-in/opt-out handling, consent tracking, quiet hours, and DNC list checking. However, compliance is ultimately your responsibility. Ensure you have proper consent before messaging contacts.

What do I need to start using the power dialer?

Just click the phone icon in the bottom-right corner of your dashboard. The Free plan gives you 1 agent, 500 minutes/month, and all core features with no credit card required. To add agents or enable Speed-to-Lead, upgrade to Pro or Team from the Dialer Billing tab.

Can I use the dialer and SMS features together?

Yes. The dialer and SMS platform are fully integrated. You can set up auto-text rules that send an SMS based on call dispositions, push leads into dialer lists via the same CRM webhooks, and manage all contacts from a single CRM. Dialer minutes and SMS credits are billed separately.

How does Speed-to-Lead work?

Speed-to-Lead flips the dialer queue order so the newest leads are called first. When a lead arrives via webhook, they jump to position #1. This ensures your agents reach fresh leads within seconds. Speed-to-Lead requires the Team plan ($69/agent/mo).

How do I cancel my account?

You can cancel at any time from Settings → Account. Remaining credits are non-refundable but will remain available if you reactivate. Monthly fees (brand and campaign registration) stop billing at the end of your current billing period.