VAPI Setup Guide

Overview

Integrating VAPI with Roark lets you automatically send call data for evaluation, analytics, and reporting. Once connected, Roark will receive call recordings and metadata after each interaction, helping you monitor assistant performance and extract insights.

Prerequisites

Before setting up the integration, make sure you have:

✅ A Roark API Key - Generate one here
✅ A VAPI Account & Assistant - Create one on VAPI

Once these are ready, follow the simple steps below to complete the integration.

Setup

Open Your VAPI Assistant Settings

Log in to your VAPI account.
Navigate to the Assistant you want to integrate.

Access the Advanced Tab

Click on the Advanced tab in your assistant’s settings.

Configure the Server URL

VAPI only allows a single webhook. If you already have one configured, you can still send data to Roark by forwarding the payload from your existing webhook.

Scroll down to the Messaging section.
Set the Server URL to: https://api.roark.ai/v1/integrations/vapi
Add a custom header called x-roark-api-key and set the value to the API key you generated on Roark.

Enable Audio Recording

Ensure Privacy > Audio Recording is checked ON.
If this setting is OFF, the integration will not work.
If you prefer not to enable call recordings, you can use our manual API integration instead.

Enable Server Messages

Enable the following server messages in your VAPI settings:

end-of-call-report
status-update
hang

Publish Your Changes

Click Publish to save and activate the integration.

You’re all set! 🎉 Your VAPI assistant will now automatically send call recordings to Roark for analysis.

Open Your VAPI Assistant Settings

Log in to your VAPI account.
Navigate to the Assistant you want to integrate.

Access the Advanced Tab

Click on the Advanced tab in your assistant’s settings.

Configure the Server URL

VAPI only allows a single webhook. If you already have one configured, you can still send data to Roark by forwarding the payload from your existing webhook.

Scroll down to the Messaging section.
Set the Server URL to: https://api.roark.ai/v1/integrations/vapi
Add a custom header called x-roark-api-key and set the value to the API key you generated on Roark.

Enable Audio Recording

Ensure Privacy > Audio Recording is checked ON.
If this setting is OFF, the integration will not work.
If you prefer not to enable call recordings, you can use our manual API integration instead.

Enable Server Messages

Enable the following server messages in your VAPI settings:

end-of-call-report
status-update
hang

Publish Your Changes

Click Publish to save and activate the integration.

You’re all set! 🎉 Your VAPI assistant will now automatically send call recordings to Roark for analysis.

If you’re already receiving VAPI call events through your own webhook, you can simply forward the payload to Roark. This lets you trigger evaluations and analytics without changing your existing setup.

You can forward the data by sending a POST request to Roark’s webhook endpoint with the call metadata and recording URL. You can use tools like Node.js, Python, or any REST client. Optional custom properties can also be included.

You can find the full API specification in the API Reference.

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"vapiEndOfCallReportPayload":{ type: "end-of-call-report"  ... },"properties":{"business_name":"customer-business-name","business_id":"customer-business-id"}}'
};

fetch('https://api.roark.ai/v1/vapi/call', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

🎉 You’re all set! Your VAPI assistant is now integrated with Roark.

Getting Started

Tools

Integrations

SDKs

Overview

Prerequisites

Setup

Getting Started

Tools

Integrations

SDKs

​Overview

​Prerequisites

​Setup

Overview

Prerequisites

Setup