¿Cómo funciona el disparador por API («Tu propio canal»)?

Objetivo: Entender que la ruta API dispara por evento, no por estado, y copiar lo necesario para conectarla.

Nivel: Avanzado · Duración: 3 min · Antes de esta lección: «¿Cómo disparo llamadas desde mi sistema con la API?»

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

Gancho

A veces no hay estado que esperar: tu sistema decide en el momento a quién llamar. Para eso está la ruta por API.

Lo que vas a lograr

Vas a abrir el disparador por API de tu agente, copiar su identificador y su ejemplo, y saber dónde seguir.

Pasos en pantalla

1. En el lienzo pulsa el rayo ⚡ de tu propio canal. Verás el aviso de que «Esta ruta se activa por evento, no por estados».
2. Copia el «Identificador de este agente».
3. Copia el «Ejemplo listo»: una petición a https://api.talkyria.com/api/v1/calls/trigger.
4. Si no tienes llave, pulsa «Generar tu clave» y reemplaza tk_live_TU_KEY por la tuya.
5. Pulsa «Ver la documentación» para el detalle de cada campo, o sigue el módulo 4.7.
6. También tienes el botón «Cómo activar» en la barra del Studio, con el mismo identificador y el comando de ejemplo.
7. Cada petición crea el pedido atado a este agente y lo llama respetando su espera, su horario y su modo, salvo que pidas llamar ya, como en la microlección «¿Cómo hago que la API llame ya o a una hora exacta?».
8. Si la misma petición llega dos veces con el mismo identificador de pedido, Talkyria no repite la llamada.
9. Sin programar: conecta n8n, Zapier o Make a esa misma dirección. El panel lo recuerda: «Sin código: conéctalo con n8n, Zapier o Make usando ese mismo endpoint».

Error común y cómo resolverlo

Dejar en el ejemplo el texto tk_live_TU_KEY. La petición responde que falta una llave válida. Reemplázalo por tu llave real, sin espacios.

¿Y ahora qué?

¿Y si no quieres ningún disparador? También puedes llamar a mano o con una lista. Siguiente lección: «¿Cómo llamo pedidos sin disparador: a mano, en lote o con una lista?».