¿Qué más puedo consultar por API: saldo, estadísticas, leads y números?

Objetivo: Usar las operaciones de saldo, contexto de la llave, estadísticas, leads de ventas, teléfonos y números verificados.

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?»

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

Gancho

Tu tablero interno puede mostrar el saldo de Talkyria y la tasa de confirmación de hoy sin que nadie entre al panel. Esto es lo último que necesitas de la API.

Lo que vas a lograr

Vas a consultar saldo, contexto y estadísticas, crear un lead de ventas y gestionar números por API.

Pasos en pantalla

1. Saldo: GET https://api.talkyria.com/api/v1/wallet trae el saldo, la tarifa por minuto, los minutos incluidos que quedan y la auto-recarga. Es solo lectura.
2. Contexto: GET /me dice de qué tienda y workspace es la llave, su país, su moneda, su plan, sus permisos y si es de prueba.
3. Estadísticas: GET https://app.talkyria.com/api/v1/analytics con preset this_month, last_7d, last_30d o all, o con from y to. Filtra por canal con source y por agente con agent.
4. Leads de ventas: POST https://api.talkyria.com/api/v1/sales/agents/{id}/leads con name y phone. La respuesta dice queued si se va a llamar, o el motivo si no: por ejemplo, duplicate o already_purchased.
5. Números verificados: POST https://app.talkyria.com/api/v1/verified-caller-ids con tu número; recibes un código y lo envías a /verified-caller-ids/{id}/verify. No tiene costo.
6. Teléfonos dedicados: GET /phones los lista y GET /phones/available busca disponibles. Comprar con POST /phones cobra tu saldo.

Error común y cómo resolverlo

Usar la llave de tu tablero, que solo lee, para crear leads o comprar números. Recibirás «403» con insufficient_scope. Crea una llave aparte con ese permiso, solo para el sistema que de verdad lo necesita.

¿Y ahora qué?

¿Y si en vez de programar le pides todo esto a tu asistente de IA? Eso es MCP. Siguiente lección: «¿Qué es conectar mi asistente de IA a Talkyria y qué le puedo pedir?».