Referencia de API
Agentes de voz y llamadas
Base: /api
Todos los endpoints de esta página usan el prefijo:
/workspaces/:workspaceId
Autenticación: API key (se abre en una pestaña nueva) o sesión válida del dashboard, según el contexto de uso.
1) Agentes de voz
Sección titulada «1) Agentes de voz»| Método | Ruta |
|---|---|
| GET | /voice-agents |
| POST | /voice-agents |
| GET | /voice-agents/:id |
| PATCH | /voice-agents/:id |
| DELETE | /voice-agents/:id |
| POST | /voice-agents/:id/duplicate |
2) Prompt versions y estado de tools
Sección titulada «2) Prompt versions y estado de tools»| Método | Ruta |
|---|---|
| GET | /voice-agents/:agentId/prompt-versions |
| POST | /voice-agents/:agentId/prompt-versions/:versionId/restore |
| GET | /voice-agents/:id/tools/status |
3) Analítica y coaching
Sección titulada «3) Analítica y coaching»| Método | Ruta |
|---|---|
| GET | /voice-agents/:id/analytics/heatmap |
| GET | /voice-agents/:id/analytics/transfer-stats |
| GET | /voice-agents/:id/coaching |
Números, caller IDs y llamadas
Sección titulada «Números, caller IDs y llamadas»Los números de voz, los caller IDs verificados y el historial de llamadas se gestionan desde el dashboard y no están disponibles con API key. Para lanzar llamadas desde una integración, agrega el contacto a una campaña de llamadas (se abre en una pestaña nueva).
Flujo recomendado
Sección titulada «Flujo recomendado»- Crea el agente y configura voz/comportamiento.
- Verifica un caller ID o asigna un número de voz desde el dashboard.
- Ejecuta una llamada de prueba.
- Revisa analytics/coaching.
- Versiona prompt y restaura si hace falta.
Ejemplo cURL (listar agentes)
Sección titulada «Ejemplo cURL (listar agentes)»curl "https://api.waiify.com/api/workspaces/WORKSPACE_ID/voice-agents" \ -H "Authorization: ******"