API y webhooks
Tus sistemas pueden conversar con Dashboard Mágico de dos formas:
- por la API, que lee y modifica los datos de la organización — usuarios del portal, entidades, conectores, páginas y el resto de lo que muestra el dashboard;
- por webhooks, que avisan a tu sistema en el momento en que algo ocurre, sin que tenga que preguntar.
Todo esto está en Sistema › API (/dashboard/api), en cuatro pestañas:
| Pestaña | Qué encuentras |
|---|---|
| API Tokens | Donde crear el token que tus aplicaciones usan en la API. Mira Tokens de API. |
| Webhooks | Los endpoints que reciben los eventos y el historial de cada envío. Mira Webhooks y Entregas. |
| Rate Limits | Cuántas solicitudes acepta la API. Mira Rate limiting. |
| Documentation | Atajos a la documentación de la API, la especificación OpenAPI, la colección de Postman y los ejemplos de payload de webhook. |
Para abrir esta pantalla, tu rol necesita acceso a los tokens de API (mira Miembros). Sin él, el dashboard muestra un aviso de acceso denegado.
Workspace en las llamadas a la API
El token identifica a la organización. El workspace va en el header X-Workspace-Id, con el ID que aparece en cada tarjeta de Sistema › Workspaces. Mientras la organización tiene un solo workspace, el header es opcional; a partir del segundo, toda llamada tiene que indicar en qué workspace actúa. Mira Organización y workspaces.
En esta sección
- Tokens de API — cómo se autentican tus aplicaciones en la API.
- Webhooks — registrar, probar y proteger los endpoints que reciben eventos.
- Entregas — seguir cada envío y reenviar lo que falló.
- Eventos de webhook — el formato del payload y los eventos disponibles.
- Rate limiting — los límites de solicitudes y qué pasa cuando los superas.
La referencia completa de los endpoints está en la sección API del menú superior (empieza por la introducción), y las herramientas para agentes de IA, en la sección MCP.