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

• No-code integration
• Forward from webhook via SDK
• Forward from webhook via n8n

1

Open Your VAPI Assistant Settings

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

2

Access the Advanced Tab

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

3

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.

4

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.

5

Enable Server Messages

Enable the following server messages in your VAPI settings:

• end-of-call-report
• status-update
• hang

6

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.