> For the complete documentation index, see [llms.txt](https://docs.klink.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.klink.cloud/getting-started/setup-channels/sms/vonage-sms-integration-guide.md).

# Vonage SMS Integration Guide

#### **Overview**

This guide explains how to connect your **Vonage SMS Provider** with the **klink.cloud** platform.\
Once integrated, you can send and receive SMS messages directly from your klink.cloud inbox, manage customer interactions, and automate workflows — all within a unified omnichannel communication dashboard.

{% embed url="<https://www.loom.com/share/285304f6f24245e5a3154cd56d972dbb>" %}

***

### **1. Prerequisites**

Before starting, ensure that you have:

* A **klink.cloud** account with admin or integration access.
* A **Vonage (formerly Nexmo)** account.
* At least one **active phone number** purchased in your Vonage account.
* Your **Vonage API Key** and **API Secret**.
* Internet access to log in to both dashboards.

***

### **2. Step-by-Step Setup Instructions**

#### **Step 1: Access the Messaging Channel Settings**

1. Log in to your **klink.cloud** dashboard.
2. Navigate to:\
   **Settings → Message Channels → Add Channel → SMS.**
3. A new setup window will open.
4. Enter a **Channel Name** — this helps you identify the SMS line (e.g., *Demo SMS*, *Sales SMS*, or *Support Line*).
5. Optionally, you can use your **phone number** as the channel name for clarity.

***

#### **Step 2: Select Vonage as the SMS Provider**

1. Under **SMS Provider**, select **Vonage** from the dropdown list.
2. In the **Mobile Number** field, log in to your Vonage account and choose one of your available numbers.
   * If you don’t have one yet, go to your Vonage dashboard → **Numbers → Buy Number**, and select one for your region.
3. Copy the number (e.g., `6581234567`) and paste it into the **Mobile Number** field on klink.cloud.

   > **Important:** Do *not* include the country code (“+65” or “+1”) in this field.

***

#### **Step 3: Configure Sender ID (Optional)**

* If your Vonage account supports a **Sender ID** (also known as a Brand Name or Sender Name), enter it under **Sender ID**.
* The Sender ID will replace your phone number in outbound messages when allowed by the recipient country’s carrier.
* If you don’t have a Sender ID, you may **leave this field blank**.

***

#### **Step 4: Retrieve and Add Your Vonage API Credentials**

1. In your **Vonage Dashboard**, go to **API Settings** → **API Keys**.
2. Copy your **API Key** and **API Secret**.
3. Paste them into the following fields in klink.cloud:
   * **API Key** → `Your Vonage API Key`
   * **API Secret** → `Your Vonage API Secret`
4. If you don’t have an API secret yet:
   * Click **Create New Secret** in Vonage, copy it, and then paste it into klink.cloud.

***

#### **Step 5: Configure Webhook for Inbound SMS**

To ensure klink.cloud receives inbound messages:

1. In klink.cloud, copy the **Webhook URL** displayed on your SMS channel setup page.
   * This webhook URL allows Vonage to forward all incoming SMS to klink.cloud.
2. Go to your **Vonage Dashboard** → **Numbers → Edit Number**.
3. Locate the field labeled **Inbound Webhook URL** (or **Webhook for Incoming Messages**).
4. Paste the **Webhook URL** you copied from klink.cloud.
5. Save the settings in your Vonage dashboard.

> ✅ **Tip:** This ensures that every SMS received on your Vonage number is automatically routed to your klink.cloud inbox for real-time visibility.

***

#### **Step 6: Complete and Save Channel Setup**

1. After filling all the required fields — *Channel Name, Provider, Mobile Number, API Key, API Secret, and Webhook URL* — click **Save Channel**.
2. The channel will appear in your list of active SMS channels.
3. Status will show **Connected** once klink.cloud successfully communicates with Vonage’s API.

***

### **3. Testing the Integration**

To verify your connection:

1. Open your mobile phone and send a test SMS to the Vonage number you linked.
2. Check your klink.cloud **Inbox** → **SMS Channel** to see if the message appears.
3. Try replying directly from klink.cloud — this should deliver a message back to your phone.

> **If both inbound and outbound messages are successful**, your Vonage SMS integration is complete.