AchieveApex: resumen de producto

Generado desde achieveApex-Frontend/public/ai-docs el 2026-10-15. Contiene la ficha tecnica y los README de apps y modulos (sin fichas individuales).

AchieveApex: ficha tecnica del producto

Documento de entrada para una IA o una persona que necesita entender que es AchieveApex (Apex), que hace, para quien y que lo diferencia. Todo lo que dice esta respaldado por el catalogo de funcionalidades de esta misma carpeta (89 modulos, 822 fichas), que a su vez se escribio leyendo el codigo real del frontend y del backend.

Como navegar este catalogo

Este catalogo se publica como HTML estatico. Cualquier IA (ChatGPT, Claude, un agente) debe abrir las URLs .html. El texto esta en la pagina, sin JavaScript y sin descargar Markdown.

Puerta de entrada: https://www.achieveapex.com/llms.html

Ficha de producto: https://www.achieveapex.com/ai-docs/FICHA-TECNICA.html

Reglas:

1. Empezar en https://www.achieveapex.com/llms.html y seguir solo enlaces .html.
2. No abrir .md ni .txt. Esos archivos son la fuente interna; la pagina que se lee es .html.
3. La carpeta de una app o modulo es su index.html (el mismo contenido que README.html).
4. Para una app completa, abrir https://www.achieveapex.com/ai-docs/bundles/{app}.html.
5. Para un detalle, ir al index.html del modulo y luego a la ficha .html.
6. Por confirmar: es una duda, no una capacidad.

1. Que es

AchieveApex es una plataforma multi-app para operar un negocio alrededor de sus clientes: atencion y ventas por canales de mensajeria, asistentes de IA que actuan sobre los datos del negocio, automatizaciones, finanzas (cotizaciones, facturas, pagos, cuentas por pagar), reservas, eventos, proyectos, helpdesk, contratos, reuniones, sitios web y presentaciones.

La pieza que une todo es un contacto unico: la misma persona es el hilo de WhatsApp, el deal, la cotizacion, la factura, la reserva, el ticket, el registro del evento, el contrato firmado y el asistente a la reunion. Cada app lee y escribe sobre ese mismo registro.

Usuario tipico: pymes y empresas de servicios de habla hispana e inglesa (clinicas, inmobiliarias, agencias, academias, e-commerce, consultoras, organizadores de eventos, despachos) que atienden clientes por WhatsApp e Instagram y quieren que la IA opere, no solo responda.

2. Arquitectura de producto

Tecnologia: frontend Next.js 14 (App Router, TypeScript, Tailwind), backend FeathersJS sobre PostgreSQL con Socket.IO para tiempo real, archivos en S3/CloudFront, autenticacion JWT y API keys, autorizacion CASL por organizacion, seccion, modulo y accion granular (own/all). Multi-tenant por organizacion.

3. Lo que hace distinto a Apex

Cada punto sale de los README de modulo (seccion "Que lo hace diferente").

3.1 Un solo contacto para toda la operacion

• Conversaciones de WhatsApp, Instagram, Messenger, SMS, webchat y email en el mismo hilo, asociado al contacto del CRM.
• Ese contacto es el que aparece en deals, estimates, invoices, pagos, reservas, tickets, registros de eventos, contratos, reuniones, smart links y proyectos.
• Un registro publico (formulario, booking, evento, catalogo) crea o relaciona un contacto; no genera listas aisladas.

3.2 Asistentes de IA que operan, no solo chatean

• Un asistente de canal puede, segun sus tools internas habilitadas: buscar y crear contactos, deals, actividades, notas, tareas; consultar disponibilidad y crear o actualizar reservas; crear estimates e invoices; buscar productos por semantica y enviarlos; crear y consultar tickets; enviar mensajes en los canales del CRM; crear smart links; sintetizar audio con voces IA.
• Handoff a humanos con reglas reales: mantener asignacion, propietario del contacto, o reparto entre miembros por disponibilidad, pesos y fallback. Y handoff inverso: un flujo puede cortar el contexto de la IA o reanudarla con una instruccion.
• Tools externas: HTTP propias (API tools), servidores MCP con OAuth o API key, y automatizaciones publicadas que el asistente invoca.
• Skills por asistente (conocimiento + condiciones de uso), historial de cambios de instrucciones con restauracion, playground, horario de disponibilidad, follow-up automatico.
• Modelos via OpenRouter con catalogo administrado por Apex (modelos permitidos por superficie: conversaciones, tickets, AI chat, voz) y cobro por wallet.
• Voz: asistentes de voz sobre Telnyx, con numeros, IVR/enrutamiento a humano o IA, cola, softphone WebRTC en el header y cumplimiento 10DLC.

3.3 Automatizaciones nativas de todo el producto

• Triggers de CRM, conversaciones, reservas, eventos (registro, check-in), Helpdesk (ticket creado/actualizado/SLA), formularios, llamadas de voz, cambios de miembros del equipo, webhook entrante y fecha.
• Acciones sobre entidades y canales nativos: contactos, deals, estimates, reservas, tickets, actividades, notas, series, WhatsApp, SMS, Gmail, Google Calendar, control del asistente IA en la conversacion, atribucion y Meta CAPI.
• Nodo Chat With AI para clasificar, resumir o redactar dentro del flujo. Creacion de automatizaciones por chat con IA. Ejecuciones visibles nodo por nodo con entradas y salidas.
• Series: secuencias donde cada contacto avanza en su propio calendario y cada paso ejecuta una automatizacion.

3.4 Finanzas pegadas a la venta

• La cotizacion nace del deal y del contacto; se envia desde la conversacion; el cliente acepta o rechaza en una vista publica con tracking de aperturas, tiempo visible y descargas.
• Conversion a factura, pagos parciales y multi-factura, payment links con Stripe o Wompi (Apex Checkout o Provider Checkout), recurrencia, multi-moneda con FX automatico.
• Pedidos estilo Shopify (estado, pago y entrega por separado) que llegan del checkout del catalogo publico, del asistente de IA, de conversiones o de creacion manual; el catalogo cobra con las pasarelas propias de la organizacion, en varias monedas, con envio o recogida, inventario opcional y recuperacion de checkouts abandonados. Sin impuestos ni suscripciones.
• Plantillas PDF con builder visual e IA, paginas adicionales Markdown y tablas inteligentes, campos personalizados del CRM en el documento.
• Cuentas por pagar (vendors, expenses, bills, payments made, recurrentes) en la misma plataforma. No es contabilidad de partida doble.

3.5 Copilotos de plataforma y acceso para otras IAs

• Nova: copilot interno de cada organizacion que ejecuta tools sobre contactos, conversaciones, deals, productos, automatizaciones, reservas, proyectos y OKRs, y construye AI Reports probando cada fuente de datos antes de guardar un widget.
• Nova Support: ayuda in-app que conoce la pagina actual (metas de soporte por ruta), consulta datos en solo lectura, acepta capturas y escala a un caso humano.
• MCP server oficial: cualquier cliente MCP (Claude, Cursor, ChatGPT con conectores) opera Apex con consentimiento OAuth por organizacion: contactos, conversaciones y mensajes, deals, facturas, reservas, proyectos, tareas, productos, formularios, asistentes IA y consultas de datos autorizadas de la organizacion. API REST documentada en /docs con API keys por organizacion.

3.6 Modelo comercial

• Suscripcion Stripe por plan mas wallet prepago para consumo variable: IA de asistentes y herramientas, sintesis de voz, transcripcion y grabacion de reuniones, envios masivos de email, busqueda semantica de productos, generacion de contenido, tramites 10DLC.
• Auto-recarga por saldo minimo con limites de 24 horas y 30 dias que la desactivan ante abuso, conservando el motivo.
• Programa de partners (agencias y afiliados) con atribucion, comisiones por eventos de cobro y payouts via Wise reconciliados por webhook.
• Dominio propio en Sites: subdominio gratuito; dominio propio con suscripcion de $5 USD/mes.

4. Integraciones externas confirmadas

5. Superficies publicas (sin login)

Formularios /f/{id}, cotizaciones /e/{path} e invoices /i/{path}, payment links /payment-links/{token}, catalogos /c/{orgId}/{slug}, eventos /events/{orgId}/..., booking /b/{orgId}/{slug}, booking personal de meetings /m/{orgId}/{slug}, transcripts /mt/{token}, firma de contratos /contracts/sign/{token}, presentaciones /p/{token}, whiteboards /wb/{token}, portal de helpdesk /help/{slug} o dominio propio, sitios publicados en pages.achieveapex.com o dominio propio, smart links en apx.red, unsubscribe de email, consentimiento SMS, webchat embebible.

6. Lo que Apex no hace (honestidad para la IA)

• No es contabilidad de partida doble ni emite facturacion electronica fiscal.
• Tickets legacy (Customer Service) y Helpdesk conviven como productos distintos.
• Clonacion de voz aparece como Coming Soon; no es operativa.
• Vector storage tiene UI de administracion pero el codigo revisado no confirma su backend ni que modulos lo consumen.
• Whiteboards: sin evidencia de colaboracion simultanea ni exportacion.
• Reservations: sin flujo publico de cancelacion por token.
• Todo lo marcado Por confirmar: en las fichas es una duda real, no una capacidad.

7. Como esta organizado el catalogo

funcionalidades/
  FICHA-TECNICA.md        ← este documento
  README.md               ← indice de apps con conteos
  PLANTILLA.md            ← formato de README de modulo y de ficha
  bundles/                ← archivos concatenados para entregar a una IA
  {app}/README.md         ← modulos de la app
  {app}/{modulo}/README.md        ← para que sirve, que lo hace diferente, acceso, alcance, tabla de fichas
  {app}/{modulo}/{capacidad}.md   ← que se logra, donde esta, como funciona, campos, reglas, backend, relaciones

Cada ficha de capacidad responde en orden: que hace, que se logra (resultado, caso de uso, con que se combina), donde esta en la UI, pasos reales, campos, reglas, servicios backend y efectos, relaciones y notas. Los nombres de UI van en ingles tal como aparecen; la explicacion en espanol. En la URL publica, {capacidad}.md y {capacidad} son el mismo documento.

8. Glosario minimo

• Organizacion: tenant. Todo dato pertenece a una.
• Contacto: persona. Compania: cuenta B2B.
• Deal: oportunidad en un pipeline con etapas.
• Estimate: cotizacion. Invoice: factura. Payment link: cobro individual publico.
• Asistente IA: agente configurado por canal (inbox, tickets, Nova/ai-chat, voz).
• Tool interna: accion que el asistente puede ejecutar sobre Apex. API tool: HTTP externa. MCP server: servidor de herramientas externo conectado al asistente.
• Automatizacion: flujo trigger → nodos. Serie: secuencia de automatizaciones por contacto.
• Wallet: saldo prepago para consumo variable.
• Nova: copilot interno. Nova Support: ayuda in-app.
• Smart link: enlace corto apx.red con QR, UTM y atribucion.

Funcionalidades

Catalogo de producto de AchieveApex. Cada app tiene su carpeta. Cada modulo tiene la suya. Cada funcionalidad interna es un archivo dentro de la carpeta del modulo.

Para que existe

Es la ficha tecnica de Apex para otra IA (ChatGPT, Claude, un agente) o para quien pregunte "que hace Apex". Empezar por FICHA-TECNICA.md. Para entregarlo a una IA usar los archivos de bundles/:

Tras editar fichas, desde achieveApex-Frontend corre node public/ai-docs/absolutize-links.mjs. Convierte los enlaces a URLs absolutas (https://www.achieveapex.com/ai-docs/...), regenera los bundles y valida que existan. No editar bundles/ a mano.

Acceso publico para IA: https://www.achieveapex.com/llms.html y https://www.achieveapex.com/ai-docs/FICHA-TECNICA.html. Cada ficha publicada es un .html estatico generado por node public/ai-docs/build-html.mjs. No enviar a una IA enlaces .md ni .txt. Google no indexa estas paginas (googlebot: noindex); ChatGPT y Claude si pueden abrir el HTML.

Nombre

Usamos funcionalidades y no modulos ni docs porque:

• Un modulo es el contenedor (Conversaciones, Invoices, Sites).
• Lo que vamos a describir dentro son las funcionalidades internas de ese modulo.
• src/app/(docs) es el sitio publico de API. Este arbol es el inventario de producto orientado a IA.

Ruta canonica:

achieveApex-Frontend/public/ai-docs/

Estructura

funcionalidades/
  README.md                 ← este indice
  FICHA-TECNICA.md          ← vision del producto para una IA: que es, que lo hace distinto, limites
  PLANTILLA.md              ← formato de README de modulo y de ficha
  build-bundles.mjs         ← genera bundles/
  bundles/                  ← concatenados por app y completo (generados, no editar)
  {app}/
    README.md               ← lista de modulos de la app
    {modulo}/
      README.md             ← para que sirve, que lo hace diferente, acceso, alcance, tabla de fichas
      {funcionalidad}.md    ← una por capacidad: que se logra, donde esta, pasos, campos, reglas, backend

Apps de un solo modulo (sites, presentations, whiteboards, support-admin) no anidan otra carpeta: las fichas van directo en la carpeta de la app.

Convencion de slugs

Carpetas en kebab-case, estables, alineadas al producto (no a traducciones de UI):

No renombrar slugs al traducir titulos. El titulo en espanol vive dentro del README.md del modulo.

Mantenimiento

Cada funcionalidad nueva se revisa con el skill funcionalidades-catalog:

• Si es una capacidad de producto (app, modulo o funcion interna usable), se agrega aqui.
• Si es bugfix, refactor, hook, cron o migracion sin UX nueva, no se agrega.

Estado de este arbol

• Inventario de apps y modulos: listo (15 apps, 89 modulos).
• Funcionalidades internas: documentadas (822 fichas). Cada ficha se escribio leyendo el codigo real de frontend y backend; lo no confirmable esta marcado como Por confirmar: (151 dudas concretas en 132 archivos).
• Capa de valor: cada ficha tiene Que se logra (resultado, caso de uso, con que se combina) y cada modulo tiene Para que sirve y Que lo hace diferente, escritos con hechos del codigo y sin marketing.
• Calidad: cada ficha sigue PLANTILLA.md. Esta prohibido el texto plantilla generico (pasos como "abre la seccion correspondiente"); si una ficha no puede describir pasos reales, no se crea.

Apps

APP: contracts

Contracts

Contratos, plantillas y firma electronica.

• Etapa: Beta
• Landing: /{orgId}/contracts

Modulos

Funcionalidades internas

18 funcionalidades documentadas en 3 modulos. Ver la tabla de cada modulo.

id: contratos app: contracts nombre: Contratos estado: beta permiso: can_access_contracts

Contratos

Gestiona documentos para solicitar firmas electrónicas o registrar contratos recibidos.

Para que sirve

• Una agencia envía un acuerdo de servicios para firma y conserva el resultado con el deal del cliente.
• Una inmobiliaria prepara contratos de arrendamiento con varios firmantes y controla su vencimiento.
• Un despacho archiva contratos ya firmados recibidos de terceros junto al contacto, proyecto o factura relacionados.
• Una empresa B2B revisa qué contratos siguen pendientes y recuerda a los firmantes sin salir del CRM.

Que lo hace diferente

• Un contrato puede vincularse con contacto, empresa, deal, estimate, invoice y proyecto del CRM.
• Combina firma pública mediante enlace con el registro de contratos recibidos que no requieren un flujo de firma.
• Genera el documento firmado con sello y certificado de auditoría, y conserva eventos del proceso.
• Usa plantillas con variables de los registros CRM para crear el documento inicial de contratos de firma.

Acceso

• Ruta principal: /[orgId]/contracts
• Como se llega: Header app switcher > Contracts
• Permiso requerido: can_access_contracts y permisos de contratos propios o de toda la organización

Alcance tecnico

• Frontend: lista, detalle, preparación y panel lateral de contratos.
• Backend: contracts, contract-document-versions, contract-signers, contract-signature-fields, contract-send, cron-expire-contracts.
• Integraciones externas: S3, SES, Telnyx y generación PDF.

Funcionalidades internas

Relaciones

• Depende de: Contactos, Empresas, Deals, Estimates, Invoices y Proyectos.
• Usado por: firma pública y documentos relacionados.

Limitaciones y notas

• Los contratos registrados no se pueden enviar ni preparar para firma.

id: firma-publica app: contracts nombre: Firma pública estado: public permiso: ninguno

Firma pública

Permite a una persona firmar un contrato desde un enlace seguro sin cuenta de AchieveApex.

Para que sirve

• Una empresa de servicios obtiene la firma de un cliente sin pedirle acceso al CRM.
• Una inmobiliaria coordina una firma secuencial entre arrendador, arrendatario y codeudor.
• Un despacho recoge evidencia de consentimiento, verificación y, cuando se exige, foto de identidad.
• Un equipo comercial recibe el documento final al completar el último firmante.

Que lo hace diferente

• La firma pública completa el contrato que vive en Apex y conserva sus relaciones con contacto, deal, factura o proyecto.
• Admite orden paralela o secuencial, y entrega cada enlace según el estado del flujo.
• El documento final se sella con un certificado de auditoría y el historial queda disponible para el propietario en Contracts.
• La verificación puede usar correo y SMS con el canal Telnyx configurado por la organización.

Acceso

• Ruta principal: /contracts/sign/[token]
• Como se llega: enlace recibido por correo
• Permiso requerido: ninguno

Alcance tecnico

• Frontend: ContractSigningExperience, SignaturePad y captura de identidad.
• Backend: public-contract-signing.
• Superficies publicas: /contracts/sign/[token].
• Integraciones externas: SES, Telnyx, S3 y generación PDF.

Funcionalidades internas

Relaciones

• Depende de: Contratos, firmantes y documentos relacionados.
• Dispara / afecta: finalización del contrato y correos de estado.

Limitaciones y notas

• Un firmante secuencial puede abrir el enlace, pero debe esperar su turno.

id: templates app: contracts nombre: Plantillas de contratos estado: beta permiso: can_access_contracts

Plantillas de contratos

Define documentos reutilizables con variables para generar contratos de firma.

Para que sirve

• Una consultora estandariza acuerdos de servicios y genera un borrador específico para cada cliente.
• Una inmobiliaria reutiliza la base de contratos y completa datos del inmueble o negocio vinculado.
• Un despacho reduce la copia manual de datos al crear contratos desde oportunidades y contactos del CRM.

Que lo hace diferente

• Las variables se resuelven a partir de los registros vinculados al contrato de Apex, no de una base externa de destinatarios.
• La plantilla genera directamente la primera versión de un contrato que después se prepara y envía para firma pública.
• Las plantillas activas se administran dentro de la misma aplicación que conserva contratos, relaciones CRM e historial de firma.

Acceso

• Ruta principal: /[orgId]/contracts/templates
• Como se llega: Contracts > Templates
• Permiso requerido: can_access_contracts y permiso de edición de contratos

Alcance tecnico

• Frontend: ContractTemplatesView y ContractTemplateEditorView.
• Backend: contract-templates y contract-generate-document.

Funcionalidades internas

Relaciones

• Depende de: Contratos y registros CRM vinculados.
• Usado por: creación de contratos para firma.

Limitaciones y notas

• Solo las plantillas activas se ofrecen al crear un contrato.

APP: crm

CRM

Inbox, pipeline, registros y herramientas de marketing/IA.

• Etapa: Produccion
• Landing: /{orgId}/conversations

Modulos

Funcionalidades internas

301 funcionalidades documentadas en 19 modulos. Ver la tabla de cada modulo.

id: actividades app: crm nombre: Actividades estado: shipped permiso: permisos granulares de actividades

Actividades

Gestiona tareas, llamadas y reuniones relacionadas con registros CRM.

Para que sirve

• Una clínica coordina llamadas de confirmación y reuniones de seguimiento con el paciente correcto.
• Una inmobiliaria agenda visitas asociadas al comprador, la constructora y la oportunidad.
• Una agencia prepara reuniones con los interesados de un deal y comparte un enlace de Google Meet.
• Una consultora consulta sus pendientes por responsable y completa las tareas sin perder el historial CRM.
• Una academia sincroniza su calendario para planificar seguimientos sin duplicar eventos futuros.

Que lo hace diferente

• Una actividad puede vincular en el mismo registro contacto, compañía, deal y responsable, y aparece en sus perfiles CRM.
• Los contactos principales y watchers de un deal se sugieren como invitados cuando tienen correo.
• La sincronización nativa con Google y Outlook permite elegir dirección, visibilidad y tipos de actividad.
• Google puede crear un enlace de Meet desde la actividad sincronizable, sin una herramienta de videollamada separada.
• Al completar o eliminar una actividad sincronizada, Apex intenta actualizar el evento externo sin bloquear el cambio en CRM.

Funcionalidades internas

Acceso

• Ruta principal: /[orgId]/activities
• Como se llega: Sidebar > CRM > Activities
• Permiso requerido: permisos granulares de actividades

Alcance tecnico

• Frontend: ActivitiesView y ActivitiesCalendarView.
• Backend: activities, activity-types, activities-bulk-actions y process-activity-reminders.
• Superficies publicas: ninguna.
• Integraciones externas: calendar integrations.

Relaciones

• Depende de: Contactos, Compañías y Deals.
• Usado por: Timeline CRM y recordatorios.

Limitaciones y notas

• Por confirmar: comportamiento de sincronización exacto con calendar integrations.

id: ai-reports app: crm nombre: Reportes con IA estado: shipped permiso: can_access_analytics

Reportes con IA

Área de Analytics para construir páginas de reportes con Nova y ejecutar análisis IA por conversación. Está dirigida a equipos que necesitan consultar métricas del CRM y clasificar conversaciones sin preparar consultas manualmente.

Para que sirve

• Un equipo comercial crea un reporte de pipeline y ventas para identificar oportunidades estancadas por etapa o responsable.
• Una empresa de soporte analiza conversaciones por canal y clasifica motivos, sentimiento o resultados definidos por el equipo.
• Una cadena de servicios prepara una página de indicadores con filtros para comparar reservas, deals o actividad entre periodos.
• Un gerente de operaciones combina tablas y gráficos para revisar el rendimiento de miembros, asistentes o canales desde datos del CRM.
• Una agencia clona un análisis de conversaciones para evaluar campañas diferentes con los mismos criterios.

Que lo hace diferente

• Nova construye reportes sobre datos reales de la organización y prueba cada fuente de datos antes de guardar un widget; no entrega un gráfico basado solo en una descripción.
• Las páginas admiten widgets, filtros vinculados y distribución en lienzo, de modo que una misma vista puede separar métricas comerciales, operativas y de atención.
• Los filtros actualizan únicamente los widgets que declararon vínculo con ellos, evitando que una selección cambie resultados no relacionados.
• Además de gráficos, el análisis IA procesa conversaciones reales que cumplen filtros del CRM y extrae los campos que el equipo define.
• El procesamiento de conversaciones es asíncrono, muestra avance, resultados y errores, y su inicio se controla mediante Wallet.

Acceso

• Ruta principal: /[orgId]/analytics/ai-reports
• Como se llega: Analytics > AI Reports; los análisis de conversaciones están en Analytics > AI Insights
• Permiso requerido: can_access_analytics

Alcance tecnico

• Frontend: analytics/ai-reports/page.tsx, analytics/ai-insights/page.tsx, AnalyticsReportsCanvasView.tsx y AIAnalyticsView.tsx.
• Backend: report-pages, report-widgets, report-widget-data, ai-report-builder, analytics-ai-conversations-job y analytics-ai-conversations-job-result.
• Superficies publicas: no hay rutas públicas para estas pantallas.
• Integraciones externas: OpenRouter genera y prueba los widgets de Nova; SQS, OpenRouter (LLM) y Jev (clasificador Fast) procesan cada conversación de un trabajo.

Funcionalidades internas

Relaciones

• Depende de: datos de CRM, Conversaciones y Wallet.
• Usado por: equipos comerciales, de soporte y de operaciones.

Limitaciones y notas

Nova solo puede guardar widgets cuya consulta de lectura sea válida y se ejecute correctamente para la organización. Las páginas adicionales y la cantidad visible de widgets usan controles de plan. Cada trabajo de conversaciones cobra Wallet una vez al iniciarse y termina de forma asíncrona.

id: analytics app: crm nombre: Analytics CRM estado: shipped permiso: can_access_analytics

Analytics CRM

Reportes operativos y comerciales de conversaciones, deals, quotes, actividades y atribución.

Para que sirve

• Un contact center compara conversaciones por agente, etapa, país y tendencia para planear la operación de soporte.
• Una empresa B2B revisa el valor, progreso, productos y resultados de sus deals para detectar cuellos de botella del pipeline.
• Una agencia analiza qué anuncios y parámetros UTM aportan contactos y oportunidades para justificar inversión de adquisición.
• Un despacho comercial sigue el estado de quotes, sus aceptaciones, rechazos y vencimientos para recuperar propuestas.
• Un gerente mide creación y completitud de actividades para verificar que el equipo ejecute los seguimientos comprometidos.

Que lo hace diferente

• Reúne en un mismo módulo datos de conversaciones, deals, quotes, actividades, productos, pipelines, miembros y atribución.
• Permite pasar de la carga operativa de conversaciones al desempeño comercial de deals y propuestas con los mismos filtros de período.
• Muestra análisis específicos de deals ganados y perdidos, y de quotes aceptadas, rechazadas o vencidas.
• Incluye atribución por anuncios y UTM conectada con los contactos que ingresan al CRM.
• Ofrece comparación de períodos y exportación desde las vistas para análisis operativo y comercial.

Acceso

• Ruta principal: /[orgId]/analytics
• Como se llega: Sidebar > Tools > Analytics
• Permiso requerido: permiso de rol can_access_analytics; el backend autoriza analytics con capacidad read.

Alcance tecnico

• Frontend: rutas /[orgId]/analytics/{conversations,deals,quotes,activities,attribution}/**, excluidos AI Reports y AI Powered Analytics.
• Backend: analytics (find). reports no alimenta estas vistas.
• Integraciones externas: ninguna confirmada en estas vistas.

Funcionalidades internas

Relaciones

• Depende de: Conversaciones, Deals, Quotes, Actividades, Productos, Pipelines y miembros.
• Usado por: equipos que revisan operación y desempeño.

Limitaciones y notas

• Las rutas AI Reports y AI Powered Analytics se excluyen por pertenecer a otros módulos.
• La ruta /[orgId]/analytics/deals no muestra contenido en el código actual; ver deals-home.md.

id: asistentes-ia app: crm nombre: Asistentes IA estado: shipped permiso: can_access_ai_assistant

Asistentes IA

Configura asistentes para Inbox, tickets, Nova y llamadas de voz. Cada tipo expone pestañas y modelos compatibles distintos.

Para que sirve

• Una clínica configura un asistente para responder consultas iniciales, consultar disponibilidad y derivar casos sensibles a recepción.
• Una inmobiliaria atiende prospectos desde Inbox, consulta propiedades o contactos del CRM y asigna la oportunidad al asesor disponible.
• Un ecommerce permite al asistente buscar productos, enviar información y continuar seguimientos cuando el comprador deja de responder.
• Un equipo de soporte clasifica tickets, ejecuta automatizaciones permitidas y entrega conversaciones complejas al miembro correcto.
• Una empresa de servicios publica un agente de voz en su web para atender llamadas, agendar o transferir a una persona.

Que lo hace diferente

• No es solo un chatbot: puede habilitar herramientas internas para buscar y crear contactos, deals, actividades, reservas, estimates, invoices, productos, notas, tareas y conversaciones, según la configuración de cada asistente.
• Puede consultar disponibilidad, crear o actualizar reservas, cotizar con estimates, buscar productos y enviar mensajes en los canales disponibles del CRM.
• El handoff puede conservar la asignación actual, usar el propietario del contacto o distribuir entre miembros según disponibilidad, pesos y reglas de fallback.
• Integra herramientas HTTP propias, servidores MCP con OAuth o API keys, y automatizaciones publicadas que el asistente puede invocar.
• Sus skills añaden conocimiento y condiciones de uso por asistente; las instrucciones y la configuración conservan historial recuperable.
• Los asistentes de voz se sincronizan con Telnyx; los modelos de texto se configuran mediante conexiones permitidas y el uso de IA se controla con Wallet.

Acceso

• Ruta principal: /[orgId]/ai-assistant
• Como se llega: Sidebar > AI Assistant
• Permiso requerido: can_access_ai_assistant

Alcance tecnico

• Frontend: ai-assistant/page.tsx, ai-assistant/[assistantId]/page.tsx y components/aiassistant.
• Backend: ai-assistants, ai-assistant-response, ai-assistant-response-v2, ai-assistant-skills, api-tools, mcp-tool-connection-proxy y servicios de voz.
• Superficies publicas: el widget de voz generado se inserta en sitios externos después de sincronizar el asistente.
• Integraciones externas: OpenRouter, Telnyx, ElevenLabs, servidores MCP y S3 para logos del widget.

Funcionalidades internas

Relaciones

• Depende de: modelos de IA, miembros de la organización, Conversaciones, Customer Service y Calling & SMS.
• Usado por: Inbox, tickets, Nova, seguimientos y llamadas de voz.

Limitaciones y notas

• ai-chat y voice nacen en Blank Canvas; conversación y tickets pueden iniciar en Guided Mode.
• Nova oculta Handoff, Follow Up y Automations; voz no tiene Follow Up.
• La creación y cada actualización guardan una versión de historial cuando la petición contiene un usuario autenticado.

id: automatizaciones app: crm nombre: Automatizaciones estado: shipped permiso: can_access_automations

Automatizaciones

Constructor visual de flujos que responde a triggers, ejecuta acciones de CRM y conserva el detalle de cada ejecución.

Para que sirve

• Una clínica: cuando se crea una reserva, envía un WhatsApp de confirmación, crea una actividad de recordatorio y notifica al doctor.
• Una inmobiliaria: cuando entra un formulario de un inmueble, busca o crea el contacto, lo distribuye entre asesores y abre un deal.
• Un e-commerce: cuando un cliente comenta una palabra clave en un Reel, inicia una conversación, identifica su interés y continúa el seguimiento comercial.
• Un equipo SaaS de soporte: cuando un ticket incumple su SLA, lo reasigna, deja una nota interna y alerta al responsable.
• Una agencia B2B: cuando un deal pasa a propuesta, busca los productos solicitados, crea un estimate y agenda el seguimiento.
• Un centro de reservas: antes de una cita, envía un recordatorio; si la llamada llega al buzón de voz, envía un SMS y crea una tarea de reintento.
• Un organizador de eventos: cuando un asistente hace check-in, crea una oportunidad para ventas y envía un mensaje posterior.
• Una tienda conectada: cuando confirma un pago en su plataforma externa, llama un webhook de Apex para actualizar el contacto y disparar la comunicación correspondiente.

Que lo hace diferente

• Los triggers nacen de módulos propios: CRM, conversaciones, reservas, eventos, Helpdesk, formularios, llamadas de voz y cambios de miembros del equipo; no requieren replicar esos datos en una herramienta externa.
• Las acciones operan entidades y canales nativos: contactos, deals, estimates, reservas, tickets, actividades, WhatsApp, SMS, Gmail y Google Calendar.
• Puede controlar el comportamiento del asistente IA dentro de una conversación, incluyendo cortar su contexto o reanudarlo con una instrucción del flujo.
• Incluye acciones para obtener y establecer atribución de contactos y enviar conversiones a Meta CAPI desde hitos comerciales que ocurren en Apex.
• El nodo Chat With AI permite clasificar, resumir o redactar una salida que pasa directamente a las siguientes ramas y acciones.
• El editor permite probar, publicar y activar el flujo, y cada ejecución puede revisarse visualmente nodo por nodo con sus entradas y salidas.
• También admite un trigger webhook con URL propia, para conectar eventos externos al mismo proceso que usa los datos del CRM.
• El código revisado no establece una tarifa universal por tarea de automatización: Chat With AI cobra Wallet según modelo y tokens, y la búsqueda semántica de productos cobra por su consulta de embeddings.

Acceso

• Ruta principal: /[orgId]/automations
• Como se llega: Sidebar > Tools > Automations
• Permiso requerido: can_access_automations

Alcance tecnico

• Frontend: automations/page.tsx, automations/[automationId]/page.tsx, automations-executions y componentes de src/components/automations.
• Backend: automations, automations-categories, automations-webhooks, automations-executions, automation-run, process-automation-trigger y servicios automation-node-*.
• Superficies publicas: URLs de webhook de automatizaciones.
• Integraciones externas: Meta, WhatsApp, Telnyx, Gmail, Google Calendar, S3 y AWS SES según nodo.

Funcionalidades internas

| Trigger legado: mensaje de WhatsApp | trigger-legacy-whatsapp-message.md | Monitorea mensajes entrantes de WhatsApp en automatizaciones existentes. | | Trigger legado: URL de WhatsApp | trigger-legacy-whatsapp-url.md | Inicia una automatización existente al coincidir una URL de WhatsApp. | | Trigger legado: mensaje de Messenger | trigger-legacy-messenger-message.md | Monitorea mensajes de Messenger en automatizaciones existentes. | | Trigger legado: comentario de Facebook | trigger-legacy-facebook-comment.md | Inicia con comentarios en publicaciones de Facebook configuradas. | | Trigger legado: clic en anuncio de Facebook | trigger-legacy-facebook-ad-click.md | Inicia al detectar clics en el anuncio configurado. | | Trigger legado: URL ref de Messenger | trigger-legacy-messenger-ref-url.md | Responde a una URL de referencia de Messenger existente. | | Trigger legado: código QR | trigger-legacy-qr-code.md | Inicia al detectar la interacción configurada de código QR. | | Trigger legado: mensaje de Instagram | trigger-legacy-instagram-message.md | Monitorea mensajes directos de Instagram en automatizaciones existentes. | | Trigger legado: comentario en vivo de Instagram | trigger-legacy-instagram-live-comment.md | Inicia con comentarios de un Instagram Live configurado. | | Trigger legado: URL ref de Instagram | trigger-legacy-instagram-ref-url.md | Responde a una URL de referencia de Instagram existente. | | Trigger legado: suscripción a secuencia | trigger-legacy-sequence-subscription.md | Inicia al suscribir un contacto a una secuencia existente. | | Trigger legado: baja de secuencia | trigger-legacy-sequence-unsubscription.md | Inicia al retirar un contacto de una secuencia existente. | | Trigger legado: fecha y hora | trigger-legacy-date-time.md | Programa un trigger único o recurrente para automatizaciones existentes. | | Trigger legado: mensaje de Facebook Shop | trigger-legacy-facebook-shop-message.md | Monitorea mensajes de tienda con filtros de tipo, palabra y tiempo. | | Trigger legado: widget web | trigger-legacy-website-widget.md | Inicia por vista, interacción, envío o cierre de un widget web configurado. | | Trigger legado: modal de Messenger | trigger-legacy-messenger-modal.md | Inicia por eventos de un modal de Messenger en un sitio web. | | Trigger legado: landing page | trigger-legacy-landing-page.md | Inicia al visitar la URL de landing page configurada. |

Relaciones

• Depende de: CRM, Conversaciones, Tickets, Reservations, Events, Series y Calling & SMS.
• Usado por: Asistentes IA, canales y operaciones automatizadas.

Limitaciones y notas

Los cambios del lienzo requieren Publish; el interruptor Active controla si el flujo publicado responde a triggers. El nodo Delay está marcado como Coming Soon.

Inventario de archivos

id: campanas app: crm nombre: Campañas estado: shipped permiso: can_access_campaigns

Campañas

Permite crear, configurar, calendarizar y supervisar envíos masivos por WhatsApp, SMS, email, llamadas de IA y automatizaciones. Incluye audiencias reutilizables y la configuración de email broadcasting.

Para que sirve

• Una clínica usa campañas de WhatsApp para recordar citas a pacientes filtrados desde su CRM y registrar el resultado de cada entrega.
• Un e-commerce segmenta compradores y les envía promociones por email, SMS o WhatsApp desde una misma operación.
• Una inmobiliaria lanza llamadas de IA a leads que no respondieron para recuperar oportunidades de visita.
• Una franquicia inicia una automatización sobre una audiencia para asignar tareas y responsables de manera masiva.

Que lo hace diferente

• Combina segmentos construidos con datos del CRM con campañas por WhatsApp, SMS, email, llamadas de IA y automatizaciones.
• Las campañas de WhatsApp usan plantillas aprobadas por Meta y variables de cada contacto.
• Puede ejecutar llamadas salientes con asistentes IA, no solo mensajes de texto.
• Una campaña puede activar una automatización para cada contacto de la audiencia.
• El email usa dominios, remitentes y supresiones compartidos con Email Broadcasting.
• Los resultados distinguen entregas procesadas y fallos, incluidos contactos que no llegaron a enviarse.

Acceso

• Ruta principal: /[orgId]/campaigns
• Como se llega: Sidebar > Campaigns
• Permiso requerido: can_access_campaigns

Alcance tecnico

• Frontend: rutas bajo /[orgId]/campaigns, CampaignsView, CampaignForm, SegmentsView y formularios por canal.
• Backend: campaigns, campaign-segments, campaign-segments-split, servicios de envío por canal y servicios email-broadcast-*.
• Superficies publicas: /email-broadcast-unsubscribe?t=....
• Integraciones externas: Meta WhatsApp Cloud API, Telnyx, AWS SES, S3, DynamoDB, SQS y wallet de la organización.

Funcionalidades internas

Relaciones

• Depende de: Contactos, Automatizaciones, plantillas de WhatsApp, Email Builder, canales de email y Calling & SMS.
• Usado por: Analytics, conversaciones, wallet y automatizaciones.

Limitaciones y notas

• Las campañas de plan Free están limitadas a una; los planes pagados no aplican ese límite desde la interfaz.
• Solo los estados draft y scheduled permiten edición.
• Los resultados de WhatsApp consideran tanto mensajes aceptados como destinatarios que fallan antes del envío.

id: canales-mensajeria app: crm nombre: Canales de mensajería estado: shipped permiso: can_access_crm

Canales de mensajería

Conecta, supervisa y configura los canales que alimentan el inbox omnicanal.

Para que sirve

• Un restaurante conecta WhatsApp, Instagram y Messenger para atender reservas desde Conversations.
• Una tienda en línea instala Webchat en su sitio y convierte consultas web en conversaciones del CRM.
• Una agencia conecta Gmail u Outlook para que los correos de clientes queden junto con el resto de su atención.
• Un e-commerce verifica su dominio y configura AWS SES antes de enviar campañas por email.

Que lo hace diferente

• Los canales no quedan aislados: todos alimentan el inbox omnicanal y el contacto compartido con el CRM.
• WhatsApp incluye diagnóstico de permisos, plantillas para revisión de Meta y sincronización inicial de contactos e historial cuando el tipo de conexión lo permite.
• Webchat entrega conversaciones al mismo flujo que los canales Meta y puede permitir adjuntos bajo configuración de la organización.
• Email combina buzones operativos Gmail/Outlook con un canal de difusión AWS SES, dominios DKIM y reglas de filtrado.

Acceso

• Ruta principal: /[orgId]/settings/channel-whatsapp
• Como se llega: Avatar menu > Settings > Channels
• Permiso requerido: can_access_crm; algunos controles son de admin o superadmin.

Alcance tecnico

• Frontend: rutas de canales WhatsApp, Instagram, Messenger, TikTok, Webchat, inbox y email
• Backend: whatsapp-channels, instagram-channels, messenger-channels, webchat-widget-settings, inbox-channels, email-channels
• Superficies publicas: widget Webchat instalado en sitios externos
• Integraciones externas: Meta, Google, Microsoft y AWS SES

Funcionalidades internas

Relaciones

• Depende de: Organización, Contactos y proveedores externos.
• Usado por: Conversaciones, Campañas y Automatizaciones.

Limitaciones y notas

• TikTok tiene una ruta de demostración, pero no se confirmó flujo de conexión equivalente.

id: catalogos-publicos app: crm nombre: Catálogos públicos estado: shipped permiso: can_access_settings

Catálogos públicos

Páginas públicas de productos configurables y compartibles por cada organización. Con el checkout activo, el catálogo funciona como tienda online (ecommerce): carrito, Add to cart / Buy now, pago con las pasarelas de la organización (Stripe o Wompi) o pagar después, envío o recogida, multi-moneda y pedidos que llegan a Finance > Orders.

Para que sirve

• Una tienda vende online desde el catálogo: el cliente agrega productos al carrito, elige envío o recogida y paga con tarjeta (Stripe o Wompi) sin iniciar sesión.
• Una tienda comparte una página pública con sus productos para que clientes consulten referencias sin iniciar sesión.
• Un restaurante publica solo categorías seleccionadas y dirige a los visitantes hacia WhatsApp para hacer consultas.
• Una marca inserta un catálogo en una landing mediante iframe y conserva el inventario administrado en Apex.
• Un distribuidor prepara catálogos diferentes para líneas o audiencias específicas sin duplicar los productos.
• Un negocio controla qué productos, precios, medios y filtros ve el visitante desde un editor interno.

Que lo hace diferente

• Cada catálogo público se alimenta directamente de Productos, categorías y media de Apex, sin exportar ni sincronizar inventario a otra herramienta.
• Un enlace puede limitarse a todos los productos, categorías concretas o una selección específica, y ordenar las categorías visibles de forma independiente.
• El visitante puede abrir el detalle, explorar media, buscar y, si el catálogo lo habilita y existe canal configurado, iniciar contacto por WhatsApp.
• Los mismos enlaces de catálogo se pueden enviar desde el composer de Conversaciones usando los modos de envío de productos.
• El checkout cobra con las pasarelas propias de la organización (formulario embebido o redirección), en varias monedas con precios fijos o convertidos, con inventario opcional, pedido mínimo y recuperación de checkouts abandonados; cada compra crea un pedido, un contacto y puede generar la factura al pagarse.
• El editor configura contenido, layouts y tema, mientras embed=true permite integrar el catálogo sin encabezado ni pie de página.

Acceso

• Ruta principal: /[orgId]/settings/products/catalog-links
• Como se llega: Settings > Products > Catalog Links
• Permiso requerido: can_access_settings

Alcance tecnico

• Frontend: editor CatalogLinkEditorPage, listado CatalogLinksManagement y ruta pública /c/[orgId]/[slug].
• Backend: catalog-links, public-catalog, public-catalog-checkout y orders.
• Superficies publicas: catálogo, categoría y producto sin inicio de sesión; checkout /c/[orgId]/[slug]/checkout y página del pedido /o/[path].

Funcionalidades internas

Relaciones

• Depende de: Productos, categorías y canal de WhatsApp opcional; Payment Gateways para pago online.
• Usado por: clientes externos, enlaces compartidos y Pedidos (checkout).

Limitaciones y notas

• Un enlace inactivo no está disponible para visitantes.
• La búsqueda semántica puede configurarse, pero su disponibilidad efectiva depende de la configuración del catálogo.

id: companias app: crm nombre: Companias estado: shipped permiso: permisos granulares de compañías

Companias

Agrupa cuentas B2B y sus contactos, deals y actividad.

Para que sirve

• Una agencia administra cada empresa cliente junto con sus contactos, oportunidades y notas.
• Una consultora reúne el historial de una cuenta antes de preparar una renovación.
• Un proveedor B2B asigna cuentas corporativas a responsables y redistribuye carteras por lote.
• Un despacho legal registra empresas y consulta sus documentos, actividad y contactos relacionados.

Que lo hace diferente

• La compañía es una cuenta compartida por Contactos, Deals, Actividades, Estimates, Reservas y Proyectos.
• Su perfil reúne registros CRM y documentos comerciales en vez de separar la cuenta de las operaciones diarias.
• Los campos personalizados y etiquetas pueden mostrarse también como columnas de la lista de empresas.
• Las acciones masivas aplican a la selección o a todos los resultados de la búsqueda, con progreso y restricciones de plan.
• La reasignación conserva cambios de responsable para mantener trazabilidad de la cartera.

Funcionalidades internas

Acceso

• Ruta principal: /[orgId]/companies
• Como se llega: Sidebar > CRM > Companies
• Permiso requerido: permisos granulares de compañías

Alcance tecnico

• Frontend: lista y detalle; CompanyView, CompanyHeader, CompanySidebar y CRMMainContent
• Backend: companies, companies-bulk-actions, contacts, deals, notes, tags y custom-fields
• Superficies publicas: ninguna
• Integraciones externas: S3 y canales de comunicación vinculados a contactos

Relaciones

• Depende de: Contactos, Deals, Etiquetas y Campos personalizados.
• Usado por: Contactos, Deals, Estimates y Actividades.

Limitaciones y notas

• El diálogo de edición confirma como datos centrales únicamente el nombre; los demás vínculos se gestionan desde el perfil.

id: contactos app: crm nombre: Contactos estado: shipped permiso: permisos granulares de contactos

Contactos

Gestiona personas y leads del CRM, sus datos, relaciones, comunicaciones y actividad comercial.

Para que sirve

• Una clínica reúne los datos y el historial de cada paciente para dar seguimiento antes y después de una cita.
• Una inmobiliaria clasifica prospectos, los vincula a empresas y distribuye su atención entre asesores.
• Un e-commerce identifica el origen de cada comprador y conserva su consentimiento de mensajería.
• Una academia importa interesados de ferias o formularios y los segmenta para sus procesos de admisión.
• Un concesionario contacta a un prospecto por WhatsApp, SMS, Instagram o llamada desde la misma ficha.

Que lo hace diferente

• Un contacto único conecta datos CRM con conversaciones de WhatsApp, SMS e Instagram y llamadas de voz.
• Desde el perfil se puede iniciar una llamada con un asistente de voz y enviar variables dinámicas del contacto.
• Los segmentos de contactos alimentan el procesamiento de campañas; no quedan como filtros aislados.
• El historial reúne actividades, notas, fuentes y cambios de responsable en la misma ficha.
• La gestión de STOP/START de SMS se refleja en el contacto y limita los envíos desde los canales integrados.

Acceso

• Ruta principal: /[orgId]/contacts
• Como se llega: Sidebar > CRM > Contacts
• Permiso requerido: permisos granulares de contactos

Alcance tecnico

• Frontend: rutas de lista y perfil de contactos; ContactsView, ContactHeader, ContactSidebar y CRMMainContent
• Backend: contacts, contacts-bulk-actions, contacts-import-error-logs, contacts-segments-*, contacts-sources, notes, tags y custom-fields
• Superficies publicas: ninguna
• Integraciones externas: WhatsApp, Instagram, SMS, voz, Meta y S3

Funcionalidades internas

Relaciones

• Depende de: Compañías, Etiquetas y Campos personalizados.
• Usado por: Deals, Conversaciones, Tickets legacy, Automatizaciones y Formularios.

Limitaciones y notas

• Un contacto de WhatsApp puede tener @username sin teléfono; el nombre de usuario no se edita desde AchieveApex.
• Por confirmar: la superficie exacta desde la que se administra manualmente la blacklist SMS/email y si el detalle ofrece Smart Links.
• No se verificó un flujo de fusión de duplicados en las rutas, componentes y servicios indicados.

id: conversaciones app: crm nombre: Conversaciones estado: shipped permiso: can_access_crm

Conversaciones

Inbox omnicanal para atender, organizar y automatizar comunicaciones con contactos.

Para que sirve

• Una clínica centraliza consultas de WhatsApp, Instagram y email para que recepción responda sin perder el historial del paciente.
• Una inmobiliaria asigna prospectos entrantes a asesores y relaciona cada conversación con sus oportunidades de venta.
• Un e-commerce responde preguntas, comparte productos y usa plantillas cuando necesita contactar fuera de la ventana de WhatsApp.
• Una academia distribuye conversaciones entre su equipo y asistentes de IA para atender inscripciones y seguimientos.

Que lo hace diferente

• Reúne WhatsApp, Instagram, Messenger, SMS, webchat y email en el mismo hilo, asociado al contacto del CRM.
• El panel del hilo conecta directamente con Deals, Tickets, Reservations, Meetings y Series, sin trasladar manualmente al cliente entre herramientas.
• Permite asignar conversaciones a personas o asistentes de IA, reanudar la IA con instrucciones concretas y ejecutar automatizaciones desde el compositor.
• Comparte catálogo de Productos y enlaces públicos de catálogo al responder desde el inbox.

Acceso

• Ruta principal: /[orgId]/conversations
• Como se llega: Sidebar > Conversations
• Permiso requerido: can_access_crm; las acciones administrativas requieren admin u owner.

Alcance tecnico

• Frontend: rutas de conversations y ConversationsView, MessageInput, ChatHeader
• Backend: conversations, conversation-messages-*, conversations-bulk-actions, conversation-ai-resume, conversation-files
• Superficies publicas: ninguna confirmada
• Integraciones externas: Meta, Telnyx, S3 y asistentes de IA

Funcionalidades internas

Relaciones

• Depende de: Contactos, Canales de mensajería, Productos y Automatizaciones.
• Usado por: Deals, Tickets, Reservations, Meetings y asistentes de IA.

Limitaciones y notas

• Meta limita mensajes libres a una ventana de 24 horas.

id: deals app: crm nombre: Deals estado: shipped permiso: permisos granulares de deals

Deals

Organiza oportunidades comerciales por pipeline, etapa, responsable y valor.

Para que sirve

• Una inmobiliaria sigue cada negocio desde el primer interés hasta la compra o pérdida.
• Una agencia separa ventas nuevas y renovaciones en pipelines con acceso por equipo.
• Un concesionario calcula el valor de una oportunidad a partir de los vehículos o servicios negociados.
• Una consultora convierte propuestas aceptadas en oportunidades ganadas vinculadas a sus estimates.
• Una academia registra motivos de pérdida para corregir su proceso de admisiones.

Que lo hace diferente

• Cada deal relaciona el contacto, la compañía, los productos, la actividad y la conversación comercial en una sola ficha.
• Los pipelines pueden restringirse por miembro, además de aplicar los permisos granulares de deals.
• El sistema conserva automáticamente la duración y los cambios de cada etapa.
• Un deal ganado puede tratar los estimates vinculados y sincronizar su valor comercial.
• Los documentos comerciales abarcan estimates, invoices y Smart Links desde el contexto de la oportunidad.
• Los watchers del deal se convierten en sugerencias de invitados al crear actividades sincronizables.

Acceso

• Ruta principal: /[orgId]/deals
• Como se llega: Sidebar > CRM > Deals
• Permiso requerido: permisos granulares de deals; la configuración de acceso de pipelines requiere propietario o administrador

Alcance tecnico

• Frontend: lista, tablero y detalle; DealsView, PipelineView, DealSidebar y CRMMainContent
• Backend: deals, pipelines, pipeline-stages, pipeline-members, deal-products, deal-watchers, deal-stage-history, deal-duplicate, deals-bulk-actions, deals-lost-reasons y owner-changes
• Superficies publicas: ninguna
• Integraciones externas: SMS, WhatsApp, Instagram, voz y S3

Funcionalidades internas

Relaciones

• Depende de: Contactos, Compañías, Productos, Currencies y Estimates.
• Usado por: Automatizaciones, reportes comerciales y Actividades.

Limitaciones y notas

• Los pipelines restringidos se ocultan de selectores para miembros sin acceso, aunque un deal permitido puede seguir visible.
• El valor manual se bloquea cuando el deal tiene productos asociados.

id: email-builder app: crm nombre: Constructor de emails estado: shipped permiso: can_access_campaigns

Constructor de emails

Permite crear plantillas de email visuales, reutilizables y preparadas para campañas o envíos directos.

Para que sirve

• Un e-commerce crea emails de lanzamiento con productos, imágenes y llamados a la acción para sus campañas.
• Una clínica prepara recordatorios de cita con su identidad visual y datos personalizados del paciente.
• Una agencia guarda encabezados, pies legales y secciones de marca para reutilizarlos entre clientes o campañas.
• Una organización sin fines de lucro redacta un newsletter con IA y luego revisa los cambios antes de aplicarlos.

Que lo hace diferente

• Convierte un editor visual por bloques en email listo para entrega mediante compilación MJML, HTML y texto plano.
• Las plantillas se usan directamente en campañas de Apex y envíos individuales, con datos de Contactos, Deals, Productos y Compañías.
• La IA propone cambios acotados sobre el documento y el usuario puede aplicar o descartar la propuesta.
• Combina bloques de marketing para productos con recursos visuales de la organización y secciones reutilizables.
• Los envíos de prueba pasan por Email Broadcasting y sus remitentes configurados.

Acceso

• Ruta principal: /[orgId]/campaigns/email-templates
• Como se llega: Sidebar > Campaigns > Email Templates
• Permiso requerido: can_access_campaigns

Alcance tecnico

• Frontend: rutas de plantillas y assets, EmailBuilder y sus paneles.
• Backend: servicios email-builder-*.
• Integraciones externas: MJML, S3, OpenRouter y AWS SES.

Funcionalidades internas

Relaciones

• Depende de: Productos, Contactos, Deals, Compañías y Email Broadcasting.
• Usado por: campañas email y Automatizaciones.

Limitaciones y notas

• Las plantillas del sistema se copian al espacio de la organización antes de editarse.
• La previsualización y los envíos compilan el documento antes de entregar el email.

id: formularios app: crm nombre: Formularios estado: shipped permiso: permisos de formularios

Formularios

Permite crear formularios para compartirlos públicamente, recibir respuestas y analizarlas desde el CRM.

Para que sirve

• Una clínica publica un formulario de solicitud para captar datos previos de pacientes y revisar cada respuesta en el CRM.
• Una inmobiliaria crea un formulario de calificación de prospectos con preguntas que cambian según el tipo de propiedad buscada.
• Una agencia inserta un formulario en su sitio y recibe una notificación por cada nueva solicitud comercial.
• Un equipo comercial vincula un formulario a un contacto o conversación existente para incorporar información sin perder el contexto.
• Una empresa activa una automatización al llegar una respuesta para iniciar tareas o comunicaciones posteriores.
• Un negocio exporta las respuestas filtradas para analizarlas fuera de la plataforma.

Que lo hace diferente

• Los formularios públicos, embeds y widgets comparten el mismo constructor y configuración; no se mantiene una versión distinta para cada canal.
• Cada respuesta puede asociarse de forma segura a un contacto o conversación existente mediante el contexto compartido, sin crear contactos automáticamente.
• La creación de una respuesta puede ejecutar automatizaciones activas vinculadas a un formulario específico o a cualquier formulario.
• El constructor incluye IA que propone una estructura editable; el equipo revisa y guarda el resultado antes de publicarlo.
• Las notificaciones por respuesta se envían mediante el correo transaccional de Apex y no bloquean el registro si el correo falla.

Acceso

• Ruta principal: /[orgId]/forms
• Como se llega: Sidebar > Forms
• Permiso requerido: permisos de formularios

Alcance tecnico

• Frontend: rutas forms/page.tsx, forms/[id]/page.tsx, forms/[id]/responses/page.tsx y f/[formId]/page.tsx; componentes FormsView, FormDetail, FormBuilder y FormAnalytics
• Backend: forms y form-submissions
• Superficies publicas: /f/[formId]
• Integraciones externas: correo transaccional mediante SES para notificaciones de respuestas

Funcionalidades internas

Relaciones

• Depende de: Contactos y Conversaciones para asociaciones contextuales.
• Usado por: Automatizaciones, Nova y CRM.

Limitaciones y notas

• Solo los formularios publicados aceptan envíos públicos.
• Por confirmar: no se encontró una función que cree, actualice o mapee automáticamente contactos o campos personalizados al enviar una respuesta.
• Por confirmar: el formulario conserva contexto de URL y referencia de origen, pero no se encontró una configuración específica para capturar UTM.
• Por confirmar: existe un elemento visual de CAPTCHA, pero no se encontró validación de CAPTCHA en el flujo de envío público.

id: productos app: crm nombre: Productos estado: shipped permiso: permisos granulares de productos

Productos

Administra productos y servicios reutilizables en ventas y conversaciones. Permite preparar su información comercial, media, categorías e indexación para IA.

Para que sirve

• Una tienda de equipos comerciales centraliza productos, precios y material visual para que ventas comparta siempre la oferta vigente.
• Una empresa de servicios recurrentes registra planes y frecuencias de cobro para reutilizarlos en propuestas comerciales.
• Una distribuidora importa su catálogo y clasifica las referencias para reducir la carga manual de alta.
• Un negocio que vende por chat envía fichas y enlaces de productos desde una conversación, sin copiar datos entre herramientas.
• Un equipo de preventa hace que el asistente IA encuentre ofertas habilitadas al responder preguntas de clientes.

Que lo hace diferente

• El mismo catálogo alimenta Deals y estimates, de modo que una oferta comercial se reutiliza en ventas y documentos.
• Desde el composer del Inbox se pueden enviar productos, categorías o enlaces de catálogo con plantillas específicas por modo de envío.
• Los productos habilitados para IA y sus campos personalizados se indexan para que asistentes IA y automatizaciones localicen la oferta adecuada.
• La media se gestiona en la ficha y se aprovecha al compartir productos cuando el canal admite imágenes.
• Las categorías y los productos pueden alimentar Catálogos públicos sin duplicar el catálogo.

Acceso

• Ruta principal: /[orgId]/products
• Como se llega: Sidebar > CRM > Products
• Permiso requerido: permisos granulares de productos

Alcance tecnico

• Frontend: ProductsView, ProductDetailsView, ProductMediaUpload y categorías.
• Backend: products, products-categories, products-media, product-send-message-templates y product-embeddings.
• Superficies publicas: ninguna.
• Integraciones externas: S3 e IA.

Funcionalidades internas

Relaciones

• Depende de: Campos personalizados y categorías.
• Usado por: Deals, Estimates y asistentes IA.

Limitaciones y notas

• Catalog Links pertenece al módulo catalogos-publicos, no a este.
• No se confirmó una función separada para exportación o acciones masivas de productos.
• Por confirmar: impuestos, variantes/SKU avanzados y orden manual de categorías.

id: series app: crm nombre: Series estado: shipped permiso: can_access_campaigns

Series

Secuencias de automatizaciones que avanzan a cada contacto de forma independiente según sus propios tiempos y condiciones.

Para que sirve

• Una academia incorpora nuevos alumnos a una secuencia de bienvenida con mensajes y tareas separadas por días.
• Una inmobiliaria nutre prospectos que descargaron una guía y detiene la secuencia cuando agendan una visita.
• Un SaaS programa seguimientos comerciales que respetan la hora y los días permitidos para cada contacto.
• Una agencia revisa qué paso de una secuencia falló antes de volver a contactar a un lead.

Que lo hace diferente

• Cada contacto avanza en su propio calendario; no recibe todos los pasos al mismo tiempo que el resto de la audiencia.
• Cada paso ejecuta una automatización existente, conectando la secuencia con acciones del CRM y canales disponibles.
• Las automatizaciones pueden suscribir o retirar contactos de series según eventos del negocio.
• Pausar una serie congela los tiempos restantes y reanudarla los recupera, sin eliminar suscripciones.
• Incluye registros por paso para rastrear ejecuciones enviadas, fallidas u omitidas.

Acceso

• Ruta principal: /[orgId]/campaigns/series
• Como se llega: Sidebar > Campaigns > Series
• Permiso requerido: can_access_campaigns

Alcance tecnico

• Frontend: rutas /[orgId]/campaigns/series/** y componentes SeriesListView, SeriesStepEditor y SeriesSubscribersTable.
• Backend: series, series-steps, series-subscriptions, series-subscription-logs, series-stats y process-series-step.
• Integraciones externas: AWS EventBridge para las esperas programadas.

Funcionalidades internas

Relaciones

• Depende de: Automatizaciones y Contactos.
• Usado por: Automatizaciones, Contactos y Conversaciones.

Limitaciones y notas

• Una serie inactiva no admite suscripciones nuevas ni ejecuta pasos.
• Pausar no elimina contactos; eliminar la serie sí cancela suscripciones activas.

id: tickets-legacy app: crm nombre: Tickets legacy estado: shipped permiso: permisos granulares de tickets

Tickets legacy

Customer Service original basado en correo para atender solicitudes vinculadas con contactos. Convive con la app Helpdesk, que tiene su propio módulo y flujos.

Para que sirve

• Una empresa que recibe solicitudes por correo reúne los casos de clientes en una bandeja operativa vinculada a sus contactos.
• Un equipo de soporte clasifica prioridades, responsables y etapas para que las solicitudes no queden sin seguimiento.
• Una mesa de ayuda procesa lotes de casos para asignar, cerrar o marcar tickets sin repetir la acción uno por uno.
• Una organización migra un histórico de solicitudes desde una hoja para conservar la continuidad de atención.
• Un miembro del equipo abre un caso de soporte sobre AchieveApex desde Support, incluso sin acceso a CRM.

Que lo hace diferente

• Los tickets legacy se vinculan con Contactos, etiquetas, pipelines y campos personalizados del CRM en lugar de vivir como correos aislados.
• El hilo usa el Inbox Channel que originó el ticket y enruta las respuestas por Gmail u Outlook, manteniendo el proveedor del caso.
• Puede asignarse un asistente IA y una regla de seguimiento directamente en las propiedades del ticket.
• El módulo legacy y Helpdesk coexisten pero son productos distintos: Helpdesk tiene sus propios tickets, fuentes y flujos; no se confunden las rutas ni los datos.
• El portal Support se destina a casos sobre AchieveApex y permite creación manual o asistida por Nova, separado de la bandeja de correo legacy.

Acceso

• Ruta principal: /[orgId]/customer-service
• Como se llega: Sidebar > Tickets
• Permiso requerido: permisos granulares de tickets

Alcance tecnico

• Frontend: CustomerServiceView, detalle y componentes tickets.
• Backend: support-tickets, support-tickets-batch-actions, support-ticket-email-templates, ticket-messages-* e import-support-tickets.
• Superficies publicas: ninguna.
• Integraciones externas: Gmail y Outlook.

Funcionalidades internas

Relaciones

• Depende de: Contactos, Inbox Channels, Tags y asistentes IA.
• Usado por: Contactos y Automatizaciones.

Limitaciones y notas

• Es el sistema legacy y no reemplaza el módulo Helpdesk.
• Convive con la app Helpdesk; sus tickets, rutas y flujos no deben asumirse equivalentes.
• No se identificó una interfaz independiente para administrar plantillas de email; estas se utilizan en seguimientos de asistentes de tickets.
• Los tickets creados manualmente no permiten seleccionar un proveedor de correo en el formulario.

id: vector-storage app: crm nombre: Almacenamiento vectorial estado: shipped permiso: can_access_ai_assistant

Almacenamiento vectorial

Pantalla para crear y revisar contenedores vectoriales de la organización. Muestra documentos y el avance de embedding que devuelve el servicio.

Para que sirve

• Una empresa con documentación propia crea contenedores separados para controlar el material vectorizado de cada área.
• Un equipo de operaciones revisa cuántos documentos de un contenedor ya están listos para usarse en búsquedas semánticas.
• Una empresa de servicios crea un contenedor inicial para preparar una base de conocimiento vectorial de la organización.

Que lo hace diferente

• El almacenamiento se administra dentro de la organización de AchieveApex y muestra por contenedor los documentos detectados y el avance de embedding.
• El estado visible distingue entre material pendiente y material completamente vectorizado, en vez de ocultar el procesamiento tras una carga de archivos.
• La pantalla actual es una superficie de administración: el código revisado no confirma todavía qué módulos consumen esos contenedores, cómo ingresan los documentos ni el proveedor de embeddings.

Acceso

• Ruta principal: /[orgId]/ai-vector-storage
• Como se llega: URL directa /[orgId]/ai-vector-storage
• Permiso requerido: can_access_ai_assistant

Alcance tecnico

• Frontend: ai-vector-storage/page.tsx y VectorStorageView.tsx.
• Backend: vector-storages se invoca desde frontend, pero no hay implementación de ese servicio en este repositorio; product-embeddings y products-embeddings-admin son servicios internos.
• Superficies publicas: ninguna.
• Integraciones externas: ninguna identificada en esta pantalla.

Funcionalidades internas

Relaciones

• Depende de: el servicio vector-storages.
• Usado por: la propia pantalla de almacenamiento vectorial.

Limitaciones y notas

Por confirmar: la fuente de documentos, el proveedor de embeddings y los permisos reales de vector-storages; no están implementados en el backend revisado.

id: voice-sms app: crm nombre: Calling y SMS estado: shipped permiso: can_access_crm

Calling y SMS

Administra telefonía Telnyx, SMS, números, agentes, llamadas y cumplimiento A2P por organización.

Para que sirve

• Un concesionario compra un número local y distribuye las llamadas de ventas entre sus asesores disponibles.
• Una clínica define saludo, cola y grabación para que pacientes esperen una respuesta o dejen información útil al equipo.
• Una inmobiliaria enruta llamadas a un asistente de voz y usa agentes humanos como respaldo.
• Un negocio estadounidense registra su campaña 10DLC para enviar SMS A2P desde sus números locales.
• Un despacho legal consulta grabaciones y transcripciones para revisar la atención telefónica y los cargos asociados.

Que lo hace diferente

• Configura llamadas, SMS, números, agentes, cumplimiento y costos en la misma organización que usa el CRM y el inbox.
• Puede enrutar llamadas hacia agentes humanos, asistentes de voz o un esquema humano con respaldo de IA.
• El historial de llamadas incorpora grabaciones, transcripciones y diagnóstico, y se relaciona con Conversaciones para conservar contexto.
• Gestiona el ciclo 10DLC, incluida una página pública de consentimiento, junto con el bloqueo de envíos SMS del contacto.
• Une la compra de números y los servicios recurrentes con Stripe, mientras el uso y algunas tarifas se muestran dentro de Apex.

Acceso

• Ruta principal: /[orgId]/settings/voice-channel
• Como se llega: Avatar menu > Settings > Calling & SMS
• Permiso requerido: can_access_crm; los enlaces Telnyx y costos son de superadmin.

Alcance tecnico

• Frontend: rutas settings/voice-channel y componentes de configuración de voz
• Backend: voice-channels, voice-agents, voice-phone-numbers, voice-calls, telnyx-webhooks
• Superficies publicas: página de consentimiento SMS por organización
• Integraciones externas: Telnyx y Stripe

Funcionalidades internas

Relaciones

• Depende de: Stripe, Telnyx, Organización y asistentes de IA.
• Usado por: Conversaciones, Automatizaciones y Plataforma/Softphone.

Limitaciones y notas

• Plataforma/Softphone es la superficie de llamadas dentro de la app; aquí se configura la infraestructura y agentes.

APP: events

Events

Eventos, invitados, check-in e insights.

• Etapa: Produccion
• Landing: /{orgId}/events

Modulos

Funcionalidades internas

40 funcionalidades documentadas en 6 modulos. Ver la tabla de cada modulo.

id: check-in app: events nombre: Check-in estado: shipped permiso: can_access_events

Check-in

Convierte el ticket del asistente en una asistencia registrada durante el evento.

Para que sirve

• Un organizador de conferencias valida entradas QR y conoce la asistencia real mientras se realiza el evento.
• Una universidad registra la llegada de participantes a una feria o seminario sin listas en papel.
• Un gimnasio controla la entrada a una clase especial con una lista de asistentes aprobados.

Que lo hace diferente

• El check-in actualiza el mismo registro ligado al contacto del CRM.
• La entrada confirmada puede disparar automatizaciones para seguimiento o entrega de materiales.
• Los conteos se reflejan en la analítica del evento sin exportar ni reconciliar listas.

Acceso

• Ruta principal: /[orgId]/events/check-in
• Como se llega: Events > Check-in
• Permiso requerido: can_access_events.

Alcance tecnico

• Frontend: EventCheckInView.tsx.
• Backend: event-registrations y la automatización de check-in.
• Integraciones externas: cámara del navegador mediante BarcodeDetector.

Funcionalidades internas

Relaciones

• Depende de: Guests y Tickets.
• Dispara / afecta: Insights y automatizaciones de asistencia.

Limitaciones y notas

• Solo los invitados approved pueden hacer check-in; un ticket ya registrado se informa sin duplicarlo.

id: eventos-publicos app: events nombre: Eventos públicos estado: public permiso: ninguno

Eventos públicos

Expone la agenda y el registro de eventos sin iniciar sesión, incluida la gestión del ticket del asistente.

Para que sirve

• Un organizador de conferencias publica una agenda y permite registro con ticket desde su enlace.
• Una iglesia comparte actividades abiertas, recibe inscripciones y entrega un ticket QR por email.
• Una universidad publica jornadas y eventos de admisión con información, ubicación y cupos.

Que lo hace diferente

• Un registro público crea o relaciona un contacto dentro del CRM de Apex.
• La página usa los tickets, cupones, pagos y reglas de capacidad definidos por la organización.
• Las visitas y registros alimentan Insights; el asistente recibe comunicaciones y ticket desde el mismo producto.
• Los registros públicos pueden disparar automatizaciones de Apex.

Acceso

• Ruta principal: /events/[orgId]
• Como se llega: enlace público de la organización o del evento.
• Permiso requerido: ninguno.

Alcance tecnico

• Frontend: rutas /events/[orgId], /events/[orgId]/[slug], ticket y feedback; componentes public/PublicOrganizationEventsView.tsx.
• Backend: public-event-registration, public-event-ticket, event-page-views.
• Integraciones externas: gateways de pago, email con ticket/ICS y Google Maps embebido.

Funcionalidades internas

Relaciones

• Depende de: Gestión de eventos, Tickets, Coupons, Guests y Payment gateways.
• Dispara / afecta: emails, métricas de Insights y automatizaciones de registros.

Limitaciones y notas

• El enlace de ticket se basa en un código de check-in; debe tratarse como un enlace privado.

id: gestion app: events nombre: Gestión de eventos estado: shipped permiso: can_access_events

Gestión de eventos

Permite crear, configurar y operar eventos de una organización, desde el borrador hasta su publicación y comunicaciones.

Para que sirve

• Un organizador de conferencias crea, publica y comunica eventos con entradas, anfitriones y página propia.
• Una universidad habilita registros con aprobación y capacidad para charlas, ferias y actividades de admisión.
• Una iglesia coordina encuentros presenciales o virtuales, envía invitaciones y mantiene informados a sus asistentes.
• Un equipo de formación vende cupos, aplica cupones y centraliza la operación del evento.

Que lo hace diferente

• Los asistentes se vinculan con contactos del CRM en vez de quedar aislados en una lista de tickets.
• El registro, sus cambios de estado y el check-in pueden disparar automatizaciones de Apex.
• Puede cobrar tickets mediante los gateways de pago configurados por la organización.
• Las comunicaciones del evento se envían por email o WhatsApp desde la misma organización.
• Puede sincronizarse con Google Calendar y generar enlaces de Google Meet cuando existe una integración activa.

Acceso

• Ruta principal: /[orgId]/events
• Como se llega: Header app switcher > Events
• Permiso requerido: can_access_events; las acciones quedan sujetas a permisos granulares de Events.

Alcance tecnico

• Frontend: rutas de lista, creación y /[orgId]/events/[eventId]; EventManageView.tsx, EventCoreFields.tsx, EventTicketTypesSection.tsx, EventCouponsSection.tsx, EventHostsCard.tsx, EventBlastsSection.tsx y EventDetailView.tsx.
• Backend: events, event-ticket-types, event-coupons, event-hosts, event-blasts y organization-events-settings.
• Superficies publicas: el evento publicado se expone bajo /events/[orgId]/[slug].
• Integraciones externas: Google Calendar/Meet, S3, gateways de pago, email y WhatsApp.

Funcionalidades internas

Relaciones

• Depende de: Currencies, Payment gateways, Document settings, Contacts y Calendar sync.
• Usado por: Guests, Check-in, People, Insights, Automatizaciones y Eventos públicos.

Limitaciones y notas

• La capacidad efectiva considera el límite del evento y el de cada ticket.
• Un anfitrión creador no se puede eliminar.
• La sincronización con Google Calendar puede informar un error sin impedir que se guarde el evento.

id: guests app: events nombre: Invitados estado: shipped permiso: can_access_events

Invitados

Gestiona el roster de asistentes de toda la organización o de un evento concreto.

Para que sirve

• Un organizador de conferencias controla invitaciones, aprobaciones y asistencia de cientos de ponentes y participantes.
• Una universidad registra asistentes de jornadas académicas y los relaciona con prospectos del CRM.
• Una iglesia invita miembros a retiros y conserva una lista operativa para el día del evento.

Que lo hace diferente

• Cada asistente se asocia o crea como contacto CRM, por lo que el historial no queda separado del resto de la relación.
• Los cambios de registro y el check-in pueden activar automatizaciones.
• Las invitaciones y notificaciones pueden salir por email o WhatsApp desde Apex.
• El estado de pago, ticket y feedback se consulta junto con el registro.

Acceso

• Ruta principal: /[orgId]/events/guests
• Como se llega: Events > Guests o Manage event > Guests
• Permiso requerido: can_access_events.

Alcance tecnico

• Frontend: EventGuestsTable.tsx y EventInviteGuestsDialog.tsx.
• Backend: event-registrations, event-feedback.
• Integraciones externas: email y WhatsApp para invitaciones y notificaciones.

Funcionalidades internas

Relaciones

• Depende de: Gestión de eventos, Contacts y Tickets.
• Usado por: Check-in, People, Insights y Eventos públicos.

Limitaciones y notas

• La exportación contiene únicamente los resultados de la página y filtro actuales.

id: insights app: events nombre: Analítica de eventos estado: shipped permiso: can_access_events

Analítica de eventos

Resume la conversión, asistencia, ingresos y feedback de la organización o de un evento.

Para que sirve

• Un organizador de conferencias mide cuántas visitas terminan en registros y asistencia real.
• Un equipo de formación compara ingresos y desempeño de sus sesiones pagas.
• Una universidad identifica qué fuentes llevan más participantes a actividades institucionales.

Que lo hace diferente

• Une vistas de páginas, registros, pagos, asistencia y feedback del mismo flujo de eventos.
• Usa el check-in y los estados operativos de Apex para medir asistencia real.
• Las fuentes, tickets y valoraciones se analizan sin mover datos a otra herramienta.

Acceso

• Ruta principal: /[orgId]/events/insights
• Como se llega: Events > Insights o Manage event > Insights
• Permiso requerido: can_access_events.

Alcance tecnico

• Frontend: EventsInsightsView.tsx y EventInsightsPanel.
• Backend: event-insights y event-page-views.

Funcionalidades internas

Relaciones

• Depende de: Eventos públicos, Guests, Check-in, Tickets y Feedback.
• Usado por: equipos de operación y marketing.

Limitaciones y notas

• Los periodos predefinidos disponibles son últimos 7, 30 y 90 días.

id: people app: events nombre: Personas estado: shipped permiso: can_access_events

Personas

Ofrece un directorio consolidado de asistentes entre eventos y su relación con el CRM.

Para que sirve

• Un organizador identifica asistentes recurrentes entre conferencias y los abre como contactos del CRM.
• Una universidad segmenta personas que han asistido a distintos eventos para seguimiento académico.
• Una comunidad profesional reconoce quién participa con mayor frecuencia en sus encuentros.

Que lo hace diferente

• Consolida la participación entre eventos sobre contactos CRM, no sobre listas independientes.
• Permite pasar de la actividad de eventos al perfil comercial o relacional de la persona.
• Conserva métricas de asistencia y gasto por persona dentro del contexto de la organización.

Acceso

• Ruta principal: /[orgId]/events/people
• Como se llega: Events > People
• Permiso requerido: can_access_events.

Alcance tecnico

• Frontend: EventsPeopleView.tsx.
• Backend: event-people y events.
• Integraciones externas: Contacts del CRM.

Funcionalidades internas

Relaciones

• Depende de: Guests, Events y Contacts.
• Usado por: gestión comercial y seguimiento de asistentes.

Limitaciones y notas

• Los importes mostrados se agrupan por moneda disponible; no se convierten entre monedas.

APP: finance

Finance

Cuentas por cobrar (AR) y cuentas por pagar (AP).

• Etapa: Beta
• Landing: /{orgId}/finance/estimates

Modulos

Funcionalidades internas

117 funcionalidades documentadas en 15 modulos. Ver la tabla de cada modulo.

id: bills app: finance nombre: Bills estado: beta permiso: can_access_bills

Bills

Registra facturas de proveedores que crean una cuenta por pagar y se cancelan mediante Payments Made.

Para que sirve

• Una distribuidora registra facturas de inventario para conocer lo que debe pagar a cada proveedor.
• Una clínica prioriza facturas vencidas y próximas a vencer desde el resumen de cuentas por pagar.
• Una agencia aplica pagos parciales a una factura de producción y sigue el saldo que queda pendiente.
• Un coworking convierte la factura mensual de internet en una recurrencia para crear los próximos bills.

Que lo hace diferente

• Conecta proveedores, cuentas por pagar y Payments Made dentro de la misma plataforma donde viven el CRM y las operaciones.
• Los pagos asignados actualizan automáticamente saldo y estado de cada bill, incluidos pagos parciales y completos.
• Comparte monedas, impuestos, partidas, reglas de numeración y plantillas documentales con los documentos de venta de Finance.
• El resumen operativo identifica total pendiente, vencimientos del día, próximos 30 días y documentos atrasados.
• No es contabilidad de partida doble; tampoco incluye órdenes de compra, créditos de proveedor ni adjuntos de facturas.

Acceso

• Ruta principal: /[orgId]/finance/bills
• Como se llega: Header app switcher > Alpha & Beta > Finance > Purchases > Bills
• Permiso requerido: can_access_bills y permisos del módulo para ver, crear, editar o eliminar.

Alcance tecnico

• Frontend: rutas de lista, creación, detalle y edición; BillsView, BillEditForm, BillDetail y BillItemsTable.
• Backend: bills, bill-items y las asignaciones bill-payments.
• Superficies publicas: ninguna.
• Integraciones externas: ninguna.

Funcionalidades internas

Relaciones

• Depende de: Vendors, Currencies, Payments Made y Document Templates.
• Usado por: Recurring Bills genera bills y Payments Made actualiza su saldo.
• La configuración de numeración AP vive en settings/document-settings; no se documenta aquí.

Limitaciones y notas

• Un bill requiere proveedor, fecha de documento y fecha de vencimiento.
• Solo puede anularse si no tiene monto pagado.

id: document-templates app: finance nombre: Plantillas de documentos estado: shipped permiso: can_manage_document_templates

Plantillas de documentos

Configura el diseño que usan estimates, invoices, expenses, bills y recibos al previsualizar o exportar PDF.

Para que sirve

• Una consultora estandariza cotizaciones, facturas y recibos con su identidad visual y condiciones comerciales.
• Una inmobiliaria agrega una página de términos en Markdown a sus propuestas sin editar cada documento desde cero.
• Una empresa de obra entrega un calendario de pagos calculado en una tabla inteligente dentro de una cotización o factura.
• Un negocio multi-moneda presenta importes y variables documentales con el formato de la moneda elegida.

Que lo hace diferente

• Una misma plantilla se usa para previsualización, PDF y documentos públicos, reduciendo diferencias entre canales de entrega.
• El constructor ofrece diseño visual y un flujo asistido por IA/HTML, además de plantillas por tipo documental.
• Las páginas adicionales son una biblioteca reutilizable de Markdown y tablas inteligentes con fórmulas, no simples adjuntos.
• Las cotizaciones y facturas incorporan campos personalizados del CRM en el diseño y en el PDF.
• La numeración, mensajes predefinidos, condiciones y datos bancarios se conectan con el mismo flujo de documentos financieros.

Acceso

• Ruta principal: /[orgId]/settings/document-templates
• Como se llega: Avatar menu > Settings > Billing & Finance > Document Templates
• Permiso requerido: can_manage_document_templates

Alcance tecnico

• Frontend: rutas de Settings; bibliotecas y document-template-builder
• Backend: document-templates, document-setting, document-predefined-messages, document-page-templates, document-template-preview, pdf-generator
• Superficies publicas: ninguna

Funcionalidades internas

Relaciones

• Depende de: Estimates, Invoices, Payments received y Currencies.
• Usado por: módulos y documentos del flujo financiero.

Limitaciones y notas

• Los permisos granulares pueden restringir acciones según el rol de la organización.

id: estimates app: finance nombre: Cotizaciones estado: shipped permiso: can_access_estimates

Cotizaciones

Las cotizaciones reúnen el cliente, artículos, condiciones y una posible solicitud de cobro antes de emitir una factura. El mismo flujo se abre desde CRM y desde Finance.

Para que sirve

• Una agencia de marketing prepara una propuesta con servicios, impuestos y condiciones para convertir una oportunidad del CRM en un documento comercial compartible.
• Una clínica envía una cotización con un anticipo para que el paciente pueda pagar antes de confirmar el tratamiento.
• Una inmobiliaria registra la aceptación o rechazo de una propuesta y conserva el contexto del contacto, empresa y deal.
• Un negocio de servicios convierte una cotización aceptada en una factura sin reconstruir artículos ni datos comerciales.

Que lo hace diferente

• La cotización nace conectada al contacto, compañía y deal del CRM, en lugar de quedar como un documento aislado.
• Se puede compartir por correo y desde el contexto de la conversación, con una vista pública donde el cliente decide.
• El asistente IA dispone de una herramienta interna para crear cotizaciones cuando tiene los datos comerciales necesarios.
• Registra aperturas, tiempo visible y descargas de la vista pública, excluyendo las consultas internas del equipo.
• Puede incluir páginas Markdown o tablas inteligentes y usar plantillas que también determinan la previsualización y el PDF.
• El importe a cobrar puede sincronizar un Payment Link de Stripe o Wompi sin convertir la cotización en una factura.

Acceso

• Ruta principal: /[orgId]/estimates y /[orgId]/finance/estimates
• Como se llega: sidebar CRM > Estimates o selector de aplicación > Finance > Sales > Estimates
• Permiso requerido: can_access_estimates

Alcance tecnico

• Frontend: rutas CRM/Finance de listado, creación, detalle y edición; EstimatesView, EstimateDetail, EstimateEditForm y DocumentPreview
• Backend: estimates, estimate-items, estimate-duplicate, estimate-convert-to-invoice, estimates-change-history y sales-document-engagement-events
• Superficies publicas: /e/[path]
• Integraciones externas: PDF, correo, S3, Stripe y Wompi mediante Payment Links

Funcionalidades internas

Relaciones

• Depende de: Contactos, Compañías, Deals, Productos, Currencies y Document Templates.
• Usado por: Invoices, Payment Links, Payments received y Automatizaciones.

Limitaciones y notas

• Una cotización convertida se bloquea en Invoiced; no se puede cambiar nuevamente su estado.
• Amount to collect crea o actualiza un Payment Link abierto; no registra por sí solo un pago.

id: expenses app: finance nombre: Expenses estado: beta permiso: can_access_expenses

Expenses

Registra gastos directos ya pagados, sin crear saldo pendiente ni un pago separado.

Para que sirve

• Un restaurante registra compras ya pagadas de suministros sin crear una deuda pendiente.
• Una agencia documenta el alquiler ya abonado de un equipo, con sus conceptos, descuentos e impuestos.
• Una clínica deja un gasto en Draft para revisión y lo activa cuando su equipo confirma el importe.
• Un negocio con suscripciones convierte un gasto frecuente en un perfil para generarlo periódicamente.

Que lo hace diferente

• Distingue expresamente gasto directo de cuenta por pagar: Expenses no crea saldo ni exige el flujo de Payments Made.
• Comparte monedas, impuestos, partidas, reglas de numeración y plantillas documentales con los documentos de venta de Finance.
• Puede partir de un proveedor de Purchases sin obligarlo, útil para desembolsos que no corresponden a un suplidor registrado.
• Un gasto puede convertirse en Recurring Expenses reutilizando su información y partidas.
• No incluye adjuntos de recibos ni es un sistema de contabilidad de partida doble.

Acceso

• Ruta principal: /[orgId]/finance/expenses
• Como se llega: Header app switcher > Alpha & Beta > Finance > Purchases > Expenses
• Permiso requerido: can_access_expenses y permisos de ver, crear, editar o eliminar gastos.

Alcance tecnico

• Frontend: rutas de lista, creación, detalle y edición; ExpensesView, ExpenseEditForm, ExpenseDetail y ExpenseItemsTable.
• Backend: servicios Feathers expenses y expense-items.
• Superficies publicas: ninguna.
• Integraciones externas: ninguna.

Funcionalidades internas

Relaciones

• Depende de: Vendors (opcional), Currencies y plantillas de documento.
• Usado por: Recurring Expenses puede originarse desde un gasto.
• La configuración de numeración AP vive en settings/document-settings; no se documenta en este módulo.

Limitaciones y notas

• Un expense no se paga desde Payments Made; ese flujo corresponde exclusivamente a bills.
• No hay adjuntos de recibos implementados.

id: invoices app: finance nombre: Facturas estado: shipped permiso: can_access_invoices

Facturas

Las facturas documentan un cobro a un cliente, conservan el saldo pendiente y reciben asignaciones de pagos. El listado y el detalle son los mismos desde CRM y Finance.

Para que sirve

• Una consultora emite una factura desde el cliente o deal que ya gestionó en el CRM y controla qué importe queda por cobrar.
• Una empresa de mantenimiento convierte una propuesta aceptada en factura conservando sus artículos y condiciones.
• Una academia registra pagos parciales de una matrícula y deja el saldo pendiente visible para el equipo de cobros.
• Un proveedor B2B comparte una factura pública por correo y verifica si el cliente la abrió o descargó.
• Un negocio por suscripción crea un perfil recurrente para generar sus cobros periódicos como facturas normales.

Que lo hace diferente

• Reutiliza el mismo contacto, compañía, deal y productos del CRM, y puede originarse directamente desde una cotización.
• Las asignaciones de pagos mantienen sincronizados el importe pagado, saldo y estado de cada factura.
• La vista pública registra actividad real del cliente —aperturas, tiempo visible y descargas— sin contar las revisiones internas.
• El documento se puede entregar por correo, PDF o enlace público y combinar con Payment Links para cobrar con Stripe o Wompi.
• Las páginas adicionales, los campos personalizados y el diseño de plantilla se usan tanto en la vista como en el PDF.
• Puede convertirse en una fuente de facturación recurrente desde Make recurring en Finance.

Acceso

• Ruta principal: /[orgId]/invoices y /[orgId]/finance/invoices
• Como se llega: sidebar CRM > Invoices o selector de aplicación > Finance > Sales > Invoices
• Permiso requerido: can_access_invoices

Alcance tecnico

• Frontend: rutas CRM y Finance; InvoicesView, InvoiceDetail, InvoiceEditForm, DocumentPreview
• Backend: invoices, invoice-items, invoice-payments, invoices-change-history, public-quote-*
• Superficies publicas: /i/[path]

Funcionalidades internas

Relaciones

• Depende de: Contacts, Companies, Deals, Products, Currencies, Payments received, Recurring Invoices y Document Templates.
• Usado por: Payments received, Payment Links, Recurring Invoices y Automatizaciones.

Limitaciones y notas

• Las facturas en draft conservan saldo cero hasta pasar a scheduled o sent.
• Solo Finance muestra Make recurring; CRM conserva la factura normal.

id: orders app: finance nombre: Pedidos estado: beta permiso: can_access_orders

Pedidos

Registro de ventas con artículos, pago y entrega en un mismo lugar, inspirado en Shopify. Un pedido puede nacer del checkout del catálogo público, del asistente de IA, de una creación manual, de la conversión de una cotización o factura, o de la API.

Para que sirve

• Una tienda de ropa recibe pedidos pagados desde su catálogo público y los prepara por envío o recogida en tienda.
• Un distribuidor convierte una cotización aceptada en pedido y luego factura cuando despacha.
• Un restaurante con WhatsApp deja que el asistente de IA tome el pedido, envíe el link de pago y marque la entrega.
• Un negocio B2B registra pedidos manuales con referencia de orden de compra y cobra el saldo con un enlace de pago.
• Un ecommerce recupera carritos abandonados con un mensaje automático que lleva el link de recuperación.

Que lo hace diferente

• Tres estados independientes por pedido: estado del pedido (Draft, Open, Completed, Cancelled), estado de pago y estado de entrega, como en Shopify.
• Cobra con las pasarelas propias de la organización (Stripe o Wompi) mediante enlaces de pago; el pago confirmado actualiza el pedido sin intervención.
• Entregas parciales con transportista, número y URL de seguimiento que el comprador ve en su página pública /o/{path}.
• Conversión en ambos sentidos con cotizaciones y facturas, conservando cliente, moneda y artículos.
• Inventario opcional por producto: el pedido reserva stock al colocarse y lo libera al cancelarse.
• 13 tools de IA en la categoría Orders para que el asistente cree, consulte, cobre y entregue pedidos desde una conversación.

Acceso

• Ruta principal: /[orgId]/finance/orders
• Como se llega: Finance > Sales > Orders
• Permiso requerido: can_access_orders (más permisos granulares can_view_own_orders, can_view_all_orders, can_create_orders, can_edit_own_orders, can_edit_all_orders, can_delete_own_orders, can_delete_all_orders)

Alcance tecnico

• Frontend: OrdersView, OrderEditForm, OrderDetail, CreateFulfillmentDialog, AbandonedCheckoutsView, AbandonedCheckoutDetail, PublicOrderPage.
• Backend: orders, order-items, order-fulfillments, orders-change-history, checkouts, public-order-preview, public-catalog-checkout, payment-links.
• Superficies publicas: /o/[path] (página del pedido) y /c/[orgId]/[slug]/checkout (checkout del catálogo).

Funcionalidades internas

Relaciones

• Depende de: Productos, Payment Gateways, Payment Links, Document templates (numeración order) y Contactos.
• Usado por: Catálogos públicos (checkout), asistente de IA, Automatizaciones (5 triggers de pedidos), Cotizaciones y Facturas.

Limitaciones y notas

• No calcula impuestos ni admite productos de suscripción.
• Solo se pueden eliminar pedidos en borrador o cancelados sin pagos.
• Cancelar no reembolsa automáticamente los pagos recibidos.
• El comprador recibe correos al colocar el pedido, al pagarlo y cuando un envío queda listo para recoger, en tránsito o entregado. Para WhatsApp u otros canales se usan los triggers de pedidos.

id: payment-gateways app: finance nombre: Pasarelas de pago estado: shipped permiso: can_access_payments

Pasarelas de pago

Conecta credenciales Stripe o Wompi de la organización y comprueba que sus claves y webhooks están listos para cobros.

Para que sirve

• Un comercio conecta su propia cuenta Stripe para cobrar enlaces de pago a sus clientes.
• Una empresa colombiana conecta Wompi para recaudar cobros en COP.
• Un equipo financiero verifica una conexión antes de publicar enlaces y detecta claves, modos o webhooks incompletos.
• Una agencia administra más de una configuración de cobro de su organización sin mezclarla con la facturación de la plataforma.

Que lo hace diferente

• Las credenciales pertenecen a cada organización y se usan para sus Payment Links, separadas de la facturación SaaS de AchieveApex.
• La comprobación valida autenticación, compatibilidad entre modo de claves y configuración de webhooks antes de cobrar.
• Stripe y Wompi se conectan al mismo flujo de enlaces públicos, pagos recibidos, cotizaciones e invoices.
• La modalidad de cobro se elige por enlace —Apex Checkout o Provider Checkout— y no queda fijada al conectar la pasarela.
• Los webhooks convierten la confirmación del proveedor en pagos recibidos sin duplicar el cobro si el evento se repite.

Acceso

• Ruta principal: /[orgId]/settings/payment-gateways
• Como se llega: Avatar menu > Settings > Billing & Finance > Payment Gateways
• Permiso requerido: can_access_payments

Alcance tecnico

• Frontend: PaymentGatewaysSettings
• Backend: organization-payment-gateways, stripe-payment-webhooks, wompi-webhooks, payment-gateway-health
• Superficies publicas: ninguna

Funcionalidades internas

Relaciones

• Depende de: Payment Links, Estimates y Payments received.
• Usado por: módulos y documentos del flujo financiero.

Limitaciones y notas

• Los permisos granulares pueden restringir acciones según el rol de la organización.

id: payment-links app: finance nombre: Enlaces de pago estado: shipped permiso: can_access_payments

Enlaces de pago

Los enlaces de pago preparan un cobro individual con un gateway de la organización. Pueden ser independientes o proceder de Amount to collect en una cotización.

Para que sirve

• Una clínica envía a un paciente un enlace para cobrar el anticipo de un procedimiento antes de facturarlo.
• Una agencia cobra el primer pago de una propuesta aceptada desde la cotización del deal.
• Un comercio B2B crea un enlace asociado a una factura y permite al comprador abrir también el documento relacionado.
• Un negocio de servicios comparte un cobro puntual por Stripe o Wompi sin requerir acceso al CRM.

Que lo hace diferente

• El enlace puede nacer de una cotización, factura, contacto, compañía o deal existentes, conservando el contexto comercial.
• Cada enlace elige su gateway y modalidad: Apex Checkout integrado o Provider Checkout hospedado por Stripe o Wompi.
• La página pública conserva identidad visual y idioma de la organización y expone solo los documentos financieros que correspondan al pagador.
• Un cobro confirmado crea un pago recibido idempotente y, cuando procede, actualiza la cotización vinculada a aceptada.
• Las facturas relacionadas se pueden liquidar después mediante la aplicación de pagos, incluso de forma parcial.

Acceso

• Ruta principal: /[orgId]/finance/payment-links
• Como se llega: Finance > Sales > Payment Links
• Permiso requerido: can_access_payments

Alcance tecnico

• Frontend: rutas Finance; PaymentLinksView, PaymentLinkEditForm, PaymentLinkDetail
• Backend: payment-links, public-payment-charge, payment-gateway-health
• Superficies publicas: /payment-links/[token]

Funcionalidades internas

Relaciones

• Depende de: Payment Gateways, Payments received, Estimates e Invoices.
• Usado por: cotizaciones, facturas, pagos recibidos y gateways de pago.

Limitaciones y notas

• La configuración de credenciales vive en Payment Gateways; el método de cobro se elige por enlace.
• Wompi solo admite enlaces en COP.

id: payments-made app: finance nombre: Payments Made estado: beta permiso: can_access_vendor_payments

Payments Made

Registra pagos a proveedores y los asigna a bills abiertos para reducir sus saldos.

Para que sirve

• Una distribuidora registra una transferencia a un proveedor y la reparte entre varias facturas abiertas.
• Una clínica aplica un pago parcial a una factura de equipos y consulta el saldo que falta por pagar.
• Un restaurante identifica el excedente de un pago recibido por su proveedor para usarlo en otras facturas del mismo proveedor.
• Una empresa de logística anula un pago registrado por error y recupera los saldos correctos de sus bills.

Que lo hace diferente

• Un solo pago puede asignarse a múltiples bills del mismo proveedor, y el sistema mantiene el importe aplicado y sin usar.
• Cada asignación actualiza automáticamente el saldo y el estado del bill, sin que el usuario edite deudas manualmente.
• Se integra con Bills, Vendors, monedas y la numeración documental compartida de Finance.
• Desde un bill abierto, Record Payment precarga el proveedor y la factura para reducir errores de captura.
• No procesa pagos bancarios ni aplica a Expenses; registra el pago y su asignación dentro del control de cuentas por pagar.

Acceso

• Ruta principal: /[orgId]/finance/payments-made
• Como se llega: Header app switcher > Alpha & Beta > Finance > Purchases > Payments Made
• Permiso requerido: can_access_vendor_payments y permisos de ver, crear, editar o eliminar pagos.

Alcance tecnico

• Frontend: rutas de lista, creación y detalle; PaymentsMadeView, RecordVendorPaymentForm y VendorPaymentDetail.
• Backend: vendor-payments y bill-payments.
• Superficies publicas: ninguna.
• Integraciones externas: ninguna.

Funcionalidades internas

Relaciones

• Depende de: Vendors, Bills y Currencies.
• Usado por: actualiza el saldo, monto pagado y estado de Bills.
• La configuración de numeración AP vive en settings/document-settings; no se documenta aquí. Las plantillas se describen en Document Templates.

Limitaciones y notas

• Payments Made no aplica a Expenses.
• Un pago se numera al crearse, sin estado de borrador.

id: payments-received app: finance nombre: Pagos recibidos estado: shipped permiso: can_access_payments

Pagos recibidos

Los pagos recibidos registran dinero cobrado manualmente o desde un gateway y distribuyen su importe entre facturas. Se consultan tanto desde CRM como desde Finance.

Para que sirve

• Una empresa de servicios registra una transferencia recibida y la aplica a una o varias facturas abiertas.
• Una escuela cobra una parte de la matrícula y conserva el saldo restante de cada factura.
• Un comercio recibe un pago desde un enlace público y después lo asigna al documento correcto.
• Un despacho corrige una aplicación equivocada o anula un cobro sin perder el rastro del movimiento.

Que lo hace diferente

• Une los cobros de gateways y los pagos manuales en un solo registro de dinero recibido.
• Puede relacionar pagos con cotizaciones, enlaces de pago, contactos, compañías y deals del CRM.
• Separa la captura del dinero de su aplicación a facturas para admitir anticipos, pagos parciales y pagos que cubren varias facturas.
• Mantiene el saldo y estado de la factura actualizados tras aplicar, desasignar o anular un importe.
• Funciona desde CRM y desde el espacio Finance sobre los mismos documentos compartidos.

Acceso

• Ruta principal: /[orgId]/payments y /[orgId]/finance/payments
• Como se llega: sidebar CRM > Payments o selector de aplicación > Finance > Sales > Received Payments
• Permiso requerido: can_access_payments

Alcance tecnico

• Frontend: rutas CRM y Finance; PaymentsView, PaymentDetail, RecordPaymentForm y diálogos de asignación
• Backend: payments e invoice-payments
• Superficies publicas: ninguna

Funcionalidades internas

Relaciones

• Depende de: Invoices, Payment Links, Estimates y Payment Gateways.
• Usado por: facturas, enlaces de pago y el historial de cobros del cliente.

Limitaciones y notas

• Un pago puede quedar parcialmente o totalmente sin asignar; capturarlo no liquida una factura automáticamente.
• La eliminación de una asignación es un borrado lógico y recalcula el saldo de la factura.

id: recurring-bills app: finance nombre: Recurring Bills estado: beta permiso: can_access_bills

Recurring Bills

Configura perfiles que generan bills periódicos para proveedores.

Para que sirve

• Un coworking genera cada mes el bill de alquiler de su oficina con la misma información y partidas.
• Una cadena de tiendas programa bills de mantenimiento y calcula sus vencimientos según los días de pago acordados.
• Una empresa de eventos pausa obligaciones estacionales y las reanuda cuando comienza su nueva temporada.
• Una inmobiliaria crea el bill del período de manera anticipada para prepararlo antes de su fecha de pago.

Que lo hace diferente

• Genera Bills normales que entran al mismo flujo de cuentas por pagar y Payments Made, en lugar de mantener una lista separada de recordatorios.
• Reutiliza proveedor obligatorio, moneda, partidas, impuestos y términos de pago del perfil para generar documentos consistentes.
• La generación automática evita duplicar un bill del mismo período y conserva el enlace entre el perfil y cada documento creado.
• Puede crear cada bill como Draft u Open; al abrirse, adquiere saldo y numeración conforme al flujo habitual.
• No automatiza el desembolso: los bills generados se pagan posteriormente desde Payments Made.

Acceso

• Ruta principal: /[orgId]/finance/recurring-bills
• Como se llega: Header app switcher > Alpha & Beta > Finance > Purchases > Recurring Bills
• Permiso requerido: permisos de Bills, incluido can_access_bills.

Alcance tecnico

• Frontend: rutas de lista, creación, detalle y edición; RecurringBillsView, RecurringBillEditForm, RecurringBillDetail.
• Backend: recurring-bills, recurring-bill-items y recurring-bill-generate.
• Superficies publicas: ninguna.
• Integraciones externas: proceso programado compartido de generación recurrente.

Funcionalidades internas

Relaciones

• Depende de: Bills, Vendors, Currencies y Document Templates.
• Usado por: genera bills normales que pueden recibir pagos.
• La numeración AP se configura en settings/document-settings; no se documenta aquí.

Limitaciones y notas

• El proveedor es obligatorio.
• Los perfiles detenidos conservan su historial.

id: recurring-expenses app: finance nombre: Recurring Expenses estado: beta permiso: can_access_expenses

Recurring Expenses

Configura perfiles que generan gastos periódicos a partir de conceptos reutilizables.

Para que sirve

• Una agencia genera periódicamente el gasto de sus herramientas de diseño sin recapturar sus conceptos.
• Una clínica programa el gasto semanal de lavandería y lo detiene durante un cierre temporal.
• Un operador turístico crea por adelantado el gasto del período desde el perfil cuando necesita revisarlo antes.
• Un restaurante conserva el historial de los gastos originados por una misma suscripción operativa.

Que lo hace diferente

• Genera Expenses normales, no registros aislados: los documentos resultantes siguen el flujo y la numeración de gastos de Finance.
• Reutiliza partidas, impuestos, moneda y proveedor opcional del perfil para mantener importes consistentes entre períodos.
• La generación automática comparte el proceso programado de recurrencias y evita duplicar documentos para un mismo período.
• Permite elegir si el gasto generado queda en Draft o se registra como Active.
• No gestiona pagos de proveedores: los gastos directos no usan Payments Made ni crean una cuenta por pagar.

Acceso

• Ruta principal: /[orgId]/finance/recurring-expenses
• Como se llega: Header app switcher > Alpha & Beta > Finance > Purchases > Recurring Expenses
• Permiso requerido: permisos de Expenses, incluido can_access_expenses.

Alcance tecnico

• Frontend: rutas de lista, creación, detalle y edición; RecurringExpensesView, RecurringExpenseEditForm y RecurringExpenseDetail.
• Backend: recurring-expenses, recurring-expense-items y recurring-expense-generate.
• Superficies publicas: ninguna.
• Integraciones externas: proceso programado compartido de generación recurrente.

Funcionalidades internas

Relaciones

• Depende de: Expenses, Vendors (opcional), Currencies y Document Templates.
• Usado por: genera documentos normales en Expenses.
• La numeración AP se configura en settings/document-settings; no se documenta aquí.

Limitaciones y notas

• Los perfiles detenidos conservan historial, pero no generan gastos.
• La interfaz permite frecuencias por días, semanas, meses, trimestres y años.

id: recurring-invoices app: finance nombre: Facturas recurrentes estado: shipped permiso: can_access_invoices

Facturas recurrentes

Define perfiles que copian sus artículos y datos comerciales a facturas normales de forma manual o programada.

Para que sirve

• Una empresa de mantenimiento genera cada mes la factura de sus contratos activos sin reescribir sus líneas de servicio.
• Una agencia factura un retainer trimestral y conserva una factura histórica independiente por cada periodo.
• Una academia programa cobros anuales con vencimiento calculado desde sus términos de pago.
• Un negocio SaaS pausa un perfil de un cliente suspendido y lo reanuda sin perder la configuración comercial.

Que lo hace diferente

• El perfil genera facturas normales: conservan numeración, PDF, pagos, documentos públicos y el resto del flujo financiero de Apex.
• Puede crearse desde una factura existente para reutilizar cliente, artículos y condiciones ya aprobadas.
• La generación programada respeta la zona horaria del perfil y evita facturas duplicadas para un mismo periodo.
• Los documentos históricos no cambian si se edita el perfil; los ajustes solo afectan la facturación futura.
• Convive con contactos, compañías y deals del CRM en vez de mantener un catálogo de clientes separado.

Acceso

• Ruta principal: /[orgId]/finance/recurring-invoices
• Como se llega: Header app switcher > Finance > Sales > Recurring Invoices
• Permiso requerido: can_access_invoices

Alcance tecnico

• Frontend: recurring-invoices/page.tsx, [id]/page.tsx, new/page.tsx, [id]/edit/page.tsx; RecurringInvoicesView, RecurringInvoiceDetail, RecurringInvoiceEditForm
• Backend: recurring-invoices, recurring-invoice-items, recurring-invoice-generate, cron-recurring-invoices
• Superficies publicas: ninguna

Funcionalidades internas

Relaciones

• Depende de: Invoices, Contacts, Companies, Currencies, Document Templates y Document Numbering.
• Usado por: Invoices y document-template-preview.

Limitaciones y notas

• Las facturas ya generadas conservan una copia histórica; editar el perfil no las cambia.
• La generación protege contra duplicados del mismo perfil y periodo.

id: taxes-currencies app: finance nombre: Impuestos y monedas estado: shipped permiso: can_access_finance

Impuestos y monedas

Centraliza las tasas de impuesto y las monedas disponibles para documentos financieros de la organización.

Para que sirve

• Una agencia que vende en Colombia y Estados Unidos prepara documentos en COP y USD con la moneda adecuada para cada cliente.
• Un comercio aplica IVA u otros impuestos definidos por la organización al calcular cotizaciones y facturas.
• Una empresa que recibe precios en otra moneda consulta y actualiza el tipo de cambio usado en sus documentos.
• Un negocio que deja de operar en una divisa la deshabilita sin eliminar el historial de documentos previos.

Que lo hace diferente

• Las monedas e impuestos se comparten con cotizaciones, facturas, pagos y enlaces de pago del mismo CRM.
• Los tipos de cambio se actualizan automáticamente y se pueden consultar o actualizar desde Finance.
• La moneda seleccionada llega al documento público, a la plantilla y al PDF, no solo a un registro contable interno.
• Mantiene un catálogo de monedas del sistema y habilitaciones por organización para ajustar la operación real de cada negocio.

Acceso

• Ruta principal: /[orgId]/settings/taxes y /[orgId]/settings/currencies
• Como se llega: Avatar menu > Settings > Billing & Finance > Taxes o Currencies
• Permiso requerido: can_access_finance

Alcance tecnico

• Frontend: TaxesList, CurrenciesList y sus diálogos
• Backend: taxes, organization-currencies, system-currencies, exchange-rates, get-exchange-rate, cron-update-exchange-rates
• Superficies publicas: ninguna

Funcionalidades internas

Relaciones

• Depende de: Estimates, Invoices, Payments received y Payment Links.
• Usado por: módulos y documentos del flujo financiero.

Limitaciones y notas

• Los permisos granulares pueden restringir acciones según el rol de la organización.

id: vendors app: finance nombre: Vendors estado: beta permiso: can_access_vendors

Vendors

Gestiona los proveedores usados en las compras de Finance. Permite mantener sus datos, personas de contacto y direcciones.

Para que sirve

• Una agencia de marketing centraliza sus imprentas, estudios y proveedores de pauta para reutilizarlos en todas sus compras.
• Una clínica conserva los contactos y direcciones de laboratorios y distribuidores para consultar rápidamente a quién corresponde cada documento.
• Un restaurante inactiva un proveedor que dejó de usar sin perder el historial de gastos y facturas asociados.

Que lo hace diferente

• Los proveedores son una entidad propia de cuentas por pagar, separada de los contactos de CRM, aunque pueden vincularse de forma opcional.
• La misma ficha alimenta Expenses, Bills y Payments Made, evitando recrear un proveedor en cada flujo de compras.
• El detalle reúne gastos y bills recientes del proveedor para navegar desde la relación comercial hasta los documentos financieros.
• No sustituye una contabilidad de partida doble ni calcula actualmente un balance agregado de proveedor a partir de los documentos.

Acceso

• Ruta principal: /[orgId]/finance/vendors
• Como se llega: Header app switcher > Alpha & Beta > Finance > Purchases > Vendors
• Permiso requerido: can_access_vendors; las acciones respetan permisos de ver, crear, editar y eliminar del módulo.

Alcance tecnico

• Frontend: rutas de lista, creación, detalle y edición de vendors; VendorsView, VendorEditForm y VendorDetail.
• Backend: servicios Feathers vendors, vendor-contacts y vendor-addresses.
• Superficies publicas: ninguna.
• Integraciones externas: ninguna.

Funcionalidades internas

Relaciones

• Depende de: Finance, Currencies y permisos de organización.
• Usado por: expenses de forma opcional; bills y vendor-payments de forma obligatoria.

Limitaciones y notas

• Un proveedor es distinto de un contacto de CRM, aunque puede vincularse opcionalmente a un contacto o compañía.
• La eliminación es lógica; los documentos históricos permanecen.

APP: helpdesk

Helpdesk

Ticketing moderno, knowledge base y portal público.

• Etapa: Beta
• Landing: /{orgId}/helpdesk

Modulos

Funcionalidades internas

56 funcionalidades documentadas en 5 modulos. Ver la tabla de cada modulo.

id: configuracion app: helpdesk nombre: Configuración de Helpdesk estado: beta permiso: can_access_helpdesk y can_manage_helpdesk_settings para cambios

Configuración de Helpdesk

Define cómo se reciben, enrutan, priorizan y notifican los tickets, además del centro de ayuda que usan los clientes.

Para que sirve

• Un SaaS define grupos, agentes y reglas de triage para dirigir facturación, incidencias técnicas y onboarding a quien corresponde.
• Un ISP configura horarios y políticas SLA para comprometer tiempos realistas de respuesta según la prioridad de una avería.
• Un e-commerce centraliza su correo de soporte, avisos al cliente y respuestas aprobadas para atender pedidos de forma consistente.
• Una empresa de servicios publica formularios y un centro de ayuda con su propia marca o dominio.
• Un BPO prepara macros y escalaciones para que cada turno aplique el mismo procedimiento ante casos sin asignar.

Que lo hace diferente

• Configura en el mismo producto el ciclo completo: entrada por correo o formulario, enrutamiento, SLA, comunicación, autoservicio y medición.
• El triage con IA clasifica tickets entrantes con prioridad, tipo, etiquetas y sentimiento sin bloquear su creación.
• Los horarios laborales influyen en SLA y escalamiento, conectando el diseño de la operación con la atención diaria.
• Los formularios y el portal público se conectan de forma nativa a tickets, Knowledge Base, CSAT y automatizaciones.
• Las reglas definidas aquí funcionan junto a asistentes IA que pueden crear y consultar tickets desde una conversación.

Acceso

• Ruta principal: /[orgId]/settings/helpdesk/general
• Cómo se llega: Avatar menu > Settings > Helpdesk
• Permiso requerido: can_access_helpdesk; las modificaciones requieren can_manage_helpdesk_settings.

Alcance técnico

• Frontend: rutas bajo settings/helpdesk y HelpdeskSettingsSidebar.tsx.
• Backend: helpdesk-settings, grupos, horarios, SLA, correo, formularios, macros, respuestas guardadas y portal.
• Superficies públicas: formularios y portal configurados aquí.
• Integraciones externas: recepción y envío de correo; dominio propio mediante DNS/CNAME.

Funcionalidades internas

Relaciones

• Depende de: grupos, tickets y portal de Helpdesk.
• Usado por: recepción de correo, SLA, formularios, Knowledge Base y portal público.

Limitaciones y notas

• La ruta /[orgId]/settings/helpdesk redirige a general.

id: insights app: helpdesk nombre: Insights de Helpdesk estado: partial permiso: can_access_helpdesk

Insights de Helpdesk

Panel operativo que calcula la carga de la cola y métricas de respuesta, SLA y CSAT para el periodo seleccionado.

Para que sirve

• Un BPO revisa el volumen abierto, tickets sin asignar y vencimientos para decidir la cobertura del turno.
• Un SaaS compara tiempos de respuesta y resolución por periodo para detectar una degradación del soporte.
• Un ISP supervisa el cumplimiento de SLA de incidencias urgentes antes de que escalen a una queja mayor.
• Una empresa de servicios mide las valoraciones CSAT recibidas tras cerrar solicitudes.

Que lo hace diferente

• Calcula la operación directamente desde los tickets, grupos, asignaciones, SLA y respuestas CSAT del mismo Helpdesk.
• Muestra la salud actual de la cola junto a tendencias de periodos de 7, 30 o 90 días, no solo reportes históricos.
• Permite relacionar una métrica de atención con las reglas de SLA y enrutamiento que la producen dentro de Apex.
• Se complementa con automatizaciones de ticket y SLA para actuar sobre los casos que explican una desviación.

Acceso

• Ruta principal: /[orgId]/helpdesk/insights
• Como se llega: Helpdesk sidebar > Insights
• Permiso requerido: can_access_helpdesk

Alcance técnico

• Frontend: HelpdeskInsightsView.tsx y la ruta helpdesk/insights/page.tsx.
• Backend: helpdesk-insights (find), construido a partir de tickets, grupos, agentes y respuestas CSAT.
• Superficies públicas: ninguna.
• Integraciones externas: ninguna; los datos de correo ya están incorporados en los tickets.

Funcionalidades internas

Relaciones

• Depende de: Tickets Helpdesk, grupos, usuarios asignados, políticas SLA y CSAT.
• Usado por: responsables que supervisan la operación de soporte.

Limitaciones y notas

• La interfaz ofrece 7, 30 y 90 días; el servicio acepta de 1 a 365.
• Los indicadores de cola no usan el rango: representan el estado actual de todos los tickets de la organización.

id: knowledge-base app: helpdesk nombre: Knowledge Base estado: beta permiso: can_access_helpdesk y can_manage_helpdesk_settings

Knowledge Base

Administra contenido de autoservicio para el portal de Helpdesk.

Para que sirve

• Un SaaS publica guías de configuración para que los clientes resuelvan tareas frecuentes sin abrir un ticket.
• Una universidad organiza contenido de matrícula, pagos y admisiones en categorías públicas y navegables.
• Un e-commerce mantiene actualizadas las políticas de devolución y entrega que sus compradores consultan desde el portal.
• Una empresa de servicios prepara artículos en borrador y los publica cuando el procedimiento está validado.

Que lo hace diferente

• El contenido se publica en el portal de Helpdesk de la misma organización, junto a formularios y seguimiento de tickets.
• Las categorías y artículos tienen estados que separan el trabajo editorial de lo que puede leer un visitante anónimo.
• Los artículos se pueden buscar desde herramientas internas de asistentes IA, además de navegarse en el portal.
• No depende de Sites ni de los formularios genéricos: mantiene su propio flujo de soporte y autoservicio.

Acceso

• Ruta principal: /[orgId]/helpdesk/knowledge-base
• Como se llega: Helpdesk sidebar > Knowledge Base
• Permiso requerido: can_access_helpdesk y can_manage_helpdesk_settings

Alcance técnico

• Frontend: HelpdeskKnowledgeBaseView.tsx, HelpdeskKnowledgeArticleEditor.tsx y HelpdeskKnowledgeEditor.tsx.
• Backend: helpdesk-knowledge-categories y helpdesk-knowledge-articles.
• Superficies públicas: categorías y artículos bajo /help/[slug].
• Integraciones externas: no aplica.

Funcionalidades internas

Relaciones

• Depende de: una categoría existente para cada artículo.
• Usado por: el portal público cuando show_knowledge_base está activado.

Limitaciones y notas

• El contenido es independiente de Sites y de Forms. La interfaz no expone reordenamiento manual de categorías ni artículos.

id: portal-publico app: helpdesk nombre: Portal público de Helpdesk estado: beta permiso: ninguno

Portal público de Helpdesk

Centro de ayuda público de cada organización para encontrar artículos, enviar formularios, consultar tickets y responder CSAT.

Para que sirve

• Un e-commerce ofrece respuestas de devolución y un formulario de solicitud sin exigir que el comprador inicie sesión.
• Un SaaS habilita a sus clientes para buscar guías, abrir un ticket y consultar su referencia desde un mismo centro de ayuda.
• Una universidad publica categorías de admisiones y recibe preguntas de aspirantes mediante formularios específicos.
• Una empresa de servicios recoge CSAT tras resolver el caso y reduce consultas de seguimiento con la búsqueda pública del ticket.

Que lo hace diferente

• Reúne artículos, formularios, seguimiento de ticket y CSAT en una superficie pública conectada al Helpdesk de Apex.
• Puede operar bajo el subdominio de Helpdesk de AchieveApex o un dominio propio verificado por DNS/CNAME.
• Los formularios públicos generan tickets que entran a la misma cola donde viven asignación, SLA, relaciones CRM y automatizaciones.
• Ofrece un widget para incrustar el formulario en un sitio externo sin duplicar el sistema de solicitudes.
• Mantiene rutas canónicas, sitemap y robots por portal para que el contenido público pueda descubrirse correctamente.

Acceso

• Ruta principal: /help/[slug]
• Cómo se llega: URL del centro de ayuda o enlace compartido por la organización.
• Permiso requerido: ninguno

Alcance técnico

• Frontend: HelpdeskPortalPage.tsx, HelpdeskPublicForm.tsx, HelpdeskPublicTicketTracking.tsx y componentes públicos de Knowledge Base.
• Backend: helpdesk-portals, helpdesk-forms, helpdesk-form-submissions, helpdesk-ticket-lookup, helpdesk-csat-survey y servicios de Knowledge Base.
• Superficies públicas: /help/[slug], categorías, artículos, formularios, seguimiento y CSAT.
• Integraciones externas: DNS/CNAME para dominios propios.

Funcionalidades internas

Relaciones

• Depende de: un portal publicado; cada sección depende además de su interruptor de visibilidad.
• Usado por: clientes sin sesión y por el widget de formularios.

Limitaciones y notas

• La dirección canónica es https://{slug}.helpdesk.achieveapex.com o el dominio propio activo. En hosts de AchieveApex, /help/[slug] redirige al host canónico; localhost queda excluido.

id: tickets app: helpdesk nombre: Tickets Helpdesk estado: partial permiso: can_access_helpdesk

Tickets Helpdesk

Espacio de trabajo para que los agentes creen, clasifiquen, asignen y resuelvan solicitudes de soporte. Conserva la conversación, el SLA, la actividad y las relaciones CRM del caso.

Para que sirve

• Un SaaS registra incidencias, asigna especialistas y controla que la respuesta y resolución cumplan el SLA.
• Un e-commerce vincula un reclamo con el contacto, la empresa y el deal antes de decidir cómo atenderlo.
• Un ISP distribuye averías entre grupos de soporte, vigila vencimientos y escala los casos que esperan atención.
• Una empresa de servicios conserva el hilo, notas internas y actividad de cada solicitud para dar continuidad entre turnos.

Que lo hace diferente

• El ticket comparte contexto con el contacto, la compañía y el deal del CRM, en vez de vivir en un repositorio de soporte aislado.
• Las respuestas de correo entrantes y salientes se incorporan al hilo del ticket cuando hay un canal de Helpdesk activo.
• Puede usar SLA basados en horarios laborales, con pausas e incumplimientos visibles en la cola y el detalle.
• Las automatizaciones nativas se activan al crear o actualizar tickets y ante incumplimientos de SLA; pueden asignar, responder, anotar o añadir seguidores.
• Los asistentes IA disponen de herramientas internas para crear, consultar y buscar tickets desde sus conversaciones.

Acceso

• Ruta principal: /[orgId]/helpdesk
• Como se llega: Header app switcher > Alpha & Beta > Helpdesk
• Permiso requerido: can_access_helpdesk

Alcance técnico

• Frontend: HelpdeskListView.tsx, HelpdeskNewTicketView.tsx, HelpdeskTicketDetailView.tsx y HelpdeskRelatedCrmSection.tsx.
• Backend: helpdesk-tickets, helpdesk-ticket-messages, helpdesk-ticket-events, helpdesk-ticket-merge, helpdesk-macro-runs, helpdesk-ticket-batch-actions y cron-helpdesk-sla.
• Superficies públicas: helpdesk-csat-survey recibe valoraciones desde el enlace enviado al solicitante.
• Integraciones externas: los canales Helpdesk envían respuestas por correo y el receptor de SES incorpora los correos entrantes al hilo.

Funcionalidades internas

Relaciones

• Depende de: Configuración Helpdesk, Contactos, Compañías, Deals, equipos y canales de correo de Helpdesk.
• Usado por: Insights de Helpdesk, automatizaciones y asistentes de IA de Helpdesk.

Limitaciones y notas

• Convive con CRM tickets-legacy (customer-service), el inbox anterior para mensajes de correo. No comparten registros, cola ni flujo de ticketing.
• Un miembro puede tener alcance all, group o assigned; el acceso a configuración requiere can_manage_helpdesk_settings.

APP: internal

Internal

Consola interna de plataforma.

• Etapa: Admin
• Landing: /internal

Modulos

Funcionalidades internas

28 funcionalidades documentadas en 4 modulos. Ver la tabla de cada modulo.

id: ai-models app: internal nombre: AI Models estado: admin permiso: admin o superadmin

AI Models

Catálogo interno de modelos de IA, sus precios y las superficies de AchieveApex donde pueden utilizarse.

Para que sirve

• Decidir qué modelos de IA puede elegir cada superficie de asistentes.
• Registrar precios mostrados al cliente y la disponibilidad de un modelo.
• Sincronizar costes y metadatos de modelos ya registrados en OpenRouter.
• Detectar asistentes que usan un modelo antes de retirarlo.
• Ver qué asistentes y organizaciones realmente consumieron un modelo en un rango de fechas, y simular otro multiplicador.
• Migrar en lote asistentes hacia un modelo de reemplazo.

Que lo hace diferente

• El catálogo controla por separado conversaciones, tickets, AI chat y voz.
• Los asistentes que usan OpenRouter se enrutan por la integración de proveedor correspondiente.
• El coste real de OpenRouter se combina con un multiplicador de coste para el cobro de uso.
• Sincronizar el proveedor actualiza sus costes y metadatos sin sustituir los precios al cliente salvo que se solicite.
• Retirar un modelo usa borrado suave, preservando el historial y las configuraciones existentes.

Acceso

• Ruta principal: /internal/models
• Como se llega: Header app switcher > Internal > AI Models
• Permiso requerido: rol de plataforma admin o superadmin

Alcance tecnico

• Frontend: src/app/(internal)/internal/models/ y src/components/internal/ai-models/
• Backend: ai-models, ai-models-openrouter, ai-models-migrate-assistants y ai-models-consumption
• Superficies publicas: ninguna
• Integraciones externas: OpenRouter

Funcionalidades internas

Relaciones

• Depende de: OpenRouter y asistentes de IA.
• Usado por: asistentes de conversaciones, tickets, AI chat y voz.

Limitaciones y notas

• Ocultar un modelo de los selectores no elimina sus configuraciones existentes.

id: home app: internal nombre: Inicio interno estado: admin permiso: admin o superadmin

Inicio interno

Consola de administración transversal de AchieveApex para personal de plataforma. Reúne el acceso al soporte Nova y a las áreas internas.

Para que sirve

• Supervisar la adopción, fricción, coste y calidad de Nova Support en toda la plataforma.
• Convertir feedback de respuestas de Nova en casos atendidos por personas.
• Mantener habilidades de conocimiento global para que Nova responda sobre configuraciones reales.
• Acceder a las áreas internas sin cambiar el alcance global de administración.

Que lo hace diferente

• Nova conecta las métricas de uso, el feedback y el historial conversacional con el flujo real de soporte.
• Una calificación puede convertirse en un caso enlazado a la conversación que la originó.
• El conocimiento operativo se publica como habilidades consultables por Nova, no como texto fijo en la interfaz.
• La consola opera sobre toda la plataforma y no sobre una organización seleccionada.

Acceso

• Ruta principal: /internal
• Como se llega: Header app switcher > Internal
• Permiso requerido: rol de plataforma admin o superadmin

Alcance tecnico

• Frontend: rutas bajo src/app/(internal)/internal/ y componentes src/components/internal/nova-support/
• Backend: support-chat-conversations, support-chat-messages, support-chat-message-feedback, nova-support-knowledge-skills y reports
• Superficies publicas: ninguna
• Integraciones externas: OpenRouter para la respuesta de Nova

Funcionalidades internas

Relaciones

• Depende de: Support Admin y AI Models.
• Usado por: administradores de plataforma.

Limitaciones y notas

• Las rutas internas no llevan [orgId]; el selector de organización del encabezado no cambia su alcance global.

id: partners-admin app: internal nombre: Administración de partners estado: admin permiso: admin o superadmin

Administración de partners

Herramientas internas para revisar partners, su atribución de clientes, comisiones, pagos y desempeño.

Para que sirve

• Revisar y aprobar solicitudes de agencias y afiliados.
• Atribuir organizaciones cliente a partners y verificar sus relaciones.
• Auditar comisiones y decidir qué retiros de partners se procesan.
• Ejecutar y seguir pagos de partners en Wise.
• Medir crecimiento, activación, churn, concentración y economía del programa.
• Identificar organizaciones Implementor y su situación dentro del programa.

Que lo hace diferente

• La atribución de clientes, comisiones y payouts se conectan en el mismo flujo operativo.
• Los payouts se ejecutan en Wise y se concilian por webhook y proceso programado; no se marcan manualmente como pagados.
• Un reintento de financiación reutiliza la transferencia pendiente, evitando duplicar pagos.
• La analítica distingue el tipo de partner desde el cliente referido, evitando una clasificación errónea en el ledger.
• El programa reúne agencias y afiliados bajo una operación común, conservando sus datos de referencia y economía.

Acceso

• Ruta principal: /internal/partners
• Como se llega: Header app switcher > Internal > Partners
• Permiso requerido: rol de plataforma admin o superadmin; algunas vistas requieren superadmin

Alcance tecnico

• Frontend: src/app/(internal)/internal/partners/ y src/components/internal/partners/
• Backend: partners-agency-applications, partners-transactions, partners-payouts, partner-payout-accounts, partners-metrics y reports
• Superficies publicas: ninguna en esta consola
• Integraciones externas: Wise para ejecución de payouts

Funcionalidades internas

Relaciones

• Depende de: Organizations, Stripe Billing y Wallet.
• Usado por: Agencies & Affiliates y Support Admin.

Limitaciones y notas

• El pago efectivo lo confirma Wise mediante webhooks y conciliación; no se puede marcar manualmente como procesado o pagado.

id: reports app: internal nombre: Informes internos estado: admin permiso: superadmin

Informes internos

Informes globales de plataforma, incluidos el constructor asistido por IA y las vistas administrativas de wallet, suscripciones y afiliados.

Para que sirve

• Crear páginas globales para vigilar la operación de toda la plataforma.
• Construir gráficos, tablas y métricas sobre suscripciones, wallet, partners u otros datos internos.
• Pedir a la IA que cree o modifique informes desde una descripción en lenguaje natural.
• Aplicar filtros por página solo a los widgets que los necesitan.
• Consultar reportes administrativos preexistentes de wallet, suscripciones y afiliados.

Que lo hace diferente

• El constructor con IA crea y ajusta páginas y widgets internos después de probar sus consultas.
• Los informes son globales y no se limitan automáticamente a una organización.
• El modelo de filtros enlaza explícitamente cada widget, evitando cambios no deseados en una página.
• Conviven un lienzo configurable por IA y reportes administrativos especializados de wallet, suscripciones y afiliados.
• El acceso es exclusivo de superadmin, separado de los informes de cada organización.

Acceso

• Ruta principal: /internal/reports
• Como se llega: Header app switcher > Internal > Reports
• Permiso requerido: rol de plataforma superadmin; las rutas /reports/* son reportes administrativos separados

Alcance tecnico

• Frontend: src/app/(internal)/internal/reports/, src/components/internal/reports/ y src/app/(reports)/reports/
• Backend: internal-report-pages, internal-report-widgets, internal-report-widget-data, internal-ai-report-builder y reports
• Superficies publicas: ninguna
• Integraciones externas: OpenRouter para el constructor asistido

Funcionalidades internas

Relaciones

• Depende de: Organizations, Wallet, Stripe Billing y Partners.
• Usado por: personal de plataforma.

Limitaciones y notas

• Los informes internos son globales y no se limitan automáticamente a una organización.

APP: links

Links

Short links branded, actividad y analitica.

• Etapa: Beta
• Landing: /{orgId}/links

Modulos

Funcionalidades internas

14 funcionalidades documentadas en 3 modulos. Ver la tabla de cada modulo.

id: activity app: links nombre: Actividad de Links estado: beta permiso: can_access_links

Actividad de Links

Registro de eventos individuales generados por los smart links.

Para que sirve

• Una agencia distingue escáneres automáticos de navegadores al evaluar la respuesta a una campaña.
• Un equipo comercial consulta la actividad reciente de un enlace antes de contactar al destinatario previsto.
• Una inmobiliaria abre el contacto o deal relacionado desde el evento para continuar la gestión comercial.

Que lo hace diferente

• Cada evento conserva el contexto CRM del enlace dentro de Apex, sin convertir una atribución en identificación comprobada.
• El modelo de confianza separa actividad técnica, automatización, humano probable y evidencia verificada.
• Las visitas medidas alimentan Activity, Analytics y el timeline CRM desde el mismo enlace apx.red.

Acceso

• Ruta principal: /[orgId]/links/activity
• Como se llega: Links > Activity
• Permiso requerido: can_access_links

Alcance tecnico

• Frontend: página de Activity
• Backend: smart-link-events y smart-link-engagement
• Superficies públicas: bridge de medición de enlaces

Funcionalidades internas

Relaciones

• Depende de: Smart Links.
• Usado por: Analytics y CRM timeline.

Limitaciones y notas

• La clasificación de confianza no confirma identidad salvo evidencia Verified.

id: analytics app: links nombre: Analítica de Links estado: beta permiso: can_access_links

Analítica de Links

Métricas agregadas y por enlace de las visitas de Apex Links.

Para que sirve

• Una agencia compara el interés técnico y humano probable de sus enlaces de campaña.
• Una inmobiliaria identifica el QR o enlace que concentra más actividad antes de invertir en otra promoción.
• Un equipo comercial analiza país, dispositivo y tendencia de un enlace asociado a un prospecto o deal.

Que lo hace diferente

• La analítica usa los eventos del enlace apx.red y los conecta con Activity y el contexto CRM.
• Distingue solicitudes automáticas de interacción humana probable, en vez de presentar todo request como una apertura de persona.
• Combina totales de vida útil con tendencias diarias, QR, país y dispositivo por enlace.

Acceso

• Ruta principal: /[orgId]/links/analytics
• Como se llega: Links > Analytics
• Permiso requerido: can_access_links

Alcance tecnico

• Frontend: analítica de organización y detalle del enlace
• Backend: smart-links y smart-link-events
• Superficies públicas: ninguna

Funcionalidades internas

Relaciones

• Depende de: Smart Links y Activity.
• Usado por: equipos de campañas y CRM.

Limitaciones y notas

• La tendencia diaria es UTC; los totales son de vida útil.

id: smart-links app: links nombre: Smart Links estado: beta permiso: can_access_links

Smart Links

Gestión de enlaces cortos de Apex Links, códigos QR y atribución CRM.

Para que sirve

• Una agencia añade enlaces cortos con UTM a campañas y mide sus visitas sin exponer los parámetros en la URL compartida.
• Una inmobiliaria imprime un QR en una ficha y observa la actividad y el contexto del deal asociado.
• Un equipo comercial comparte un enlace para un prospecto y conserva la atribución prevista en el timeline CRM.
• Una empresa de eventos desactiva o vence enlaces promocionales cuando una campaña deja de estar vigente.

Que lo hace diferente

• Los enlaces usan el dominio apx.red, QR dinámico y UTM aplicados al destino sin incluir datos personales en el slug.
• Puede relacionar un enlace con contacto, empresa, deal o conversación del CRM y llevar sus eventos al timeline.
• Separa solicitudes técnicas, automatización probable, interacción humana probable y evidencia verificada, sin afirmar identidad por asociación CRM.
• La creación está disponible para Nova mediante una herramienta interna que entrega el enlace para enviarlo en conversaciones.

Acceso

• Ruta principal: /[orgId]/links
• Como se llega: Header app switcher > Links
• Permiso requerido: can_access_links

Alcance tecnico

• Frontend: lista, creación, QR y edición de enlaces
• Backend: smart-links, redirect y eventos
• Superficies públicas: https://apx.red/{slug}
• Integraciones externas: Route 53/ALB e IP2Location LITE

Funcionalidades internas

Relaciones

• Depende de: CRM y Organizations.
• Usado por: Activity, Analytics y timeline de CRM.

Limitaciones y notas

• No se deben incluir datos personales en el slug.

APP: marketplace

Marketplace

Marketplace installs versioned CRM configuration templates into an organization: roles, custom fields, tags, pipelines, activity types, lost reasons, email templates, quick replies, and forms.

Private templates stay visible to the author. Public templates appear in the catalog only after AchieveApex approval.

Updates keep local changes unless you choose to apply the template version.

APP: meetings

Meetings

Grabaciones, booking links y transcripts.

• Etapa: Produccion
• Landing: /{orgId}/meetings

Modulos

Funcionalidades internas

19 funcionalidades documentadas en 4 modulos. Ver la tabla de cada modulo.

id: booking-links app: meetings nombre: Enlaces de reserva estado: shipped permiso: acceso a la app Meetings

Enlaces de reserva

Permite publicar páginas para que invitados reserven tiempo en el calendario conectado de un miembro del equipo. Se pueden ver y crear enlaces para otros anfitriones si ya conectaron Google u Outlook.

Para que sirve

• Una agencia permite que cada asesor comercial reciba reuniones sin coordinar horarios por correo.
• Una clínica agenda llamadas de orientación respetando los bloques y excepciones del profesional.
• Una inmobiliaria convierte solicitudes de visita en una actividad CRM y un contacto desde la página pública.
• Una firma B2B reduce ausencias con confirmaciones y recordatorios automáticos para prospectos.

Que lo hace diferente

• Cada reserva consulta la disponibilidad real de Google Calendar u Outlook y crea una actividad CRM vinculada al contacto.
• Funciona como una página personal de agenda, no como reservas de servicios, pagos, grupos o round robin.
• El formulario público puede actualizar contactos y usar campos personalizados seleccionados de Apex.
• La reserva sincroniza el evento con el calendario del anfitrión y puede crear Google Meet.

Acceso

• Ruta principal: /[orgId]/meetings/booking-links
• Como se llega: Header app switcher > Meetings > Booking links
• Permiso requerido: acceso a la app Meetings

Alcance tecnico

• Frontend: lista, editor y página pública de reserva.
• Backend: meeting-booking-links, meeting-bookings, public-meeting-booking.
• Superficies publicas: /m/[orgId]/[slug] y su página de gestión.
• Integraciones externas: Google Calendar, Outlook, S3 y SES.

Funcionalidades internas

Relaciones

• Depende de: Calendar Sync, Contactos, Actividades y campos personalizados.
• Usado por: calendario conectado y CRM.

Limitaciones y notas

• Es una reserva uno a uno; no ofrece pagos, grupos ni round robin.

id: recordings app: meetings nombre: Grabaciones de reuniones estado: shipped permiso: acceso a la app Meetings

Grabaciones de reuniones

Consulta y comparte reuniones capturadas por el bot de AchieveApex, con reproducción y transcripción.

Para que sirve

• Una consultora conserva reuniones de descubrimiento junto al contacto y deal para preparar propuestas con el contexto original.
• Una inmobiliaria revisa conversaciones con prospectos y comparte la transcripción con agentes que no asistieron.
• Un equipo de ventas identifica participantes e historial de una llamada antes de retomar una oportunidad.
• Una empresa de servicios convierte audios grabados desde el CRM en texto cuando necesita documentar una interacción.

Que lo hace diferente

• La reunión se relaciona con contactos, empresas y deals del CRM en lugar de quedar aislada en una biblioteca de notas.
• Puede capturarse con un bot de Recall desde reuniones de calendario o transcribirse desde una grabación de micrófono del CRM.
• El procesamiento de grabaciones y transcripciones consume saldo de la wallet de la organización.
• Las transcripciones se pueden compartir mediante un enlace público administrable desde el detalle de la reunión.

Acceso

• Ruta principal: /[orgId]/meetings
• Como se llega: Header app switcher > Meetings > Recordings
• Permiso requerido: acceso a la app Meetings

Alcance tecnico

• Frontend: lista, detalle y controles de compartición de Meetings.
• Backend: meeting-transcriptions, recall-webhooks, meeting-recording-transcription.
• Integraciones externas: Recall, OpenAI, S3 y wallet.

Funcionalidades internas

Relaciones

• Depende de: Calendar Sync, Contactos, Deals y wallet.
• Usado por: actividad CRM y transcripción pública.

Limitaciones y notas

• La lista muestra solo grabaciones de origen Recall; las reservas no aparecen aquí.

id: settings app: meetings nombre: Ajustes de Meetings estado: shipped permiso: acceso a la app Meetings

Ajustes de Meetings

Centraliza la configuración organizacional de los correos automáticos de transcripciones.

Para que sirve

• Una consultora decide que todos los asistentes reciban el enlace a la transcripción después de una reunión capturada.
• Un despacho regula centralmente el envío de transcripciones para evitar compartirlas automáticamente.
• Un equipo de ventas mantiene el mismo criterio de seguimiento de reuniones para toda la organización.

Que lo hace diferente

• El ajuste gobierna el envío de enlaces públicos generados por las grabaciones Recall de Apex, no una campaña de correo independiente.
• Los destinatarios se obtienen de asistentes de calendario y participantes de la reunión, sin duplicados.
• El enlace público se integra con las grabaciones y su control de acceso, por lo que apagar el envío no altera enlaces ya creados.

Acceso

• Ruta principal: /[orgId]/meetings/settings
• Como se llega: Header app switcher > Meetings > Settings
• Permiso requerido: acceso a la app Meetings

Alcance tecnico

• Frontend: MeetingsSettingsView.
• Backend: organization-meetings-settings.
• Integraciones externas: SES.

Funcionalidades internas

Relaciones

• Depende de: Grabaciones de reuniones.
• Usado por: transcripción pública.

Limitaciones y notas

• Este ajuste no cambia enlaces públicos ya creados.

id: transcript-publico app: meetings nombre: Transcripción pública estado: public permiso: ninguno

Transcripción pública

Comparte una transcripción de reunión mediante un enlace que no requiere iniciar sesión.

Para que sirve

• Una consultora entrega a clientes el registro de una sesión de trabajo sin crearles usuarios en Apex.
• Una agencia comparte la llamada de aprobación con un cliente y mantiene el detalle asociado al CRM.
• Un equipo comercial envía a los asistentes el enlace a la conversación cuando termina la transcripción Recall.

Que lo hace diferente

• El enlace nace desde una grabación de Meetings y se puede revocar o regenerar desde el detalle CRM.
• Para reuniones Recall, Apex puede enviar el enlace automáticamente a asistentes y participantes mediante correo de sistema.
• La página pública muestra participantes sin revelar sus correos y renueva el acceso temporal al video cuando corresponde.

Acceso

• Ruta principal: /mt/[token]
• Como se llega: Meetings > Recordings > Share
• Permiso requerido: ninguno para la página; acceso a Meetings para administrarla

Alcance tecnico

• Frontend: PublicMeetingTranscriptView y MeetingShareControls.
• Backend: public-meeting-transcript y meeting-transcriptions.
• Superficies publicas: /mt/[token].
• Integraciones externas: Recall, S3 y SES.

Funcionalidades internas

Relaciones

• Depende de: Grabaciones y Ajustes de Meetings.
• Usado por: asistentes de una reunión.

Limitaciones y notas

• El correo automático no se aplica a grabaciones de micrófono del CRM.

APP: operations

Operations

Proyectos, tareas, equipos y OKRs.

• Etapa: Produccion
• Landing: /{orgId}/operations/tasks

Modulos

Funcionalidades internas

52 funcionalidades documentadas en 5 modulos. Ver la tabla de cada modulo.

id: my-tasks app: operations nombre: Mis tareas estado: shipped permiso: can_access_tasks

Mis tareas

Hub transversal para consultar y ejecutar tareas de proyectos, de una persona o de un equipo.

Para que sirve

• Una consultora permite a cada especialista concentrar los compromisos de varios clientes en una sola vista personal.
• Una agencia revisa la carga de un equipo y redistribuye tareas vencidas antes de afectar una entrega.
• Un equipo de implementación coordina bloqueos, subtareas, comentarios y responsables para cerrar un despliegue.
• Un estudio profesional sigue tareas por proyecto, hito y prioridad sin separar el trabajo operativo de su contexto.

Que lo hace diferente

• Reúne tareas de Projects y tareas que ejecutan resultados clave de Strategy / OKRs.
• Las asignaciones se apoyan en miembros de proyectos y equipos, y actualizan My Tasks, Workload y Reports.
• Las tareas alimentan progreso de proyecto, hitos, bitácora de actividad y reportes de cumplimiento.
• Nova y el MCP de AchieveApex pueden crear, consultar y actualizar tareas, dependencias, comentarios y asignaciones.

Acceso

• Ruta principal: /[orgId]/operations/tasks
• Como se llega: Operations sidebar > My Tasks.
• Permiso requerido: can_access_tasks; las acciones respetan permisos de Tasks para todos o tareas propias.

Alcance tecnico

• Frontend: operations/tasks, tablero de tareas y panel/detalle.
• Backend: ops-project-tasks, ops-tasks, statuses, listas, assignees, comments, dependencies, attachments y activities.
• Integraciones externas: notificaciones de asignación.

Funcionalidades internas

Relaciones

• Depende de: Projects y Teams.
• Usado por: Reports, Project Tasks y Strategy / OKRs.

Limitaciones y notas

• My Tasks es el destino por defecto al abrir Operations.
• La carga de archivos desde Attachments muestra Coming soon; solo pueden abrirse o eliminarse adjuntos existentes.
• El panel lateral no administra dependencias; están únicamente en la página completa de tarea.

id: proyectos app: operations nombre: Proyectos estado: shipped permiso: can_access_projects

Proyectos

Workspaces para planificar y ejecutar trabajo por proyecto. Reúnen tareas, alcance, roadmap, documentos, miembros y vínculos con CRM.

Para que sirve

• Una agencia digital convierte cada Deal ganado en un proyecto con responsable, entregables y fechas comprometidas con el cliente.
• Una consultora conserva alcance, documentos y cambios aprobados de una implementación en el mismo workspace que ejecuta el equipo.
• Un estudio de arquitectura organiza hitos, planos y entregables de cada obra, sin perder la relación con la empresa contratante.
• Un equipo de servicios recurrentes genera y sigue los entregables de cada período para detectar compromisos pendientes.

Que lo hace diferente

• Vincula el proyecto con Contacts, Companies, Deals, Invoices y Quotes del CRM; desde esos registros se puede volver al trabajo de entrega.
• Formaliza entregables, documentos de alcance y cambios manuales o generados al modificar el alcance.
• Conecta la ejecución con My Tasks, Teams, Strategy / OKRs y los reportes de plazos y alcance.
• Nova y el MCP de AchieveApex pueden crear y consultar proyectos, tareas, documentos, entregables y cambios de alcance.

Acceso

• Ruta principal: /[orgId]/operations/projects
• Como se llega: Operations sidebar > Projects o una colección/proyecto del sidebar.
• Permiso requerido: can_access_projects; crear, editar y eliminar respetan permisos granulares de Projects. Los miembros Admin pueden administrar miembros y archivar su proyecto.

Alcance tecnico

• Frontend: rutas de Projects, workspace del proyecto y Operations settings.
• Backend: ops-projects, miembros, documentos, entregables, cambios de alcance, hitos, colecciones y duplicación.
• Integraciones externas: vínculos con Contactos, Companies, Deals, Invoices y Quotes del CRM.

Funcionalidades internas

Relaciones

• Depende de: My Tasks, Teams, Strategy / OKRs, Contactos, Companies y Deals.
• Usado por: Reports, CRM y el sidebar de Operations.

Limitaciones y notas

• El layout del proyecto expone Dashboard, Scope, Roadmap, Tasks, Docs y Members; no existe una pestaña Calendar propia.
• El acceso rápido Calendar de la página raíz de Operations apunta a /[orgId]/operations/calendar, pero esa ruta no tiene página implementada.
• Templates y usar Template como fuente de duplicación están marcados como Coming soon.

id: reports app: operations nombre: Reportes de operaciones estado: shipped permiso: can_access_operations

Reportes de operaciones

Analiza ejecución, carga, plazos y alcance de Operations.

Para que sirve

• Una agencia detecta proyectos con tareas vencidas, entregables atrasados o cambios de alcance antes de la reunión con el cliente.
• Una consultora compara la carga y las horas estimadas por miembro para reasignar trabajo.
• Un equipo de implementación evalúa si sus entregas se completan antes, en o después de las fechas comprometidas.
• Un estudio profesional revisa el volumen de actividad y avance del portafolio en un período común.

Que lo hace diferente

• Reporta sobre proyectos, tareas, hitos, entregables y cambios de alcance que se ejecutan dentro de AchieveApex.
• Relaciona cumplimiento de plazos y alcance con los proyectos que pueden estar vinculados a Deals, Contacts y Companies del CRM.
• Usa equipos, miembros, colecciones y proyectos como filtros compartidos con Operations.
• Complementa el seguimiento operativo con OKRs conectados a tareas, en vez de limitarse a tableros aislados.

Acceso

• Ruta principal: /[orgId]/operations/reports
• Como se llega: Operations sidebar > Reports.
• Permiso requerido: acceso a Operations.

Alcance tecnico

• Frontend: ReportsPage.tsx, filtros y siete pestañas.
• Backend: ops-reporting.

Funcionalidades internas

Relaciones

• Depende de: Projects, My Tasks y Teams.
• Usado por: responsables de Operations.

Limitaciones y notas

• El período inicial corresponde a los últimos 30 días.

id: strategy-okrs app: operations nombre: Estrategia y OKRs estado: shipped permiso: can_access_strategy

Estrategia y OKRs

Espacio para definir estrategias, ciclos, objetivos, resultados clave y las tareas que los ejecutan.

Para que sirve

• Una consultora traduce su plan anual en ciclos, objetivos medibles y tareas con responsables.
• Una agencia conecta la meta de retención de clientes con resultados clave y el trabajo que debe ejecutarla.
• Un equipo de implementación actualiza avances y notas para detectar objetivos que requieren intervención.
• Un estudio profesional prioriza iniciativas por ciclo y revisa si su ejecución alcanza la meta definida.

Que lo hace diferente

• Une objetivos y resultados clave con tareas ejecutables que también aparecen en My Tasks.
• Calcula progreso de objetivos y estrategias al cambiar resultados o registrar actualizaciones.
• Los equipos y responsables de la organización se usan en la planeación y ejecución, en lugar de mantener listas separadas.
• Nova y el MCP de AchieveApex pueden crear y consultar objetivos, key results, ciclos y tareas de OKR.

Acceso

• Ruta principal: /[orgId]/operations/strategy
• Como se llega: Operations sidebar > Strategy.
• Permiso requerido: can_access_strategy; vista, creación, edición y eliminación distinguen registros propios y todos.

Alcance tecnico

• Frontend: lista de estrategias, detalle y árbol de OKRs.
• Backend: ops-strategies, ciclos, objetivos, grupos, key results, actualizaciones, motivaciones y ops-tasks.

Funcionalidades internas

Relaciones

• Depende de: Teams y miembros de organización.
• Usado por: My Tasks y Reports.

Limitaciones y notas

• Las tareas de estrategia usan ops-tasks; no son Project Tasks.
• Componentes alternos de tarjetas y diálogos existen en el código, pero la interfaz actual usa StrategyTree y paneles laterales.

id: teams app: operations nombre: Equipos estado: shipped permiso: can_access_operations

Equipos

Agrupa miembros de organización para visualizar carga de trabajo y filtrar Operations.

Para que sirve

• Una agencia separa diseño, cuentas y desarrollo para revisar el trabajo asignado a cada disciplina.
• Una consultora compara la carga de sus equipos de implementación antes de aceptar una nueva fase.
• Un estudio de arquitectura identifica qué equipo concentra tareas vencidas o demasiadas horas estimadas.

Que lo hace diferente

• Los equipos se usan directamente en View as team de My Tasks y en los filtros de Operations Reports.
• La carga se calcula sobre tareas reales de Projects y no sobre una planificación aislada.
• Convive con los miembros específicos de cada proyecto, de modo que asignación y capacidad pueden revisarse en conjunto.

Acceso

• Ruta principal: /[orgId]/operations/team
• Como se llega: Operations sidebar > Team.
• Permiso requerido: acceso a Operations.

Alcance tecnico

• Frontend: página y diálogos de Teams.
• Backend: ops-teams y ops-team-members.

Funcionalidades internas