# Visión general de la plataforma


# Visión general de la plataforma

imatic es una plataforma con tres productos — Voice Portal, Calendar y Survey. Se ven y se sienten diferentes porque sirven a trabajos distintos, pero comparten los mismos cimientos: cómo inicias sesión, cómo autenticas las llamadas a la API, cómo recibes webhooks y cómo se conectan los agentes de IA mediante MCP. Esta página mapea esas piezas compartidas para que sepas dónde vive cada producto y qué se traslada entre ellos.

## Los tres productos

| Producto | Qué hace | Modelo de cuenta |
| --- | --- | --- |
| **Voice Portal** | Agentes de llamadas de voz con IA, campañas, contactos, registros de llamadas | Organización (equipo) |
| **Calendar** | Enlaces de reserva compartibles, sincronización de calendario, citas | Individual |
| **Survey** | Formularios y encuestas, respuestas, analítica en vivo | Individual |

Cada producto tiene su propia introducción: [Voice Portal](/voice/introduction), [Calendar](/calendar/introduction) y [Survey](/survey/introduction).

## Cuentas y organizaciones

Cómo te organizas depende del producto:

- **Voice Portal es organización primero.** Cuando te registras, creas una organización y te conviertes en su admin. Dentro de la org agrupas el trabajo en **Proyectos**, y los proyectos contienen **Agentes**. Invitas a compañeros y les asignas roles. Consulta [Inicio de sesión de la organización](/voice/organization-login).
- **Calendar y Survey son individuales primero.** Te registras como persona y empiezas a trabajar de inmediato — tus propios enlaces de reserva o tus propios formularios. Ambos productos también admiten invitar personas y roles de admin donde necesites un equipo alrededor de tu cuenta.

### Roles

Los tres productos usan una jerarquía de roles, desde un **administrador de la organización** (el propietario) hasta un **miembro** con acceso de visualización y edición limitada. Voice Portal agrega un **gerente de proyecto** limitado a un proyecto. Calendar y Survey usan la misma forma general, escalada a una cuenta individual.

## Conceptos compartidos

Estas cuatro ideas funcionan igual en todos los productos. Apréndelas una vez y se trasladan.

### Autenticación

Inicias sesión en la aplicación web de cada producto con tu correo y contraseña (Calendar también ofrece inicio de sesión con Google y Outlook). Tras bambalinas, la app usa un **JWT** para tu sesión. Para el acceso programático no usas tu contraseña — creas una **clave de API con ámbitos** en su lugar. Consulta la página de la [API REST](./api) para ambos.

### Claves de API

Cada producto te permite crear claves de API para llamar a su API REST. Una clave se muestra en forma `prefix.secret`, lleva **ámbitos** que limitan lo que puede hacer y **se muestra una sola vez** al crearla. Gestionas las claves en el área de desarrolladores de cada producto.

:::danger[Las claves de API son secretas]

Una clave de API concede acceso a tus datos. Se muestra solo una vez, cuando la creas — cópiala entonces y guárdala en un lugar seguro. Nunca confirmes una clave en el control de versiones ni la pegues en un lugar público. Si una clave se filtra, revócala y crea una nueva.

:::

### Webhooks

En lugar de hacer sondeo, puedes registrar un **webhook** para que imatic notifique a tu servidor cuando algo ocurra — se crea una reserva, se envía una respuesta, y así sucesivamente. Las entregas de webhook están **firmadas con HMAC** para que puedas verificar que realmente provinieron de imatic. Consulta [los webhooks en la guía de la API REST](./api#webhooks).

### MCP para agentes de IA

imatic expone servidores de **Model Context Protocol (MCP)** para que los asistentes de IA puedan leer y actuar sobre tus datos con los permisos adecuados. La credencial difiere según el producto: el MCP de Calendar se autentica con una **clave de API con ámbitos** que lleva el ámbito `mcp`; el MCP de Survey se autentica con tu **JWT del portal**; Voice Portal en su lugar te permite **registrar servidores MCP externos** para tus agentes. En todos los casos, las llamadas permanecen dentro del aislamiento de tu organización. Consulta [MCP para agentes de IA](./mcp).

## Dónde vive la API de cada producto

Los conceptos compartidos de arriba son los mismos en todas partes, pero cada producto expone sus propios **recursos**. Empieza desde la página para desarrolladores del producto para conocer nombres de endpoints, cargas útiles y ejemplos:

- **Calendar** — tipos de evento, disponibilidad/espacios, reservas, calendarios, webhooks, claves de API y un servidor MCP de 7 herramientas. Consulta [Calendar para desarrolladores](/calendar/developers).
- **Survey** — formularios, respuestas, agregación, generación de formularios con IA, webhooks y herramientas MCP. Consulta [Survey para desarrolladores](/survey/developers).
- **Voice Portal** — agentes, herramientas y registro de servidores MCP para conectar herramientas externas a tus agentes. Consulta [Herramientas y MCP para agentes](/voice/agents/tools-mcp).

## Idiomas

Las apps de imatic y estos documentos están disponibles en 13 idiomas, incluida la representación de derecha a izquierda para árabe y urdu. Cambia con el menú desplegable de idioma en la navegación superior. Consulta [Idiomas y RTL](./languages).

## Obtener soporte

- Empieza con estos documentos — la mayoría de las páginas terminan con enlaces de **Próximos pasos** o **Relacionado** que te llevan más a fondo.
- Las organizaciones de Voice Portal pueden plantear una solicitud en el área de **Tickets** dentro de la app.
- Para preguntas de cuenta o facturación, usa los datos de contacto de soporte que se muestran dentro de los ajustes de tu producto.

## Relacionado

- [Primeros pasos](../getting-started) — elige un producto y da tus primeros pasos.
- [API REST](./api) — autenticación, claves de API, webhooks y convenciones.
- [MCP para agentes de IA](./mcp) — conecta asistentes de IA mediante el Model Context Protocol.
- [Idiomas y RTL](./languages) — lee las apps y documentos en 13 idiomas.
