¿Qué permisos le doy a cada llave de API y cómo pruebo sin gastar saldo?

Objetivo: Crear llaves con permisos mínimos, de prueba o reales, con caducidad, y rotarlas o eliminarlas sin cortar tu integración.

Nivel: Avanzado · Duración: 3 min · Antes de esta lección: «¿Cómo funciona la API de Talkyria antes de escribir una sola línea?»

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

Gancho

Una llave con acceso total es una llave maestra: si se pierde, abre todo. En cuatro minutos vas a crear llaves que solo abren lo que cada sistema necesita.

Lo que vas a lograr

Vas a crear una llave de prueba para desarrollar, una real con permisos mínimos para producción, y vas a saber rotarla o eliminarla cuando haga falta.

Pasos en pantalla

1. Abre «Integraciones» → «API», pestaña «Llaves». Arriba está «API Keys»: «Genera claves para autenticar requests a la API de Talkyria».
2. En «Nombre (ej: ChateaPro)» escribe quién la va a usar, por ejemplo «Mi CRM». Así sabrás cuál rotar si algo pasa.
3. Abre «▸ Opciones avanzadas (permisos, tienda, modo prueba, caducidad)». En «Permisos (scopes)» marca solo lo necesario. Para disparar llamadas y leer resultados bastan «Disparar llamadas / ingresar órdenes a llamar» y «Leer resultado de llamadas (duración, outcome, resumen)».
4. La transcripción y la grabación son contenido sensible: van en un permiso aparte, «Leer transcripción + grabación (contenido sensible)». Márcalo solo si tu sistema de verdad las necesita.
5. Activa «Modo de prueba (sandbox)» mientras desarrollas: la llave empieza por tk_test_, no hace llamadas reales, no consume saldo y caduca sola.
6. Si quieres, define la «Caducidad» en días y elige «Restringir a una tienda» o «Todo el workspace (envía el header X-Talkyria-Shop en cada request)».
7. Pulsa «Generar API Key» y cópiala en ese momento: «no podrás verla completa de nuevo». En la tabla verás su «Tipo», sus «Permisos», «Caduca» y «Último uso».
8. Para cambiarla sin cortar tu integración pulsa «Rotar»: la anterior sigue funcionando 30 días. Para cortarla ya, «Eliminar» y confirma «¿Confirmar eliminación?».

Error común y cómo resolverlo

Pasar a producción con la llave de prueba. Todo «funciona», pero ninguna llamada sale de verdad: la respuesta trae test true y test_simulated. Cuando termines de probar, crea una llave real con los mismos permisos y cámbiala en tu sistema.

¿Y ahora qué?

Con tu llave lista, dispara tu primera llamada por API. Siguiente lección: «¿Cómo creo un pedido y disparo su llamada por API?».