Vonage - LevelAI Integration

Last updated: June 18, 2026

Required API Credentials

To proceed with the setup, we will need the following credentials from the clients team:

  • Client ID: To be provided by Client (Vonage admin/POC)

  • Client Secret: To be provided by Client (Vonage admin/POC)

  • Scope: To be provided by Client (Vonage admin/POC)

We would need the following scope: 
stats interaction-content:read users:read users:write

These are required to access both the Interactions and Users API endpoints.

INFO
Vonage’s documentation here should guide your team on generating these credentials: How to authenticate with a Vonage Contact Center (VCC) API

API Endpoints We Use

Below is a list of the API calls our system makes, along with their required parameters. This should help LevelAI team ensure the proper scope access is granted.

  1. Authentication

    • POST /Auth/connect/token

    • Params: grant_type, client_id, client_secret, scope

    • Purpose: Obtain OAuth access token

  2. List Interactions

    • GET /stats/interactions

    • Params: start, end, page, limit

    • Purpose: Retrieve interactions within a time range (paginated)

  3. Get Agent Profile

    • GET/useradmin/users/by/agentDisplayId/{agent_id}

    • Params: agent_id (path)

    • Purpose: Fetch agent details such as name, email, and userId

  4. Download Call Recording

    • GET
      /interaction content/interactions/{interaction_id}/content/callrecording

    • Params: interaction_id (path)

    • Purpose: Download call recording (WAV format)

  5. Get Specific Interaction (debugging/ occasional use)

    • GET /stats/interactions/{interaction_id}

    • Params: interaction_id (path)

    • Purpose: Retrieve details of a specific interaction