Vonage

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

   

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.
7. If using Data Inspection, click the Enable Data Inspection checkbox and provide a Min Likelihood of results.
8. Paste the API Key, API Secret, and JWT Token into their respective fields.

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

12. Congratulations, you are now connected to Vonage.

Manage this integration with Terraform

Connections for this integration can be managed as code with the Relyance Terraform provider. 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.

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