API de llamadas con IA con especificación OpenAPI 3.1: constrúyela hoy.
Una API REST de pago por uso para llamadas telefónicas salientes con IA, descrita en una especificación pública OpenAPI 3.1. Claves bearer, gestión completa de contactos y campañas, transcripciones, grabaciones e informes.
Qué cubre la API de FoxEra Calls
La API REST de FoxEra Calls permite que tu propio código, plataforma de automatización o GPT Action active y gestione llamadas telefónicas salientes con IA. Cubre todo el ciclo de vida de la campaña:
- Contactos — crea, actualiza y organiza contactos en carpetas.
- Campañas — previsualiza una campaña (número de contactos, coste estimado, agente de llamadas), créala, prográmala, apruébala o cancélala.
- Resultados — lee el resultado de cada llamada: contestada, buzón de voz, sin respuesta, y la reacción del prospecto.
- Transcripciones y grabaciones — obtén la transcripción completa y un enlace a la grabación de cualquier llamada finalizada.
- Informes — resúmenes a nivel de campaña: llamadas totales, minutos conectados, coste, contactos interesados.
- Cuenta — comprueba el saldo de crédito, configura el horario de llamadas, elige el agente de IA (Cass, Alex o Andrea), edita y aprueba el guion.
La autenticación usa claves de API bearer (formato fxk_...). Cada clave está limitada a un espacio de trabajo y puede revocarse al instante desde tu configuración para desarrolladores.
La especificación OpenAPI 3.1
La API completa se describe en un documento OpenAPI 3.1 en una URL pública:
https://app.foxera.co.uk/api/public/openapi.json
Puedes importar esta especificación en cualquier herramienta que lea OpenAPI: Postman, Insomnia, Swagger UI o tu propio generador de código. También es el formato que aceptan directamente las GPT Actions: pega la URL y tu GPT personalizado podrá llamar a la API sin escribir código de integración.
La especificación documenta cada endpoint, cuerpo de solicitud, forma de respuesta y código de error. Si quieres convertir la especificación en herramientas MCP para un asistente de IA, la comparativa entre MCP y clave de API explica cuándo encaja cada enfoque.
Cómo empezar
- Crea una cuenta gratis de FoxEra Calls en foxera.co.uk. Las cuentas nuevas reciben £7 de crédito gratis para llamadas.
- Ve a tu configuración para desarrolladores y genera una clave de API. La clave empieza por
fxk_y solo actúa dentro de tu espacio de trabajo. - Incluye la clave como token bearer en la cabecera
Authorizationde cada solicitud. - Empieza añadiendo algunos contactos mediante la API y luego previsualiza una campaña para ver el número de contactos y el coste estimado antes de aprobar.
La API usa convenciones REST estándar: cuerpos de solicitud y respuesta en JSON, códigos de estado HTTP para los errores y paginación en los endpoints de listado. Todos los detalles están en la guía para desarrolladores.
Flujo de seguridad y aprobación
La API aplica las mismas reglas de seguridad que el panel y el servidor MCP:
- Número confirmado — cada campaña requiere que se confirme el número exacto de contactos antes de la aprobación.
- Paso de aprobación separado — crear una campaña no inicia las llamadas. Debes aprobarla explícitamente en una segunda solicitud.
- Horario de llamadas — las llamadas solo se realizan dentro del horario que configures. Fuera de ese horario, la campaña espera.
- Claves limitadas — cada clave de API funciona solo dentro de un espacio de trabajo. Revocar una clave detiene todo acceso de inmediato.
- Registro completo — cada acción de la API queda registrada con una marca de tiempo, para que puedas auditar exactamente qué ocurrió y cuándo.
Estas reglas se aplican del lado del servidor, sin importar qué cliente o modelo esté llamando a la API. Lee más sobre las medidas de seguridad para agentes de IA en llamadas salientes.
Casos de uso de la API
La API está pensada para desarrolladores y creadores de automatizaciones que quieren integrar las llamadas salientes en sus propios sistemas:
- Integración con CRM — envía contactos nuevos desde tu CRM a FoxEra y recupera los resultados de las llamadas, manteniendo ambos sistemas sincronizados.
- Plataformas de automatización — activa una campaña de llamadas desde n8n, Make o un webhook de Zapier cuando llegue un contacto nuevo a tu proceso.
- GPT Actions — importa la especificación OpenAPI en un GPT personalizado para que pueda gestionar campañas de forma conversacional.
- Paneles de informes — lleva los datos de campaña a tu propio análisis o CRM de llamadas salientes para un informe combinado.
- Agentes personalizados — construye un agente autónomo que investigue prospectos, los añada a FoxEra, previsualice una campaña y pida tu aprobación antes de marcar.
Si prefieres una interfaz conversacional en lugar de código, puedes conectar ChatGPT o cualquier asistente a través del servidor MCP.
Precios
La API en sí es gratuita. Solo pagas por las llamadas que se conectan, desde 12p por minuto conectado, sin suscripción ni cuota de plataforma. Las cuentas nuevas empiezan con £7 de crédito gratis para llamadas.
Cada previsualización de campaña muestra el coste estimado antes de aprobar, así que no hay sorpresas. Compáralo con los modelos de cuota mensual por usuario en la página de precios o usa la calculadora de costes para estimar una campaña.
Preguntas frecuentes
¿Dónde está alojada la especificación OpenAPI?
La especificación está en https://app.foxera.co.uk/api/public/openapi.json. Es pública y siempre está actualizada. Impórtala en Postman, Swagger UI o cualquier herramienta que lea OpenAPI 3.1.
¿Cuánto cuesta usar la API?
La API es gratuita. Solo pagas por los minutos de llamada conectados, desde 12p por minuto conectado. Las cuentas nuevas reciben £7 de crédito gratis para llamadas.
¿Puede la API iniciar llamadas sin mi aprobación?
No. Crear una campaña no inicia las llamadas. Debes confirmar el número de contactos y enviar una solicitud de aprobación por separado. Esto se aplica del lado del servidor.
¿Funciona la API con GPT Actions?
Sí. La especificación OpenAPI 3.1 se puede importar directamente en una GPT Action. Tu GPT personalizado puede entonces gestionar contactos, campañas y resultados de forma conversacional.