Saltar al contenido
TalkyriaAcademy

Módulo 07

Módulo 4.7 · La API de Talkyria, endpoint por endpoint

Para el desarrollador (o el comercio curioso) que quiere conectar su sistema con Talkyria sin ayuda: llaves y permisos, pedidos, llamadas, resultados, webhooks con firma, ofertas, agentes y saldo. Cada lección es una parte de la documentación pública app.talkyria.com/docs/api, explicada en palabras simples.

11 lecciones32 min

  1. ¿Cómo funciona la API de Talkyria antes de escribir una sola línea?La API de Talkyria se usa desde tu servidor con una llave en la cabecera Authorization. Tiene dos hosts que no se intercambian, permisos por llave, un modo de prueba sin llamadas reales y errores con un código fijo para que tu sistema sepa qué hacer.Avanzado3 min
  2. ¿Qué permisos le doy a cada llave de API y cómo pruebo sin gastar saldo?En «Integraciones» → «API» → «Llaves» creas una llave por sistema y le das solo los permisos que usa. Una llave de prueba no hace llamadas reales ni gasta saldo, y «Rotar» te da 30 días para cambiarla sin cortar nada.Avanzado3 min
  3. ¿Cómo creo un pedido y disparo su llamada por API?Con una sola petición a /api/v1/calls/trigger creas el pedido y tu agente lo llama. Solo son obligatorios tu identificador del pedido y el teléfono del cliente; lo demás le da contexto al agente.Avanzado3 min
  4. ¿Cómo consulto mis pedidos y su estado por API?Con GET /orders buscas pedidos por teléfono o por tu identificador, y con GET /orders/{id} lees el detalle con todas sus llamadas. Para saber solo el estado actual y la última llamada existe GET /orders/{id}/status en app.talkyria.com.Avanzado3 min
  5. ¿Cómo vuelvo a llamar, pauso o confirmo un pedido desde mi sistema?Sobre un pedido que ya existe puedes pedir otra llamada, detener o reanudar sus llamadas automáticas y cambiar su estado. Son los mismos botones del panel, pero desde tu sistema.Avanzado3 min
  6. ¿Cómo leo las llamadas y sus resultados, y llamo un lote por API?GET /calls lista las llamadas con su resultado, duración y resumen, y GET /calls/{id} trae una sola. Con POST /calls/bulk llamas hasta 500 pedidos en un lote que puedes pausar, reanudar o cancelar.Avanzado3 min
  7. ¿Cómo recibo cada resultado con webhooks y compruebo que vienen de Talkyria?Cada llamada terminada genera un aviso a tus URLs, firmado con la cabecera X-Talkyria-Signature. Tu sistema recalcula la firma con el secreto de esa URL y, si coincide, sabe que el aviso viene de Talkyria.Avanzado3 min
  8. ¿Puedo crear mis Ofertas Inteligentes por API?Sí: la API tiene la operación «Crear una smart-offer» y también listar, editar y borrar. Las cifras de resultados, como veces mostrada o aceptada, son de solo lectura.Avanzado3 min
  9. ¿Cómo creo y edito agentes y su conversación por API?En app.talkyria.com/api/v1/agents creas, lees, editas y borras agentes, y con /workflow lees o reemplazas su conversación completa. Un cambio de flujo se aplica a las llamadas reales, así que se prueba antes.Avanzado3 min
  10. ¿Qué más puedo consultar por API: saldo, estadísticas, leads y números?Por API también lees tu saldo y tu tarifa, el contexto de tu llave, tus estadísticas, y creas leads para tu agente de ventas. La recarga de saldo nunca se hace por API: solo desde el panel.Avanzado3 min