# Vonage

![Vonage_Logo.png](https://assets.relyanceuat.xyz/images/docs/23232317496461/23232317486989.png)
Vonage is a communications platform that provides cloud-based communication solutions for businesses. Vonage helps streamline and enhance real-time communication capabilities within your applications, fostering better customer engagement and collaboration.

In order to integrate Vonage with Relyance AI you will need **API Key**, **API Secret**, and (optionally) a **JWT Token**.

#### In Vonage:

1. Login to your Vonage account.
2. One your main dashboard, you'll see your **API Key** and **API Secret**.
3. Optionally, you can also include a Vonage **JWT Token**, this will enable scanning of the *Conversations*, *Members*, *Events*, *Users*, and *Calls* endpoints. Use the following instructions to create the **JWT Token**:
    1. Click the **Applications** menu on the left.
    2. Click the **+Create a new application** button.
    3. Provide a meaningful name for the application (e.g. Relyance), and click the **Generate public and private key**. The public key will be registered and a file with the private key will be downloaded, store it safely.
    4. Under **Capabilities**, select **Voice**.
    5. Click the **Generate new application** button at the bottom. Copy the generated **Application ID**.
    6. Go to [https://developer.vonage.com/en/jwt](https://developer.vonage.com/en/jwt)
    7. Enter the private key (previously downloaded file content) and the **Application ID**.
    8. Under **ACL**, select:
        - Create and manage Users (users)
        - Create and manage Conversations & send/receive messages (conversations)
    9. Copy the value of **Your JWT** field to be used in Relyance as your **JWT Token**.

    ![Vonage-1.png](https://assets.relyanceuat.xyz/images/docs/23232317496461/23232281109389.png)

#### In the Relyance AI application:

1. Login to your Relyance account.
2. Navigate to the **Settings** Menu in the bottom left-hand side.
3. Select **Integrations**.
4. Click on the **Vendors and Data Stores** filter.
5. Find the **Vonage** integration card and click it to open its connections.
6. Under **Authentication Method**, choose **Custom**.
8. If using Data Inspection, click the **Enable Data Inspection** checkbox and provide a **Min Likelihood** of results.
9. Paste the **API Key**, **API Secret**, and **JWT Token** into their respective fields.

![Vonage-2.png](https://assets.relyanceuat.xyz/images/docs/23232317496461/23232281111053.png)

10. Click **Authenticate**.
11. At this point, you should see the following result on the integrations page:

![Vonage-3.png](https://assets.relyanceuat.xyz/images/docs/23232317496461/23232317491725.png)

12. Congratulations, you are now connected to **Vonage**.

<!-- terraform-examples:begin (generated from the integration catalog; do not hand-edit) -->

## Manage this integration with Terraform

Connections for this integration can be managed as code with the [Relyance Terraform provider](https://registry.terraform.io/providers/Relyance/relyance/latest). Non-secret fields go in `auth.params`; secret fields go in `auth.secrets_wo`, which is write-only — never stored in Terraform state. Rotate secrets by bumping `auth.secrets_wo_version`.

```hcl
resource "relyance_integration_connection" "vonage" {
  vendor = "vonage"
  name   = "<your connection name>"

  auth = {
    method = "api-key"
    params = {
      data_storage_location = "us"
    }
    # Secret fields are write-only: sent to Relyance, never stored in state.
    secrets_wo = {
      api_key = var.vonage_api_key
      api_secret = var.vonage_api_secret
      jwt_token = var.vonage_jwt_token
    }
    secrets_wo_version = 1
  }

  scans = { "data-inspection" = { enabled = true } }
}
```

<!-- terraform-examples:end -->