¿Cómo hago que la API llame ya o a una hora exacta?
Parte de «¿Cómo creo un pedido y disparo su llamada por API?»
Por defecto, una llamada por API respeta la espera, el horario y el modo del agente. Con immediate sale en segundos y con scheduledAt sale a la hora que digas, pero el modo manual o híbrido del agente se respeta siempre.
Video en preparación
Estamos grabando este video. Mientras tanto, la guía de abajo te lleva paso a paso.
Objetivo de la lección
Usar immediate o scheduledAt sin romper el horario ni el modo del agente.
Lleva lo aprendido a tu cuenta: abre esta pantalla en Talkyria.
Abrir en Talkyria(se abre en una pestaña nueva)Guía
Objetivo: Usar immediate o scheduledAt sin romper el horario ni el modo del agente.
Nivel: Avanzado · Duración: 2 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
Hay pedidos que no pueden esperar y otros que deben llamarse mañana a las diez. La API resuelve los dos casos con un solo campo.
Lo que vas a lograr
Vas a usar immediate y scheduledAt, y a leer los avisos de la respuesta.
Pasos en pantalla
- Agrega immediate true para «llamar ya»: se salta la espera de la primera llamada y el horario del agente, y la llamada sale en unos 2 segundos.
- O agrega scheduledAt con una fecha y hora futura, hasta 7 días adelante. Si cae fuera del horario del agente, la respuesta te avisa en warnings con scheduled_outside_agent_hours.
- Recuerda: si el agente está en modo manual, o el pedido supera el monto del modo híbrido, la respuesta es not_called aunque pidas «llamar ya».
Error común y cómo resolverlo
Usar immediate en todos los pedidos. Así llamas de madrugada si tu sistema recibe pedidos a esa hora. Úsalo solo cuando un pedido de verdad no puede esperar.
¿Y ahora qué?
Ahora consulta tus pedidos y su estado por API. Siguiente lección: «¿Cómo consulto mis pedidos y su estado por API?».
Paso a paso
Agrega immediate true para «llamar ya»: se salta la espera de la primera llamada y el horario del agente, y la llamada sale en unos 2 segundos.
O agrega scheduledAt con una fecha y hora futura, hasta 7 días adelante. Si cae fuera del horario del agente, la respuesta te avisa en warnings con scheduled_outside_agent_hours.
Recuerda: si el agente está en modo manual, o el pedido supera el monto del modo híbrido, la respuesta es not_called aunque pidas «llamar ya».
Preguntas frecuentes
¿Puedo enviar las dos opciones a la vez?
No. Son excluyentes: usa una u otra.
¿Puedo cambiar el idioma o la zona horaria desde la API?
No. Son del agente; si los envías se ignoran y la respuesta lo avisa en warnings.
Para profundizar
Actualizada el 29 de octubre de 2026