Payload de webhook de voz

Los webhooks de voz se envían cuando las llamadas se inician, completan o fallan.

Payload de ejemplo

{
"event": {
"id": "evt_voice_abc123",
"channel": "voice",
"timestamp": 1706640000.0,
"data": {
"timestamp": 1706640000.0,
"direction": "inbound",
"platform": "voice",
"call_id": "call_xyz789",
"vapi_status": "completed",
"duration": 245,
"cost": 0.15,
"recording_url": "https://storage.example.com/recordings/call_xyz789.mp3",
"transcription": "Agent: Hello, thanks for calling...\nLead: Hi, I'm interested in...",
"summary": "Lead inquired about pricing for premium plan. Scheduled demo for Friday.",
"tools_called": ["book_appointment", "check_availability"],
"analysis_result": {
"sentiment": "positive",
"intent": "purchase"
},
"appointments": [
{
"datetime": "2024-02-01T10:00:00Z",
"type": "demo",
"confirmed": true
}
]
}
},
"lead_id": "lead_123",
"lead_contact": {
"number": "+15551234567",
"email": "john@example.com",
"name": "John Doe"
},
"business_id": "biz_456",
"lead_created": false
}

Referencia de campos

Campos principales

CampoTipoRequeridoDescripción
timestampfloatMarca de tiempo Unix epoch
directionstringinbound o outbound
platformstringSiempre voice
call_idstringIdentificador único de llamada
vapi_statusstringEstado de la llamada (ver valores abajo)

Valores de vapi_status

ValorDescripción
initiatedLlamada iniciada, timbrando
completedLlamada terminada exitosamente
failedLlamada falló al conectar
busyLínea del destinatario ocupada
no-answerSin respuesta después de timbrar

Campos opcionales

CampoTipoDescripción
durationintegerDuración de la llamada en segundos
costfloatCosto de la llamada en USD
recording_urlstringURL de la grabación de audio
transcriptionstringTranscripción completa de la llamada
summarystringResumen de la llamada generado por IA
tools_calledarrayLista de nombres de herramientas ejecutadas durante la llamada
tool_callsarrayDatos sin procesar de llamadas a herramientas con argumentos y resultados
analysis_resultobjectResultado del análisis de IA (sentimiento, intención, etc.)
appointmentsarrayDatos de citas extraídos

Array de appointments

CampoTipoDescripción
datetimestringFecha y hora ISO 8601
typestringTipo de cita
confirmedbooleanSi está confirmada

Array de tool_calls

CampoTipoDescripción
namestringNombre de la herramienta
argumentsobjectArgumentos de entrada
resultobjectResultado de la ejecución de la herramienta

Valores de dirección

ValorDescripción
inboundProspecto llamó
outboundAgente llamó al prospecto