> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.cloudbridal.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Vonage Integration (SMS)

The Vonage Integration allows you to integrate with [Vonage](https://www.vonage.com/communications-apis/) to send and receive SMS messages directly in CloudBridal. This has many advantages over our built-in messaging including removing the 150-character limit on SMS messages and allowing you to use automated SMS messaging functionality like appointment reminders and automated rules-based messaging.

||| The Vonage integration is offered as an alternative to [Twilio](https://help.cloudbridal.com/en/article/twilio-integration-sms-1cbkr2n/) for users based in the UK. When possible, we recommend using Twilio instead as it has improved support for features like MMS.

## Requirements

- You must be on the **Core** or **Ultimate** plan in order to enable SMS messaging.
- Register for a [Vonage account (formerly Nexmo)](https://www.vonage.com/communications-apis/sms/).
- Add a payment method to your Vonage account, as Vonage charges for SMS messages sent and received. See regional pricing [here](https://www.vonage.com/communications-apis/sms/pricing/).

## Configuring Vonage

1. In CloudBridal, open **Vonage** in [Settings > Integrations](https://go.cloudbridal.com/settings/integrations) and click **Turn on**.
2. Register for a [Vonage account (formerly Nexmo)](https://www.vonage.com/communications-apis/sms/).
3. Go into the [API Settings](https://dashboard.nexmo.com/settings) page and copy your **API key** and **API Secret**. You will need these later.

![The Vonage API Key and Secret](https://storage.crisp.chat/users/helpdesk/website/-/c/a/0/9/ca09be8644de0800/image_yjmtig.png)

4. Navigate to the [Buy Numbers](https://dashboard.nexmo.com/buy-numbers) page and purchase a number. You may first need to fund your account before they will allow you to purchase a number.

![The Vonage page to purchase a number](https://storage.crisp.chat/users/helpdesk/website/-/c/a/0/9/ca09be8644de0800/image_77hsbv.png)

5. Navigate to the [Your Numbers](https://dashboard.nexmo.com/your-numbers) page, where you will see the number you purchased. Copy the number into the same place along with your **API key** and **API Secret** from before.

![Copy number from Vonage](https://storage.crisp.chat/users/helpdesk/website/-/c/a/0/9/ca09be8644de0800/image_16f36ab.png)

6. Click the pencil icon to edit the phone number, and in the **Inbound Webhook URL** field, paste the **Reply address** shown under **Replies** in your [Vonage settings in CloudBridal](https://go.cloudbridal.com/settings/integrations). Paste it exactly as shown.
7. In your [Vonage settings in CloudBridal](https://go.cloudbridal.com/settings/integrations), enter your **API key**, **API secret**, and **Phone number** from earlier, then click **Save**. Once saved, your API secret isn't shown again: leave the field empty to keep it, or enter a new one to replace it.
8. Test the integration by sending a test SMS message from a CloudBridal prospect/customer record. You should also try replying to the SMS message from your phone and validate that it is received in CloudBridal.

## Opt-Out Keywords (STOP / START / HELP)

- If a customer texts **STOP** (or a similar keyword like UNSUBSCRIBE or CANCEL), CloudBridal blocks all further texts to them. Only the customer can undo this by texting **START** — staff cannot clear it.
- Unlike Twilio, Vonage does not auto-reply to **HELP** by default — HELP replies arrive in CloudBridal as regular inbound messages, so your staff should answer them like any other text.

See [Email & SMS Communications](https://help.cloudbridal.com/en/article/email-sms-communications-1kqe3ky/) for the full consent and opt-out behavior.

## Delivery Status

CloudBridal shows whether each text was delivered without any extra setup in Vonage. See [Email & SMS Communications](https://help.cloudbridal.com/en/article/email-sms-communications-1kqe3ky/) for where delivery status appears.