Copy page

Voice AI Integrations

Vapi-IraVoice Integration

Overview

IraVoice can integrate with Vapi using Vapi's WebSocket transport mechanism. This integration allows IraVoice to connect live PSTN calls to a Vapi voicebot over a secure WebSocket (WSS) connection.

When a call is answered, IraVoice requests a dynamically generated WebSocket URL from your application. Your application is responsible for creating a Vapi WebSocket session and returning the corresponding WSS URL to IraVoice.

---

Integration Flow

1. An inbound or outbound call is established through IraVoice.
2. Once the call is answered, IraVoice sends an HTTP POST request to your configured endpoint.
3. Your application creates a new Vapi WebSocket transport session.
4. Vapi returns a dynamic WebSocket URL.
5. Your application returns this WSS URL in the HTTP response.
6. IraVoice connects to the returned WebSocket endpoint and begins streaming audio between the caller and the Vapi voicebot.

---

Creating a Vapi WebSocket Session

Your application must create a WebSocket session using the Vapi Call API.

Sample Request

Code
curl 'https://api.vapi.ai/call' \
  -H 'authorization: Bearer YOUR_API_KEY' \
  -H 'content-type: application/json' \
  --data-raw '{
    "assistantId": "YOUR_ASSISTANT_ID",
    "transport": {
      "provider": "vapi.websocket",
      "audioFormat": {
        "format": "pcm_s16le",
        "container": "raw",
        "sampleRate": 16000
      }
    }
  }'

The response contains a dynamically generated WebSocket URL that can be used to connect the call audio stream to the Vapi assistant.

---

Endpoint Requirements

You must expose an HTTP endpoint that IraVoice can invoke when a call is answered.

Sample Endpoint

Code
POST /vapi/wss-url

Request from IraVoice

IraVoice sends a POST request to your endpoint after the call has been answered.

Example:

Code
{
  "call_uuid": "12345678-abcd-1234-abcd-1234567890ab"
}

The exact payload may vary depending on your implementation requirements.

---

Expected Response

Example Response:

Code
{
  "call_uuid": "12345678-abcd-1234-abcd-1234567890ab",
  "wss_url": "wss://your-vapi-generated-websocket-url"
}

---