API Documentation

Integrate VoxNexus voice AI into your applications.

Authentication

All API requests require a Bearer token. Generate one in your admin dashboard under Settings.

Authorization: Bearer your-api-token

Webhooks

VoxNexus sends webhook events for session lifecycle.

POST /api/v1/webhooks/vapi

Receives Vapi voice engine events. Configure your webhook URL in the admin panel.

Event Types:

Type Description
status-updateCall started, ended
transcriptReal-time speech transcription
function-callAI tool invocation (record_answer, flag_concern, etc.)
end-of-call-reportFull transcript + recording URL after call ends

Embeddable Widget

Add a voice AI widget to any website with a single script tag.

<script src="https://voice.progroup.hr/widget.js"></script>
<script>
  VoxNexus.init({
    agentId: 'your-agent-id',
    position: 'bottom-right',  // bottom-right, bottom-left, top-right, top-left
    theme: 'light',            // light, dark
    language: 'hr',            // hr, en, de, sl
    brandColor: '#7c3aed',     // custom brand color
    onSessionStart: function(data) {
      console.log('Session started');
    },
    onSessionEnd: function(data) {
      console.log('Session ended', data);
    }
  });
</script>

Interview Session Links

Generate unique interview links for candidates.

Format: https://voice.progroup.hr/s/{invite_token}

Flow: Pre-session (mic check + GDPR consent) → Active session (AI interview) → Post-session (thank you)

Session States:

scheduled waiting active completed abandoned

Supported Languages

🇭🇷

Croatian

hr

🇸🇮

Slovenian

sl

🇩🇪

German

de

🇬🇧

English

en

Rate Limits

EndpointLimit
API endpoints60 requests/minute
Webhooks100 requests/second
Widget scriptNo limit (cached)

VoxNexus Voice AI Platform — progroup.hr