# 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](/files/-Md64QX0kzqYdchcYsNw)

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](/files/-Md64amiftpczzTep6uq)

**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](/files/aj6SGiMmHuI8wwtkX8W8)

{% 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.

![](/files/BYS7dT8wIcBd9vNChSiQ)

**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

![](/files/-Md66978UYdr-gEIj0HM)

![](/files/kJ7erAPOTgwbMcuvFC2c)

**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.

![](/files/-Md66_eI45UdtB2b-IlU)

**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

![](/files/-Md66dJVcTUBxfLmoLsP)

**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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.is-messenger.com/ismessenger/messaging-channels/sms/vonage-sms.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.