Saltar al contenido principal
GET
Obtener una conversación

Autorizaciones

Authorization
string
header
requerido

Envía Authorization: Bearer YOUR_API_KEY. La clave corresponde a una sola organización.

Parámetros de ruta

id
string<uuid>
requerido

Respuesta

La conversación.

id
string<uuid>
requerido
agentId
string<uuid>
requerido
name
string
requerido
source
string
requerido

De dónde vino la conversación, p. ej. vapi, retell, speechify, livekit, upload. zelto significa que se envió por la API (POST /webhooks/calls) o con la herramienta MCP upload_conversation.

createdAt
string<date-time>
requerido
updatedAt
string<date-time>
requerido
receiverId
string<uuid> | null
referenceId
string | null
endedReason
string | null
cost
string | null

Proveedor-informó el costo en dólares, como una cadena de precisión.

startedAt
string<date-time> | null

Cuándo empezó realmente la conversación, tal como se envió en call.startedAt. Es nulo cuando quien la envió no indicó la hora de inicio (createdAt es entonces el momento en que Zelto la recibió).

durationSeconds
integer | null

Duración en segundos enteros: el call.durationSeconds enviado; si no, se calcula con call.startedAt y call.endedAt; si no, con el desplazamiento del último turno de la transcripción. Es nulo cuando no se envió ninguno.

analysisStatus
enum<string>

Si Zelto analizó esta conversación. Presente en GET /v1/conversations y GET /v1/conversations/{id}. analyzed: fue admitida para análisis (sus minutos se contaron contra el límite del plan). pending: guardada, el análisis aún no terminó. skipped_too_short: menos de 4 turnos, guardada pero nunca analizada. skipped_plan_limit: su duración completa no cabía en los minutos mensuales restantes cuando llegó (una conversación más corta que sí cabe se analiza). skipped_no_duration: una conversación de voz enviada sin duración. unknown: no se puede determinar. Pueden añadirse valores nuevos; trata uno que no conozcas como "aún sin analizar".

Opciones disponibles:
analyzed,
pending,
skipped_too_short,
skipped_plan_limit,
skipped_no_duration,
unknown