La ventanilla de la oficina: qué es una API
| Fase | F1 — Cimientos, seguridad y arquitectura del sistema |
|---|---|
| Módulo | M1.2 — Modelos mentales: radiografía de un agente telefónico |
| Puntos de profesionalidad al superar el test | 15 |
Objetivo práctico
Al terminar esta lección podrás explicar qué es una API con tus propias palabras, sin necesidad de conocimientos de programación, y entender por qué casi todas las herramientas de este curso (Vapi, ElevenLabs, Twilio, n8n, Google Calendar) se comunican entre sí mediante API.
Resultado que obtendrás
Un modelo mental correcto de API que te permitirá entender, en lecciones posteriores, por qué necesitas una «clave de API» para conectar dos sistemas entre sí.
Dónde encaja dentro del sistema final
Las API son el mecanismo que permite que las distintas piezas del sistema (agente, automatización, calendario) se comuniquen entre sí. Sin API no sería posible el Tool Calling ni la automatización con n8n o Make.
Conocimientos previos
- Flujo completo de la llamada (lección anterior).
Herramientas necesarias
- Un navegador con NVDA activo, en modo de exploración.
Posible coste
Esta lección es conceptual. Usar una API concreta puede tener coste según la plataforma; eso se trata en el módulo 2.1.
Modelo mental
Piensa en la ventanilla oficial mediante la que dos departamentos pueden solicitarse cosas siguiendo unas reglas. Imagina que tu negocio necesita un dato de otro departamento —por ejemplo, el departamento de calendario necesita saber si un hueco está libre—. No entras directamente en su archivo a rebuscar: te acercas a su ventanilla, rellenas una solicitud con el formato que ellos exigen, y ellos te devuelven la respuesta por la misma ventanilla, también en un formato acordado. Esa ventanilla, con sus reglas de solicitud y respuesta, es una API.
Explicación
API son las siglas de Application Programming Interface (interfaz de programación de aplicaciones). Es el conjunto de reglas que permite que un programa solicite información o acciones a otro programa, sin necesidad de conocer cómo funciona por dentro. Cuando dices que «Vapi se conecta con ElevenLabs mediante API», significa que Vapi envía una solicitud siguiendo el formato que ElevenLabs exige (por ejemplo, «genera audio a partir de este texto, con esta voz») y ElevenLabs devuelve una respuesta siguiendo también un formato acordado (el archivo de audio, o un error si algo ha fallado).
Para que esa comunicación sea segura, la mayoría de API exigen identificarse mediante una clave de acceso (la API Key, que se trata en la siguiente lección de vocabulario acumulado en el módulo 2.1). Sin esa clave, la «ventanilla» no atiende la solicitud.
Vocabulario nuevo
API
Piénsalo así: La ventanilla oficial entre dos departamentos.
Application Programming Interface: conjunto de reglas que permite que un programa solicite información o acciones a otro programa de forma estandarizada.
Ejemplo: Vapi solicita a ElevenLabs, mediante su API, que convierta un texto en audio con una voz concreta.
Preparación
No se requiere preparación técnica.
Procedimiento paso a paso
Contexto: Vas a localizar «API» en el Glosario del curso y a comprobar, dentro de su definición, el enlace a esta misma lección.
Acción de teclado: Abre el Glosario (
/glosario.php) y pulsa H hasta llegar al encabezado de nivel 3 «API», dentro del bloque «A».Respuesta esperada de NVDA: NVDA debería anunciar «API, encabezado de nivel 3».
Qué significa: Confirmas que el término se encuentra correctamente indexado y accesible mediante navegación de encabezados.
Acción siguiente: Lee la definición completa con la flecha abajo hasta el enlace «Aparece por primera vez en…».
Contexto: Compara ahora la definición del glosario con la analogía de la ventanilla de esta lección.
Acción de teclado: Pulsa Alt + flecha izquierda (o el botón «Atrás» del navegador) para volver a esta lección.
Respuesta esperada de NVDA: NVDA debería anunciar de nuevo el título «La ventanilla de la oficina: qué es una API» al recargar la página.
Qué significa: Confirmas que puedes moverte con soltura entre el glosario y las lecciones usando únicamente el teclado.
Acción siguiente: Continúa con el resto de esta lección.
Errores frecuentes y diagnóstico
Confundir la interfaz visual de una plataforma (su página web) con su API.
Cómo localizarlo: Son dos cosas distintas: la interfaz web es para que una persona la use directamente; la API es para que un programa la use automáticamente.
Solución: Cuando en este curso se hable de «conectar dos plataformas», casi siempre se está hablando de sus API, no de que una persona copie y pegue datos manualmente entre dos páginas web.
Comprobación final
Explica con la analogía de la ventanilla por qué una plataforma A no puede simplemente «entrar» en los datos internos de una plataforma B sin usar su API. Si tu explicación incluye la idea de reglas acordadas de solicitud y respuesta, la comprobación es positiva.
Qué acabas de conseguir
Tienes la base conceptual necesaria para entender, en el resto del curso, por qué cada integración entre herramientas requiere una clave de API y sigue un formato de solicitud concreto.
Ejercicio práctico
Piensa en dos ejemplos de tu vida cotidiana que funcionen como una «ventanilla con reglas»: por ejemplo, pedir una cita médica por teléfono siguiendo un guion concreto de preguntas. Anota qué información se pide y en qué formato se responde.
Resumen de lo imprescindible
- API significa interfaz de programación de aplicaciones: reglas para que dos programas se comuniquen.
- Es la «ventanilla» que permite que Vapi hable con ElevenLabs, que n8n hable con Google Calendar, etc.
- La interfaz web de una plataforma (para personas) es distinta de su API (para programas).
- Casi todas las API exigen una clave de acceso para atender solicitudes.
No necesitas aprender todavía
Todavía no necesitas escribir ninguna solicitud a una API a mano: este curso proporciona archivos y Blueprints ya preparados para las integraciones necesarias.
Estoy preparado para continuar si puedo…
- Explicar qué es una API usando la analogía de la ventanilla.
- Diferenciar la interfaz web de una plataforma de su API.
- Entender por qué las API necesitan una clave de acceso.
Fuentes
Última actualización de esta lección: 2026-02-10.
Test de la lección
Para realizar el test y obtener Puntos de profesionalidad necesitas iniciar sesión o crear una cuenta.
Navegación
Lección anterior: El flujo completo: de la voz humana a la respuesta hablada
Continuar con la siguiente lección: El buzón de entrada: qué es un Webhook