¿Cómo creo y edito agentes y su conversación por API?

Objetivo: Conocer las operaciones de agentes, su flujo y su configuración avanzada, y usarlas sin dejar a un agente mudo.

Nivel: Avanzado · Duración: 3 min · Antes de esta lección: «¿Qué permisos le doy a cada llave de API y cómo pruebo sin gastar saldo?», «¿Cómo cambio lo que dice mi agente sin romperlo?»

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

Gancho

Si administras varias marcas, crear cada agente a mano es lento. La API crea, configura y enciende agentes iguales en todas tus tiendas.

Lo que vas a lograr

Vas a conocer las operaciones de agentes, leer y reemplazar su flujo con cuidado, y ajustar su configuración avanzada.

Pasos en pantalla

1. Leer: GET https://api.talkyria.com/api/v1/agents lista tus agentes y GET /agents/{id} trae uno.
2. Crear: POST https://app.talkyria.com/api/v1/agents con el permiso «Crear/editar/borrar agentes + su flujo + voz». Para un agente universal envía mission: el agente nace con su conversación probada y sus disparadores sugeridos.
3. Usa la cabecera Idempotency-Key al crear: si reintentas, no se crea un segundo agente.
4. Editar: PATCH /agents/{id} con voz, idioma, nombre, horario, número o reintentos. isActive true lo enciende igual que el interruptor del Studio.
5. Conversación: GET /agents/{id}/workflow la lee entera. PUT /agents/{id}/workflow la reemplaza completa: debe tener un solo nodo de inicio, un nodo global y conexiones con condición.
6. Configuración avanzada: PATCH /agents/{id}/advanced cambia solo los campos que envías y conserva el resto.
7. Voces: GET /voices, filtrando por idioma, por ejemplo es.
8. Después de cualquier cambio de conversación, abre el Studio y usa «Llamar para probar» antes de dejarlo trabajar con clientes.

Error común y cómo resolverlo

Reemplazar el flujo de un agente que está llamando sin probarlo antes. El cambio se aplica a la siguiente llamada real. Copia el flujo actual con GET antes de cambiarlo, para poder volver a enviarlo si algo sale mal.

¿Y ahora qué?

Para cerrar el módulo: saldo, estadísticas, leads, números y teléfonos por API. Siguiente lección: «¿Qué más puedo consultar por API: saldo, estadísticas, leads y números?».