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

# SMS

> Integrate SMS providers with WorldVisa to deliver text message notifications. Configure providers, set up workflows, and manage delivery.

The SMS channel delivers messages to your subscribers’ mobile devices through your configured SMS provider integrations.

> [!NOTE]
>
> **SMS is outbound-only in WorldVisa.** You can send SMS through workflows, but WorldVisa does not receive or route inbound SMS replies. For two-way messaging, handle inbound SMS with your provider's webhooks directly.

## How SMS delivery works in WorldVisa

Here’s the typical flow for sending an SMS notification through WorldVisa:

**Step 1**

### Add an SMS provider

Start by adding an SMS provider in the **Integration Store** on your WorldVisa dashboard. You can connect one or more integrations for the different or the same providers.

To learn [how to add an SMS provider](https://docs.worldvisagroup.com/developers/integrations/sms#supported-providers), refer to the guide for that provider.

**Step 2**

### Add the SMS channel to your workflow

Next, include an [SMS step in your workflow](https://docs.worldvisagroup.com/developers/workflow/create-a-workflow.md). This step defines when and how an SMS should be sent as part of your notification workflow.

**Step 3**

### Define the SMS content

Within the SMS step editor, write the message body. The editor supports dynamic data for personalized content.

**Step 4**

### Store subscriber phone number

WorldVisa automatically sends the notification to the phone number stored on the subscriber's profile. You must ensure that this field is set for any subscriber who needs to receive SMS messages. You can store subscribers phone number using the WorldVisa API, or SDK.

**Step 5**

### Trigger the workflow

Trigger the workflow from your application code by sending an event to WorldVisa.
WorldVisa automatically:

* Resolves the subscriber.
* Selects the correct provider. See [Integration conditions](https://docs.worldvisagroup.com/developers/integrations/integration-conditions.md).
* Renders the SMS template.
* Delivers the message through the configured SMS integration.

> [!NOTE]
>
> Some countries restrict using verified `from` sender IDs (name). Kindly check the country- and provider-specific requirements first.

## Configuring SMS providers

To add an SMS provider from the **Integration Store**, you must configure settings and credentials that are specific to that SMS provider.

### Default sender settings

The **From** field, which is displayed as the sender of the SMS, is a required default setting for any SMS provider that you connect. You can override this field during trigger if necessary.

### Provider authentication

You must provide credentials specific to your SMS provider, such as:

* API key
* Auth token
* Account SID
* Username
* Password.

Each provider has different requirements.

> [!NOTE]
>
> Refer to the [supported SMS providers](https://docs.worldvisagroup.com/developers/integrations/sms#supported-providers) list for detailed setup guides for each provider integration.

## Override SMS settings

You can override the SMS settings when triggerring a notification by passing the `overrides` object. The overrides object field supports an `sms` property and `from`, `to`, and `content` field overrides. This lets you send a message to a different recipient, from a different sender, or with a different content.

```bash theme={null}
curl -L -X POST "${WV_API_URL}/v1/events/trigger" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H "Authorization: ApiKey ${WV_API_KEY}" \
-d '{
    "name": "workflowId",
    "to": {
        "subscriberId": "subscriberId"
    },
    "overrides": {
        "sms": {
            "to": "+123012345678",
            "from": "WorldVisa Team",
            "content": "This SMS message is from overrides"
        }
    }
}'
```

## Target a specific provider

By default, WorldVisa uses your primary SMS provider. To route automatically from subscriber or context data, see [Integration conditions](https://docs.worldvisagroup.com/developers/integrations/integration-conditions.md). To force a specific, active integration for a trigger, then use the `integrationIdentifier`.

This is useful if you have multiple active integrations for different purposes. For example, you might have one integration for transactional SMS and one for security SMS. You can find the `integrationIdentifier` in the **Integration Store** of the WorldVisa dashboard.

When you pass `integrationIdentifier` in `overrides.sms`, WorldVisa sends through that integration and doesn't check [integration conditions](https://docs.worldvisagroup.com/developers/integrations/integration-conditions.md) for the step. If the integration doesn't exist or isn't active, the step fails instead of falling back to the primary integration.

```bash theme={null}
curl -L -X POST "${WV_API_URL}/v1/events/trigger" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H "Authorization: ApiKey ${WV_API_KEY}" \
-d '{
    "name": "workflowId",
    "to": {
        "subscriberId": "subscriberId"
    },
    "overrides": {
        "sms": {
            "integrationIdentifier": "infobip-abcdef"
        }
    }
}'
```

## Supported providers

Here are the SMS providers that are currently supported by WorldVisa. Select any provider to see its detailed setup guide.

> [card] [Twilio](https://docs.worldvisagroup.com/developers/integrations/sms/twilio.md)
>
> Learn how to use the Twilio provider to send SMS notifications using WorldVisa.

> [card] [MessageBird](https://docs.worldvisagroup.com/developers/integrations/sms/messagebird.md)
>
> Learn how to use the MessageBird provider to send SMS notifications using WorldVisa.

> [card] [CM.com](https://docs.worldvisagroup.com/developers/integrations/sms/cm-com.md)
>
> Learn how to use the CM.com provider to send SMS notifications using WorldVisa.

> [card] [Azure SMS](https://docs.worldvisagroup.com/developers/integrations/sms/azure.md)
>
> Learn how to use the Azure SMS provider to send SMS notifications using WorldVisa.

> [card] [Clicksend](https://docs.worldvisagroup.com/developers/integrations/sms/clicksend.md)
>
> Learn how to use the Clicksend provider to send SMS notifications using WorldVisa.

> [card] [BulkSMS](https://docs.worldvisagroup.com/developers/integrations/sms/bulk-sms.md)
>
> Learn how to use the BulkSMS provider to send SMS notifications using WorldVisa.

> [card] [Termii](https://docs.worldvisagroup.com/developers/integrations/sms/termii.md)
>
> Learn how to use the Termii provider to send SMS notifications using WorldVisa.

> [card] [Kudosity](https://docs.worldvisagroup.com/developers/integrations/sms/kudosity.md)
>
> Learn how to use the Kudosity provider to send SMS notifications using WorldVisa.

> [card] [Sendchamp](https://docs.worldvisagroup.com/developers/integrations/sms/sendchamp.md)
>
> Learn how to use the Sendchamp provider to send SMS notifications using WorldVisa.

> [card] [SMS Central](https://docs.worldvisagroup.com/developers/integrations/sms/sms-central.md)
>
> Learn how to use the SMS Central provider to send SMS notifications using WorldVisa.

> [card] [smsmode](https://docs.worldvisagroup.com/developers/integrations/sms/smsmode.md)
>
> Learn how to use the smsmode provider to send SMS notifications using WorldVisa.

> [card] [iSend SMS](https://docs.worldvisagroup.com/developers/integrations/sms/isend-sms.md)
>
> Learn how to use the iSend SMS provider to send SMS notifications using WorldVisa.

> [card] [iSendPro](https://docs.worldvisagroup.com/developers/integrations/sms/isendpro.md)
>
> Learn how to use the iSendPro provider to send SMS notifications using WorldVisa.

> [card] [SMS Webhook](https://docs.worldvisagroup.com/developers/integrations/sms/sms-webhook.md)
>
> Learn how to send SMS through your own HTTP API using WorldVisa.


## Related topics

- [SMS Central SMS Integration with WorldVisa](https://docs.worldvisagroup.com/developers/integrations/sms/sms-central.md)
- [SMS Webhook SMS Integration with WorldVisa](https://docs.worldvisagroup.com/developers/integrations/sms/sms-webhook.md)
- [Azure SMS SMS Integration with WorldVisa](https://docs.worldvisagroup.com/developers/integrations/sms/azure.md)
- [smsmode SMS Integration with WorldVisa](https://docs.worldvisagroup.com/developers/integrations/sms/smsmode.md)


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