VitrinaAPI

Referencia

Cada endpoint que esta API publica, generado desde el mismo documento OpenAPI que sirve el backend.

Estas páginas se generan desde openapi.public.json, la proyección de la API pública que el backend deriva de sus propias definiciones de rutas. No pueden describir un endpoint que no existe, y solo quedan viejas si el spec queda viejo.

El backend sirve más de lo que ves aquí. Un recurso llega a esta referencia por ser estable o beta (toda operación tiene un nivel — ver la página de versionado); lo que sigue interna se descarta, porque un endpoint al que no nos comprometimos no es un contrato. Puedes descargar la proyección completa desde cada página de abajo.

Los resúmenes y las descripciones de cada operación están en inglés: son el texto del contrato, escrito junto al código que describen, y traducirlos crearía un segundo lugar donde dice qué hace un endpoint. Los capítulos escritos a mano sí están en español.

Agentes de IA

El agente que conversa por el workspace: su configuración en borrador y en vivo, versiones, herramientas y skills, el canal de voz, y las Solicitudes con las que un cliente pide un cambio. 75 operaciones.

Publicidad

Gasto, ROAS e ingresos atribuidos por campaña, el ranking de creativos y la salud de la atribución, más el tag único: el fragmento que pegas (o su instalador de Google Tag Manager) y si ya está enviando visitas. Lecturas de Atribu con la clave delegada del workspace. 126 operaciones.

Analytics

Los reportes del panel: volumen y resolución de conversaciones, desempeño humano y de IA, uso de herramientas y de tokens, y latencia. 24 operaciones.

API keys

Emitir, listar y revocar las credenciales con las que se llama a todo lo demás. 4 operaciones.

Agenda y citas

Las horas reservadas y el catálogo de lo que se reserva: disponibilidad, reservar, mover, cerrar y cancelar. Una prueba de manejo y una consulta son el mismo recurso. 22 operaciones.

Reglas de asignación

Enrutamiento ordenado, primera coincidencia gana, hacia un equipo o un pool de agentes. 8 operaciones.

Audiencias

Segmentos de contactos definidos por condiciones, con sus conteos y su superposición. 11 operaciones.

Método de pago

El proveedor de pago del workspace y el estado de su mandato — lo que habilita activar complementos por autoservicio — y la escritura que lo conecta con Fintoc o Mercado Pago. 18 operaciones.

Campañas

Envíos masivos por WhatsApp o correo a una audiencia: borrador, programación, pausa y destinatarios. 18 operaciones.

Canales

La lectura y desconexión de un canal de mensajería — conectar uno sigue siendo un flujo de navegador. 8 operaciones.

Diagnóstico y números comerciales de la clínica

El Diagnóstico gratuito de la clínica en una lectura (estado, día de la ventana y la banda de plan) y sus números comerciales: aceptación de presupuestos, cierres y caja, siempre agregados, nunca un paciente. 23 operaciones.

Agenda de la clínica

El día de una clínica: leer la agenda, buscar horas libres, reservar y mover una cita, con los mismos ids sea cual sea el sistema que la lleva. Una aplicación conectada la lee con seudónimos de paciente. 13 operaciones.

Presupuestos de la clínica

Presupuestos con folio, sus líneas con el precio congelado y los planes de tratamiento que ordenan lo que se va a hacer. 30 operaciones.

Caja de la clínica

El turno en una sucursal: abrirlo con su fondo, cerrarlo contra un conteo y firmar el arqueo. 7 operaciones.

Consentimientos

El consentimiento informado contra el texto exacto que se firmó, su revocación y la galería clínica que ese consentimiento habilita. Marcado como sensible. 11 operaciones.

Documentos de la ficha

Exámenes, informes e imágenes colgados de una ficha, con su plazo de conservación — y las solicitudes de acceso y supresión de la Ley 21.719. Marcado como sensible. 8 operaciones.

Esterilización de la clínica

El registro de ciclos de esterilización: equipo, lote, fecha y hora, quién lo realizó, resultado con su indicador y los paquetes del ciclo, con exportación CSV y PDF por período y equipo; el lote usado queda anotado en la atención. 8 operaciones.

Recursos humanos de la clínica

La conexión de solo lectura con Buk y el costo de nómina del mes, sumado a partir de las liquidaciones cerradas sin guardar el detalle por persona. 12 operaciones.

Laboratorio de la clínica

Los laboratorios de la clínica, su lista de precios por tipo de trabajo y los pedidos que se les envían, con el estado de cada pedido. 9 operaciones.

Líneas de la clínica

La lista corta de lo que buscan los pacientes (Implantes, Estética, Endodoncia…): cada especialidad del equipo y cada anuncio pertenecen a una sola Línea, y cada lead lleva una. 9 operaciones.

Packs de sesiones

Sesiones vendidas por adelantado: el pack del catálogo, la compra de un paciente y su saldo derivado. 13 operaciones.

Registro de pacientes

Quién es paciente de la clínica y quién responde por él: la ficha de identidad, los duplicados y los vínculos de familia. Marcada como sensible — pide su propio permiso y ninguna aplicación conectada la alcanza. 20 operaciones.

Precios de la clínica

Aranceles, reglas y convenios, y la cotización que explica cuánto le cuesta una prestación a un paciente concreto. 19 operaciones.

Profesionales de la clínica

Quién atiende en la clínica, con qué especialidad y con qué bloque por defecto — el id que la agenda usa como lane. 9 operaciones.

Ficha clínica

Lo que se le hizo a una persona y por qué: atenciones, evoluciones firmadas, antecedentes, alertas, fichas y el odontograma con su historia. Marcada como sensible. 51 operaciones.

Reembolsos de seguros

La solicitud de reembolso al seguro por atención, con sus documentos y estados (por enviar, enviada, pagada, rechazada), los pagos del seguro y su conciliación con las solicitudes que saldan, parciales incluidos. El dinero del seguro nunca se cuenta dos veces: no es un pago de Caja ni del espejo de ingresos. 13 operaciones.

Seguros de la clínica

Los seguros del paciente (varios, uno principal), la tabla de cobertura por plan y prestación, y la cobertura estimada y el copago en el presupuesto y en el estado de cuenta, también en PDF. La cobertura nunca es un descuento: los precios y convenios no cambian. 13 operaciones.

Prestaciones de la clínica

Qué hace la clínica: duración, precio de lista, requisitos de consentimiento y quién puede ejecutar cada prestación. 19 operaciones.

Plantillas y conservación

Los textos y las preguntas antes de que nadie los firme o los responda, y cuántos años se guarda cada tipo de documento. No nombran a ningún paciente, y por eso no son sensibles. 18 operaciones.

Feed bancario de la clínica

Los movimientos bancarios de la clínica, desde correo, Fintoc o la API del banco, normalizados a un mismo formato para conciliar la caja. 6 operaciones.

Comisiones de la clínica

El historial de comisiones de cada profesional: los meses que liquida Vitrina junto a las liquidaciones que emitió Dentalink, importadas de solo lectura, y las exportaciones de Dentalink que suba la clínica. 4 operaciones.

Sugerencias del panel de inicio

Hasta tres tarjetas con la cifra de la propia clínica que justifica abrir un módulo (pagos sin boleta, comisiones sin liquidar, pagos sin conciliar, presupuestos aceptados sin cita, gasto en publicidad), y cómo cerrar una para quien la ve. 2 operaciones.

Inventario de insumos

Los insumos de la clínica con su stock, mínimo y último precio; cada entrada, salida y conteo queda registrado con quién, cuándo y por qué, y los que están bajo su mínimo salen como «Por reponer». 29 operaciones.

Empresas

Las organizaciones a las que pertenecen los contactos. Agrupan personas; la identidad legal vive en el contacto que representa a la empresa. 5 operaciones.

Consignaciones

El contrato bajo el cual una automotora vende el auto de otra persona: crear, editar, devolver y vender con su liquidación. 8 operaciones.

Contactos

Las personas con las que habla el workspace: buscar, crear, corregir, fusionar, etiquetar, y los canales y atributos que cuelgan de cada una. 39 operaciones.

Conversaciones

Los hilos con clientes y pacientes: leer la bandeja, responder, asignar, posponer y resolver — con el autor de cada mensaje. 61 operaciones.

Voz de correo del workspace

Lo que un asistente debe leer antes de escribir un correo a nombre del workspace: idioma, guía de estilo, la persona del agente de IA y correos recientes reales del equipo. 1 operación.

Solicitudes de crédito

El expediente que persigue una carpeta bancaria: registrar, marcar enviada, registrar la respuesta del banco y retirar. 8 operaciones.

Atributos personalizados

Los campos propios de cada workspace: la definición una vez, y después el valor en cada contacto o conversación. 7 operaciones.

Herramientas personalizadas

El Tool Store: enseñarle al agente a llamar la API propia del workspace, sin escribir código — una plantilla de request más una lista de parámetros. 8 operaciones.

Resumen semanal

La configuración del resumen de los lunes: día y hora de envío, canales (correo y WhatsApp, que se activa por separado), destinatarios y el estado de las plantillas de WhatsApp. 2 operaciones.

Pagos de documentos

Registrar dinero contra una reserva o una nota de venta. Puerta heredada — POST /payments es la vía nueva y más completa. 2 operaciones.

Plantillas de documentos

El texto estándar de cada familia de documentos (nota de venta, reserva, cotización, consignación, nota de compra, ficha técnica), con las variables que usa. 3 operaciones.

Borradores de correo

Un correo que alguien, o su asistente de IA, deja listo para que una persona lo revise y lo envíe: listar, crear, editar, descartar y enviar. 6 operaciones.

Plantillas de correo

Los cuerpos de correo reutilizables que usan las campañas. 6 operaciones.

Complementos

El catálogo de complementos, los que este workspace ha activado alguna vez y el uso en vivo de los que se miden — y las dos escrituras de autoservicio para activar o cancelar uno. 3 operaciones.

Finanzas

Las finanzas del negocio, para cualquier rubro: bancos, Mercado Pago y SII conectados, con su estado y la última sincronización. 158 operaciones.

Seguimientos

Recetas de seguimiento, las Búsquedas de cada cliente, la demanda, Recontacto y su cola de revisión. 53 operaciones.

Centros de ayuda

El portal de documentación de cara al cliente: secciones, artículos multi-idioma y su sincronización con la base de conocimiento. 40 operaciones.

Régimen IVA

Si un auto se vende con IVA (afecto) o sin IVA (exento): el predeterminado de la automotora y la decisión por unidad, que se captura al ingresar el auto y no cambia con el predeterminado. 4 operaciones.

Vistas del inbox

Filtros guardados de la bandeja, del equipo o personales, por atributos de la conversación; una vista del equipo puede sacar sus conversaciones de Esperando respuesta. 7 operaciones.

Indicadores de la automotora

La exportación de Comisiones para el cierre de mes, en Excel o CSV: una fila por vendedor y negocio con el cálculo de la comisión a la vista, y un resumen de lo que corresponde pagar a cada persona. 2 operaciones.

Posts de Instagram

Prepara el post de Instagram de un vehículo (pie de foto escrito con el estilo de la automotora y las primeras fotos) y apruébalo para publicarlo o programarlo. Nada se publica sin la aprobación. 2 operaciones.

Integraciones · Meta Ads

La conexión de la cuenta publicitaria de Meta: iniciarla, resolver la selección de cuenta cuando hay más de una, desconectarla y leer los anuncios de click-to-WhatsApp del workspace. 26 operaciones.

Base de conocimiento — fuentes y texto indexado

Las fuentes manuales del agente — un problema, su causa y los pasos de solución, redactados a mano en vez de subidos — y el texto indexado de un archivo de la biblioteca: literalmente lo que el agente busca. 10 operaciones.

Base de conocimiento — archivos

La biblioteca de documentos subidos del workspace: uno se sube o se genera desde una URL, y se adjunta a uno o más agentes. 10 operaciones.

Leads

Las oportunidades que el workspace está trabajando: abrirlas, moverlas por el tablero, cerrarlas ganadas, perdidas o no calificadas, y leer el embudo. 34 operaciones.

Sucursales

Las sucursales del workspace, y la dirección con la que se muestran. 5 operaciones.

Macros

Respuestas guardadas con acciones automáticas que un agente aplica en un clic. 8 operaciones.

Margen y rentabilidad

El Resumen del negocio de una unidad vendida (en JSON, PDF, Excel o CSV) y la exportación de Margen y rentabilidad: una fila por nota de venta del período, con las cifras del negocio sin IVA y las del comprador con IVA. 5 operaciones.

Portales

Las cuentas de portales conectadas: su estado, su historial de sincronización y «Sincronizar». 6 operaciones.

Mis notificaciones

Lo que ve quien llama: el feed de notificaciones del workspace activo y sus preferencias de aviso, por preset o celda por celda. 3 operaciones.

Biblioteca

Fotos, videos, PDFs y audios que el equipo y el agente envían, con «cuándo usarlo», temas y consentimiento para fotos de pacientes. 8 operaciones.

Mejoras

Lo que el revisor nocturno encontró en tu agente: descartar o marcar resuelto un hallazgo, y calificar una derivación. 2 operaciones.

Equipo

Los miembros del workspace y sus invitaciones: alta, cambio de rol o sucursal, y baja — que siempre reparte el trabajo pendiente de la persona en lugar de dejarlo huérfano. 10 operaciones.

Buzones de envío

Los buzones desde los que la persona conectada puede enviar un correo nuevo: el suyo y el principal del workspace, con cuál se usa por defecto. Su id es el from_account_id de un envío o un borrador. 12 operaciones.

Pedidos

Cada venta como un pedido: líneas con precio del catálogo, cobro con link de Mercado Pago, despacho y entrega. 19 operaciones.

Datos legales

La identidad legal de la automotora (razón social, RUT, giro, domicilio, representante y escritura) y sus poderes. Sin ella, imprimir una nota de venta o una compraventa responde 409. 6 operaciones.

Por aprobar

Los mensajes que esperan el OK de una persona antes de salir, de cualquier camino. 11 operaciones.

Registro de pagos en la clínica

Los pagos de Mercado Pago que faltan por registrar en el sistema de la clínica: la lista de tareas, confirmar a qué pago del sistema corresponde cada uno o cerrar la tarea sin coincidencia, y qué medio representa a Mercado Pago. 6 operaciones.

Ajustes de cobro

Cómo cobra el negocio según el tipo de cargo, desde qué monto un link de pago ofrece cuotas, qué cobra «aceptar y pagar» en un presupuesto y la conexión con Mercado Pago. 24 operaciones.

Cobros y pagos

El ledger del workspace: lo que se debe, lo que llegó y cómo se imputa lo segundo a lo primero. 31 operaciones.

Tokens personales

La credencial que un miembro emite para sí mismo: ve exactamente lo mismo que esa persona, y deja de servir cuando esa persona deja de tener acceso. 3 operaciones.

Embudos

Los tableros por los que avanza el trabajo, y las plantillas versionadas con las que se arma uno. 12 operaciones.

Aprobaciones de precio

La autoridad sobre un precio bajo el de referencia: quien pide y quien decide deben ser personas distintas. 5 operaciones.

Productos

El catálogo de lo que ofreces cuando no son vehículos, y su publicación en tus canales. 12 operaciones.

Proyectos

Los proyectos de una inmobiliaria, sus tipologías, su stock de unidades (departamentos, casas, estacionamientos y bodegas) y su lista de precios en UF versionada y las cotizaciones en PDF con pie y dividendo, con importación desde Excel. 163 operaciones.

Propiedades

La cartera de una corredora: cada propiedad con su operación, precio en UF o pesos, características y estado. 14 operaciones.

Stock público

El lote publicado de una automotora: listar, contar y leer una unidad. Es la superficie que consume un sitio web de la automotora. 7 operaciones.

Notas de compra

El instrumento que crea el costo de un vehículo: emitir, corregir y anular. 6 operaciones.

Cotizaciones

Una oferta de precio sobre una unidad, congelada al emitirse. No reserva nada: varios clientes pueden tener cotizaciones vigentes sobre el mismo auto. 6 operaciones.

Reservas

La única de estas ocho que bloquea inventario: toma un cupo sobre una unidad, con un abono opcional y un plazo. 10 operaciones.

Roles personalizados

El catálogo de scopes y visibilidad por rol — acceso efectivo, no una etiqueta. 5 operaciones.

SLAs

Los objetivos de primera respuesta y resolución que un ticket debe cumplir, y qué canales/prioridades los disparan. 5 operaciones.

Notas de venta

El documento que vende el auto: emitir, aprobar (lo que lo hace legalmente válido y marca la unidad vendida) y anular. 11 operaciones.

Espacio de prueba

Un workspace sintético aparte de tus datos reales, con claves sk_test_: aprovisionar, reiniciar y ver lo que quedó capturado en vez de salir. 6 operaciones.

Dominios de envío

El dominio propio con el que un workspace envía campañas de correo, con sus registros DKIM y su verificación. 5 operaciones.

Secuencias

Cada camino de seguimiento (Al llegar, Si no responde, Avisos) con sus pasos, esperas, canales y resultados. 28 operaciones.

Etapas

Las columnas de un tablero: su categoría, su umbral de envejecimiento y a qué otras columnas puede saltar una tarjeta. 7 operaciones.

Configuración de tienda

Lo que le falta a una tienda nueva para vender por el chat: conectar la tienda, revisar el catálogo y conectar Mercado Pago. 2 operaciones.

Etiquetas

El vocabulario suelto que se cuelga de una conversación o de un contacto: adjuntar por nombre lo crea la primera vez. 6 operaciones.

Equipos de trabajo

El destino de enrutamiento de canales y tickets, y su horario de cobertura propio. 9 operaciones.

Ajustes del workspace

La identidad general del workspace (nombre, zona horaria, idioma, moneda, sitio web) y las decisiones de Vitrina Ads: cómo se respondió el paso del tag y la meta mensual. 4 operaciones.

Tickets

El caso que sobrevive al hilo: puede dueñar varias conversaciones, vive en una columna de un tablero y tiene responsable y SLA. 21 operaciones.

Credenciales de herramientas

La bóveda detrás de una herramienta personalizada autenticada — el secreto nunca vuelve a mostrarse, solo un preview. 5 operaciones.

Triggers

Automatizaciones evento → condición → acción: asignar, etiquetar, mover de etapa o avisar sin que nadie lo haga a mano. 5 operaciones.

Adjuntos de vehículo

Documentos y archivos colgados de una unidad. 5 operaciones.

Vehículos

El stock por dentro: alta, edición, etapas, publicaciones en portales y las herramientas de mantenimiento del inventario. Pide scopes más anchos que el stock público. 54 operaciones.

Clips de voz

Notas de voz grabadas que el equipo y el agente reutilizan, con transcripción, vencimiento y filtro por modelo. 6 operaciones.

Webhooks

Suscripciones a los eventos del workspace, y el registro de cada entrega. 9 operaciones.

Flows de WhatsApp

Formularios estructurados de varias pantallas que se abren dentro de una conversación de WhatsApp, construidos y publicados desde Vitrina. 17 operaciones.

Plantillas de WhatsApp

El catálogo de mensajes pre-aprobados por Meta para escribir fuera de la ventana de 24 horas, y cómo Vitrina llena cada variable. 22 operaciones.

Generado desde un documento OpenAPI con 2135 rutas y 2697 operaciones; aquí se publican 1791.