Pre-Call Init - TurnCall

Pre-call initialization lets you dynamically select and configure the agent before a call starts — like Vapi’s call-init or ElevenLabs’ conversation-init. Works on all transports.

Supported Transports

Transport	Trigger	`call.type` value
Twilio voice	`routing_target_type: "webhook"` on phone number	`inboundPhoneCall`
WhatsApp voice	`routing_target_type: "webhook"` on phone number	`inboundWhatsAppCall`
WebRTC	`server_url` in POST /v1/webrtc/connect body	`webrtc`

Setup

Phone numbers (Twilio / WhatsApp)

Bind with routing_target_type: "webhook":

curl -X POST http://localhost:8090/v1/phone-numbers \
  -H "Authorization: Bearer tc_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "e164_number": "+15551234567",
    "external_number_sid": "PNxxx",
    "routing_target_type": "webhook",
    "server_url": "https://your-server.com/turncall/init"
  }'

WebRTC

Pass server_url in requestData:

POST /v1/webrtc/connect
{
  "sdp": "v=0...",
  "type": "offer",
  "requestData": {
    "server_url": "https://your-server.com/turncall/init"
  }
}

Your Server Receives

{
  "message": {
    "type": "call-init",
    "call": {
      "id": "call-uuid",
      "provider_call_id": "CA...",
      "type": "inboundPhoneCall"
    },
    "phoneNumber": {"number": "+15551234567"},
    "customer": {"number": "+15559876543"},
    "timestamp": "2026-04-06T12:00:00Z"
  }
}

Response Options

Agent ID
Agent ID + Variables
Inline Agent
Full Response

{
  "agent_id": "agent-uuid-here"
}

{
  "agent_id": "agent-uuid-here",
  "variables": {
    "customer_name": "John Smith",
    "account_id": "ACC-123"
  }
}

{
  "agent": {
    "system_prompt": "You are helping John Smith...",
    "first_message": "Hello John!"
  }
}

{
  "agent_id": "agent-uuid-here",
  "variables": {"customer_name": "Jane", "tier": "enterprise"},
  "metadata": {"crm_id": "C-789"},
  "dynamic_data": {
    "knowledge_context": "Customer has 2 open tickets: #101, #102."
  }
}

Response Fields

Field	Purpose
`agent_id`	Load existing agent by UUID
`agent`	Inline agent config (alternative to `agent_id`)
`variables`	Template variables rendered into `{{placeholders}}` in prompts
`metadata`	Stored on call record for analytics
`dynamic_data.knowledge_context`	Prepended to system prompt as runtime context

What Happens

call.initializing webhook event fires (informational)

Template {{variables}} are rendered into the system prompt

knowledge_context is prepended to the system prompt

metadata is stored on the call record

call.started event fires

Pipeline starts with the resolved configuration

For persistent, searchable knowledge, use the Knowledge Base API instead of knowledge_context. Use knowledge_context for per-call dynamic data like CRM records or open tickets.

​Supported Transports

​Setup

​Phone numbers (Twilio / WhatsApp)

​WebRTC

​Your Server Receives

​Response Options

​Response Fields

​What Happens

Supported Transports

Setup

Phone numbers (Twilio / WhatsApp)

WebRTC

Your Server Receives

Response Options

Response Fields

What Happens