¿Cómo leo las llamadas y sus resultados, y llamo un lote por API?

Objetivo: Listar y leer llamadas con su resultado, y crear y controlar lotes de llamadas.

Nivel: Avanzado · Duración: 3 min · Antes de esta lección: «¿Cómo consulto mis pedidos y su estado por API?»

Dónde, en Talkyria: app.talkyria.com/integraciones/api

Gancho

Tu reporte semanal necesita cada llamada con su resultado, y tu operación necesita llamar 200 pedidos atrasados de una vez. Las dos cosas se hacen con la API.

Lo que vas a lograr

Vas a listar y filtrar llamadas, leer el resultado y el análisis de una, y lanzar y controlar un lote de llamadas.

Pasos en pantalla

1. Listar: GET https://api.talkyria.com/api/v1/calls, con el permiso de leer llamadas. Filtra por status, callType, phone y fechas from y to. limit llega hasta 50.
2. Cada llamada trae outcome, durationSeconds, summary, notesForHuman, cancelReason y disconnectionReason, además de channel, que dice si llamó la IA o un asesor.
3. En analysis vienen respuestas cortas de la IA: si el número era equivocado, si cambió la dirección, si confirmó el producto y el precio, y el sentimiento.
4. Con el permiso de ofertas, offer dice si se mostró la oferta y si la aceptó. Con el de contenido sensible, transcript y recordingUrl.
5. Una sola llamada: GET /calls/{id}.
6. Lote: POST /calls/bulk con orderIds, una lista de pedidos, o con status y limit. Hasta 500 pedidos por lote. Opcional: agentId para que un solo agente haga todas las llamadas.
7. Controla el lote con POST /calls/bulk/{id} y action pause, resume o cancel. Consulta su avance con GET /calls/bulk/{id}.

Error común y cómo resolverlo

Enviar un lote sin agentId cuando hay pedidos sin agente claro. La respuesta es «409» con agent_choice_required, la lista de pedidos sin agente y los agentes candidatos. Elige uno y envíalo en agentId.

¿Y ahora qué?

Ahora deja que Talkyria te avise solo de cada resultado, con webhooks firmados. Siguiente lección: «¿Cómo recibo cada resultado con webhooks y compruebo que vienen de Talkyria?».