​
Overview

Not using one of our pre-built integrations? No problem. Roark’s API and SDKs make it simple to send call data from any voice AI platform or custom application. At its core, you just need to send us an audio file and we’ll handle the rest.

​
Integration Options

​
Direct API

Send call data directly to our REST API endpoints: 
curl -X POST https://api.roark.ai/v1/calls \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audio_url": "https://your-storage.com/call-recording.mp3",
    "metadata": {
      "agent_id": "custom-agent-1",
      "customer_phone": "+1234567890",
      "duration": 180
    }
  }'

​
Node.js SDK

Install and use our Node SDK for a more integrated experience: 
import { RoarkClient } from '@roarkanalytics/node-sdk';

const roark = new RoarkClient({ 
  apiKey: process.env.ROARK_API_KEY 
});

// Send a call for analysis
const call = await roark.calls.create({
  audioUrl: 'https://your-storage.com/call-recording.mp3',
  metadata: {
    agentId: 'custom-agent-1',
    customerPhone: '+1234567890',
    duration: 180
  }
});

// Trigger evaluation
const evaluation = await roark.evaluations.create({
  callId: call.id,
  evaluators: ['task_completion', 'sentiment_analysis']
});

​
Python SDK

Use our Python SDK for seamless integration: 
from roarkanalytics import RoarkClient

roark = RoarkClient(api_key="YOUR_API_KEY")

# Send a call for analysis
call = roark.calls.create(
    audio_url="https://your-storage.com/call-recording.mp3",
    metadata={
        "agent_id": "custom-agent-1",
        "customer_phone": "+1234567890",
        "duration": 180
    }
)

# Trigger evaluation
evaluation = roark.evaluations.create(
    call_id=call.id,
    evaluators=["task_completion", "sentiment_analysis"]
)

​
Core Capabilities

With custom integrations, you can:

​
Send Call Data

  • Audio files - MP3, WAV, or any common audio format
  • Transcripts - Pre-transcribed text if available
  • Metadata - Agent info, customer details, call context
  • Tool calls - Track function invocations and API calls

​
Run Evaluations

  • Apply built-in evaluators
  • Create custom evaluation criteria
  • Get scores and insights
  • Track performance over time

​
Manage Agents

  • Register custom agents
  • Track agent versions
  • Compare performance
  • Use agents in simulations

​
Getting Started

1

Generate API Key

Create an API key in your Roark dashboard
2

Choose Integration Method

Select direct API, Node.js SDK, or Python SDK
3

Send Your First Call

Upload an audio file and metadata using your chosen method
4

View Results

Check your Roark dashboard for analysis and insights

​
Audio Requirements

For best results, ensure your audio files meet these specifications:
RequirementSpecification
FormatMP3, WAV, M4A, or FLAC
Sample Rate8kHz or higher
ChannelsMono or stereo
DurationUp to 2 hours
File SizeMax 500MB
AccessPublicly accessible URL or base64 encoded

​
Need a Custom Integration?

If you need deeper integration with a specific platform or have unique requirements:

Contact Our Team

Reach out to discuss custom integration options
 Our team can help with:
  • Native integrations for unsupported platforms
  • Custom webhook handlers
  • Bulk migration from other systems
  • Enterprise-specific requirements

​
Resources

API Reference

Complete API documentation

Node.js SDK

Node.js SDK guide

Python SDK

Python SDK guide

API Keys

Generate credentials