Custom Integrations

Overview

Not using one of our pre-built integrations? No problem. Send call data from any voice AI platform or custom application — just provide an audio file and Roark handles the rest: transcription, speech analysis, sentiment detection, and metric collection.

Send a Call

Node.js
Python
cURL

Install the Node.js SDK:

npm install @roarkanalytics/sdk

import Roark from '@roarkanalytics/sdk'

const client = new Roark({
  bearerToken: process.env.ROARK_API_BEARER_TOKEN,
})

const call = await client.call.create({
  recordingUrl: 'https://your-storage.com/call-recording.mp3',
  startedAt: '2024-01-15T10:00:00Z',
  interfaceType: 'PHONE',
  callDirection: 'INBOUND',
  agent: {
    name: 'Support Agent',
    customId: 'custom-agent-1',
  },
  customer: {
    phoneNumberE164: '+1234567890',
  },
  properties: {
    department: 'sales',
    region: 'us-east',
  },
})

Install the Python SDK:

pip install roark-analytics

import os
from roark_analytics import Roark

client = Roark(
    bearer_token=os.environ.get("ROARK_API_BEARER_TOKEN"),
)

call = client.call.create(
    recording_url="https://your-storage.com/call-recording.mp3",
    started_at="2024-01-15T10:00:00Z",
    interface_type="PHONE",
    call_direction="INBOUND",
    agent={
        "name": "Support Agent",
        "customId": "custom-agent-1",
    },
    customer={
        "phoneNumberE164": "+1234567890",
    },
    properties={
        "department": "sales",
        "region": "us-east",
    },
)

Use the REST API directly:

curl --request POST \
  --url https://api.roark.ai/v1/call \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "recordingUrl": "https://your-storage.com/call-recording.mp3",
    "startedAt": "2024-01-15T10:00:00Z",
    "interfaceType": "PHONE",
    "callDirection": "INBOUND",
    "agent": {
      "name": "Support Agent",
      "customId": "custom-agent-1"
    },
    "customer": {
      "phoneNumberE164": "+1234567890"
    },
    "properties": {
      "department": "sales",
      "region": "us-east"
    }
  }'

Once a call is created, it appears in Call History and is automatically transcribed and analyzed.

What You Can Send

Data	Description
Audio file	MP3, WAV, M4A, or FLAC — via public URL or base64
Metadata	Agent info, customer details, call direction, interface type
Custom properties	Arbitrary key-value pairs for filtering and segmentation
Tool calls	Function/tool invocations made during the conversation
Pre-transcribed text	If you already have a transcript, send it along

Audio Requirements

Spec	Requirement
Format	MP3, WAV, M4A, or FLAC
Sample Rate	8kHz or higher
Channels	Mono or stereo
Duration	Up to 2 hours
File Size	Max 500MB
Access	Publicly accessible URL or base64 encoded

What Happens Next

Once a call is ingested, Roark automatically:

Transcribes and analyzes the conversation — speech patterns, sentiment, 64+ emotions, interruptions, and more
Runs metric collectors — any active metric collectors collect metrics automatically (LLM evaluations, compliance checks, custom KPIs)
Makes it searchable — the call appears in Call History with full filtering by properties, agent, duration, and more

Use With Simulations

Agents created via the API can also be used in simulations. When you send calls with an agent.customId, Roark creates or matches an agent record that you can then target in simulation run plans — useful for testing custom-built voice agents that aren’t on a pre-built platform.

MCP Server

If you use an AI-powered development environment, the Roark MCP Server gives your AI assistant direct access to the Roark API — including creating calls, querying metrics, and managing agents — without writing integration code manually.

Getting Started

Generate an API Key

Create an API key in your Roark dashboard

Send Your First Call

Upload an audio file using the SDK or REST API above

Configure Collectors

Set up metric collectors to automatically collect metrics on every call

Explore Your Data

Browse calls in Call History, build reports, and create dashboards

Resources

Enable Tracing

Send OpenTelemetry traces from any platform

Node.js SDK

Full SDK guide and reference

Python SDK

Full SDK guide and reference

API Reference

Complete REST API documentation

Getting Started

Observability

Metrics

Simulations

Recipes

Integrations

SDKs & Libraries

Resources

Overview

Send a Call

What You Can Send

Audio Requirements

What Happens Next

Use With Simulations

MCP Server

Getting Started

Resources

Enable Tracing

Node.js SDK

Python SDK

API Reference

​Overview

​Send a Call

​What You Can Send

​Audio Requirements

​What Happens Next

​Use With Simulations

​MCP Server

​Getting Started

​Resources

Enable Tracing

Node.js SDK

Python SDK

API Reference

Overview

Send a Call

What You Can Send

Audio Requirements

What Happens Next

Use With Simulations

MCP Server

Getting Started

Resources