Para desarrolladores

Voz IA en tu producto, con una llamada a la API

API REST y webhooks para que los asistentes de voz de AI4CALL llamen, respondan y actúen dentro de tus sistemas. Especificación OpenAPI, ejemplos listos para copiar, sin SDK que instalar.

Prueba gratuita con crédito inicial incluido.

  • REST · JSON
  • OpenAPI 3.0.3
  • HTTPS / TLS
  • /api/v1
# Haz que tu asistente IA llame a un lead
curl -X POST https://client-api.ai4call.com/webhook/outbound_call \
  -H "x-client-email: you@company.com" \
  -H "x-portal-api-key: $AI4CALL_PORTAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "assistantApiKey": "ast_xxx",
    "to": "+39081...",
    "from": "+3902...",
    "metadata": { "lead_id": "123" }
  }'
POST /webhook/outbound_call · el asistente marca el número y recibe tus metadata
Anatomía de una llamada

Dónde se engancha tu código

Una llamada, capa por capa: la voz es solo la primera. Cada fila es un punto donde tu código puede intervenir.

En curso Entrante · Línea de citas · Asistente IA 00:00 Demo
Agente IA

Clínica Bianchi, buenos días Marco. ¿En qué puedo ayudarle?

Voz
Comprensión
Intención · cambio de citaLLM Propuesta · 2 opcionesLLM
Conocimiento
Reglas de cambiosRAG
Sistemas
Cliente reconocido · Marco R.pre-call Calendario · disponibilidadMCP Resultado enviado a tu endpointhangup
Acciones
Cita cambiada · vie 9:30tool
Operador
Operador disponible · transferencia en cualquier momentoredirect
  1. 1

    Antes de contestar

    Tu servidor recibe el número de quien llama, lo reconoce y enriquece el prompt con los datos del cliente.

    webhook pre-llamada
  2. 2

    Durante la conversación

    El LLM responde usando la base de conocimiento y llama a tus herramientas cuando necesita datos o acciones.

    herramientas HTTP · MCP · RAG
  3. 3

    Al colgar

    Transferencia, redirección o cierre. La IA extrae los campos que definas y los envía con un POST a tu URL de colgado.

    webhook de colgado
  4. 4

    Después

    Historial de llamadas, consumos, eventos de herramientas y SMS para llevar a tu CRM, data warehouse o BI.

    /account/analytics/*

Ejemplo: webhook pre-llamada

AI4CALL envía un POST a tu endpoint. Responde con enable para aceptar o rechazar la llamada y con callerInfo para dar contexto al asistente: los campos se añaden al system prompt.

Especificación completa del webhook pre-llamada →
Petición a tu servidor
POST https://yourserver.com/api/verify-caller
Content-Type: application/json

{
  "number": "+393331234567",
  "timestamp": "2025-12-13T10:30:00Z",
  "assistantId": "ast_abc123",
  "callId": "call_xyz789"
}
Tu respuesta
{
  "enable": true,
  "callerInfo": {
    "name": "Mario",
    "surname": "Rossi",
    "custom_field_1": "VIP since 2020"
  }
}
Puntos de integración

Cinco formas de conectar AI4CALL con tu código

Usa solo lo que necesitas: desde un único webhook hasta automatizar toda la plataforma.

REST · OpenAPI 3

API REST de la plataforma

Crea y configura asistentes, prompts, voz TTS/ASR/LLM, bases de conocimiento RAG, herramientas y analytics. Todo lo que haces en el portal, hecho con código.

Webhook

Llamadas salientes

Un POST desde tu backend y el asistente llama a tu cliente, por la troncal de AI4CALL o por tu PBX. Envía metadata propios (lead, ticket, pedido) y recupéralos en analytics.

Webhook entrante

Webhook pre-llamada

Antes de que el asistente conteste, AI4CALL llama a tu endpoint con el número de quien llama. Tú decides si aceptar la llamada y qué contexto dar a la IA.

Function calling · MCP

Herramientas y servidores MCP

En plena llamada, el asistente invoca tus API: busca clientes, abre tickets, consulta pedidos. Autenticación Bearer, API Key u OAuth2, o tu propio servidor MCP.

SIP · FreePBX

Telefonía: troncal SIP y PBX

Conecta el asistente a tu centralita mediante troncal SIP o el módulo FreePBX, y conserva los números y el enrutamiento que ya tienes.

API + portal

El portal sigue siempre a tu disposición

La API no sustituye al portal de AI4CALL: lo complementa, con la misma lógica. Automatizas solo lo que necesitas y para todo lo demás tienes la interfaz gráfica, sin tener que construir tu propio panel.

Un flujo típico: el equipo configura y ajusta el asistente desde el portal, y el desarrollador integra llamadas salientes, webhooks y analytics vía API.

  • Prompts, voces, modelos, herramientas y base de conocimiento configurables desde la interfaz
  • Panel con historial de llamadas, consumos y recargas
  • Numeraciones, usuarios y perfiles de tu equipo
  • Marketplace de plugins y notificaciones
Quickstart

Del registro a la primera respuesta en minutos

Sin SDK ni dependencias: basta con un cliente HTTP.

  1. Crea tu cuenta

    Regístrate en el portal y crea tu primer asistente. La prueba incluye crédito para llamadas de test.

    Ir al portal →
  2. Genera la portalApiKey

    Crea una clave por entorno (test, producción) en el portal. Se envía en las cabeceras junto con tu email.

    Cómo generar la API key →
  3. Haz tu primera petición

    Lista tus asistentes para obtener la assistantApiKey y después lanza una llamada saliente o configura prompt y voz.

terminal
curl https://client-api.ai4call.com/api/v1/assistants \
  -H "x-client-email: you@company.com" \
  -H "x-portal-api-key: $AI4CALL_PORTAL_KEY"
Respuesta: la lista de tus asistentes en JSON
Mapa de endpoints

Toda la plataforma, vía API

Las principales áreas expuestas por client-api.ai4call.com. Peticiones, respuestas y errores están documentados en Swagger.

Asistentes y prompts

GET · POST /api/v1/assistants GET · PATCH /api/v1/assistants/{key}/prompt

Voz: TTS, ASR, LLM, DTMF

PATCH /api/v1/assistants/{key}/runtime/{tts|asr|llm|dtmf} GET /api/v1/catalog/providers/tts

Base de conocimiento RAG

/api/v1/catalog/rag/… PATCH /api/v1/assistants/{key}/runtime/rag

Herramientas

GET /api/v1/catalog/tools PATCH /api/v1/assistants/{key}/runtime/tools

Pre-llamada

/api/v1/assistants/{key}/runtime/precall/number-validation /api/v1/assistants/{key}/runtime/precall/mcp-config

Colgado y post-llamada

PATCH /api/v1/assistants/{key}/runtime/hangup …/runtime/hangup/save-conversation · /schema

Llamadas salientes

POST /webhook/outbound_call POST /webhook/outbound_call_pbx

Analytics

GET /api/v1/account/analytics/calls …/calls-outbound · /recharges · /tool-responses

Cuenta y seguridad

GET · PATCH /api/v1/account/allowed-ips GET · PATCH /api/v1/account/call-limits
Elección de modelos

Tú eliges el LLM, la voz y la transcripción

Sin dependencia de un único proveedor: para cada asistente eliges el modelo que mejor encaja en calidad, coste, latencia y requisitos de privacidad. Y lo cambias cuando quieras, también vía API.

LLM

20 provider
  • OpenAI
  • OpenAI EU
  • Anthropic
  • Google
  • Mistral
  • Azure OpenAI
  • Azure Foundry · API Key
  • Azure Foundry · Entra ID
  • Vertex AI
  • AWS Bedrock
  • xAI
  • OpenRouter
  • DeepInfra
  • IONOS
  • Nebius
  • OVHcloud
  • Perplexity
  • Scaleway
  • Together AI
  • Ollama

Voz en tiempo real (audio-to-audio)

2 provider
  • Google Gemini realtime
  • OpenAI realtime

Síntesis de voz (TTS)

5 provider
  • Azure
  • ElevenLabs
  • Google
  • KugelAudio
  • Mistral

Transcripción (ASR)

3 provider
  • Azure
  • Mistral
  • OpenAI Whisper
GDPR

Un pipeline adaptado a los requisitos del RGPD

Dónde se procesan los datos de una llamada depende también de los modelos que uses. Con AI4CALL compones el pipeline según tus requisitos de privacidad y los de tus clientes.

Proveedores europeos

Mistral, IONOS, OVHcloud y Scaleway, o los modelos de OpenAI servidos desde el endpoint europeo (OpenAI EU).

Tu nube, tu región

Azure OpenAI, Azure Foundry, Vertex AI y AWS Bedrock con tus propias credenciales: los modelos se ejecutan en tu cuenta, en la región que configures.

Autoalojado

Conecta Ollama a tu endpoint privado u on-premise y mantén la inferencia LLM en tu propia infraestructura.

El proveedor y el modelo de cada asistente también se cambian vía API, sin pasar por el portal:

PATCH /api/v1/assistants/{key}/runtime/llm
BYOK · Bring Your Own Key

Usa tus propias claves de proveedor

Con BYOK conectas a AI4CALL las credenciales de tu cuenta en el proveedor (API key, service account, claves IAM o token) en lugar de las de AI4CALL. Las peticiones a los modelos salen de tu cuenta y el proveedor te las factura directamente.

Pagas directamente al proveedor

El consumo del componente que usas con tu clave (LLM, voz o transcripción) no descuenta tu crédito de recarga de AI4CALL.

Sin recargo por volumen

Con volúmenes altos es la opción más económica: pagas las tarifas de tu contrato con el proveedor, sin margen añadido.

La relación con el proveedor es tuya

Cuenta, región y acuerdo de tratamiento de datos (DPA) los gestionas tú directamente con el proveedor: un punto más para los requisitos del RGPD.

Más modelos disponibles

Algunos proveedores solo se usan con tus propias credenciales, por ejemplo Anthropic, Google Gemini, OpenRouter, Vertex AI y AWS Bedrock.

Listo para producción

Pensado para producción, no solo para demos

Autenticación de dos niveles

Email y portalApiKey en las cabeceras para la cuenta, assistantApiKey en la ruta para cada asistente. Solo HTTPS.

Lista blanca de IP

Limita el acceso a la API a tus servidores gestionando la lista con /account/allowed-ips.

Límites de llamadas

Consulta y ajusta las llamadas simultáneas y por periodo con /account/call-limits.

Versionado estable

Endpoints bajo /api/v1. Los cambios incompatibles llegarán en una nueva versión mayor, con periodo de transición.

Datos en Europa

Servidores en Europa y cumplimiento del RGPD. Health check público en GET /health para tu monitorización.

Preguntas de desarrolladores

Sí. El plan Trial incluye crédito inicial para llamadas de prueba. Para separar test y producción puedes usar credenciales dedicadas; si necesitas una cuenta de test adicional, contáctanos desde el portal.

La API es REST/JSON estándar descrita en OpenAPI 3.0.3, así que funciona con cualquier cliente HTTP. Desde Swagger puedes descargar openapi.yaml y generar un cliente tipado con herramientas como OpenAPI Generator.

Define las propiedades a extraer (p. ej. email_cliente, resultado) y una URL de colgado: al terminar la llamada recibes un POST con los datos extraídos. También puedes recibir la transcripción completa por email.

Sí, con herramientas personalizadas: define endpoint, método HTTP, parámetros y autenticación (Bearer, API Key, OAuth2) y la IA las invoca cuando hace falta. Para integraciones más estructuradas puedes conectar tu propio servidor MCP.

El límite principal es el número de llamadas simultáneas y por periodo de tu plan, que puedes consultar y ajustar con /account/call-limits. Para grandes volúmenes, contáctanos para un plan dedicado.

El consumo depende de tu plan (por uso o con minutos incluidos). En los planes Trial y Freedom puedes usar tus propias API keys de LLM y voces y pagar directamente al proveedor. Detalles en la página de precios.

Todos los endpoints de negocio están versionados bajo /api/v1/. Los posibles breaking changes llegarán en /api/v2/, manteniendo la v1 activa durante la transición.

Sí. Puedes elegir proveedores europeos (Mistral, IONOS, OVHcloud, Scaleway), el endpoint europeo de OpenAI, tus cuentas de Azure, Vertex AI o AWS Bedrock en la región que prefieras, o un modelo autoalojado con Ollama. La evaluación final de cumplimiento corresponde al responsable del tratamiento: contáctanos para casos específicos.

Empieza a construir hoy

Crea tu cuenta, genera tu clave y haz tu primera llamada IA desde código. ¿Tienes un proyecto complejo? Lo vemos con nuestro equipo técnico.


Algunos de los usuarios de ai4call
AI4Call Demo

Chiama e prova la qualità dei nostri assistenti A.I.