# Vonage SMS Quick Start

{% hint style="info" %}
To connect with Vonage, you will need a [Vonage account](https://dashboard.nexmo.com/sign-up).
{% endhint %}

![Vonage Logo](https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mbui1HRO4dGghy5ITOz%2F-Md64BbCQYgZhpMZPybI%2F-Md64QX0kzqYdchcYsNw%2Fimage.png?alt=media\&token=637dd450-69f3-4ec5-901a-d029ff3d2def)

Vonage is a cloud communications platform that allows you to send and receive SMS text messages through web service APIs.

This Vonage integration lets you respond to SMS messages directly from our platform.

## Setting Up Vonage

### Purchasing **a Virtual Number**

{% hint style="info" %}
Note that you will have to [upgrade to a paid Vonage account](https://dashboard.nexmo.com/payments/new) in order to purchase a Virtual Number.
{% endhint %}

**Step 1: Navigate to the** [**Vonage Developer Dashboard**](https://dashboard.nexmo.com/)\
Sign in with your user credentials. If you are not already signed in, you may have to log in with your [Vonage account](https://dashboard.nexmo.com/sign-up) first.

**Step 2: Purchase a phone number**\
Under the Numbers section of the sidebar, select **Buy numbers**

![Buying a Virtual Number on Vonage](https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mbui1HRO4dGghy5ITOz%2F-Md64BbCQYgZhpMZPybI%2F-Md64amiftpczzTep6uq%2Fimage.png?alt=media\&token=ef3e11d6-8723-4f34-ae61-3b0e128eb9de)

**Step 3: Choose a phone number**\
Select a phone number that you prefer and best suit your company needs. You can select a number from any country available on MessageBird.

![Choosing a Virtual Number](https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mbui1HRO4dGghy5ITOz%2Fuploads%2FcR0OZVxZtVbuCp2kgVIW%2FScreen_Shot_2020-04-20_at_2_35_09_PM.png?alt=media\&token=88094b00-eec3-40ac-9fc1-8c4197455c19)

{% hint style="warning" %}
Be sure to select a phone number that supports SMS capability as it is required for this connection to work. 
{% endhint %}

## Connecting Vonage

**Step 1: Navigate to Channel Settings**\
From **Settings** Module, navigate to the menu item, **Channels**

**Step 2: Add Channel**\
Press **Add Channel** and choose **SMS.** Select **Vonage** on the second step.

![](https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mbui1HRO4dGghy5ITOz%2Fuploads%2FgWAI5UHYNWxK2B6FNme2%2F1.gif?alt=media\&token=492b2eae-59c3-4868-9520-13009c1ac5d3)

**Step 3: Sign in to Vonage** Sign in to [Vonage](https://dashboard.nexmo.com/) using your user credentials

**Step 4: Add API Key and API Secret Find** the API Key and API Secret on the Dashboard and add it to the corresponding fields at IS-Messenger

![](https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mbui1HRO4dGghy5ITOz%2F-Md65gnoEdSrf1MhSzjl%2F-Md66978UYdr-gEIj0HM%2Fimage.png?alt=media\&token=4e909d99-cfcd-4a72-ba50-7ac53c4e0b57)

![](https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mbui1HRO4dGghy5ITOz%2Fuploads%2FnZgYJcV0xaWdxHtTicJ8%2FScreenshot%202023-10-13%20120511.png?alt=media\&token=78349626-62ae-4a85-9459-3f8af1e69235)

**Step 5:** After you've filled in both values, follow the instructions by clicking **Next**.

{% embed url="<https://www.youtube.com/watch?v=ErfUTnpG88w>" %}

**Step 6:** Navigate to [Your Numbers](https://dashboard.nexmo.com/your-numbers) and locate the phone number. Add it to the corresponding field on the respond.io platform.

![](https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mbui1HRO4dGghy5ITOz%2F-Md65gnoEdSrf1MhSzjl%2F-Md66_eI45UdtB2b-IlU%2Fimage.png?alt=media\&token=82ce2374-80a9-4087-8ffa-ae91d6dead5a)

**Step 7: Navigate to the phone number settings**\
Press the settings icon next to the number to be connected

**Step 8: Add the generated URL to Vonage**\
From the ISMessenger platform, copy the generated URL and paste it to the Inbound Webhook URL field at Vonage

![](https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mbui1HRO4dGghy5ITOz%2F-Md65gnoEdSrf1MhSzjl%2F-Md66dJVcTUBxfLmoLsP%2Fimage.png?alt=media\&token=cd2b863c-2c5a-4e4f-beef-df4bd59f3707)

**Step 9: Save Webhook configuration**\
Press Save to save your Webhook configuration.

**Step 10: Complete set up at ISMessenger**\
Press **DONE** to complete set up

{% hint style="success" %}
Once you completed the setup, any SMS sent to the Vonage phone number will now be received in your space.
{% endhint %}

## Channel Configuration

{% hint style="info" %}
Vonage SMS channel can be configured with a unique channel name
{% endhint %}

**Step 1:** Navigate to **Workspace Settings** > Click **Channels**.

**Step 2:** Locate the Vonage SMS Channel > Click **Manage > Configuration**

**Step 3:** Configure the Channel name, which is used internally to identify the account.

{% hint style="warning" %}
Be careful when entering your details as errors might cause failure to receive messages from the connected Vonage SMS account.
{% endhint %}

**Step 4:** Click **Save Changes** to update the Channel configuration.

#### Feeling stuck? Do not fear.