¿Cómo disparo llamadas desde mi sistema con la API?

Objetivo: Generar una API key, hacer una primera llamada por API y gestionar tus llaves.

Nivel: Avanzado · Duración: 3 min · Antes de esta lección: «¿Cómo creo mi agente de confirmación?»

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

Gancho

Si tu sistema sabe hacer una petición web, puede pedirle a tu agente que llame a un cliente. Necesitas una llave y un ejemplo que ya está escrito para ti.

Lo que vas a lograr

Vas a crear una llave segura con permisos mínimos, disparar una llamada de prueba por API y saber rotar o borrar llaves.

Pasos en pantalla

1. Abre «Integraciones» → «API», pestaña «Llaves». Escribe un nombre que identifique quién la usa, por ejemplo el de tu sistema.
2. Abre «Opciones avanzadas»: elige solo los permisos necesarios, restringe a una tienda si aplica y activa «Modo de prueba (sandbox)» para empezar sin gastar saldo.
3. Pulsa «Generar API Key» y cópiala: no podrás verla completa de nuevo.
4. En el Studio de tu agente pulsa «Cómo activar»: copia el identificador del agente y el comando de ejemplo para disparar una llamada.
5. Reemplaza la llave de ejemplo por la tuya y envía la petición desde tu sistema, o desde n8n, Zapier o Make.
6. Consulta la pestaña «Referencia» y la documentación pública en app.talkyria.com/docs/api para el resto de operaciones.
7. Cuando termines las pruebas, crea una llave real. Si una llave se filtra, usa «Rotar», que mantiene la anterior 30 días, o «Eliminar», que la corta al instante.
8. Si tienes varias tiendas en el mismo workspace, la documentación explica cómo indicar a qué tienda pertenece cada petición.

Error común y cómo resolverlo

Usar una llave con «Acceso total» para todo. Si se filtra, da acceso a todo tu workspace. Crea una llave por sistema, con solo los permisos que ese sistema necesita. Y nunca pegues tu llave en un lugar público, como un grupo de WhatsApp o un repositorio de código.

¿Y ahora qué?

Y para que tu sistema se entere de cada resultado, configura los webhooks. Siguiente lección: «¿Cómo recibo el resultado de cada llamada en mi sistema?».