¿Cómo vuelvo a llamar, pauso o confirmo un pedido desde mi sistema?

Objetivo: Usar las operaciones que actúan sobre un pedido existente: volver a llamar, detener o reanudar llamadas, y actualizar su estado logístico o del pedido.

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

El cliente confirmó por WhatsApp y tu agente lo iba a llamar en diez minutos. Con una petición se lo cuentas a Talkyria y la llamada no sale.

Lo que vas a lograr

Vas a volver a llamar un pedido, detener y reanudar sus llamadas, y actualizar su estado logístico o confirmarlo o cancelarlo desde tu sistema.

Pasos en pantalla

1. Volver a llamar: POST https://api.talkyria.com/api/v1/orders/{id}/calls. Es el botón «Llamar» del panel. Con restart true reinicia la escalera de reintentos en vez de sumar una llamada suelta.
2. Opcional en esa misma petición: agentId, para que otro agente universal haga solo esta llamada.
3. Detener o reanudar: PATCH /orders/{id}/calls con callsPaused true para detener la primera llamada y los reintentos, o false para reanudar.
4. Estado logístico: PATCH https://api.talkyria.com/api/v1/orders/{id}/status con logisticStatus, trackingNumber y carrier, en el vocabulario de tu canal, por ejemplo «EN REPARTO».
5. Estado del pedido: PATCH https://app.talkyria.com/api/v1/orders/{id}/status con status confirmed, cancelled o needs_attention, y una nota. Confirmar o cancelar también detiene los reintentos.
6. Confirmación externa: POST /webhooks/external-confirmation con status confirmed o cancelled y el identificador del pedido. Si ya estaba confirmado, responde already_confirmed y no lo cambia.
7. Revisa el pedido en «Pedidos» del panel: verás el cambio en su detalle.

Error común y cómo resolverlo

Enviar el cambio de estado del pedido al host api.talkyria.com. Allí esa ruta espera el estado logístico, no confirmed o cancelled. El estado del pedido va a app.talkyria.com; si te equivocas de host, la respuesta te dice «wrong_host».

¿Y ahora qué?

Ahora lee las llamadas y sus resultados, y lanza lotes. Siguiente lección: «¿Cómo leo las llamadas y sus resultados, y llamo un lote por API?».