API y webhooks en el software escolar: cómo conectar la gestión del centro con tu web, tu app y tu contabilidad
Qué son una API y un webhook, diez integraciones útiles en un colegio o una academia y qué exigir a la API de tu software de gestión escolar.
Ena by Edena | 7 min de lectura En casi todos los centros educativos hay alguien que copia datos de un sitio a otro: las solicitudes del formulario de la web al programa de admisiones, los alumnos nuevos a la plataforma de aprendizaje, las facturas a la hoja que se manda a la gestoría, las faltas a un informe para dirección. Ese trabajo existe porque los programas no hablan entre sí. La forma de que hablen se llama API, y su complemento son los webhooks.
Este artículo explica qué son, con ejemplos de un colegio, una escuela infantil o una academia; diez integraciones que ahorran tiempo de verdad; cómo se hace una integración paso a paso; y qué debería ofrecer la API de tu software de gestión antes de que alguien escriba la primera línea de código.
Qué es una API
Una API es un conjunto de operaciones que un programa ofrece a otros programas: "dame la lista de alumnos de 2.º B", "crea esta solicitud de matrícula", "marca este recibo como cobrado". Quien la usa envía una petición con una clave que lo identifica y recibe una respuesta con los datos, normalmente en formato JSON.
Tres ideas para entenderla sin entrar en tecnicismos:
- Hace lo mismo que las pantallas, pero desde otro programa. Si en el software de gestión puedes dar de alta a un alumno, con la API tu web o tu sistema pueden hacerlo también.
- Cada clave tiene permisos. Una clave creada con el rol de gestor llega a lo mismo que una persona con ese rol, ni más ni menos.
- Está documentada. Una API seria publica qué operaciones tiene, qué datos recibe cada una, qué devuelve y qué errores puede dar.
Qué es un webhook
Un webhook es el camino inverso: en lugar de que tu sistema pregunte, el software de gestión avisa. Cuando ocurre algo (una matrícula nueva, una factura cobrada, un pase de lista con ausencias), envía un mensaje a la dirección que tú has indicado con los detalles del cambio.
Tres cosas distinguen un webhook fiable:
- Va firmado, para que tu sistema compruebe que el aviso viene realmente del software de gestión.
- Se reintenta si tu sistema no responde, durante horas o días, para no perder eventos.
- Se puede consultar después, por si tu sistema estuvo caído y necesitas recuperar lo que pasó.
Diez integraciones útiles en un centro educativo
- Formulario de la web a admisiones. Cada solicitud del formulario entra en el CRM de admisiones con su origen, sin copiar nada a mano.
- Matrícula confirmada a la plataforma de aprendizaje. Cuando un alumno se matricula, un webhook avisa a tu sistema, que crea su cuenta en la plataforma de aprendizaje que uséis.
- Facturas cobradas a la contabilidad. Cada cobro llega a tu programa de contabilidad o a la gestoría con su factura, como contamos en el artículo sobre la integración con la gestoría.
- Asistencia a un panel de dirección. Los datos de asistencia de cada día alimentan un panel propio en la herramienta de análisis que use el centro.
- Ausencias del día al comedor o al transporte. Quién no ha venido hoy, para ajustar comensales o rutas.
- Una app propia para las familias. Con tokens de usuario final, tu app muestra a cada familia sus hijos, sus recibos y sus comunicados, y nada más.
- Calendario y actividades en la web pública. Los eventos y las extraescolares con plazas se publican solos en la web del centro.
- Un panel consolidado para un grupo de centros. Si cada centro tiene su propia cuenta, el equipo del grupo puede leer los datos de cada uno con su clave y construir su propio informe de toda la red.
- Datos para el sistema académico. Preparar en el formato que pide tu sistema académico los datos que ya están en la gestión, sin teclearlos de nuevo.
- Avisos al equipo en su herramienta de trabajo. Una solicitud de matrícula nueva o un recibo devuelto aparecen en el canal que el equipo ya usa.
No hace falta hacerlas todas. Empieza por la que hoy obliga a alguien a copiar datos cada semana.
Cómo se hace una integración, paso a paso
- Define el objetivo. Qué dato va de dónde a dónde, cada cuánto y quién lo necesita.
- Trabaja en un entorno de pruebas. Un sandbox es una copia vacía del centro donde se puede probar sin tocar datos reales ni enviar nada a las familias.
- Crea una clave con el rol mínimo. Si la integración solo lee la asistencia, no necesita poder emitir facturas.
- Programa las llamadas y los webhooks siguiendo la documentación, y gestiona los errores y los reintentos.
- Prueba con casos reales: un alumno con dos familias, un recibo devuelto, una baja a mitad de curso.
- Pasa a producción con una clave nueva para los datos reales, guardada en el servidor.
- Vigila el registro de peticiones y de entregas de webhooks durante las primeras semanas.
Qué exigir a la API de tu software de gestión
Antes de encargar una integración, comprueba que la API del proveedor cumple estos puntos:
- Documentación pública y completa, idealmente en formato OpenAPI, con lo que recibe y devuelve cada operación.
- Cobertura de todos los módulos, no solo de alumnos y familias. Si algo se hace en pantalla y no por API, tarde o temprano tendrás que copiarlo a mano.
- Webhooks para los cambios importantes, firmados y con reintentos.
- Un entorno de pruebas del que no salga nada al mundo real.
- Claves por rol, revocables al momento y con un límite de claves activas.
- Límites de peticiones documentados, con cabeceras que digan cuánto margen queda.
- Errores con una clave estable, para que tu código pueda decidir qué hacer en cada caso.
- Reintentos seguros: poder repetir una escritura sin que se haga dos veces.
- Registro de peticiones que permita saber qué pasó y cuándo.
- Tokens para apps de terceros que actúen como una familia concreta sin exponer la clave del centro.
Una API así también es tu garantía de portabilidad: si un día cambias de proveedor, podrás sacar tus datos de forma ordenada. Lo explicamos en el artículo sobre interoperabilidad y portabilidad.
Seguridad y protección de datos
- La clave nunca va en el navegador ni en la app. Se guarda en el servidor; la app usa tokens de usuario final.
- Rol mínimo para cada integración, y una clave distinta para cada una, para poder revocarla sin afectar a las demás.
- Contrato de encargo con la agencia o el desarrollador que trabaje con datos reales.
- Datos de prueba en el sandbox, nunca copias de los datos reales de alumnos.
- Revisión periódica de las claves activas y de quién tiene acceso a la consola de desarrollo.
Programar con IA sobre la API del centro
Los agentes de programación, como Claude Code, Codex o Gemini CLI, han cambiado quién puede construir una integración. Si la API tiene una referencia pública, el agente la lee, entiende qué operaciones existen y escribe el código. Para que salga bien:
- Trabaja siempre en el sandbox, con claves de prueba.
- Dale la documentación oficial, no le dejes adivinar los nombres de los campos.
- Revisa el código antes de pasarlo a producción, sobre todo en lo que escribe datos.
- No le des claves de datos reales a un agente que trabaja en tu ordenador.
Si lo que quieres es consultar los datos del centro desde tu asistente, sin programar, lo que necesitas es un conector MCP. Lo explicamos en qué es MCP y para qué sirve en un centro educativo.
La API de Edena
- Más de 800 operaciones que cubren todos los módulos: alumnos, familias, facturas, cobros, asistencia, CRM, horarios y el resto. Cada pantalla tiene su operación.
- 240 tipos de evento por webhook, firmados con HMAC-SHA256 y reintentados durante unos tres días si tu sistema no responde. Los eventos de los últimos 30 días se pueden consultar.
- Sandbox: una copia vacía del centro con sus propias claves, de la que no salen correos, avisos a familias, envíos a VeriFactu en producción ni cobros con tarjeta.
- Claves por rol (administrador o gestor, con su subrol), hasta 25 activas por organización y revocables al momento.
- Tokens de usuario final para que tu app actúe como cada familia.
- Referencia OpenAPI pública en español, catalán e inglés, errores con clave estable e Idempotency-Key para repetir escrituras sin duplicarlas.
- Límites: 300 peticiones por minuto por clave y 1.200 entre todas las de la organización.
- CLI de código abierto para personas y agentes de IA, y un registro de 30 días con cada petición y cada entrega de webhook.
Conclusión
Una API y unos webhooks bien hechos son lo que permite que el software de gestión del centro deje de ser una isla. Con ellos, la web, la contabilidad, la plataforma de aprendizaje o una app propia reciben los datos sin que nadie los copie. Antes de encargar una integración, comprueba que la API de tu proveedor está documentada, cubre todos los módulos, tiene un entorno de pruebas y claves con permisos acotados.
Si tu centro ya usa Edena, la consola está en Desarrolladores, en el menú de la app. Si solo necesitas la API para tu propio software, puedes crear una organización de desarrollo con 15 días de prueba. Conoce la plataforma para desarrolladores de Edena o habla con el equipo.
Preguntas frecuentes
¿Qué es la API de un software escolar?
¿Qué es un webhook?
¿Necesito un equipo de programación para usar la API?
¿Es seguro abrir los datos del centro a una API?
¿Qué ofrece la API de Edena?
Este contenido ha sido generado por Ena, el agente de inteligencia artificial de Edena. Puede contener errores o inexactitudes y no constituye asesoramiento legal, fiscal ni profesional. Edena no garantiza la exactitud, integridad ni vigencia de la información. Consulte las fuentes oficiales y, en su caso, a un profesional cualificado antes de adoptar cualquier decisión. La imagen de portada procede de Unsplash .