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


---

# 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.klink.cloud/getting-started/setup-channels/sms/vonage-sms-integration-guide.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.