VAPI Setup Guide
Evaluate calls from VAPI
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.
🎉 You’re all set! Your VAPI assistant is now integrated with Roark.
Prerequisites
Before starting, ensure you have:
- ✅ A VAPI account with an active agent
- ✅ An n8n account with an active instance and workflow
- ✅ A Roark API Key - Generate one here
Create Webhook in n8n
- Create a new workflow or modify an existing one
- Click
Add a node
and search for “webhook” - Configure the webhook node:
- Set HTTP method to POST
- Copy the Production URL for later use
- Activate the workflow by switching from Inactive to Active
Configure VAPI Webhook
- Go to your VAPI agent settings
- Navigate to the Advanced tab
- Scroll to the Messaging section
- Paste your n8n webhook URL in the Server URL field
- Ensure
end-of-call-report
is enabled in Server Messages
Set Up Roark Integration
- Add an HTTP Request node to your n8n workflow
- Connect it to the Webhook node
- Configure the HTTP Request node:
- Method: POST
- URL:
https://api.roark.ai/v1/vapi/call
- Headers:
- Name:
Authorization
- Value:
Bearer <YOUR_API_KEY>
- Name:
- Body:
- Content Type: JSON
- Body Parameters:
- Name:
vapiEndOfCallReportPayload
- Value:
{{ $json.body.message }}
- Name:
Test the Integration
- Make a test call to your VAPI agent
- Verify the data flows through n8n to Roark
- Check your Roark dashboard for the incoming call data
🎉 Your VAPI calls are now being forwarded to Roark through n8n!