Payload de webhook de voz

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

Payload de ejemplo

1{
2 "event": {
3 "id": "evt_voice_abc123",
4 "channel": "voice",
5 "timestamp": 1706640000.0,
6 "data": {
7 "timestamp": 1706640000.0,
8 "direction": "inbound",
9 "platform": "voice",
10 "call_id": "call_xyz789",
11 "vapi_status": "completed",
12 "duration": 245,
13 "cost": 0.15,
14 "recording_url": "https://storage.example.com/recordings/call_xyz789.mp3",
15 "transcription": "Agent: Hello, thanks for calling...\nLead: Hi, I'm interested in...",
16 "summary": "Lead inquired about pricing for premium plan. Scheduled demo for Friday.",
17 "tools_called": ["book_appointment", "check_availability"],
18 "analysis_result": {
19 "sentiment": "positive",
20 "intent": "purchase"
21 },
22 "appointments": [
23 {
24 "datetime": "2024-02-01T10:00:00Z",
25 "type": "demo",
26 "confirmed": true
27 }
28 ]
29 }
30 },
31 "lead_id": "lead_123",
32 "lead_contact": {
33 "number": "+15551234567",
34 "email": "john@example.com",
35 "name": "John Doe"
36 },
37 "business_id": "biz_456",
38 "lead_created": false
39}

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