SMS Providers

LeadSail supports multiple telephony providers for sending and receiving SMS messages. Providers are configured through the Integrations page.

Supported Providers

Vonage (Primary)

Vonage is the most deeply integrated SMS provider.

Features

• Send SMS — Via the Vonage Messages API (v1/messages)
• Receive SMS — Inbound webhook with JWT signature verification
• Phone Number Sync — Automatically sync all phone numbers from your Vonage account
• Delivery Status — Status callbacks for tracking message delivery

Configuration

Navigate to Integrations and configure:

• API Key — Your Vonage API key
• API Secret — Your Vonage API secret
• Signature Secret — Optional secret for verifying inbound webhook JWT signatures (separate from API secret)
• Enabled — Toggle the integration on/off

Phone Number Management

Click Sync Phone Numbers to fetch all numbers from your Vonage account. Synced numbers appear in the phone number selector when configuring SMS agents and campaigns. Each number shows:

• Phone number (E.164 format)
• Country
• Type (mobile, landline, VOIP)
• Capabilities (SMS, Voice, MMS)

Webhook Setup

Configure these webhook URLs in your Vonage dashboard:

• Inbound URL — https://api.yourdomain.com/webhooks/vonage/inbound/{tenantId}
• Status URL — https://api.yourdomain.com/webhooks/vonage/status/{tenantId}

Replace {tenantId} with your organization's tenant ID.

Twilio

Twilio integration supports SMS sending with API credentials. Configure:

• Account SID — Your Twilio Account SID
• Auth Token — Your Twilio Auth Token
• Enabled — Toggle on/off

Setting a Default Provider

Navigate to Integrations and set the Default SMS Provider to control which provider is used when no campaign-level override is configured. Options: vonage, twilio, telnyx.

Provider Resolution Order

When sending an SMS, the provider is resolved in this order:

1. Campaign override — If the campaign has a specific SMS provider configured
2. Tenant default — The organization's default SMS provider setting
3. Fallback — vonage