¿Cómo consulto mis pedidos y su estado por API?

Objetivo: Buscar pedidos, leer el detalle de uno con sus llamadas y consultar su estado actual.

Nivel: Avanzado · Duración: 3 min · Antes de esta lección: «¿Cómo creo un pedido y disparo su llamada por API?»

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

Gancho

Tu equipo pregunta «¿ya confirmó el cliente del pedido 1042?». Tu sistema puede responderlo solo, sin entrar al panel, con una consulta a la API.

Lo que vas a lograr

Vas a buscar pedidos, leer el detalle completo de uno y consultar su estado y su última llamada.

Pasos en pantalla

1. Buscar: GET https://api.talkyria.com/api/v1/orders con el permiso «Leer órdenes (cliente, estado, dirección, totales)». Filtra por phone, por externalId o por shopifyOrderId.
2. Pasa siempre limit: si lo omites, un host devuelve 50 y el otro 10. Recorre las páginas con offset mientras pagination.hasMore sea verdadero.
3. Detalle: GET /orders/{id}. Trae el cliente, los productos, totalPrice, currency, la dirección y, si el cliente la corrigió en la llamada, addressFinal.
4. En el mismo detalle vienen confirmationChannel, que dice quién confirmó, attentionReason si necesita a una persona, callAttempts y la lista calls con cada llamada.
5. Si pides el id de un reporte viejo que ya se unió a su pedido, el detalle trae canonicalOrderId: es el pedido donde vive hoy ese contacto.
6. Estado rápido: GET https://app.talkyria.com/api/v1/orders/{id}/status devuelve el estado actual y el resultado de la última llamada.
7. Solo las llamadas de un pedido: GET /orders/{id}/calls, con el permiso de leer llamadas.

Error común y cómo resolverlo

Consultar el pedido cada pocos segundos para saber si ya terminó la llamada. Gastas tu límite de peticiones y te puede responder «429». Para enterarte del resultado sin preguntar, usa los webhooks de la lección «¿Cómo recibo cada resultado con webhooks y compruebo que vienen de Talkyria?».

¿Y ahora qué?

Ahora aprende a actuar sobre un pedido: volver a llamar, pausar y cambiar su estado. Siguiente lección: «¿Cómo vuelvo a llamar, pauso o confirmo un pedido desde mi sistema?».