Saltar al contenido principal

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​

ProductoQué haceModelo de cuenta
Voice PortalAgentes de llamadas de voz con IA, campañas, contactos, registros de llamadasOrganización (equipo)
CalendarEnlaces de reserva compartibles, sincronización de calendario, citasIndividual
SurveyFormularios y encuestas, respuestas, analítica en vivoIndividual

Cada producto tiene su propia introducción: Voice Portal, Calendar y Survey.

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 Iniciar sesión y organizaciones.
  • 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 superadmin a nivel de plataforma hasta un usuario normal con acceso de visualización y edición limitada. Voice Portal agrega un admin de org (el propietario) y 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 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.

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.

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.

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.
  • Survey — formularios, respuestas, agregación, generación de formularios con IA, webhooks y herramientas MCP. Consulta Survey para desarrolladores.
  • Voice Portal — agentes, herramientas y registro de servidores MCP para conectar herramientas externas a tus agentes. Consulta Herramientas y MCP para agentes.

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.

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​