AchieveApex: ficha tecnica completa

Generado desde achieveApex-Frontend/public/ai-docs el 2026-10-15. Contiene la ficha tecnica, el indice y todas las fichas de todas las apps.

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: contract-detail modulo: contratos app: contracts nombre: Gestionar detalle del contrato tipo: accion

Gestionar detalle del contrato

Consulta y actualiza los datos, propietario y relaciones de un contrato.

Que se logra

• Resultado: mantiene el documento contractual conectado con su responsable y registros comerciales relacionados.
• Caso de uso: un ejecutivo actualiza el valor y vincula la factura de un acuerdo antes de iniciar la firma.
• Se combina con: versiones del documento, preparación de firmas y CRM.

Donde esta

• Ruta: /[orgId]/contracts/[contractId]
• Acceso en UI: Contracts > fila
• Componente(s): ContractDetailView.tsx, ContractSidebar.tsx

Como funciona

1. Revisa Document y Activity.
2. Edita valor, fechas y notas desde el panel lateral.
3. Cambia el propietario o asigna y desvincula contacto, empresa, deal, estimate, invoice y proyecto.
4. Descarga el documento o abre Prepare & Send para un borrador de firma.

Reglas y validaciones

• Los permisos propios o globales se basan en el propietario.
• Tras la primera firma, estimate, invoice y archivos adicionales quedan bloqueados.

Backend

• Servicios: contracts (get/patch), servicios de relaciones.

Relaciones

• Requiere: contrato existente.

id: create-contract modulo: contratos app: contracts nombre: Crear contrato para firma tipo: accion

Crear contrato para firma

Inicia un borrador que podrá prepararse y enviarse para firma electrónica.

Que se logra

• Resultado: crea un contrato de firma con documento y relaciones de negocio listo para preparar.
• Caso de uso: una agencia abre un acuerdo ligado al deal ganado de un cliente antes de enviarlo a firma.
• Se combina con: plantillas, preparar firmas y registros CRM.

Donde esta

• Ruta: /[orgId]/contracts
• Acceso en UI: Contracts > New Contract > Request signatures
• Componente(s): CreateContractDialog.tsx

Como funciona

1. Elige Request signatures e introduce el título.
2. Sube un PDF/DOCX o selecciona una plantilla activa.
3. Vincula opcionalmente registros CRM, financieros o proyecto y añade valor o fechas.
4. Crea el borrador y abre su detalle.

Reglas y validaciones

• Título y documento o plantilla son obligatorios.
• Los archivos aceptados son PDF/DOCX hasta 20 MB.

Backend

• Servicios: contracts (create), contract-document-versions (create), contract-generate-document (create).

Relaciones

• Dispara / afecta: preparación y envío para firma.

id: document-versions modulo: contratos app: contracts nombre: Gestionar versiones del documento tipo: accion

Gestionar versiones del documento

Mantiene el archivo actual del contrato y conserva las versiones previas.

Que se logra

• Resultado: reemplaza el documento de trabajo sin perder el historial de versiones del contrato.
• Caso de uso: una empresa actualiza las cláusulas de un acuerdo antes de enviarlo a los firmantes.
• Se combina con: preparar firmas y detalle del contrato.

Donde esta

• Ruta: /[orgId]/contracts/[contractId]
• Acceso en UI: Contract detail > Document > upload or version picker
• Componente(s): ContractDetailView.tsx, ContractSidebar.tsx

Como funciona

1. Sube un PDF o DOCX desde el detalle.
2. El sistema convierte el DOCX para permitir vista previa y firma.
3. Consulta la versión actual o selecciona una versión disponible.

Reglas y validaciones

• Al incorporar una versión, los campos ligados a la anterior dejan de ser vigentes.
• Después de abandonar draft, no se puede cambiar la estructura de firma.

Backend

• Servicios: contract-document-versions (find/create).
• Efectos: S3 almacena el archivo y se calcula la vista PDF.

Relaciones

• Afecta: preparación de firmas.

id: history-and-completion modulo: contratos app: contracts nombre: Historial y finalización del contrato tipo: automatizacion

Historial y finalización del contrato

Registra el progreso de firma y produce el documento definitivo cuando firma la última persona.

Que se logra

• Resultado: conserva el rastro de la firma y entrega un PDF final con certificado al completar el flujo.
• Caso de uso: un despacho demuestra el progreso y cierre de un acuerdo ante el propietario del contrato.
• Se combina con: firma pública, recordatorios y detalle del contrato.

Donde esta

• Ruta: /[orgId]/contracts/[contractId]
• Acceso en UI: Contract detail > Activity / Signers
• Componente(s): ContractTimeline.tsx, ContractSidebar.tsx

Como funciona

1. El historial refleja creación, envío, apertura, recordatorios, firma, rechazo o anulación.
2. View details muestra información de una firma o rechazo.
3. Al completar todos los firmantes, el sistema finaliza el contrato y ofrece su descarga.

Reglas y validaciones

• El proceso pasa por Sent, Partially Signed y Signed, o por rechazo, vencimiento o anulación.
• El cron vence contratos pendientes después de su fecha límite.

Backend

• Servicios: contract-events (find), cron-expire-contracts.
• Efectos: se sella el PDF, se agrega certificado de firma y se envían correos de finalización.

Relaciones

• Requiere: firma pública.

id: prepare-signatures modulo: contratos app: contracts nombre: Preparar firmantes y campos tipo: accion

Preparar firmantes y campos

Configura quién firma y dónde debe completar el documento.

Que se logra

• Resultado: asigna a cada firmante los campos obligatorios y el orden necesario para completar un PDF.
• Caso de uso: una inmobiliaria coloca firmas e iniciales para arrendador, arrendatario y codeudor.
• Se combina con: enviar para firma y firma pública.

Donde esta

• Ruta: /[orgId]/contracts/[contractId]/prepare
• Acceso en UI: Contract detail > Prepare & Send
• Componente(s): ContractPrepareView.tsx, ContractPdfCanvas.tsx

Como funciona

1. Agrega firmantes manualmente, desde el usuario, equipo o cliente.
2. Selecciona firma paralela o secuencial y ordena los firmantes.
3. Coloca Signature, Initials, Name, Date, Text o Checkbox sobre el PDF.
4. Ajusta responsable, obligatorio y etiqueta de cada campo.

Reglas y validaciones

• Solo está disponible para borradores de firma, no para On file.
• Cada firmante necesita al menos un campo Signature obligatorio antes de enviar.
• Los cambios se guardan progresivamente.

Backend

• Servicios: contract-signers, contract-signature-fields, contracts (create/patch/remove).

Relaciones

• Requiere: documento PDF vigente.

id: register-contract modulo: contratos app: contracts nombre: Registrar contrato recibido tipo: accion

Registrar contrato recibido

Archiva un contrato que ya recibió la organización, sin solicitar firmas.

Que se logra

• Resultado: conserva un contrato firmado externamente con sus relaciones comerciales sin abrir un proceso de firma.
• Caso de uso: una inmobiliaria archiva un contrato de arrendamiento recibido y lo relaciona con el inquilino.
• Se combina con: contactos, empresas, deals y proyectos.

Donde esta

• Ruta: /[orgId]/contracts
• Acceso en UI: Contracts > New Contract > Register on file
• Componente(s): CreateContractDialog.tsx

Como funciona

1. Selecciona Register on file.
2. Añade título y un PDF/DOCX.
3. Vincula registros relacionados y detalles opcionales.
4. Selecciona Register contract.

Reglas y validaciones

• Requiere documento y no admite iniciar desde plantilla.
• No tiene firmantes, preparación ni envío electrónico.

Backend

• Servicios: contracts (create), contract-document-versions (create).

Relaciones

• Requiere: un documento recibido.

id: reminders modulo: contratos app: contracts nombre: Recordatorios a firmantes tipo: accion

Recordatorios a firmantes

Reenvía la invitación de firma a un firmante pendiente.

Que se logra

• Resultado: reanuda el seguimiento de un firmante pendiente sin generar un contrato nuevo.
• Caso de uso: una consultora recuerda a un cliente el acuerdo enviado antes de la fecha de vencimiento.
• Se combina con: enviar para firma e historial del contrato.

Donde esta

• Ruta: /[orgId]/contracts/[contractId]
• Acceso en UI: Contract detail > Signers > reminder bell
• Componente(s): ContractSidebar.tsx

Como funciona

1. Abre el contrato enviado.
2. Selecciona el recordatorio junto al firmante pendiente.
3. El sistema reenvía el correo de invitación.

Reglas y validaciones

• Solo aplica a contratos Sent o Partially Signed.
• No se permite para firmantes que ya firmaron o rechazaron.

Backend

• Servicios: contract-send (create con acción de recordatorio).
• Efectos: envía correo y registra el evento.

Relaciones

• Requiere: envío para firma previo.

id: search-and-filter modulo: contratos app: contracts nombre: Buscar y filtrar contratos tipo: vista

Buscar y filtrar contratos

Permite localizar contratos y segmentarlos por tipo o estado.

Que se logra

• Resultado: identifica contratos de firma o archivados por estado, contenido y relación comercial.
• Caso de uso: un despacho prioriza los contratos enviados que siguen pendientes antes del cierre mensual.
• Se combina con: detalle del contrato e historial de firma.

Donde esta

• Ruta: /[orgId]/contracts
• Acceso en UI: Contracts > search and filters
• Componente(s): ContractsListView.tsx

Como funciona

1. Escribe un término en la búsqueda.
2. Filtra entre For signature y On file, y por estado.
3. Abre una fila o un registro relacionado de la columna Related.

Reglas y validaciones

• La búsqueda cubre título, número, notas, relaciones y datos de firmantes.
• Los contratos registrados no muestran firmantes.

Backend

• Servicios: contracts (find).
• Hooks relevantes: búsqueda de contratos.

Relaciones

• Requiere: contratos creados.

id: send-for-signature modulo: contratos app: contracts nombre: Enviar contrato para firma tipo: accion

Enviar contrato para firma

Envía enlaces de firma a todos los firmantes configurados.

Que se logra

• Resultado: inicia un proceso de firma con enlaces personales, idioma, mensaje y vencimiento definidos.
• Caso de uso: una empresa B2B envía un acuerdo a cliente y representante legal siguiendo un orden acordado.
• Se combina con: preparar firmas, firma pública e historial del contrato.

Donde esta

• Ruta: /[orgId]/contracts/[contractId]/prepare
• Acceso en UI: Prepare & Send > Send for signature
• Componente(s): ContractPrepareView.tsx

Como funciona

1. Espera que figure All changes saved.
2. Abre Send for signature.
3. Selecciona idioma, asunto, mensaje y vencimiento.
4. Confirma con Send now.

Reglas y validaciones

• Solo se envían borradores con documento, firmantes y firma obligatoria por firmante.
• El vencimiento es entre 1 y 365 días.
• En modo secuencial todos reciben enlace, pero los posteriores ven espera hasta su turno.

Backend

• Servicios: contract-send (create).
• Efectos: genera tokens, envía correos, registra historial y fija vencimiento.

Relaciones

• Dispara / afecta: firma pública.

id: void-contract modulo: contratos app: contracts nombre: Anular contrato tipo: accion

Anular contrato

Detiene un contrato que ya no debe seguir disponible para firma.

Que se logra

• Resultado: invalida los enlaces de firma de un documento que no debe continuar vigente.
• Caso de uso: una empresa reemplaza una propuesta contractual enviada con condiciones incorrectas.
• Se combina con: historial del contrato y firma pública.

Donde esta

• Ruta: /[orgId]/contracts/[contractId]
• Acceso en UI: Contract detail > More > Void contract
• Componente(s): ContractDetailView.tsx

Como funciona

1. Abre el menú More.
2. Selecciona Void contract y confirma la operación.
3. El contrato queda anulado y los enlaces de firma se invalidan.

Reglas y validaciones

• No se puede anular un contrato ya firmado, vencido o anulado.

Backend

• Servicios: contract-send (create con acción de anulación).
• Efectos: elimina los tokens de firmantes y añade un evento al historial.

Relaciones

• Afecta: firma pública.

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: fill-fields modulo: firma-publica app: contracts nombre: Completar campos del contrato tipo: publico

Completar campos del contrato

Permite llenar los campos que el emisor asignó al firmante dentro del PDF.

Que se logra

• Resultado: cada firmante completa únicamente los datos y firmas que le corresponden en el documento.
• Caso de uso: una inmobiliaria recoge fecha, iniciales y firma de cada parte del arrendamiento.
• Se combina con: abrir paquete de firma y firmar o rechazar.

Donde esta

• Ruta: /contracts/sign/[token]
• Acceso en UI: Signing page > document fields
• Componente(s): ContractSigningExperience.tsx, ContractPdfCanvas.tsx

Como funciona

1. Selecciona el siguiente campo o pulsa directamente uno del PDF.
2. Completa texto, nombre, fecha, casilla, iniciales o firma.
3. El avance indica campos completados y dirige al siguiente obligatorio.

Reglas y validaciones

• Los campos requeridos deben completarse para finalizar.
• El nombre y la fecha se proponen automáticamente cuando están vacíos.

Backend

• Servicios: public-contract-signing (get/create).

Relaciones

• Requiere: paquete de firma disponible.

id: open-signing-package modulo: firma-publica app: contracts nombre: Abrir paquete de firma tipo: publico

Abrir paquete de firma

Presenta al firmante el documento, sus campos y el estado de su enlace.

Que se logra

• Resultado: el firmante sabe si puede actuar, esperar su turno o si el enlace ya no está disponible.
• Caso de uso: un arrendatario abre el enlace de su contrato y consulta el PDF sin usar una cuenta interna.
• Se combina con: verificar identidad y completar campos.

Donde esta

• Ruta: /contracts/sign/[token]
• Acceso en UI: enlace enviado por correo
• Componente(s): ContractSigningExperience.tsx

Como funciona

1. La persona abre el enlace personal.
2. Ve un estado de disponible, completado, espera, verificación requerida o no disponible.
3. Cuando corresponde, consulta el PDF y documentos relacionados.

Reglas y validaciones

• Un enlace anulado, rechazado o vencido no permite firmar.
• En firma secuencial muestra a quién debe esperar.

Backend

• Servicios: public-contract-signing (get).

Relaciones

• Requiere: envío de contrato.

id: sign-or-decline modulo: firma-publica app: contracts nombre: Firmar o rechazar contrato tipo: publico

Firmar o rechazar contrato

Registra la decisión del firmante, su consentimiento y evidencia asociada.

Que se logra

• Resultado: formaliza la firma o rechazo y deja evidencia para finalizar o detener el contrato.
• Caso de uso: un cliente acepta un acuerdo con firma y consentimiento desde el enlace recibido por correo.
• Se combina con: verificación de identidad e historial y finalización del contrato.

Donde esta

• Ruta: /contracts/sign/[token]
• Acceso en UI: Signing page > Finish o More > Decline
• Componente(s): ContractSigningExperience.tsx, SignaturePad.tsx, SigningIdentityPhoto.tsx

Como funciona

1. Añade la firma dibujada, escrita o cargada cuando existe un campo de firma.
2. Selecciona Finish, acepta el consentimiento y toma foto de identidad si se solicita.
3. Confirma Sign; alternativamente abre Decline e indica un motivo opcional.

Reglas y validaciones

• Requiere consentimiento, campos obligatorios y firma si hay campo de firma.
• La foto requerida debe ser JPEG y no superar 3 MB.
• Un rechazo cambia el contrato a Declined y avisa al propietario.

Backend

• Servicios: public-contract-signing (create).
• Efectos: guarda evidencia, registra IP y dispositivo; la última firma finaliza y sella el PDF.

Relaciones

• Dispara / afecta: historial y finalización del contrato.

id: verify-identity modulo: firma-publica app: contracts nombre: Verificar identidad del firmante tipo: publico

Verificar identidad del firmante

Verifica al firmante antes de mostrarle el paquete de firma cuando el remitente lo exige.

Que se logra

• Resultado: añade una comprobación por código antes de permitir el acceso al documento de firma.
• Caso de uso: un despacho exige código por correo o SMS antes de que un cliente firme un acuerdo sensible.
• Se combina con: abrir paquete de firma y firmar o rechazar.

Donde esta

• Ruta: /contracts/sign/[token]
• Acceso en UI: pantalla Verification
• Componente(s): ContractSigningExperience.tsx

Como funciona

1. La persona solicita un código.
2. Recibe el mismo código de seis dígitos por correo, SMS o ambos.
3. Lo introduce y continúa al documento.

Reglas y validaciones

• El código vence en 15 minutos.
• Después de cinco intentos fallidos debe solicitarse un código nuevo.
• La verificación SMS requiere teléfono válido del firmante.

Backend

• Servicios: public-contract-signing (create).
• Efectos: correo de verificación y/o SMS de Telnyx.

Relaciones

• Requiere: verificación configurada al preparar el firmante.

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.

id: edit-template-document modulo: templates app: contracts nombre: Editar documento de plantilla tipo: accion

Editar documento de plantilla

Redacta y guarda el contenido reutilizable de una plantilla.

Que se logra

• Resultado: estandariza el texto de futuros contratos y conserva una base editable por la organización.
• Caso de uso: un despacho actualiza sus cláusulas para que los próximos acuerdos usen la versión aprobada.
• Se combina con: variables de plantilla y generar contrato.

Donde esta

• Ruta: /[orgId]/contracts/templates/[templateId]
• Acceso en UI: Contracts > Templates > fila
• Componente(s): ContractTemplateEditorView.tsx, DocumentMarkdownEditor

Como funciona

1. Actualiza el nombre y el cuerpo en el editor.
2. Usa la previsualización del editor para revisar el Markdown.
3. Activa o desactiva la disponibilidad de la plantilla.
4. Selecciona Save changes.

Reglas y validaciones

• Guardar requiere nombre y contenido no vacío.
• Las plantillas históricas con HTML aún pueden generar documentos.

Backend

• Servicios: contract-templates (get/patch).

Relaciones

• Requiere: permiso de edición de contratos.

id: generate-contract modulo: templates app: contracts nombre: Generar contrato desde plantilla tipo: accion

Generar contrato desde plantilla

Convierte una plantilla activa en el documento inicial de un contrato de firma.

Que se logra

• Resultado: crea un borrador documental a partir de una plantilla y sus datos CRM vinculados.
• Caso de uso: una empresa de servicios abre un nuevo acuerdo de cliente desde su modelo de contratación.
• Se combina con: crear contrato, variables de plantilla y preparar firmas.

Donde esta

• Ruta: /[orgId]/contracts
• Acceso en UI: Contracts > New Contract > Request signatures > Use a template
• Componente(s): CreateContractDialog.tsx

Como funciona

1. El usuario elige una plantilla activa al crear un contrato de firma.
2. El sistema genera el documento y abre el detalle del nuevo borrador.
3. El contrato pasa a preparación de firmantes y campos.

Reglas y validaciones

• Los contratos Register on file no pueden usar plantillas.
• Si no hay plantillas activas, la opción no está disponible.

Backend

• Servicios: contract-generate-document (create), contract-document-versions.

Relaciones

• Dispara / afecta: crear contrato y preparar firmas.

id: manage-templates modulo: templates app: contracts nombre: Gestionar plantillas tipo: accion

Gestionar plantillas

Crea y administra el inventario de plantillas reutilizables.

Que se logra

• Resultado: mantiene versiones reutilizables de documentos disponibles para nuevos contratos de firma.
• Caso de uso: una agencia conserva sus modelos de acuerdo activos y retira los que ya no debe usar.
• Se combina con: generar contrato desde plantilla.

Donde esta

• Ruta: /[orgId]/contracts/templates
• Acceso en UI: Contracts > Templates
• Componente(s): ContractTemplatesView.tsx

Como funciona

1. Selecciona New Template, escribe el nombre y la crea.
2. Busca por nombre o filtra por estado.
3. Abre una fila para editarla, o elimina la plantilla desde Actions.

Reglas y validaciones

• Crear solicita únicamente el nombre.
• Eliminar una plantilla no altera contratos ya generados.

Backend

• Servicios: contract-templates (find/create/remove).

Relaciones

• Afecta: creación de contratos desde plantilla.

id: template-variables modulo: templates app: contracts nombre: Variables de plantilla tipo: configuracion

Variables de plantilla

Inserta referencias que se reemplazan al generar un contrato.

Que se logra

• Resultado: completa documentos con datos de las relaciones del contrato al generarlo.
• Caso de uso: una consultora crea un acuerdo desde un deal sin repetir manualmente los datos asociados.
• Se combina con: editar plantilla, contactos, empresas y deals.

Donde esta

• Ruta: /[orgId]/contracts/templates/[templateId]
• Acceso en UI: Template page > Variables
• Componente(s): ContractTemplateVariablesButton.tsx

Como funciona

1. Abre Variables.
2. Pulsa una variable para insertarla en la posición actual del editor o usa el icono de copia.
3. Guarda el documento.

Reglas y validaciones

• Las variables siguen siendo marcadores en la previsualización de la plantilla.
• Los valores disponibles dependen de los registros vinculados al contrato generado.

Backend

• Servicios: contract-templates (patch), contract-generate-document (create).

Relaciones

• Requiere: contrato con sus relaciones correspondientes.

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: activity-attendees-meetings modulo: actividades app: crm nombre: Invitados y enlace de reunión tipo: integracion

Invitados y enlace de reunión

Permite añadir invitados a una actividad sincronizable y crear o consultar un enlace de Google Meet.

Que se logra

• Resultado: convierte una actividad CRM en una reunión convocada con sus interesados y, en Google, con enlace de conferencia.
• Caso de uso: una agencia invita al contacto y a los watchers de un deal a la reunión de presentación sin salir del CRM.
• Se combina con: Watchers del deal y Sincronización con Google y Outlook Calendar.

Donde esta

• Ruta: /[orgId]/activities
• Acceso en UI: Activity form > Add Invites
• Componente(s): ActivityForm.tsx, ActivityInvites.tsx

Como funciona

1. Crea o edita una actividad y asigna un miembro con integración de calendario activa.
2. Selecciona Add Invites.
3. Añade invitados; el contacto relacionado y watchers del deal se sugieren cuando tienen correo.
4. Para una integración Google y una actividad pendiente, activa Add video conference.
5. Guarda; si ya existe, el formulario muestra el enlace de Google Meet.

Campos y opciones

Reglas y validaciones

• Los invitados no se habilitan si no hay integración de calendario activa para el responsable.
• La actividad completada no ofrece la creación de conferencia.

Backend

• Servicios: activities (método: create/patch), organization-users-calendar-integrations (método: find), deal-watchers (método: find)
• Efectos: los invitados y la solicitud de conferencia se trasladan a la actividad sincronizada.

Relaciones

• Requiere: Responsable con integración activa; Google para conferencia de Meet.
• Dispara / afecta: Sincronización de calendario y watchers del deal.

Notas

• Por confirmar: soporte de enlace de reunión equivalente para Outlook.

id: activity-bulk-actions modulo: actividades app: crm nombre: Acciones masivas de actividades tipo: accion

Acciones masivas de actividades

El backend expone una capacidad de acciones masivas sobre actividades con permisos granulares.

Que se logra

• Resultado: no hay una operación de negocio verificable desde usuario; existe un servicio autorizado pero no una UI ni acciones implementadas confirmadas.
• Caso de uso: un equipo de ventas necesitaría definir las acciones y conectar una interfaz antes de operar varias actividades a la vez.

Donde esta

• Ruta: /[orgId]/activities
• Acceso en UI: Por confirmar: no se encontró un control de acciones masivas conectado en ActivitiesView.tsx.
• Componente(s): Por confirmar: no se encontró componente de UI asociado.

Como funciona

1. Por confirmar: flujo y acciones disponibles para el usuario.
2. El servicio activities-bulk-actions está registrado en el backend.

Reglas y validaciones

• Las autorizaciones granulares incluyen un manejador para activities-bulk-actions.
• Por confirmar: alcance por selección, filtros y acciones soportadas.

Backend

• Servicios: activities-bulk-actions (método: create)
• Hooks relevantes solo si cambian el comportamiento visible: autorización granular para el servicio.
• Efectos: Por confirmar: modificaciones específicas que ejecuta el servicio.

Relaciones

• Requiere: Actividades y permisos granulares.
• Dispara / afecta: Por confirmar.

Notas

• No se presenta como funcionalidad de UI completa mientras no se confirme el flujo en frontend.

id: activity-calendar modulo: actividades app: crm nombre: Calendario de actividades tipo: vista

Calendario de actividades

Consulta tareas, llamadas y reuniones del CRM en formato calendario.

Que se logra

• Resultado: sitúa el trabajo comercial y de atención en una agenda temporal que revela compromisos y huecos.
• Caso de uso: una clínica revisa las llamadas y reuniones de la semana antes de coordinar a recepción.
• Se combina con: Crear y editar actividades, Sincronización con Google y Outlook Calendar y Recordatorios.

Donde esta

• Ruta: /[orgId]/activities
• Acceso en UI: Sidebar > CRM > Activities
• Componente(s): ActivitiesView.tsx, ActivitiesCalendarView.tsx

Como funciona

1. Abre Activities.
2. Consulta el calendario y actividades existentes.
3. Crea o actualiza una actividad desde el flujo disponible.

Reglas y validaciones

• Por confirmar: los filtros y vistas exactos disponibles.

Backend

• Servicios: activities, activity-types (método: find/create/patch/remove)

Relaciones

• Requiere: Contactos, Compañías o Deals según la actividad.
• Dispara / afecta: Timeline CRM y recordatorios.

Notas

• El backend incluye procesamiento de recordatorios.

id: activity-relationships modulo: actividades app: crm nombre: Vincular actividades al CRM tipo: accion

Vincular actividades al CRM

Asocia una actividad a un contacto, compañía, deal y responsable para conservar el contexto comercial.

Que se logra

• Resultado: cada acción pendiente queda visible desde los registros CRM que motivaron el trabajo.
• Caso de uso: una inmobiliaria vincula una visita con el comprador, la constructora y la oportunidad para no perder seguimiento.
• Se combina con: Contactos, Compañías, Deals e Invitados y enlace de reunión.

Donde esta

• Ruta: /[orgId]/activities y perfiles CRM relacionados
• Acceso en UI: Activity form > selección de registros relacionados
• Componente(s): ActivityForm.tsx, ActivityRelatedSelection.tsx, ActivitiesView.tsx

Como funciona

1. Abre la creación o edición de una actividad.
2. Selecciona el contacto, compañía, deal y miembro responsable cuando aplique.
3. Guarda la actividad.
4. Desde la lista, abre los enlaces del contacto, compañía o deal asociados.

Reglas y validaciones

• Una actividad puede iniciarse desde un perfil CRM con el contacto, compañía o deal ya seleccionado.
• El contacto principal y los watchers del deal se usan como sugerencias de invitación cuando tienen correo.

Backend

• Servicios: activities (método: create/get/patch/find), contacts, companies, deals y organizations-users (método: find/get)
• Hooks relevantes solo si cambian el comportamiento visible: la consulta rápida adjunta los registros relacionados.
• Efectos: incluye la actividad en los perfiles y el timeline de sus registros.

Relaciones

• Requiere: Contactos, Compañías, Deals y miembros de organización.
• Dispara / afecta: Invitaciones, sincronización de calendario y timeline CRM.

Notas

• La actividad no exige una relación CRM en el formulario encontrado.

id: activity-reminders modulo: actividades app: crm nombre: Recordatorios de actividades tipo: automatizacion

Recordatorios de actividades

El backend incluye un proceso dedicado para evaluar y enviar recordatorios de actividades.

Que se logra

• Resultado: no hay un envío de recordatorios verificable todavía; la superficie actual solo expone un servicio sin lógica de procesamiento observable.
• Caso de uso: una clínica necesitaría una configuración y un procesador funcional antes de usarlo para recordar llamadas a pacientes.

Donde esta

• Ruta: /[orgId]/activities
• Acceso en UI: Por confirmar: no se encontró una configuración visible de recordatorios en las rutas inspeccionadas.
• Componente(s): Por confirmar: no se encontró un componente de configuración asociado.

Como funciona

1. El proceso de recordatorios recibe una solicitud de ejecución.
2. La implementación actual devuelve la solicitud sin evaluar actividades ni entregar notificaciones.

Reglas y validaciones

• No hay condiciones de envío, reintento o supresión implementadas en el servicio revisado.

Backend

• Servicios: process-activity-reminders (método: create), activities (método: find/patch)
• Efectos: no se confirma el envío de notificaciones.

Relaciones

• Requiere: Actividades.
• Dispara / afecta: Recordatorios de actividades.

Notas

• El servicio actual es un marcador técnico; no debe presentarse como recordatorio operativo hasta implementar su procesamiento.

id: activity-types modulo: actividades app: crm nombre: Tipos de actividad tipo: configuracion

Tipos de actividad

El sistema dispone de tipos para clasificar actividades y cuenta con un servicio de gestión para tipos de actividad.

Que se logra

• Resultado: diferencia tareas, llamadas y reuniones para que la agenda y la sincronización reflejen la intención de cada acción.
• Caso de uso: una academia distingue sus llamadas de admisión de las reuniones informativas en la agenda del equipo.
• Se combina con: Crear y editar actividades y Sincronización con Google y Outlook Calendar.

Donde esta

• Ruta: /[orgId]/activities
• Acceso en UI: Activity form > selector de tipo
• Componente(s): ActivityForm.tsx, ActivitiesView.tsx, ActivitiesCalendarView.tsx

Como funciona

1. Crea o edita una actividad.
2. Selecciona uno de los tipos visibles: Call, Meeting, Task, Deadline, Email o Lunch.
3. La lista y el calendario muestran un icono y color según el tipo.

Reglas y validaciones

• Los tipos usados por el formulario inspeccionado están definidos en la aplicación.
• La configuración de sincronización permite elegir qué tipos se envían al calendario externo.

Backend

• Servicios: activity-types (método: find/create/patch/remove), activities (método: create/patch)
• Efectos: clasifica actividades en las vistas y sincronización.

Relaciones

• Requiere: Actividades.
• Dispara / afecta: Calendario y sincronización externa.

Notas

• Por confirmar: la ruta y UI administrativa que consume el servicio activity-types; no se encontró en la superficie autenticada inspeccionada.

id: activity-views-filters modulo: actividades app: crm nombre: Vistas, filtros y búsqueda de actividades tipo: vista

Vistas, filtros y búsqueda de actividades

Alterna entre lista y calendario, filtra por responsable o estado y busca actividades por texto.

Que se logra

• Resultado: cada miembro reduce la agenda a sus pendientes, a un responsable o a un período concreto.
• Caso de uso: un gerente de ventas revisa las reuniones pendientes de su equipo en la semana actual.
• Se combina con: Calendario de actividades y Crear y editar actividades.

Donde esta

• Ruta: /[orgId]/activities
• Acceso en UI: Activities > barra superior
• Componente(s): ActivitiesView.tsx, ActivitiesCalendarView.tsx, TeamMemberSelector.tsx

Como funciona

1. Cambia entre Calendar View y List View.
2. Selecciona un responsable desde el selector de equipo.
3. Elige Not Done, Done o todos los estados.
4. Usa Search activities para restringir los resultados.
5. En el calendario, cambia entre Month, Week y Day y navega por fechas.

Reglas y validaciones

• El responsable inicial es el usuario actual cuando está disponible.
• La preferencia de vista lista/calendario se guarda para el usuario.
• La lista se pagina con tamaños entre 10 y 50 elementos; el calendario recupera todos los resultados del período visible.

Backend

• Servicios: activities (método: find), organizations-users (método: find), users (método: patch)
• Hooks relevantes solo si cambian el comportamiento visible: la consulta rápida aporta el contacto, compañía, deal y responsable para cada actividad.
• Efectos: define las actividades visibles en ambas presentaciones.

Relaciones

• Requiere: Miembros de la organización.
• Dispara / afecta: Exportación y navegación hacia contactos, compañías y deals.

Notas

• La vista por asignado se consigue mediante el selector de responsable; no se encontró una ruta separada por asignado.

id: calendar-sync modulo: actividades app: crm nombre: Sincronización con Google y Outlook Calendar tipo: integracion

Sincronización con Google y Outlook Calendar

Conecta el calendario personal para sincronizar actividades CRM y eventos externos de acuerdo con una configuración elegida.

Que se logra

• Resultado: mantiene coordinada la agenda personal con las actividades CRM y permite consultar disponibilidad externa al planear trabajo.
• Caso de uso: una clínica asigna una llamada al asesor correcto consultando su disponibilidad y sincroniza los eventos futuros seleccionados.
• Se combina con: Crear y editar actividades, Invitados y enlace de reunión y Calendario de actividades.

Donde esta

• Ruta: /[orgId]/my-profile/calendar-sync
• Acceso en UI: My Profile > Calendar Sync > Add Account
• Componente(s): CalendarSyncSettings.tsx, ConnectCalendarDialog.tsx, CalendarIntegrationCard.tsx, ActivityForm.tsx

Como funciona

1. Abre Calendar Sync y selecciona Add Account.
2. Elige Google Calendar u Outlook Calendar.
3. Configura Two-way sync, One-way sync o View only, visibilidad y tipos de actividad.
4. Completa la autorización con el proveedor.
5. Administra conexiones activas, inactivas o con error desde la misma pantalla.

Campos y opciones

Reglas y validaciones

• Solo se sincronizan eventos futuros al conectar una cuenta.
• Una actividad pendiente solo se sincroniza si tiene responsable, integración activa y un tipo incluido en la configuración.
• Los fallos de sincronización no impiden guardar la actividad; se marca su estado de sincronización como fallido.
• Al desconectar se deja de sincronizar; una conexión inactiva se puede eliminar.

Backend

• Servicios: organization-users-calendar-integrations, calendar-sync-processor, google-calendar-webhook, outlook-calendar-webhook, organization-users-calendar-integration-events (método: find/create/patch/remove)
• Hooks relevantes solo si cambian el comportamiento visible: creación, edición, finalización y eliminación de actividades se propagan al calendario externo si aplica.
• Efectos: crea, actualiza, completa o elimina eventos externos y procesa cambios recibidos de Google u Outlook.

Relaciones

• Requiere: Perfil del usuario, miembro asignado y autorización OAuth del proveedor.
• Dispara / afecta: Actividades, invitados y enlaces de Google Meet.

Notas

• View only muestra disponibilidad durante la creación sin sincronizar.

id: complete-delete-activity modulo: actividades app: crm nombre: Completar y eliminar actividades tipo: accion

Completar y eliminar actividades

Permite marcar una actividad como realizada o eliminarla, incluyendo la actualización de su evento externo cuando corresponde.

Que se logra

• Resultado: mantiene al día la agenda CRM y, si corresponde, su reflejo en el calendario externo.
• Caso de uso: una consultora completa una llamada realizada y evita que siga apareciendo entre sus pendientes y en Google Calendar.
• Se combina con: Sincronización con Google y Outlook Calendar y Vistas, filtros y búsqueda.

Donde esta

• Ruta: /[orgId]/activities
• Acceso en UI: Activities > casilla Done; edición completa de la actividad
• Componente(s): ActivitiesView.tsx, ActivityForm.tsx

Como funciona

1. Localiza una actividad en la lista.
2. Marca o desmarca su casilla Done.
3. Abre una actividad para editarla o usar las acciones de eliminación disponibles.

Reglas y validaciones

• La vista predeterminada muestra actividades no realizadas.
• Al marcarla como realizada, la lista de no realizadas la oculta.
• Si la actividad se sincronizó con Google u Outlook, completarla actualiza su evento externo; eliminarla intenta eliminar el evento asociado.
• Los errores de sincronización no deben impedir completar ni eliminar la actividad CRM.

Backend

• Servicios: activities (método: patch/remove)
• Hooks relevantes solo si cambian el comportamiento visible: markCalendarEventDone y deleteFromCalendar propagan el cambio cuando hay una integración activa.
• Efectos: cambia estado de actividad y de evento de calendario asociado.

Relaciones

• Requiere: Actividad existente; integración de calendario solo cuando se sincronizó.
• Dispara / afecta: Lista, calendario y recordatorios.

Notas

• Por confirmar: el punto exacto de UI para eliminar una actividad dentro del formulario.

id: create-edit-activity modulo: actividades app: crm nombre: Crear y editar actividades tipo: accion

Crear y editar actividades

Crea o actualiza tareas, llamadas, reuniones y otros tipos de actividad con horario, prioridad y detalles.

Que se logra

• Resultado: transforma una próxima acción comercial en una tarea calendarizada, asignada y trazable.
• Caso de uso: una agencia programa una reunión de seguimiento, le asigna prioridad y la vincula con el deal del cliente.
• Se combina con: Vincular actividades al CRM, Invitados y enlace de reunión y Sincronización de calendario.

Donde esta

• Ruta: /[orgId]/activities
• Acceso en UI: Activities > Add Activity, tarjeta existente o creación rápida desde el calendario
• Componente(s): ActivityForm.tsx, ActivityQuickCreatePopover.tsx, ActivitiesCalendarView.tsx

Como funciona

1. Selecciona Add Activity, un bloque horario del calendario o una actividad existente.
2. Escribe el asunto y elige el tipo.
3. Define fechas, horas, prioridad y detalles opcionales.
4. Guarda con Save o actualiza con Update.

Campos y opciones

Reglas y validaciones

• Si la hora inicial supera la final en el mismo día, el formulario ajusta la hora final.
• La creación rápida de calendario usa bloques de 30 minutos y abre el formulario completo cuando se necesita.

Backend

• Servicios: activities (método: create/get/patch)
• Hooks relevantes solo si cambian el comportamiento visible: una creación o edición puede sincronizarse al calendario del responsable.
• Efectos: actualiza listas, calendario y timeline CRM.

Relaciones

• Requiere: Responsables y, opcionalmente, contactos, compañías o deals.
• Dispara / afecta: Sincronización de calendario y recordatorios.

Notas

• Por confirmar: si existen tipos de actividad adicionales creados por configuración.

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: ai-conversation-analysis modulo: ai-reports app: crm nombre: Análisis IA de conversaciones tipo: automatizacion

Análisis IA de conversaciones

Permite definir un trabajo que aplica instrucciones de IA a cada conversación que coincida con los filtros elegidos.

Que se logra

• Resultado: el equipo obtiene campos comparables extraídos de un conjunto de conversaciones reales, delimitado por los criterios operativos que elija.
• Caso de uso: un equipo de soporte analiza conversaciones de WhatsApp cerradas durante un mes para identificar motivo de contacto, resolución y sentimiento.
• Se combina con: Conversaciones, Asistentes IA, etiquetas, pipelines de deals y Seguimiento de trabajos de análisis.

Donde esta

• Ruta: /[orgId]/analytics/ai-insights
• Acceso en UI: Analytics > AI Insights > Create analysis
• Componente(s): AIAnalyticsView.tsx, CreateAnalysisJobDialog.tsx, AnalysisResultsView.tsx

Como funciona

1. Pulsar Create analysis e indicar nombre y descripción.
2. Elegir intervalo de fechas, al menos un canal y al menos un estado; opcionalmente restringir por miembros, asistentes IA, etiquetas, pipeline y etapas.
3. Agregar uno o más campos de análisis con nombre, tipo e instrucción para IA. En classification, añadir al menos dos opciones para usar el clasificador Fast; dejarlas vacías extrae etiquetas libres con Standard.
4. Crear el trabajo; desde la lista, usar Run mientras esté en borrador.
5. Cuando tenga más de una conversación procesada, pulsar View para abrir sus resultados.

Reglas y validaciones

• Los tipos de campo son text, number, classification, boolean y date.
• Cada nombre de campo debe ser único, no puede contener espacios ni caracteres fuera de letras, números y guion bajo.
• Una columna classification con 2 o más opciones, o una columna boolean, se procesa con el clasificador Fast (Jev). text, number, date y classification sin opciones usan el LLM Standard.
• El trabajo muestra Fast, Mixed o Standard según esa mezcla. Si hay columnas Standard, ellas marcan el ritmo.
• El trabajo requiere nombre, al menos un canal, al menos un estado y un campo de análisis.
• Al ejecutarlo se comprueba y debita Wallet una vez por conversación ($0.004); el motor no cambia el precio. Después se procesa de forma asíncrona.

Backend

• Servicios: analytics-ai-conversations-job (create/patch), analytics-ai-conversations-job-result (create/patch)
• Efectos: calcula las conversaciones objetivo, crea resultados por conversación y envía el trabajo a la cola de procesamiento.

Relaciones

• Requiere: conversaciones que cumplan filtros y saldo suficiente de Wallet.
• Dispara / afecta: resultados de IA y métricas agregadas del trabajo.

Notas

El diálogo puede abrirse con filtros y campos propuestos por el asistente de IA de esta sección.

id: analysis-job-monitoring modulo: ai-reports app: crm nombre: Seguimiento de trabajos de análisis tipo: vista

Seguimiento de trabajos de análisis

Muestra cada trabajo de análisis, su avance y las operaciones disponibles según su estado.

Que se logra

• Resultado: el responsable conoce cuántas conversaciones se procesaron, qué errores hubo y cuándo puede consultar o reutilizar el análisis.
• Caso de uso: una empresa de telecomunicaciones vigila el análisis de interacciones de soporte y clona la definición para evaluar el periodo siguiente.
• Se combina con: Análisis IA de conversaciones, Conversaciones y Wallet.

Donde esta

• Ruta: /[orgId]/analytics/ai-insights
• Acceso en UI: AI Insights > lista de trabajos
• Componente(s): AnalysisJobsList.tsx, AnalysisMetricsView.tsx

Como funciona

1. Entrar a Analytics > AI Insights.
2. Consultar nombre, fecha, conversaciones procesadas, errores y total.
3. Usar Edit o Run si el trabajo sigue en Draft.
4. Pulsar View cuando haya más de una conversación procesada.
5. Clonar un trabajo para reutilizar su definición o eliminarlo cuando no esté en ejecución.

Reglas y validaciones

• Los estados visibles son Draft, Running, Processing, Completed y Failed.
• Cada trabajo muestra además si corre en Fast, Mixed o Standard según sus columnas.
• La lista se suscribe por tiempo real a trabajos en Running o Processing.
• En resultados, las columnas Fast muestran confianza 0–1; las métricas incluyen promedio y conteo de baja confianza.
• No permite eliminar un trabajo que esté ejecutándose o procesándose.
• Si un trabajo en procesamiento no progresa durante 30 minutos, se marca como fallido.

Backend

• Servicios: analytics-ai-conversations-job (find/get/patch/remove), analytics-ai-conversations-job-result (find)
• Efectos: las transiciones terminales actualizan el conteo de procesadas y errores; al completarse se calculan métricas finales.

Relaciones

• Requiere: un trabajo de análisis existente.
• Dispara / afecta: resultados y métricas del análisis seleccionado.

Notas

La ejecución distribuye el procesamiento por conversación a través de SQS; la pantalla no espera ese trabajo en la petición inicial.

id: nova-report-builder modulo: ai-reports app: crm nombre: Constructor de reportes con Nova tipo: accion

Constructor de reportes con Nova

Convierte una petición escrita en páginas, widgets y vínculos de filtros. Nova prueba la fuente de datos antes de guardar un widget.

Que se logra

• Resultado: el usuario obtiene un reporte funcional desde una pregunta de negocio, con widgets cuya fuente de datos fue comprobada antes de aparecer en el lienzo.
• Caso de uso: una agencia pide comparar deals ganados por mes y Nova crea el gráfico y los filtros necesarios para explorarlo.
• Se combina con: Páginas de reportes, Filtros de página, Datos de widgets y Edición y eliminación de widgets.

Donde esta

• Ruta: /[orgId]/analytics/ai-reports
• Acceso en UI: AI Reports > Add with Nova
• Componente(s): AnalyticsReportsAddSheet.tsx, useAIReportBuilder.ts

Como funciona

1. Crear o abrir una página de reporte.
2. Pulsar Add o Add with Nova.
3. Describir el resultado esperado, por ejemplo una métrica, un gráfico comparativo o una tabla.
4. Seguir el progreso de Nova en la hoja lateral y leer su respuesta final.
5. Para cambiar un widget existente, abrir Edit with Nova, describir el ajuste y enviar.

Reglas y validaciones

• Nova puede listar, crear y actualizar páginas; crear, actualizar y eliminar widgets; y revisar sus vínculos de filtros.
• Para cada widget con datos valida la visualización, la pertenencia a la organización y que la consulta se ejecute.
• Si faltan ubicación y tamaño, el backend sitúa el widget debajo de los existentes.
• Al reemplazar filtros de página o vínculos de un widget, se sustituye la lista completa anterior.

Backend

• Servicios: ai-report-builder (create), report-pages (find/create/patch), report-widgets (find/create/patch/remove)
• Efectos: devuelve la respuesta de Nova y las acciones realizadas; el lienzo recarga las páginas y widgets afectados.

Relaciones

• Requiere: una página activa para agregar widgets; puede crear otra página si la petición lo necesita.
• Dispara / afecta: páginas, widgets, fuentes de datos y vínculos de filtros.

Notas

Nova no se utiliza para iniciar análisis de conversaciones; esa función está en AI Insights.

id: report-filters modulo: ai-reports app: crm nombre: Filtros de página tipo: configuracion

Filtros de página

Permite usar filtros definidos para la página y refresca únicamente los widgets que declararon una vinculación con ellos.

Que se logra

• Resultado: cada lector puede acotar un reporte por el periodo o dimensión configurada sin alterar los widgets que no corresponden a ese filtro.
• Caso de uso: una red de clínicas filtra una página por canal y fechas para comparar resultados de atención, manteniendo intacto un indicador global.
• Se combina con: Páginas de reportes, Datos de widgets y Constructor de reportes con Nova.

Donde esta

• Ruta: /[orgId]/analytics/ai-reports
• Acceso en UI: AI Reports > barra de filtros
• Componente(s): ReportFilterBar.tsx, useReportFilterEntityOptions.ts

Como funciona

1. Abrir una página que tenga filtros creados por Nova.
2. Elegir un intervalo de fechas, opción, varias opciones, rango numérico, texto o valor booleano en la barra superior.
3. Consultar los gráficos actualizados; un widget sin vinculación conserva sus datos.
4. Pulsar Reset para quitar los valores elegidos y volver a los valores predeterminados de la página.

Reglas y validaciones

• Las opciones de filtros de miembros, pipelines, asistentes IA y etiquetas se cargan desde la organización.
• Una página define el filtro, pero cada widget declara el campo por el que responde.
• Los filtros de fecha admiten presets y un rango personalizado.

Backend

• Servicios: report-pages (find/patch), report-widget-data (create)
• Efectos: ejecuta otra vez la consulta de cada widget vinculado con los valores aplicables.

Relaciones

• Requiere: filtros presentes en la página activa.
• Dispara / afecta: datos mostrados por los widgets vinculados.

Notas

Los valores elegidos viven en la sesión del lienzo; no se guardan como configuración de la página.

id: report-layout modulo: ai-reports app: crm nombre: Lienzo y distribución tipo: configuracion

Lienzo y distribución

Distribuye los widgets de la página activa en una cuadrícula de doce columnas y conserva su tamaño y ubicación.

Que se logra

• Resultado: cada página presenta los indicadores en una distribución que prioriza la lectura del equipo y se conserva para futuras consultas.
• Caso de uso: un gerente de operaciones coloca primero los indicadores de cumplimiento y deja las tablas de detalle debajo para las reuniones semanales.
• Se combina con: Páginas de reportes y Widgets de visualización.

Donde esta

• Ruta: /[orgId]/analytics/ai-reports
• Acceso en UI: AI Reports > lienzo
• Componente(s): ReportCanvasGrid.tsx, AnalyticsReportsCanvasView.tsx

Como funciona

1. Entrar a una página que tenga widgets.
2. Mantener el control Drag de un widget y moverlo a la posición deseada.
3. Redimensionar el widget desde la cuadrícula.
4. Continuar trabajando: el lienzo agrupa los cambios y los guarda automáticamente.

Reglas y validaciones

• El lienzo utiliza doce columnas y filas visuales de 80 píxeles.
• El guardado se demora 800 ms para agrupar varios movimientos o redimensiones.
• La posición y dimensiones se guardan por widget, no como un diseño compartido de la página.

Backend

• Servicios: report-widgets (patch)
• Efectos: los cambios se mantienen al recargar o abrir la misma página mediante enlace directo.

Relaciones

• Requiere: widgets visibles en la página activa.
• Dispara / afecta: distribución de los widgets de esa página.

Notas

Los bloques de encabezado, texto, divisor y espaciador usan el mismo sistema de cuadrícula.

id: report-pages modulo: ai-reports app: crm nombre: Páginas de reportes tipo: configuracion

Páginas de reportes

Crea pestañas independientes para separar reportes y permite cambiar su nombre directamente en el encabezado.

Que se logra

• Resultado: el equipo organiza indicadores en vistas separadas y enlazables, con una pestaña por objetivo de análisis.
• Caso de uso: un concesionario mantiene una página para ventas mensuales y otra para seguimiento de leads, sin mezclar sus widgets.
• Se combina con: Widgets de visualización, Filtros de página y Lienzo y distribución.

Donde esta

• Ruta: /[orgId]/analytics/ai-reports
• Acceso en UI: AI Reports > icono +; una página vacía muestra Create report page
• Componente(s): AnalyticsReportsCanvasView.tsx

Como funciona

1. Entrar a AI Reports.
2. Pulsar el icono + para crear una página con el nombre predeterminado.
3. Elegir una pestaña para verla; la dirección conserva la página elegida con reportPageId.
4. Pulsar el título de la pestaña activa, escribir el nuevo nombre y confirmar la edición.

Reglas y validaciones

• Las páginas se ordenan por su posición de creación.
• Crear más de una página requiere el control de plan ai_reports_multiple_pages.
• Si no existen páginas, no se puede pedir a Nova que agregue widgets.

Backend

• Servicios: report-pages (find/create/patch)
• Efectos: al crearla queda activa; sus filtros y widgets comienzan vacíos.

Relaciones

• Requiere: acceso a Analytics.
• Dispara / afecta: determina la página donde Nova crea y modifica widgets.

Notas

La eliminación de páginas no está expuesta en el lienzo actual.

id: report-widgets modulo: ai-reports app: crm nombre: Widgets de visualización tipo: configuracion

Widgets de visualización

Muestra los widgets de una página y los recarga después de una acción de Nova. Cada widget pertenece a una sola página.

Que se logra

• Resultado: una página convierte métricas o resultados de CRM en gráficos, tablas, indicadores o bloques que el equipo puede revisar en conjunto.
• Caso de uso: un equipo de ventas añade una tabla de deals abiertos y un gráfico por etapa en la misma página para priorizar su seguimiento.
• Se combina con: Constructor de reportes con Nova, Datos de widgets y Tipos de visualización.

Donde esta

• Ruta: /[orgId]/analytics/ai-reports
• Acceso en UI: AI Reports > Add o Add with Nova
• Componente(s): ReportCanvasGrid.tsx, ReportCanvasWidget.tsx

Como funciona

1. Elegir la pestaña de reporte donde se necesita el contenido.
2. Pulsar Add y describir a Nova la métrica, gráfico, tabla o bloque deseado.
3. Esperar la respuesta de Nova; el lienzo recarga los widgets de la página afectada.
4. Usar los controles al pasar el cursor sobre un widget para renombrarlo, inspeccionarlo, pedir un cambio o eliminarlo.

Reglas y validaciones

• Los widgets con datos se validan antes de guardarse; los bloques de diseño no requieren fuente de datos.
• El control ai_reports_more_widgets limita la creación; los excedentes no se renderizan y se informa cuántos quedaron ocultos.
• La organización solo puede ver o modificar sus propios widgets.

Backend

• Servicios: report-widgets (find/create/patch/remove), ai-report-builder (create)
• Efectos: Nova puede crear, actualizar o eliminar widgets y el lienzo actualiza sus datos.

Relaciones

• Requiere: una página de reporte activa.
• Dispara / afecta: filtros de página, distribución y consultas de datos.

Notas

La interfaz no ofrece un editor manual de tipo ni fuente del widget; esos cambios se solicitan a Nova.

id: visualization-types modulo: ai-reports app: crm nombre: Tipos de visualización tipo: vista

Tipos de visualización

Define cómo se representan los datos que Nova prepara para cada widget y qué bloques de contenido no requieren datos.

Que se logra

• Resultado: el resultado de una consulta se presenta en el formato que mejor comunica una tendencia, comparación, distribución, detalle o explicación.
• Caso de uso: una empresa de formación usa una métrica para inscripciones, una serie para su evolución y una tabla para revisar los cursos involucrados.
• Se combina con: Widgets de visualización, Datos de widgets y Constructor de reportes con Nova.

Donde esta

• Ruta: /[orgId]/analytics/ai-reports
• Acceso en UI: AI Reports > widgets
• Componente(s): ReportVisualizationRenderer.tsx, ReportLayoutBlock.tsx

Como funciona

1. Pedir a Nova el tipo de resultado necesario desde Add.
2. Nova guarda el tipo y la configuración compatible con las claves de datos devueltas.
3. Consultar el resultado en el lienzo y pedir un ajuste a Nova si la representación no comunica bien la métrica.

Reglas y validaciones

• Tipos con datos: metric, line, area, bar, horizontal_bar, stacked_bar, stacked_area, combo, pie, donut, scatter, gauge y table.
• combo mezcla series de barras y líneas. gauge espera un valor entre 0 y 100.
• Los bloques heading, subheading, text, divider y spacer no ejecutan una consulta.
• Las cifras admiten formato numérico, moneda, porcentaje y compacto; las tablas pueden formatear cada columna.

Backend

• Servicios: report-widgets (find/create/patch), report-widget-data (create)
• Efectos: el renderizador elige las claves de eje, serie, etiqueta y valor guardadas para el tipo.

Relaciones

• Requiere: una configuración de widget compatible con la fuente de datos.
• Dispara / afecta: presentación de las filas obtenidas por el widget.

Notas

Si un widget no tiene fuente de datos, el renderizador usa datos de ejemplo salvo en los bloques de diseño.

id: widget-data modulo: ai-reports app: crm nombre: Datos de widgets tipo: vista

Datos de widgets

Obtiene las filas de un widget con fuente de datos y las entrega al gráfico, métrica o tabla que lo representa.

Que se logra

• Resultado: cada visualización muestra datos actuales de la organización y se recalcula cuando cambia un filtro vinculado.
• Caso de uso: una empresa de servicios selecciona el último trimestre y ve actualizarse solo los widgets preparados para ese periodo.
• Se combina con: Filtros de página, Widgets de visualización y Constructor de reportes con Nova.

Donde esta

• Ruta: /[orgId]/analytics/ai-reports
• Acceso en UI: AI Reports > widget con datos
• Componente(s): ReportWidgetChart.tsx, ReportVisualizationRenderer.tsx

Como funciona

1. Abrir una página de reportes con widgets de datos.
2. El widget solicita sus filas al cargar y vuelve a solicitarlas cuando cambia un filtro que tiene vinculado.
3. Revisar la visualización; después de una operación de Nova, el lienzo fuerza una actualización de los datos.

Reglas y validaciones

• Solo se ejecutan consultas de lectura contra tablas autorizadas.
• El servicio añade el alcance de organización, limita el resultado a 1.000 filas y corta consultas que exceden 15 segundos.
• Los filtros fijos del widget se suman a los valores elegidos en la página.

Backend

• Servicios: report-widget-data (create)
• Efectos: devuelve columnas, filas, cantidad de filas y si el widget tiene una consulta.

Relaciones

• Requiere: un widget con fuente de datos válida.
• Dispara / afecta: la visualización del widget.

Notas

Los bloques de diseño no solicitan datos; se muestran con su título y contenido.

id: widget-editing modulo: ai-reports app: crm nombre: Edición y eliminación de widgets tipo: accion

Edición y eliminación de widgets

Permite cambiar el título, conocer la fuente funcional del widget, solicitar ajustes a Nova y eliminarlo con confirmación.

Que se logra

• Resultado: el equipo mantiene los indicadores útiles, comprensibles y alineados con sus preguntas sin reconstruir toda la página.
• Caso de uso: un director comercial pide a Nova desglosar un gráfico por asesor, revisa el resultado y elimina el widget anterior.
• Se combina con: Constructor de reportes con Nova, Widgets de visualización y Filtros de página.

Donde esta

• Ruta: /[orgId]/analytics/ai-reports
• Acceso en UI: AI Reports > controles al pasar sobre un widget
• Componente(s): ReportCanvasWidgetActions.tsx, ReportCanvasInlineTitle.tsx

Como funciona

1. Pasar el cursor sobre un widget para mostrar sus acciones.
2. Pulsar el título para editarlo en línea.
3. Usar Edit with Nova, escribir el ajuste solicitado y enviarlo; Nova recibe el identificador y el contexto del widget.
4. Abrir Info para ver descripción, vínculos a filtros y, si el usuario es superadmin, la consulta del widget.
5. Pulsar Delete, revisar el nombre y confirmar la eliminación.

Reglas y validaciones

• El botón para enviar a Nova permanece desactivado hasta que exista una instrucción.
• El contenido de la consulta solo se expone a superadmins y nunca para bloques de diseño.
• La eliminación usa borrado lógico.

Backend

• Servicios: report-widgets (patch/remove), ai-report-builder (create)
• Efectos: tras el cambio con Nova se recargan la página y los widgets tocados; eliminar retira el widget del lienzo.

Relaciones

• Requiere: un widget creado en la página activa.
• Dispara / afecta: título, contenido, vínculos de filtro o existencia del widget.

Notas

Info indica explícitamente cuando un widget es inmune a los filtros de página.

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: activities-completion modulo: analytics app: crm nombre: Completitud de actividades tipo: vista

Completitud de actividades

Analiza la completitud general, vencimientos, duración y resultado por tipo.

Que se logra

• Resultado: Responde qué proporción de actividades del período fue completada y dónde hay tareas pendientes.
• Caso de uso: Un call center detecta si su equipo está cerrando los seguimientos comprometidos con los prospectos.
• Se combina con: Actividades y filtros de Analytics.

Donde esta

• Ruta: /[orgId]/analytics/activities/completion
• Acceso en UI: Analytics > Activities > Completion
• Componente(s): ActivityCompletionView.tsx, CompletionSummaryCards.tsx, CompletionByTypeChart.tsx

Como funciona

1. Ajuste filtros.
2. Revise tarjetas y gráfica por tipo.

Reglas y validaciones

• Filtros: rango de fechas, tipo de actividad y miembro.

Backend

• Servicios: analytics (método: find; análisis de completitud).

Relaciones

• Requiere: Actividades.

Notas

• Muestra Overall Completion Rate, Completed Last Week, Completed Last Month, Overdue Rate, duraciones promedio y CompletionByTypeChart, que ofrece Export Excel.

id: activities-home modulo: analytics app: crm nombre: Entrada de actividades tipo: vista

Entrada de actividades

Redirige al resumen de actividades.

Que se logra

• Resultado: Lleva al análisis operativo de actividades para responder cómo está trabajando el equipo.
• Caso de uso: Una agencia comercial abre esta vista para revisar tareas, reuniones y seguimientos del período.
• Se combina con: Actividades y filtros de Analytics.

Donde esta

• Ruta: /[orgId]/analytics/activities
• Acceso en UI: Analytics > Activities
• Componente(s): page.tsx

Como funciona

1. Abra Activities.
2. El sistema reemplaza la ruta por Overview.

Reglas y validaciones

• No contiene filtros propios.

Backend

• Servicios: ninguno invocado por esta ruta.

Relaciones

• Requiere: Resumen de actividades.

Notas

• No añade métricas ni gráficas propias.

id: activities-overview modulo: analytics app: crm nombre: Resumen de actividades tipo: vista

Resumen de actividades

Resume cantidad, estado, duración y completitud de actividades.

Que se logra

• Resultado: Responde cuántas actividades se crearon, completaron o permanecen pendientes en el período.
• Caso de uso: Una clínica mide si su equipo administrativo está atendiendo las tareas que genera cada paciente.
• Se combina con: Actividades y comparación de períodos.

Donde esta

• Ruta: /[orgId]/analytics/activities/overview
• Acceso en UI: Analytics > Activities > Overview
• Componente(s): ActivityOverviewView.tsx, ActivityMetrics.tsx

Como funciona

1. Ajuste filtros.
2. Revise tarjetas y gráficas.

Reglas y validaciones

• Filtros: rango de fechas, tipo de actividad y miembro.

Backend

• Servicios: analytics (método: find; métricas, actividades por tipo y completitud).

Relaciones

• Requiere: Actividades y miembros.

Notas

• Muestra Total Activities, Completed, Pending, Overdue, tasa de completitud, duración promedio, ActivitiesByTypeChart y CompletionRateChart.

id: activities-team modulo: analytics app: crm nombre: Equipo de actividades tipo: vista

Equipo de actividades

Compara carga, estado, duración y tasa de completitud por miembro.

Que se logra

• Resultado: Responde qué miembros del equipo generan y completan más actividades.
• Caso de uso: Un equipo B2B compara la carga y cumplimiento de seguimientos entre sus ejecutivos.
• Se combina con: Actividades y filtros globales.

Donde esta

• Ruta: /[orgId]/analytics/activities/team
• Acceso en UI: Analytics > Activities > Team
• Componente(s): ActivityTeamView.tsx, TeamPerformanceTable.tsx

Como funciona

1. Ajuste filtros.
2. Consulte la tabla TeamPerformanceTable.

Reglas y validaciones

• Filtros: rango de fechas, tipo de actividad y miembro.

Backend

• Servicios: analytics (método: find; actividades por miembro).

Relaciones

• Requiere: Actividades y miembros.

Notas

• La tabla incluye desempeño y ofrece Export Excel.

id: activities-trends modulo: analytics app: crm nombre: Tendencias de actividades tipo: vista

Tendencias de actividades

Presenta el volumen, estado, duración y completitud de actividades por día y mes.

Que se logra

• Resultado: Responde cómo cambia con el tiempo el volumen de actividades y sus estados.
• Caso de uso: Una inmobiliaria detecta semanas en las que baja la creación de llamadas de seguimiento.
• Se combina con: Actividades y comparación de períodos.

Donde esta

• Ruta: /[orgId]/analytics/activities/trends
• Acceso en UI: Analytics > Activities > Trends
• Componente(s): ActivityTrendsView.tsx, DailyTrendsChart.tsx, MonthlyTrendsChart.tsx

Como funciona

1. Ajuste filtros.
2. Consulte las tendencias diaria y mensual.

Reglas y validaciones

• Filtros: rango de fechas, tipo de actividad y miembro.

Backend

• Servicios: analytics (método: find; tendencias diarias y mensuales).

Relaciones

• Requiere: Actividades.

Notas

• DailyTrendsChart y MonthlyTrendsChart disponen de Export Excel.

id: attribution-ads modulo: analytics app: crm nombre: Atribución de anuncios tipo: vista

Atribución de anuncios

Analiza contactos, conversiones y resultados procedentes de anuncios.

Que se logra

• Resultado: Responde qué anuncios originan contactos y resultados comerciales atribuibles.
• Caso de uso: Un e-commerce identifica cuál campaña publicitaria está llevando contactos que avanzan en el CRM.
• Se combina con: Atribución, Contactos y Deals.

Donde esta

• Ruta: /[orgId]/analytics/attribution/ads
• Acceso en UI: Analytics > Attribution > Ads
• Componente(s): AttributionAdsView.tsx, AttributionShared.tsx

Como funciona

1. Seleccione período y dimensión.
2. Revise métricas, cobertura, tendencia y desglose.

Reglas y validaciones

• Filtros: rango de fechas y dimensión: Source ID, Source URL o Channel.

Backend

• Servicios: analytics (método: find; resumen, cobertura, desglose y tendencias con alcance de anuncios).

Relaciones

• Requiere: Contactos con atribución de anuncios.

Notas

• Muestra AttributionMetricCards, AttributionCoverageCards, AttributionTrendsCard y AttributionBreakdownSection.

id: attribution-contacts modulo: analytics app: crm nombre: Contactos atribuidos tipo: vista

Contactos atribuidos

Lista contactos y sus datos de atribución según período y dimensión.

Que se logra

• Resultado: Responde cuántos contactos llegan por cada fuente atribuida.
• Caso de uso: Una academia compara los registros generados por sus campañas para decidir dónde invertir.
• Se combina con: Contactos, atribución UTM y anuncios.

Donde esta

• Ruta: /[orgId]/analytics/attribution/contacts
• Acceso en UI: Analytics > Attribution > Contacts
• Componente(s): AttributionContactsView.tsx, AttributionContactsTable

Como funciona

1. Seleccione período y dimensión.
2. Navegue los resultados con los controles anterior y siguiente.

Reglas y validaciones

• Filtros: rango de fechas y dimensión: fuente, canal, identificador, URL o UTM Source.
• La tabla muestra 20 contactos por página.

Backend

• Servicios: analytics (método: find; detalle de atribución).

Relaciones

• Requiere: Contactos.

Notas

• Muestra AttributionContactsTable.

id: attribution-home modulo: analytics app: crm nombre: Entrada de atribución tipo: vista

Entrada de atribución

Redirige al tablero de resumen de atribución.

Que se logra

• Resultado: Lleva al análisis de origen de contactos y resultados para evaluar la adquisición.
• Caso de uso: Una empresa de servicios entra aquí para entender qué fuentes están alimentando su CRM.
• Se combina con: Atribución, Contactos y Deals.

Donde esta

• Ruta: /[orgId]/analytics/attribution
• Acceso en UI: Analytics > Attribution
• Componente(s): page.tsx

Como funciona

1. Abra Attribution.
2. El sistema redirige a Overview.

Reglas y validaciones

• No contiene filtros propios.

Backend

• Servicios: ninguno invocado por esta ruta.

Relaciones

• Requiere: Resumen de atribución.

Notas

• No añade métricas ni gráficas propias.

id: attribution-overview modulo: analytics app: crm nombre: Resumen de atribución tipo: vista

Resumen de atribución

Relaciona adquisición, conversaciones, conversiones, deals ganados e ingresos por origen.

Que se logra

• Resultado: Responde qué canales y fuentes concentran el rendimiento atribuido del período.
• Caso de uso: Una agencia presenta a un cliente el aporte relativo de anuncios y campañas a la captación.
• Se combina con: Atribución de anuncios, UTM, Contactos y Deals.

Donde esta

• Ruta: /[orgId]/analytics/attribution/overview
• Acceso en UI: Analytics > Attribution > Overview
• Componente(s): AttributionOverviewView.tsx, AttributionShared.tsx

Como funciona

1. Elija período y dimensión.
2. Cambie entre Daily y Monthly para la tendencia.
3. Revise métricas, embudo, tendencia y desglose.

Reglas y validaciones

• Filtros: rango de fechas y dimensión: fuente, canal, campaña o UTM source.

Backend

• Servicios: analytics (método: find; resumen, embudo, desglose y tendencias de atribución).

Relaciones

• Requiere: Contactos, conversaciones y deals.

Notas

• Muestra AttributionMetricCards, AttributionFunnelCard, AttributionTrendsCard y AttributionBreakdownSection.

id: attribution-utm modulo: analytics app: crm nombre: Atribución UTM tipo: vista

Atribución UTM

Analiza la adquisición atribuida a parámetros UTM.

Que se logra

• Resultado: Responde qué combinaciones UTM generan contactos y resultados rastreables.
• Caso de uso: Un negocio de cursos compara campañas de email, redes y afiliados sin mezclar sus fuentes.
• Se combina con: Atribución, campañas y Contactos.

Donde esta

• Ruta: /[orgId]/analytics/attribution/utm
• Acceso en UI: Analytics > Attribution > UTM
• Componente(s): AttributionUtmView.tsx, AttributionShared.tsx

Como funciona

1. Seleccione período y dimensión UTM.
2. Revise la cobertura y, si hay datos UTM, las tendencias y desglose.

Reglas y validaciones

• Filtros: rango de fechas y dimensión: UTM Source, UTM Medium, UTM Campaign, UTM Term o UTM Content.
• Sin contactos UTM, no se muestran tendencia ni desglose.

Backend

• Servicios: analytics (método: find; resumen, cobertura, desglose y tendencias con alcance UTM).

Relaciones

• Requiere: Contactos con parámetros UTM.

Notas

• Muestra AttributionMetricCards, AttributionCoverageCards, AttributionTrendsCard y AttributionBreakdownSection.

id: conversations-countries modulo: analytics app: crm nombre: Países de conversaciones tipo: vista

Países de conversaciones

Desglosa las conversaciones por el país detectado a partir de su información telefónica.

Que se logra

• Resultado: Responde desde qué países se originan más conversaciones del período.
• Caso de uso: Un comercio internacional identifica mercados donde debe reforzar cobertura de atención.
• Se combina con: Conversaciones y filtros globales.

Donde esta

• Ruta: /[orgId]/analytics/conversations/countries
• Acceso en UI: Analytics > Conversations > Countries
• Componente(s): ConversationCountriesView.tsx

Como funciona

1. Aplique filtros superiores.
2. Busque un país en Search countries... o revise las gráficas y la tabla.

Reglas y validaciones

• Filtros: rango de fechas, estado, miembro, asistente de IA y canal.

Backend

• Servicios: analytics (método: find; reporte por país).

Relaciones

• Requiere: Conversaciones con número telefónico.

Notas

• Muestra Countries Detected, Phone Coverage, Top Country, Unknown Country, Top 10 Countries, Country Distribution y All Countries.

id: conversations-daily-trend modulo: analytics app: crm nombre: Tendencia diaria de conversaciones tipo: vista

Tendencia diaria de conversaciones

Presenta las variaciones diarias de volumen, canales, asignación, no leídos y seguimientos.

Que se logra

• Resultado: Responde en qué días sube o baja el volumen de conversaciones.
• Caso de uso: Un soporte técnico relaciona picos diarios de mensajes con un lanzamiento de producto.
• Se combina con: Conversaciones y comparación de períodos.

Donde esta

• Ruta: /[orgId]/analytics/conversations/daily-trend
• Acceso en UI: Analytics > Conversations > Daily Trend
• Componente(s): DailyTrendView.tsx

Como funciona

1. Seleccione el período y los filtros.
2. Consulte las gráficas por día.

Reglas y validaciones

• Filtros: rango de fechas, estado, miembro, asistente de IA y canal.

Backend

• Servicios: analytics (método: find; reporte de tendencias diarias).

Relaciones

• Requiere: Conversaciones y canales de mensajería.

Notas

• Gráficas: Daily Conversations Volume, Daily Channel Distribution, Daily Assignment Rates, Daily Unread Messages, Daily Follow-ups y Daily Assignment Breakdown.

id: conversations-home modulo: analytics app: crm nombre: Entrada de conversaciones tipo: vista

Entrada de conversaciones

La ruta de conversaciones carga directamente el tablero Conversations Overview.

Que se logra

• Resultado: Lleva a las vistas que responden cómo evoluciona y se distribuye la atención conversacional.
• Caso de uso: Un equipo de soporte abre esta entrada para revisar la operación de sus canales.
• Se combina con: Conversaciones y filtros de Analytics.

Donde esta

• Ruta: /[orgId]/analytics/conversations
• Acceso en UI: Analytics > Conversations
• Componente(s): ConversationOverviewView.tsx

Como funciona

1. Abra Conversations.
2. Revise el mismo contenido de Conversations Overview.

Reglas y validaciones

• Aplica los filtros compartidos de conversaciones.

Backend

• Servicios: analytics (método: find).

Relaciones

• Requiere: Resumen de conversaciones.

Notas

• Esta ruta no contiene una vista distinta; renderiza el resumen.

id: conversations-monthly-trend modulo: analytics app: crm nombre: Tendencia mensual de conversaciones tipo: vista

Tendencia mensual de conversaciones

Agrupa por mes el volumen, canales, asignación, no leídos y seguimientos.

Que se logra

• Resultado: Responde cómo evoluciona mes a mes la demanda de conversaciones.
• Caso de uso: Una empresa de turismo anticipa temporadas de alta consulta para planear turnos de atención.
• Se combina con: Conversaciones y comparación de períodos.

Donde esta

• Ruta: /[orgId]/analytics/conversations/monthly-trend
• Acceso en UI: Analytics > Conversations > Monthly Trend
• Componente(s): MonthlyTrendView.tsx

Como funciona

1. Ajuste el período y filtros.
2. Compare los valores mensuales de las gráficas.

Reglas y validaciones

• Filtros: rango de fechas, estado, miembro, asistente de IA y canal.

Backend

• Servicios: analytics (método: find; reporte de tendencias mensuales).

Relaciones

• Requiere: Conversaciones y canales de mensajería.

Notas

• Gráficas: Total Conversations, Channel Distribution, Assignment Rates, Unread Messages, Follow-ups y Assignment Breakdown.

id: conversations-overview modulo: analytics app: crm nombre: Resumen de conversaciones tipo: vista

Resumen de conversaciones

Resume volumen, asignación, actividad, mensajes sin leer y distribución por canal.

Que se logra

• Resultado: Responde cuántas conversaciones entran y cuál es la fotografía general de la atención.
• Caso de uso: Un negocio de delivery revisa el volumen atendido antes de ajustar la capacidad de su equipo.
• Se combina con: Conversaciones, miembros y filtros globales.

Donde esta

• Ruta: /[orgId]/analytics/conversations/overview
• Acceso en UI: Analytics > Conversations > Overview
• Componente(s): ConversationOverviewView.tsx

Como funciona

1. Ajuste los filtros superiores.
2. Revise las tarjetas y el bloque Channels.

Reglas y validaciones

• Filtros: rango de fechas, estado, miembro del equipo, asistente de IA y canal.

Backend

• Servicios: analytics (método: find; reporte de resumen de conversaciones).

Relaciones

• Requiere: Conversaciones y asistentes de IA.

Notas

• Muestra Total Conversations, Assignment, Today's Activity, Unread Messages y tarjetas de WhatsApp, Instagram y Messenger.

id: conversations-stages modulo: analytics app: crm nombre: Etapas de conversaciones tipo: vista

Etapas de conversaciones

Analiza el rendimiento de conversaciones por etapa de pipeline.

Que se logra

• Resultado: Responde en qué etapas se concentran las conversaciones y dónde se estanca la atención.
• Caso de uso: Una inmobiliaria detecta leads que permanecen demasiado tiempo en la etapa de primera respuesta.
• Se combina con: Conversaciones y automatizaciones.

Donde esta

• Ruta: /[orgId]/analytics/conversations/stages
• Acceso en UI: Analytics > Conversations > Stages Analysis
• Componente(s): ConversationStagesView.tsx

Como funciona

1. Seleccione filtros y, si procede, un pipeline.
2. Revise gráficas, análisis y detalle por etapa.

Reglas y validaciones

• Filtros: rango de fechas, estado, miembro, asistente de IA, canal y pipeline.

Backend

• Servicios: analytics (método: find; reporte de etapas del pipeline).

Relaciones

• Requiere: Conversaciones y pipelines.

Notas

• Muestra Total Conversations, Open Conversations, Avg Workload Distribution, Avg Days in Stage, gráficas de embudo, asignación, rendimiento y canales, Stages Efficiency Analysis y Stage Performance Details.

id: conversations-team modulo: analytics app: crm nombre: Equipo de conversaciones tipo: vista

Equipo de conversaciones

Muestra carga, antigüedad y estado de conversaciones asignadas por miembro.

Que se logra

• Resultado: Responde cuántas conversaciones gestiona cada agente y cómo se distribuye la carga.
• Caso de uso: Un contact center identifica asesores sobrecargados para redistribuir nuevas conversaciones.
• Se combina con: Conversaciones y miembros.

Donde esta

• Ruta: /[orgId]/analytics/conversations/team
• Acceso en UI: Analytics > Conversations > Team
• Componente(s): ConversationTeamView.tsx

Como funciona

1. Elija Unread o Waiting.
2. Ordene la tabla por sus encabezados y use Load more si hay más miembros.

Reglas y validaciones

• Filtros: rango de fechas, estado, miembro, asistente de IA, canal y pipeline.
• La vista usa páginas de hasta 50 miembros.

Backend

• Servicios: analytics (método: find; reporte por miembro).

Relaciones

• Requiere: Conversaciones, miembros y pipelines.

Notas

• Muestra Members, Assigned, Unread 24h+ o Reply 24h+, Load skew y la tabla Team members.

id: deals-home modulo: analytics app: crm nombre: Entrada de deals tipo: vista

Entrada de deals

La ruta existe, pero su componente no retorna contenido visible.

Que se logra

• Resultado: Actualmente no muestra un reporte ni datos visibles; la ruta existe como punto de navegación sin contenido.
• Caso de uso: Un equipo B2B debe abrir Overview para revisar semanalmente las oportunidades de su pipeline.
• Se combina con: Resumen de deals, Pipelines y filtros de Analytics.

Donde esta

• Ruta: /[orgId]/analytics/deals
• Acceso en UI: Analytics > Deals
• Componente(s): page.tsx

Como funciona

1. Abra Deals.

Reglas y validaciones

• La ruta no redirige ni carga una vista analítica en el código actual.

Backend

• Servicios: ninguno invocado por esta ruta.

Relaciones

• Requiere: Resumen de deals.

Notas

• La ayuda de Nova la describe como entrada del dominio, pero el código actual no renderiza esa interfaz.

id: deals-lost-analysis modulo: analytics app: crm nombre: Análisis de deals perdidos tipo: vista

Análisis de deals perdidos

Estudia volumen, valor, tiempo, causas y deals perdidos recientes.

Que se logra

• Resultado: Responde cuántos deals se pierden y cuáles son los motivos o patrones de pérdida.
• Caso de uso: Una concesionaria detecta que el precio explica la mayoría de oportunidades perdidas y ajusta su oferta.
• Se combina con: Deals, Pipelines y comparación de períodos.

Donde esta

• Ruta: /[orgId]/analytics/deals/lost-analysis
• Acceso en UI: Analytics > Deals > Lost Analysis
• Componente(s): DealLostAnalysisView.tsx

Como funciona

1. Ajuste filtros de Deals.
2. Revise resumen, tendencias, motivos y tablas.

Reglas y validaciones

• Filtros: rango de fechas, pipeline, estado y miembro del equipo.

Backend

• Servicios: analytics (método: find; análisis y tendencias de deals perdidos).

Relaciones

• Requiere: Deals perdidos y pipelines.

Notas

• Incluye LostSummaryCards, tendencias diarias y mensuales, TimeRangeDistributionChart, LostReasonsTable y RecentLossesTable; las dos últimas ofrecen Export Excel.

id: deals-overview modulo: analytics app: crm nombre: Resumen de deals tipo: vista

Resumen de deals

Resume métricas comerciales, distribución por pipeline y proporción de resultados.

Que se logra

• Resultado: Responde cuál es el valor y volumen general de oportunidades abiertas, ganadas o perdidas.
• Caso de uso: Una consultora revisa la salud comercial del período antes de proyectar ingresos.
• Se combina con: Deals, Pipelines y filtros globales.

Donde esta

• Ruta: /[orgId]/analytics/deals/overview
• Acceso en UI: Analytics > Deals > Overview
• Componente(s): DealOverviewView.tsx, DealMetrics.tsx

Como funciona

1. Ajuste filtros del dominio Deals.
2. Consulte tarjetas y gráficas.

Reglas y validaciones

• Filtros: rango de fechas, pipeline, estado y miembro del equipo.

Backend

• Servicios: analytics (método: find; métricas, pipeline y razón open/won/lost).

Relaciones

• Requiere: Deals y pipelines.

Notas

• Incluye DealMetrics, DealsPipelineChart y WinLossChart.

id: deals-products modulo: analytics app: crm nombre: Productos de deals tipo: vista

Productos de deals

Muestra la distribución y el valor de los productos asociados a deals.

Que se logra

• Resultado: Responde qué productos aparecen con mayor frecuencia o valor dentro de los deals.
• Caso de uso: Un distribuidor identifica los productos que impulsan más oportunidades comerciales.
• Se combina con: Deals, Productos y Pipelines.

Donde esta

• Ruta: /[orgId]/analytics/deals/products
• Acceso en UI: Analytics > Deals > Products
• Componente(s): DealProductsView.tsx, ProductsDistributionChart.tsx, ProductsValueChart.tsx

Como funciona

1. Ajuste los filtros de Deals.
2. Revise las dos gráficas de producto.

Reglas y validaciones

• Filtros: rango de fechas, pipeline, estado y miembro del equipo.

Backend

• Servicios: analytics (método: find; distribución y valor por producto).

Relaciones

• Requiere: Deals, productos y pipelines.

Notas

• Gráficas: ProductsDistributionChart y ProductsValueChart.

id: deals-progress modulo: analytics app: crm nombre: Progreso de deals tipo: vista

Progreso de deals

Compara la evolución diaria y mensual de cantidad, estado y valor de deals.

Que se logra

• Resultado: Responde cuánto avanza el valor de los deals a través del embudo durante el período.
• Caso de uso: Un SaaS observa si sus oportunidades están progresando hacia cierre o permanecen inmóviles.
• Se combina con: Deals, Pipelines y comparación de períodos.

Donde esta

• Ruta: /[orgId]/analytics/deals/progress
• Acceso en UI: Analytics > Deals > Progress
• Componente(s): DealProgressView.tsx, DealDailyTrendsChart.tsx, DealMonthlyTrendsChart.tsx

Como funciona

1. Ajuste filtros.
2. Revise tendencias diarias y mensuales.

Reglas y validaciones

• Filtros: rango de fechas, pipeline, estado y miembro del equipo.

Backend

• Servicios: analytics (método: find; tendencias diarias y mensuales de deals).

Relaciones

• Requiere: Deals y pipelines.

Notas

• Gráficas: DealDailyTrendsChart y DealMonthlyTrendsChart.

id: deals-stages modulo: analytics app: crm nombre: Etapas de deals tipo: vista

Etapas de deals

Analiza distribución, conversión, velocidad y cuellos de botella por etapa.

Que se logra

• Resultado: Responde cuántos deals y qué valor se concentran en cada etapa del pipeline.
• Caso de uso: Una agencia identifica cuellos de botella en la etapa de propuesta y prioriza seguimientos.
• Se combina con: Deals y Pipelines.

Donde esta

• Ruta: /[orgId]/analytics/deals/stages
• Acceso en UI: Analytics > Deals > Stages
• Componente(s): DealStagesView.tsx

Como funciona

1. Seleccione un pipeline para el análisis detallado.
2. Revise las tarjetas, gráficas, análisis y tabla de etapas.

Reglas y validaciones

• Filtros: rango de fechas, pipeline, estado y miembro del equipo.
• Con varios pipelines, el embudo y el detalle solicitan elegir uno específico.

Backend

• Servicios: analytics (método: find; etapas, velocidad y cuellos de botella).

Relaciones

• Requiere: Deals y pipelines.

Notas

• Muestra Total Deals, Total Value, Avg Conversion Rate, Avg Days in Stage, Stage Velocity Analysis, Stage Performance Details, embudo, distribución y eficiencia.

id: deals-team modulo: analytics app: crm nombre: Equipo de deals tipo: vista

Equipo de deals

Muestra la evolución mensual y estadísticas de deals por miembro.

Que se logra

• Resultado: Responde cuántos deals maneja, gana o pierde cada miembro del equipo comercial.
• Caso de uso: Una empresa de software compara la producción comercial de sus account executives.
• Se combina con: Deals, miembros y Pipelines.

Donde esta

• Ruta: /[orgId]/analytics/deals/team
• Acceso en UI: Analytics > Deals > Team
• Componente(s): DealTeamView.tsx, TeamMonthlyChart.tsx, TeamStatsChart.tsx

Como funciona

1. Ajuste filtros de Deals.
2. Consulte las gráficas disponibles por miembro.

Reglas y validaciones

• Filtros: rango de fechas, pipeline, estado y miembro del equipo.

Backend

• Servicios: analytics (método: find; estadísticas mensuales y de equipo).

Relaciones

• Requiere: Deals, miembros y pipelines.

Notas

• Muestra TeamMonthlyChart y TeamStatsChart. TeamPerformanceChart y TeamValueChart están importados pero no se renderizan.

id: deals-won-analysis modulo: analytics app: crm nombre: Análisis de deals ganados tipo: vista

Análisis de deals ganados

Estudia volumen, valor, tiempo de cierre y deals ganados recientes.

Que se logra

• Resultado: Responde cuántos deals se ganan, por qué valor y con qué patrones de cierre.
• Caso de uso: Un proveedor B2B identifica qué tipo de oportunidad termina convirtiéndose con mayor frecuencia.
• Se combina con: Deals, Productos y Pipelines.

Donde esta

• Ruta: /[orgId]/analytics/deals/won-analysis
• Acceso en UI: Analytics > Deals > Won Analysis
• Componente(s): DealWonAnalysisView.tsx

Como funciona

1. Ajuste filtros de Deals.
2. Revise el resumen, las tendencias, distribución y la tabla.

Reglas y validaciones

• Filtros: rango de fechas, pipeline, estado y miembro del equipo.

Backend

• Servicios: analytics (método: find; análisis y tendencias de deals ganados).

Relaciones

• Requiere: Deals ganados y pipelines.

Notas

• Incluye WonSummaryCards, WonDailyTrendsChart, WonMonthlyTrendsChart, TimeRangeDistributionChart y RecentWinsTable; esta última ofrece Export Excel.

id: export-analytics modulo: analytics app: crm nombre: Exportar datos de Analytics tipo: vista

Exportar datos de Analytics

Algunas tablas y gráficas permiten descargar sus datos como archivo Excel.

Que se logra

• Resultado: Los datos de la vista analítica se pueden llevar fuera de Apex para compartirlos o trabajarlos después.
• Caso de uso: Una agencia exporta el desempeño de deals para preparar el informe mensual de un cliente.
• Se combina con: Todas las vistas de Analytics.

Donde esta

• Ruta: vistas de tendencias, equipo, completitud y análisis de deals.
• Acceso en UI: botón Export Excel dentro del componente correspondiente.
• Componente(s): DailyTrendsChart.tsx, MonthlyTrendsChart.tsx, TeamPerformanceTable.tsx, CompletionByTypeChart.tsx, RecentWinsTable.tsx, LostReasonsTable.tsx, RecentLossesTable.tsx

Como funciona

1. Abra una vista que muestre Export Excel.
2. Aplique filtros si necesita limitar los datos.
3. Seleccione Export Excel.

Reglas y validaciones

• La disponibilidad no es global: aparece solo en los componentes enumerados.

Backend

• Servicios: ninguno; la exportación se prepara en el navegador con los datos cargados.

Relaciones

• Requiere: Tendencias de actividades, equipo de actividades, completitud de actividades o análisis de deals.

Notas

• No se detectó una exportación transversal para todas las vistas de Analytics.

id: global-filters modulo: analytics app: crm nombre: Filtros de Analytics tipo: vista

Filtros de Analytics

Los tableros disponen de filtros específicos por dominio para acotar los resultados.

Que se logra

• Resultado: Responde una misma pregunta analítica para el período, equipo o alcance elegido sin cambiar de reporte.
• Caso de uso: Un gerente limita todas las vistas al trimestre y a una sede antes de tomar decisiones.
• Se combina con: Todas las vistas de Analytics.

Donde esta

• Ruta: /[orgId]/analytics/{conversations,deals,quotes,activities,attribution}/**
• Acceso en UI: barras superiores de cada dominio.
• Componente(s): TopBar.tsx, DateRangeSelector.tsx

Como funciona

1. Abra una vista de Analytics.
2. Ajuste el rango de fechas y los selectores disponibles.
3. La vista vuelve a consultar sus métricas y gráficas.

Reglas y validaciones

• Conversaciones: rango, estado, miembro, asistente de IA, canal y en algunas vistas pipeline.
• Deals: rango, pipeline, estado y miembro.
• Quotes: rango, estado, miembro y producto.
• Actividades: rango, tipo de actividad y miembro.
• Atribución: rango y dimensión.

Backend

• Servicios: analytics (método: find).

Relaciones

• Requiere: las vistas de Analytics.

Notas

• No todos los selectores están presentes en todas las vistas; consulte su ficha individual.

id: period-comparison modulo: analytics app: crm nombre: Comparativa de períodos tipo: vista

Comparativa de períodos

El resumen de quotes calcula indicadores de cambio frente al período anterior.

Que se logra

• Resultado: Responde si el desempeño actual mejora o empeora frente a otro período equivalente.
• Caso de uso: Un e-commerce compara las conversaciones de esta semana con la anterior tras una promoción.
• Se combina con: Conversaciones, Deals, Quotes y Actividades.

Donde esta

• Ruta: /[orgId]/analytics/quotes/overview
• Acceso en UI: Analytics > Quotes > Overview > QuotesMetrics
• Componente(s): QuotesMetrics.tsx

Como funciona

1. Seleccione un rango de fechas en Quotes.
2. Revise el indicador de cambio de las tarjetas.

Reglas y validaciones

• Se compara el rango seleccionado con el período anterior.

Backend

• Servicios: analytics (método: find; métricas del resumen de estimates).

Relaciones

• Requiere: Resumen de quotes.

Notas

• No se detectó un selector de comparación manual común a todos los tableros.

id: quotes-accepted-analysis modulo: analytics app: crm nombre: Análisis de quotes aceptadas tipo: vista

Análisis de quotes aceptadas

Analiza valor, tiempo de aceptación, tendencia y quotes aceptadas recientes.

Que se logra

• Resultado: Responde cuántas quotes son aceptadas y qué productos o valores participan en esas aceptaciones.
• Caso de uso: Un proveedor industrial identifica las propuestas que sus clientes aprueban con mayor frecuencia.
• Se combina con: Quotes, Productos y Deals.

Donde esta

• Ruta: /[orgId]/analytics/quotes/accepted-analysis
• Acceso en UI: Analytics > Quotes > Accepted Analysis
• Componente(s): QuotesAcceptedView.tsx

Como funciona

1. Ajuste fecha, miembro o producto.
2. Revise tarjetas, tendencia y tabla.

Reglas y validaciones

• Filtros: rango de fechas, miembro y producto.

Backend

• Servicios: analytics (método: find; análisis de estimates aceptados).

Relaciones

• Requiere: Quotes aceptadas y productos.

Notas

• Incluye AcceptedSummaryCards, AcceptedTrendsChart y RecentAcceptedTable.

id: quotes-declined-analysis modulo: analytics app: crm nombre: Análisis de quotes rechazadas y vencidas tipo: vista

Análisis de quotes rechazadas y vencidas

Analiza conteo, valor, motivos, tendencia y quotes recientes rechazadas o vencidas.

Que se logra

• Resultado: Responde cuántas quotes se rechazan o vencen y qué resultados requieren seguimiento.
• Caso de uso: Una empresa de servicios detecta propuestas vencidas para que ventas retome el contacto.
• Se combina con: Quotes, Actividades y Deals.

Donde esta

• Ruta: /[orgId]/analytics/quotes/declined-analysis
• Acceso en UI: Analytics > Quotes > Declined Analysis
• Componente(s): QuotesDeclinedView.tsx

Como funciona

1. Ajuste fecha, miembro o producto.
2. Revise las tarjetas, tendencias y tablas.

Reglas y validaciones

• Filtros: rango de fechas, miembro y producto.

Backend

• Servicios: analytics (método: find; análisis de estimates rechazados o vencidos).

Relaciones

• Requiere: Quotes rechazadas, vencidas y productos.

Notas

• Incluye DeclinedSummaryCards, DeclinedTrendsChart, Declined Reasons Breakdown y Recent Declined & Expired Quotes.

id: quotes-home modulo: analytics app: crm nombre: Entrada de quotes tipo: vista

Entrada de quotes

Redirige al resumen de quotes.

Que se logra

• Resultado: Lleva al análisis de propuestas para responder su estado, progreso y aceptación comercial.
• Caso de uso: Un estudio creativo inicia aquí la revisión de cotizaciones enviadas durante el mes.
• Se combina con: Quotes y filtros de Analytics.

Donde esta

• Ruta: /[orgId]/analytics/quotes
• Acceso en UI: Analytics > Quotes
• Componente(s): page.tsx

Como funciona

1. Abra Quotes.
2. El sistema redirige a Overview.

Reglas y validaciones

• No contiene filtros propios.

Backend

• Servicios: ninguno invocado por esta ruta.

Relaciones

• Requiere: Resumen de quotes.

Notas

• No añade métricas ni gráficas propias.

id: quotes-overview modulo: analytics app: crm nombre: Resumen de quotes tipo: vista

Resumen de quotes

Resume quotes por valor, estado y variación frente al período anterior.

Que se logra

• Resultado: Responde cuál es el volumen, valor y distribución general de las quotes del período.
• Caso de uso: Una constructora revisa cuánto valor tiene en propuestas antes de planear su flujo de ventas.
• Se combina con: Quotes, Deals y comparación de períodos.

Donde esta

• Ruta: /[orgId]/analytics/quotes/overview
• Acceso en UI: Analytics > Quotes > Overview
• Componente(s): QuotesOverviewView.tsx, QuotesMetrics.tsx, QuotesByStatusChart.tsx

Como funciona

1. Ajuste los filtros.
2. Revise tarjetas y distribución por estado.

Reglas y validaciones

• Filtros: rango de fechas, estado, miembro y producto.

Backend

• Servicios: analytics (método: find; métricas del resumen y quotes por estado).

Relaciones

• Requiere: Quotes, productos y miembros.

Notas

• Muestra QuotesMetrics y QuotesByStatusChart; las tarjetas incluyen comparación con el período anterior.

id: quotes-products modulo: analytics app: crm nombre: Productos de quotes tipo: vista

Productos de quotes

Desglosa quotes y valores por producto.

Que se logra

• Resultado: Responde qué productos aparecen más en las cotizaciones y en qué resultados comerciales.
• Caso de uso: Un mayorista descubre qué referencias concentran las propuestas aceptadas para priorizar inventario.
• Se combina con: Quotes, Productos y análisis de aceptación.

Donde esta

• Ruta: /[orgId]/analytics/quotes/products
• Acceso en UI: Analytics > Quotes > Products
• Componente(s): QuotesProductsView.tsx, ProductsDistributionChart.tsx, ProductsValueChart.tsx

Como funciona

1. Ajuste filtros.
2. Revise gráficas y Product Details.

Reglas y validaciones

• Filtros: rango de fechas, estado, miembro y producto.

Backend

• Servicios: analytics (método: find; estimates por producto).

Relaciones

• Requiere: Quotes y productos.

Notas

• La tabla Product Details muestra cantidad, aceptadas, valor, cantidad cotizada y tasa promedio.

id: quotes-progress modulo: analytics app: crm nombre: Progreso de quotes tipo: vista

Progreso de quotes

Presenta la evolución diaria y mensual de quotes.

Que se logra

• Resultado: Responde cómo avanza el valor de las quotes desde creación hasta su resultado.
• Caso de uso: Una agencia mide si el valor de sus propuestas está convirtiéndose o quedando pendiente.
• Se combina con: Quotes, Deals y comparación de períodos.

Donde esta

• Ruta: /[orgId]/analytics/quotes/progress
• Acceso en UI: Analytics > Quotes > Progress
• Componente(s): QuotesProgressView.tsx, QuotesDailyTrendsChart.tsx, QuotesMonthlyTrendsChart.tsx

Como funciona

1. Ajuste filtros de Quotes.
2. Consulte ambas tendencias.

Reglas y validaciones

• Filtros: rango de fechas, estado, miembro y producto.

Backend

• Servicios: analytics (método: find; tendencias diaria y mensual de estimates).

Relaciones

• Requiere: Quotes.

Notas

• Gráficas: QuotesDailyTrendsChart y QuotesMonthlyTrendsChart.

id: quotes-status modulo: analytics app: crm nombre: Estado y embudo de quotes tipo: vista

Estado y embudo de quotes

Muestra las etapas del embudo y sus métricas de conversión.

Que se logra

• Resultado: Responde cuántas quotes están en cada estado, incluidas aceptadas, rechazadas o vencidas.
• Caso de uso: Un despacho de arquitectura identifica cuántas propuestas necesitan seguimiento antes de expirar.
• Se combina con: Quotes y Actividades.

Donde esta

• Ruta: /[orgId]/analytics/quotes/status
• Acceso en UI: Analytics > Quotes > Status & Funnel
• Componente(s): QuotesStatusView.tsx, QuotesConversionMetrics.tsx, QuotesFunnelChart.tsx

Como funciona

1. Ajuste fecha, miembro o producto.
2. Revise métricas y embudo.

Reglas y validaciones

• Filtros: rango de fechas, miembro y producto.

Backend

• Servicios: analytics (método: find; embudo de conversión de estimates).

Relaciones

• Requiere: Quotes y productos.

Notas

• Muestra QuotesConversionMetrics y QuotesFunnelChart.

id: quotes-team modulo: analytics app: crm nombre: Equipo de quotes tipo: vista

Equipo de quotes

Compara desempeño y valor de quotes por miembro.

Que se logra

• Resultado: Responde qué miembros crean, administran o convierten más quotes.
• Caso de uso: Un equipo comercial compara el desempeño de sus asesores en la elaboración de propuestas.
• Se combina con: Quotes, miembros y Deals.

Donde esta

• Ruta: /[orgId]/analytics/quotes/team
• Acceso en UI: Analytics > Quotes > Team
• Componente(s): QuotesTeamView.tsx, TeamPerformanceChart.tsx, TeamValueChart.tsx, TeamStatsTable.tsx

Como funciona

1. Ajuste filtros.
2. Revise gráficas y tabla por miembro.

Reglas y validaciones

• Filtros: rango de fechas, estado, miembro y producto.

Backend

• Servicios: analytics (método: find; estimates por miembro).

Relaciones

• Requiere: Quotes y miembros.

Notas

• Muestra TeamPerformanceChart, TeamValueChart y TeamStatsTable.

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: advanced-settings modulo: asistentes-ia app: crm nombre: Configuración avanzada tipo: configuracion

Configuración avanzada

Controla salida estructurada, respuesta, medios, análisis de imágenes y resumen.

Que se logra

• Resultado: el equipo ajusta cómo el modelo razona, responde y devuelve resultados para adecuarlo a una tarea de atención concreta.
• Caso de uso: una tienda con catálogo visual configura análisis de imágenes para que el asistente interprete una foto enviada por el cliente antes de orientar la conversación.
• Se combina con: Instrucciones y modos, Modelo y ajustes básicos y Herramientas internas.

Donde esta

• Ruta: /[orgId]/ai-assistant
• Acceso en UI: AI Assistant
• Componente(s): AdvancedModelOptionsDialog.tsx, JsonSchemaEditor.tsx

Como funciona

1. Abre Advanced y usa Advanced Model Configuration.
2. Selecciona Verbosity y Reasoning Effort, o usa Reset en cada ajuste y Reset All para volver a valores base.
3. Cierra con Save y pulsa Update Assistant.

Reglas y validaciones

• Verbosity se aplica a modelos GPT-5 compatibles; Reasoning Effort ofrece None, Low, Medium y High en los modelos que lo soportan.
• Las opciones avanzadas requieren plan de pago; Free muestra el botón bloqueado.
• La configuración registrada también puede incluir temperatura, Top P, máximo de tokens, secuencias de parada, análisis de imágenes, mensajes múltiples, audio y claves JSON adicionales si se configuraron desde otras secciones.

Backend

• Servicios: ai-assistants (patch) y ai-assistants-change-history (find).

Relaciones

• Requiere: plan distinto de Free para guardar el diálogo.
• Dispara / afecta: detalle y razonamiento de las respuestas.

Notas

Por confirmar: qué controles de configuración avanzada siguen visibles en AssistantSettingsForm además del diálogo.

id: ai-handoff modulo: asistentes-ia app: crm nombre: Transferencia a otro asistente tipo: configuracion

Transferencia a otro asistente

Transfiere conversaciones a otro asistente con reglas y opciones de respuesta.

Que se logra

• Resultado: una conversación pasa al asistente especializado adecuado sin perder las decisiones de asignación ni el contexto del intercambio.
• Caso de uso: una aseguradora transfiere las preguntas de cotización a un asistente comercial y los siniestros a otro configurado para soporte.
• Se combina con: Gestión de asistentes, Transferencia a personas y Herramientas internas.

Donde esta

• Ruta: /[orgId]/ai-assistant
• Acceso en UI: AI Assistant
• Componente(s): AIAssistantHandoffSection.tsx

Como funciona

1. En Handoff, añade una regla de AI Assistant Handoff.
2. Describe When should this rule be triggered? y selecciona el asistente destino; el selector permite buscar por nombre o descripción. Puedes insertar variables de contacto en la condición y en el mensaje de handoff.
3. Configura el mensaje opcional, Keep assigned human agent, Mark conversation as unread, Trigger AI reply immediately y Also send current AI reply.
4. Si hay variables de contacto y el permiso de lectura del contacto está en No Access, aparece una alerta roja.
5. Guarda mediante Update Assistant.

Campos y opciones

Reglas y validaciones

• Free permite una regla y los planes de pago más de una.
• Un asistente no puede transferirse a sí mismo; los asistentes de voz solo pueden transferir a otro asistente de voz.

Backend

• Servicios: ai-assistants (patch), ai-assistant-response y ai-assistant-response-v2.

Relaciones

• Requiere: otro asistente válido de la organización.
• Dispara / afecta: el asistente asignado y el estado de lectura de la conversación.

Notas

Por confirmar: cómo se ordenan reglas simultáneamente aplicables.

id: api-tools modulo: asistentes-ia app: crm nombre: Herramientas API tipo: integracion

Herramientas API

Crea, prueba y conecta herramientas HTTP personalizadas al asistente.

Que se logra

• Resultado: el asistente puede consultar o enviar datos a un sistema externo mediante una operación HTTP definida y probada por la organización.
• Caso de uso: un distribuidor conecta su inventario para que el asistente confirme disponibilidad antes de responder a un comprador.
• Se combina con: Herramientas internas y Servidores MCP, para cubrir datos del CRM y sistemas externos.

Donde esta

• Ruta: /[orgId]/ai-assistant
• Acceso en UI: AI Assistant
• Componente(s): ApiToolsGallery.tsx

Como funciona

1. En Tools > API, crea o selecciona una herramienta.
2. Define Name, Description, endpoint, método GET o POST, esquema de parámetros y, según corresponda, parámetros URL, cuerpo, headers y ejemplo de respuesta.
3. Usa la prueba de la galería antes de asociarla al asistente y describe cuándo debe utilizarse.
4. Guarda la asociación con Update Assistant.

Campos y opciones

Reglas y validaciones

• Una herramienta asociada puede aportar descripción, condición de uso y configuración por asistente.

Backend

• Servicios: api-tools (find/create/patch/remove), api-tool-testing-proxy (create), ai-assistants (patch) y respuestas IA.

Relaciones

• Requiere: endpoint HTTP disponible.
• Dispara / afecta: llamadas externas solicitadas por el asistente.

Notas

Por confirmar: restricciones de red y tiempo de espera del proxy de pruebas.

id: assistant-automations modulo: asistentes-ia app: crm nombre: Automatizaciones invocables tipo: automatizacion

Automatizaciones invocables

Asocia automatizaciones publicadas e instrucciones para que el asistente las ejecute.

Que se logra

• Resultado: el asistente puede activar un proceso publicado del negocio y usar su resultado para responder o sustituir su respuesta.
• Caso de uso: un operador turístico deja que el asistente ejecute la automatización de solicitud de reserva cuando el cliente confirma fechas y cantidad de viajeros.
• Se combina con: Automatizaciones, Herramientas internas y Seguimientos automáticos.

Donde esta

• Ruta: /[orgId]/ai-assistant
• Acceso en UI: AI Assistant
• Componente(s): AutomationsSection.tsx

Como funciona

1. En Automations, pulsa Add Automation.
2. Selecciona una automatización no añadida previamente mediante el selector por carpetas y escribe When To Use.
3. En la tarjeta, activa Pass automation output as context si la IA debe esperar el resultado; Override AI Response reemplaza la respuesta con un texto fijo.
4. Usa el ojo para ver el canvas o el enlace externo para editar el flujo. Guarda con Update Assistant.

Campos y opciones

Reglas y validaciones

• Free permite una automatización; los planes de pago permiten más.

Backend

• Servicios: ai-assistants (patch), automations (find) y ejecución de automatizaciones desde la respuesta IA.

Relaciones

• Requiere: automatizaciones existentes.
• Dispara / afecta: ejecuciones solicitadas por el asistente.

Notas

Por confirmar: si el backend restringe la selección a automatizaciones publicadas.

id: assistant-history modulo: asistentes-ia app: crm nombre: Historial y restauración tipo: vista

Historial y restauración

Consulta snapshots, compara versiones y restaura instrucciones o configuración completa.

Que se logra

• Resultado: el equipo puede auditar quién cambió la configuración y volver a una versión conocida si una modificación afecta la calidad de atención.
• Caso de uso: una empresa SaaS compara el comportamiento anterior y actual después de actualizar las instrucciones de soporte y restaura solo las instrucciones si es necesario.
• Se combina con: Instrucciones y modos, Skills del asistente y Configuración al enviar mensajes.

Donde esta

• Ruta: /[orgId]/ai-assistant
• Acceso en UI: AI Assistant
• Componente(s): AssistantHistoryDialog.tsx, AssistantVersionCompare.tsx

Como funciona

1. Desde Instructions, pulsa el icono de historial.
2. Expande una fecha y selecciona una versión para ver autor, fecha, idioma, instrucciones y configuración.
3. Usa Compare with Current o Compare para contrastarla con el estado actual.
4. Elige Restore Instructions Only o Restore Complete Configuration; la pantalla se recarga al terminar.

Reglas y validaciones

• El historial se muestra en bloques de 50 entradas, ordenado de más reciente a más antiguo.
• Las restauraciones no crean otra entrada de historial para evitar registrar la restauración como un cambio ordinario.

Backend

• Servicios: ai-assistants-change-history (find) y ai-assistants-restore-from-changes-history (create).

Relaciones

• Requiere: versiones creadas por cambios autenticados del asistente.
• Dispara / afecta: instrucciones o toda la configuración del asistente seleccionado.

Notas

Por confirmar: los permisos específicos para consultar o restaurar el historial.

id: assistant-instructions modulo: asistentes-ia app: crm nombre: Instrucciones y modos tipo: configuracion

Instrucciones y modos

Define comportamiento con Guided Mode o Blank Canvas.

Que se logra

• Resultado: cada asistente responde y decide acciones con un comportamiento definido para el idioma, tono, reglas y proceso de atención del negocio.
• Caso de uso: una agencia define en Guided Mode cómo calificar leads y cuándo escalar una consulta; su equipo técnico usa Blank Canvas para reglas más detalladas.
• Se combina con: Asistente de redacción, Herramientas internas, Skills del asistente y Configuración avanzada.

Donde esta

• Ruta: /[orgId]/ai-assistant
• Acceso en UI: AI Assistant
• Componente(s): InstructionsSection.tsx, EasyModeForm.tsx

Como funciona

1. Selecciona un asistente y abre Instructions.
2. Elige English o Spanish.
3. En Guided Mode, completa el formulario estructurado; el sistema regenera las instrucciones. En Blank Canvas, redacta Markdown directamente o usa Code y Preview.
4. Usa Insert variable para personalizar el texto con campos del contacto, por ejemplo {{contact.first_name}} o {{contact.custom_fields_by_key.membership}}. Esas variables se resuelven al responder.
5. Si insertas variables de contacto, el asistente necesita Contact Read en Advanced > Access. Si el permiso sigue en No Access, aparece una alerta roja.
6. Usa el icono de brillo para pedir una propuesta al asistente de redacción y aplica el texto resultante.
7. Guarda el panel ampliado con Save Changes o los cambios generales con Update Assistant.

Campos y opciones

Reglas y validaciones

• El cambio de Guided Mode a Blank Canvas elimina la configuración guiada y no ofrece conversión inversa.
• Nova usa Blank Canvas; el historial permite restaurar las instrucciones de una versión.
• Las variables de contacto requieren access_permissions_contact en read. Sin ese permiso, los tokens se resuelven vacíos.

Backend

• Servicios: ai-assistants (patch), ai-assistants-change-history (find) y ai-assistants-restore-from-changes-history (create).

Relaciones

• Requiere: un asistente creado.
• Dispara / afecta: la respuesta de ese asistente en conversaciones, tickets, Nova o voz.

Notas

Por confirmar: el límite operativo de longitud de las instrucciones no está validado en el schema.

id: assistant-management modulo: asistentes-ia app: crm nombre: Gestión de asistentes tipo: configuracion

Gestión de asistentes

Crea asistentes de conversación, tickets, Helpdesk, Nova y voz; desde el panel también se seleccionan, duplican o eliminan.

Que se logra

• Resultado: la organización dispone de asistentes separados por canal o función, con configuración reutilizable para atención, soporte, análisis o voz.
• Caso de uso: una empresa de software crea un asistente para ventas en Inbox y otro para tickets, evitando que ambos operen con las mismas instrucciones.
• Se combina con: Instrucciones y modos, Herramientas internas, Transferencia a personas y Configuración de voz.

Donde esta

• Ruta: /[orgId]/ai-assistant
• Acceso en UI: Sidebar > AI Assistant > Conversation | Voice | Tickets | Nova > Add Assistant
• Componente(s): AIAssistantView.tsx, AIAssistantSidebar.tsx

Como funciona

1. Expande el grupo de tipo y pulsa Add Assistant.
2. Escribe Name, escoge AI Model cuando el tipo no sea voz, selecciona Timezone y el Assistant Type.
3. Para conversación, tickets y Helpdesk elige Guided Mode o Blank Canvas; Nova y voz se crean siempre con Blank Canvas.
4. Pulsa Create Assistant; el nuevo recurso queda seleccionado y se abre en /[orgId]/ai-assistant/[assistantId].
5. Usa el lápiz para Basic Settings, el icono de copia para duplicar y el icono de papelera junto a Update Assistant para eliminar.

Campos y opciones

Reglas y validaciones

• Los modelos eliminados no aparecen; Tickets/Helpdesk requieren modelos habilitados para tickets, Nova para AI Chat y voz para Voice.
• En planes no Enterprise, la conexión se fuerza a System; una conexión Specific exige Specific OpenAI Secret Key.
• Los planes Free limitan a un asistente por tipo y el resto de límites se señalan con PremiumFeature.

Backend

• Servicios: ai-assistants (find/get/create/patch/remove).
• Efectos: genera version_id, registra historial, sincroniza asistentes de voz con Telnyx y al eliminar desasigna el asistente de conversaciones.

Relaciones

• Requiere: can_access_ai_assistant y modelos de IA configurados.
• Dispara / afecta: Inbox, Customer Service, Nova y voz.

Notas

Por confirmar: el comportamiento del tipo helpdesk no tiene una carpeta separada en el panel lateral.

id: assistant-model-settings modulo: asistentes-ia app: crm nombre: Modelo y ajustes básicos tipo: configuracion

Modelo y ajustes básicos

Configura nombre, modelo, zona horaria y conexión de IA permitida.

Que se logra

• Resultado: el asistente usa el modelo, zona horaria y conexión de IA aprobados para su función y nivel de acceso.
• Caso de uso: una empresa con varias marcas asigna modelos distintos a ventas y soporte, y restringe un asistente empresarial a una conexión específica.
• Se combina con: Gestión de asistentes, Configuración avanzada y Horario de disponibilidad.

Donde esta

• Ruta: /[orgId]/ai-assistant
• Acceso en UI: AI Assistant
• Componente(s): BasicSettingsSection.tsx

Como funciona

1. En el encabezado de Assistant Settings, pulsa el icono de lápiz.
2. Edita Name, AI Model y Timezone.
3. En Enterprise, elige Connection; si eliges Specific, introduce Specific OpenAI Secret Key.
4. Pulsa Done y termina con Update Assistant.

Campos y opciones

Reglas y validaciones

• La lista de modelos depende del tipo; voz no muestra este selector.
• Fuera de Enterprise se conserva System, aunque el registro previo tuviera otra conexión.

Backend

• Servicios: ai-assistants (patch), ai-models (find) y organizations (get).

Relaciones

• Requiere: modelos publicados para el tipo de asistente.
• Dispara / afecta: proveedor y coste de las respuestas del asistente.

Notas

Por confirmar: la interfaz no muestra el criterio exacto que clasifica una organización como Enterprise.

id: assistant-skills modulo: asistentes-ia app: crm nombre: Skills del asistente tipo: configuracion

Skills del asistente

Crea y mantiene conocimiento especializado activado bajo condiciones de uso.

Que se logra

• Resultado: el asistente recibe procedimientos y conocimiento específico solo en los escenarios en que debe aplicarlos.
• Caso de uso: una firma contable crea un skill para explicar requisitos de facturación cuando un cliente pregunta por ese trámite.
• Se combina con: Instrucciones y modos, Herramientas internas e Historial y restauración.

Donde esta

• Ruta: /[orgId]/ai-assistant
• Acceso en UI: AI Assistant
• Componente(s): SkillsSection.tsx

Como funciona

1. Abre Skills y pulsa Add Skill.
2. Escribe Skill Name, describe When To Use y redacta Skill Content.
3. Usa Insert variable en When To Use o Skill Content para personalizar con campos del contacto ({{contact.first_name}}, {{contact.custom_fields_by_key.<key>}}).
4. Alterna entre Markdown y Code; en modo código puedes abrir Preview.
5. Pulsa Add Skill; para cambiar una existente expándela, edita sus campos y pulsa Save Changes. Eliminar requiere confirmar Remove.
6. Si hay variables de contacto y el asistente no tiene Contact Read, aparece una alerta roja. Activa el permiso y guarda con Update Assistant.

Campos y opciones

Reglas y validaciones

• La creación se bloquea hasta completar los tres campos.
• El listado se carga por asistente, hasta 50 skills ordenadas por creación.

Backend

• Servicios: ai-assistant-skills (find/create/patch/remove).

Relaciones

• Requiere: asistente seleccionado.
• Dispara / afecta: contexto de respuesta del asistente.

Notas

Por confirmar: selección o prioridad de skills cuando sus condiciones se solapan.

id: availability-schedule modulo: asistentes-ia app: crm nombre: Horario de disponibilidad tipo: configuracion

Horario de disponibilidad

Define atención semanal y acciones fuera de horario.

Que se logra

• Resultado: el asistente atiende en las franjas definidas y ejecuta una respuesta o derivación previsible cuando la organización está cerrada.
• Caso de uso: un centro médico informa fuera de horario el siguiente periodo de atención o asigna la solicitud a un miembro de guardia.
• Se combina con: Transferencia a personas, Seguimientos automáticos y Modelo y ajustes básicos.

Donde esta

• Ruta: /[orgId]/ai-assistant
• Acceso en UI: AI Assistant
• Componente(s): ScheduleSection.tsx

Como funciona

1. Abre Advanced > Schedule y elige Always Available o Based on Schedule.
2. Para horario, añade franjas From/to en cada día y usa Copy to All Days cuando corresponda.
3. Fuera de horario, selecciona Send Message y redacta Not Available Message, o Assign to Team Member.
4. En handoff, define mensaje, desasignación de IA, no leído, disponibilidad, distribución general y distribución por día.
5. Pulsa Update Assistant.

Campos y opciones

Reglas y validaciones

• Elegir Always Available borra las franjas semanales de la configuración.
• El handoff con disponibilidad exige fallback válido, igual que la transferencia humana.

Backend

• Servicios: ai-assistants (patch) y respuestas de asistente para aplicar la acción fuera de horario.

Relaciones

• Requiere: miembros activos para transferir.
• Dispara / afecta: respuesta o asignación de conversaciones entrantes.

Notas

Por confirmar: la zona horaria efectiva usada por el evaluador de agenda.

id: follow-up modulo: asistentes-ia app: crm nombre: Seguimientos automáticos tipo: automatizacion

Seguimientos automáticos

Configura reglas de seguimiento cuando el cliente deja de responder.

Que se logra

• Resultado: el asistente reanuda oportunidades o solicitudes sin respuesta mediante el canal, plantilla, automatización o mensaje de IA elegido.
• Caso de uso: un concesionario envía un recordatorio de prueba de manejo por WhatsApp tras un periodo sin respuesta y limita los intentos.
• Se combina con: Plantillas de Email y WhatsApp, Automatizaciones invocables y Conversaciones.

Donde esta

• Ruta: /[orgId]/ai-assistant
• Acceso en UI: AI Assistant
• Componente(s): FollowUpSection.tsx

Como funciona

1. Activa Enable Follow Up y define Maximum Follow Ups entre 1 y 10.
2. Añade una regla con When To Assign y el número de minutos en Time After.
3. Agrega acciones de tipo Template, Automation o AI Generated Message.
4. Para template, selecciona Email o WhatsApp y una plantilla; para automatización selecciona el flujo; para IA escribe sus instrucciones.
5. Pulsa Update Assistant.

Campos y opciones

Reglas y validaciones

• Free admite una regla; los planes de pago más de una.
• Las plantillas de correo se cargan desde support-ticket-email-templates; las de WhatsApp se eligen con el selector de plantillas aprobado.
• El procesador incrementa el contador de seguimiento y evita generar dos mensajes de IA si la regla ya incluye AI Generated Message.

Backend

• Servicios: ai-assistants (patch), process-follow-ups (create), ai-conversation-follow-up (create) y plantillas/automatizaciones seleccionadas.

Relaciones

• Requiere: asistente de conversación o tickets.
• Dispara / afecta: conversaciones y tickets asignados al asistente.

Notas

Por confirmar: el planificador que decide cuándo encolar cada siguiente regla.

id: human-handoff modulo: asistentes-ia app: crm nombre: Transferencia a personas tipo: configuracion

Transferencia a personas

Define reglas para entregar conversaciones a miembros disponibles, propietarios o alternativas.

Que se logra

• Resultado: las conversaciones que requieren intervención humana llegan a una persona elegible con la asignación, etapa y señales de atención definidas.
• Caso de uso: una inmobiliaria distribuye solicitudes de visita entre asesores disponibles, pero conserva al asesor propietario cuando ya existe relación con el contacto.
• Se combina con: Horario de disponibilidad, Seguimientos automáticos, Conversaciones y pipelines de deals.

Donde esta

• Ruta: /[orgId]/ai-assistant
• Acceso en UI: AI Assistant
• Componente(s): HumanHandoffSection.tsx

Como funciona

1. En Handoff, pulsa Add Rule y expande la regla.
2. Define un Rule Name de hasta 10 caracteres con minúsculas, números o guiones bajos, y redacta When should rule be triggered?. Puedes insertar variables de contacto ({{contact.first_name}}) en la condición y en el Custom Handoff Message. Si usas variables, el asistente necesita Contact Read.
3. Añade miembros en Add agent y reparte su Weight; Auto Distribute Weight recalcula pesos al agregar o modificar integrantes.
4. Decide si conserva un miembro ya asignado, asigna al propietario del contacto, desasigna el agente IA y marca la conversación como no leída.
5. Opcionalmente selecciona Pipeline y Stage, y configura disponibilidad y fallback. Guarda con Update Assistant.

Campos y opciones

Reglas y validaciones

• Free permite una regla; los planes de pago permiten más.
• Si se respeta disponibilidad, el fallback puede dejar sin asignar, mantener IA, usar un usuario de respaldo o el propietario del contacto. Un fallback de usuario debe pertenecer a la organización.
• Para asistentes de voz, cada miembro elegido debe ser un agente de voz activo.

Backend

• Servicios: ai-assistants (patch) y ai-assistant-response / ai-assistant-response-v2 (procesan el handoff).

Relaciones

• Requiere: miembros activos; pipeline y etapa son opcionales.
• Dispara / afecta: asignación, estado de lectura y etapa de la conversación.

Notas

Por confirmar: la prioridad cuando coinciden varias reglas.

id: instruction-writing-assistant modulo: asistentes-ia app: crm nombre: Asistente de redacción tipo: accion

Asistente de redacción

Ayuda a redactar, revisar o diagramar instrucciones antes de aplicarlas.

Que se logra

• Resultado: el responsable puede convertir una necesidad operativa en instrucciones revisables sin reemplazar directamente la configuración vigente.
• Caso de uso: una clínica describe cómo debe manejar consultas de urgencia y recibe una propuesta antes de aplicarla al asistente de recepción.
• Se combina con: Instrucciones y modos y Herramientas internas, cuyas definiciones se incluyen en el contexto de la propuesta.

Donde esta

• Ruta: /[orgId]/ai-assistant
• Acceso en UI: AI Assistant
• Componente(s): AssistantInstructionsAIAssistant.tsx

Como funciona

1. En el editor de Instructions, pulsa el icono de brillo.
2. Describe el cambio que quieres hacer; el asistente recibe las instrucciones actuales, la configuración del asistente y las definiciones de sus herramientas internas activadas.
3. Revisa la propuesta y aplícala al editor; después guarda las instrucciones o pulsa Update Assistant.

Reglas y validaciones

• En el panel expandido, la propuesta se aplica a ese borrador y requiere Save Changes.

Backend

• Servicios: servicio de composición de instrucciones y ai-assistants (patch).

Relaciones

• Requiere: asistente seleccionado.
• Dispara / afecta: texto de Instructions; no guarda automáticamente.

Notas

Por confirmar: el modelo y el servicio backend exactos usados por el compositor.

id: internal-tools modulo: asistentes-ia app: crm nombre: Herramientas internas tipo: configuracion

Herramientas internas

Activa herramientas nativas que el modelo puede invocar al atender una conversación o solicitud.

Que se logra

• Resultado: el asistente puede convertir una conversación en acciones verificables sobre datos de la organización, no solo redactar una respuesta.
• Caso de uso: una empresa de reservas permite al asistente consultar horarios, crear una reserva y registrar una nota del cliente sin salir de la conversación.
• Se combina con: Instrucciones y modos, Seguimientos automáticos y Automatizaciones invocables.

Donde esta

• Ruta: /[orgId]/ai-assistant
• Acceso en UI: AI Assistant > Tools > Internal
• Componente(s): AssistantSettingsForm.tsx

Como funciona

1. Abre Tools y selecciona Internal.
2. Activa Enable All o habilita únicamente las herramientas necesarias por grupo.
3. Pulsa Update Assistant para persistir la selección.

Campos y opciones

Reglas y validaciones

• El catálogo expone herramientas de Contactos (crear, buscar, leer, actualizar), Deals (crear, buscar, leer, actualizar, añadir productos), Tickets (crear, consultar, buscar y buscar conocimiento), Empresas (crear, buscar, leer, actualizar) y Mensajería (buscar conversaciones, leer conversación o mensajes, buscar mensajes, iniciar WhatsApp, buscar/enviar templates y enviar mensajes).
• También incluye Pipelines y configuración (pipelines, monedas, custom fields), Productos (buscar y leer), Actividades/Notas (crear, actualizar o eliminar), Billing (PDF de estimates e invoices), voz (voces guardadas y síntesis), Smart Links, Email Broadcast, Automatizaciones y Reservas.
• Activar una herramienta no concede permisos adicionales al asistente; limita qué acciones puede solicitar al backend.

Backend

• Servicios: ai-assistant-internal-tools-catalog (find), ai-assistants (patch), ai-assistant-response-v2 (create).

Relaciones

• Requiere: asistente seleccionado.
• Dispara / afecta: las llamadas disponibles durante la generación de respuestas.

Notas

Por confirmar: el orden y rótulos exactos de grupos en la galería, que no están en el catálogo backend.

id: mcp-assistant-configuration modulo: asistentes-ia app: crm nombre: Configuración externa por MCP tipo: integracion

Configuración externa por MCP

Permite a clientes MCP autorizados consultar y modificar asistentes de conversación y tickets.

Que se logra

• Resultado: un cliente MCP autorizado puede administrar asistentes de conversación y tickets desde su propio entorno sin repetir la configuración manualmente en la interfaz.
• Caso de uso: una empresa con un agente interno sincroniza las instrucciones y herramientas aprobadas de su asistente de soporte mediante MCP.
• Se combina con: Servidores MCP, Skills del asistente, Herramientas API e Historial y restauración.

Donde esta

• Ruta: /[orgId]/ai-assistant
• Acceso en UI: AI Assistant
• Componente(s): mcp-internal-tools (backend)

Como funciona

1. Conecta un cliente MCP autorizado a las herramientas internas de AchieveApex.
2. Consulta asistentes y sus capacidades; recupera configuración, skills, herramientas API e historial.
3. Crea asistentes o modifica instrucciones, ajustes, handoff, follow-up, herramientas internas/API y servidores MCP mediante las herramientas expuestas.

Reglas y validaciones

• La superficie no tiene pantalla propia: las operaciones están expuestas por mcp-internal-tools.
• Las herramientas conservan el alcance de la organización autenticada y los validadores de ai-assistants.

Backend

• Servicios: mcp-internal-tools (create), ai-assistants, ai-assistant-skills, api-tools y ai-assistants-change-history.

Relaciones

• Requiere: cliente MCP autenticado y autorizado.
• Dispara / afecta: la misma configuración disponible en AI Assistant.

Notas

Por confirmar: política de autorización por herramienta MCP.

id: mcp-servers modulo: asistentes-ia app: crm nombre: Servidores MCP tipo: integracion

Servidores MCP

Conecta servidores MCP y habilita herramientas remotas por asistente.

Que se logra

• Resultado: cada asistente puede usar un conjunto seleccionado de herramientas de un servidor MCP externo con las credenciales configuradas por la organización.
• Caso de uso: una empresa de logística conecta su servidor MCP para que el asistente consulte el estado de un envío durante la atención.
• Se combina con: Herramientas API, Herramientas internas y Configuración externa por MCP.

Donde esta

• Ruta: /[orgId]/ai-assistant
• Acceso en UI: AI Assistant
• Componente(s): MCPServerConnectionDialog.tsx, MCPServerCard.tsx

Como funciona

1. En Tools > MCP, pulsa conectar servidor y completa URL, Label y Description.
2. Elige OAuth 2.1, Bearer Token / API Key, Custom Headers o No Authentication.
3. Para headers, añade cada par Header/Value; para API key escribe el token.
4. Con OAuth, Connect descubre el servidor de autorización, registra el cliente, abre una ventana y canjea el código con PKCE.
5. Tras conectar, selecciona las herramientas remotas y guarda con Update Assistant.

Campos y opciones

Reglas y validaciones

• No Authentication muestra advertencia; OAuth requiere que el servidor admita registro dinámico de cliente.
• Si expira OAuth, la configuración puede indicar que necesita reautorización.

Backend

• Servicios: mcp-tool-connection-proxy (create), ai-assistants (patch) y ai-assistant-response-v2 (ejecución).

Relaciones

• Requiere: servidor MCP confiable y, para OAuth, autorización del proveedor.
• Dispara / afecta: herramientas disponibles durante la respuesta del asistente.

Notas

Por confirmar: la validación backend de URL y el tiempo de espera de la conexión.

id: message-time-configuration modulo: asistentes-ia app: crm nombre: Configuración al enviar mensajes tipo: vista

Configuración al enviar mensajes

Consulta la configuración histórica asociada a un mensaje de IA.

Que se logra

• Resultado: el equipo puede explicar una respuesta concreta con la versión de instrucciones, modelo, herramientas y reglas que estaban vigentes al enviarse.
• Caso de uso: un responsable de soporte revisa por qué un asistente escaló un ticket y comprueba la configuración histórica, sin depender de la versión actual.
• Se combina con: Historial y restauración, Instrucciones y modos y Herramientas internas.

Donde esta

• Ruta: /[orgId]/ai-assistant
• Acceso en UI: AI Assistant
• Componente(s): AssistantConfigurationAtTimeDialog.tsx

Como funciona

1. Abre la configuración histórica desde el mensaje de IA que la expone.
2. El diálogo busca la versión de historial vigente en ese momento y carga el modelo asociado.
3. Revisa instrucciones, conexión, modelo, opciones avanzadas, permisos, handoffs, automatizaciones, herramientas y agenda como una instantánea de solo lectura.

Reglas y validaciones

• No edita ni restaura; sirve para explicar con qué configuración se emitió una respuesta.

Backend

• Servicios: ai-assistants-change-history (find) y ai-models (get).

Relaciones

• Requiere: un mensaje asociado a una versión de configuración.
• Dispara / afecta: no modifica el asistente ni el mensaje.

Notas

Por confirmar: el punto exacto de UI que abre este diálogo para cada canal.

id: playground modulo: asistentes-ia app: crm nombre: Playground de texto tipo: vista

Playground de texto

Prueba asistentes de conversación y Nova con contactos y conversaciones de Playground.

Que se logra

• Resultado: el equipo puede verificar respuestas, asignaciones y acciones del asistente en una conversación aislada antes de usarlo con clientes.
• Caso de uso: un ecommerce prueba una instrucción de devolución con un contacto de ejemplo y confirma si el asistente transfiere el caso como se espera.
• Se combina con: Instrucciones y modos, Herramientas internas y Gestión de asistentes.

Donde esta

• Ruta: /[orgId]/ai-assistant
• Acceso en UI: AI Assistant
• Componente(s): AIAssistantPlayground.tsx

Como funciona

1. Selecciona un asistente y abre Playground; en Guided Mode primero cambia el panel derecho a Playground.
2. Selecciona o crea el contacto y la conversación de prueba.
3. Envía mensajes y revisa en tiempo real los cambios de conversación, asistente asignado y usuario asignado.
4. Usa System Prompt solo si eres superadmin para inspeccionar el prompt compuesto.

Reglas y validaciones

• Las conversaciones creadas por Playground son registros de conversación; no se asignan a canales externos por esta pantalla.
• El panel escucha eventos created, patched y removed de conversaciones.

Backend

• Servicios: contacts, conversations, ai-assistants, users y respuesta del asistente.

Relaciones

• Requiere: asistente de conversación o Nova seleccionado.
• Dispara / afecta: contactos y conversaciones de prueba.

Notas

Por confirmar: mecanismo exacto que distingue una conversación de Playground de una conversación productiva.

id: voice-configuration modulo: asistentes-ia app: crm nombre: Configuración de voz tipo: configuracion

Configuración de voz

Configura runtime, voz, transcripción, saludo, variables y sincronización de un asistente de voz.

Que se logra

• Resultado: la organización despliega un agente telefónico configurado para escuchar, hablar, usar herramientas y responder bajo una identidad de voz definida.
• Caso de uso: una clínica crea un agente que saluda, transcribe solicitudes de cita y consulta herramientas de reserva antes de confirmar el siguiente paso.
• Se combina con: Herramientas internas, Transferencia de voz, Widget web de voz y Calling & SMS.

Donde esta

• Ruta: /[orgId]/ai-assistant
• Acceso en UI: AI Assistant
• Componente(s): VoiceSection.tsx

Como funciona

1. Crea o selecciona un asistente de tipo Voice y abre Voice.
2. Elige runtime, proveedor, modelo y voz; configura saludo, idioma y modelo de transcripción, interrupciones y tiempos de espera.
3. Ajusta herramientas, variables dinámicas, audio de fondo, retención de datos y webhooks cuando el runtime los muestre.
4. Pulsa Update Assistant; el servicio sincroniza la configuración con Telnyx y expone estado pending, synced o error.

Reglas y validaciones

• Los runtimes admitidos son telnyx_builtin, custom_llm y openai_realtime_sip.
• El backend valida la automatización indicada para variables dinámicas y resuelve la clave de voz antes de sincronizar.

Backend

• Servicios: ai-assistants (get/patch), telnyx-ai-assistants, telnyx-ai-models, telnyx-ai-voices, telnyx-ai-transcription-languages y voice-assistant-playground.

Relaciones

• Requiere: modelo disponible para voz y configuración de Telnyx.
• Dispara / afecta: llamadas, widget de voz y handoffs de voz.

Notas

Por confirmar: campos visibles por cada runtime, ya que VoiceSection.tsx supera el límite de lectura disponible en esta revisión.

id: voice-handoff modulo: asistentes-ia app: crm nombre: Transferencia de voz tipo: configuracion

Transferencia de voz

Transfiere llamadas a agentes de voz, otros asistentes o destinos externos.

Que se logra

• Resultado: una llamada que requiere otra atención se redirige al número, SIP o destino configurado con una regla que el agente de voz puede reconocer.
• Caso de uso: una firma legal transfiere llamadas sobre casos urgentes a la línea de guardia y las consultas administrativas al conmutador.
• Se combina con: Configuración de voz, Calling & SMS y Transferencia a personas.

Donde esta

• Ruta: /[orgId]/ai-assistant
• Acceso en UI: AI Assistant
• Componente(s): ExternalHandoffTargetsSection.tsx

Como funciona

1. En el asistente de voz abre Handoff > External Handoff Targets.
2. Elige Original Caller Number o Company Number; para empresa selecciona From Number o Automatic.
3. Añade External Target, identifica su Internal Name, Caller Label y When To Use.
4. Selecciona External Number con país y número E.164, o SIP URI; establece Timeout (seconds), mensaje opcional y Enabled.
5. Guarda con Update Assistant.

Campos y opciones

Reglas y validaciones

• Solo asistentes de voz pueden guardar destinos externos.
• IDs, etiquetas y destinos no pueden repetirse. El número debe ser E.164 válido, coincidir con el país indicado y estar permitido por el canal de voz activo; la URI debe ser SIP/SIPS válida.

Backend

• Servicios: ai-assistants (patch), voice-channels (find) y flujos de voz.

Relaciones

• Requiere: canal de voz activo para aplicar países permitidos.
• Dispara / afecta: transferencias de llamadas del asistente de voz.

Notas

Por confirmar: el comportamiento del timeout al no contestar el destino.

id: voice-web-widget modulo: asistentes-ia app: crm nombre: Widget web de voz tipo: integracion

Widget web de voz

Personaliza y copia el embed del agente de voz para un sitio web.

Que se logra

• Resultado: un sitio externo ofrece una entrada de voz identificada con la marca de la organización y conectada al asistente sincronizado.
• Caso de uso: una escuela de idiomas inserta el widget en su página de cursos para que visitantes hablen con el agente y soliciten información.
• Se combina con: Configuración de voz, Sitios y S3 para el logo cargado.

Donde esta

• Ruta: /[orgId]/ai-assistant
• Acceso en UI: AI Assistant
• Componente(s): WebWidgetEmbedSection.tsx

Como funciona

1. En un asistente de voz abre Voice > Embed on your website.
2. Cuando exista el ID tras la sincronización, pulsa Copy embed code.
3. En Widget appearance ajusta tema, posición, estado inicial y textos del widget.
4. Sube un logo de imagen de hasta 5 MB o pega una URL pública; usa Clear appearance fields para limpiar los campos administrados.
5. Persiste el aspecto con Update Assistant.

Campos y opciones

Reglas y validaciones

• Sin ID del recurso de voz, no se genera embed y la UI pide guardar y esperar sincronización.
• Solo se aceptan archivos de imagen de 5 MB o menos.

Backend

• Servicios: ai-assistants (patch), s3-url-signing (create) y sincronización Telnyx.
• Efectos: el logo se sube al almacenamiento de archivos de la organización.

Relaciones

• Requiere: asistente de voz sincronizado.
• Dispara / afecta: el widget Telnyx insertado en un sitio externo.

Notas

Por confirmar: las opciones adicionales aceptadas por el widget de Telnyx.

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: activity-actions modulo: automatizaciones app: crm nombre: Acciones de actividades tipo: accion

Acciones de actividades

Agrupa acciones para actividades, Google Calendar y envíos de correo.

Que se logra

• Resultado: Crea y mantiene tareas, eventos de calendario y comunicaciones de seguimiento para que el equipo actúe en el momento adecuado.
• Caso de uso: Una correduría: cuando un deal pasa a propuesta, crea una tarea para el asesor, un evento de Google Calendar y un email de seguimiento.
• Se combina con: Trigger: deal actualizado, Deal actions y Google Calendar/Gmail.

Donde esta

• Ruta: /[orgId]/automations/[automationId]
• Acceso en UI: Automation editor > Add Node
• Componente(s): CreateActivityNode.tsx, CreateGoogleCalendarEventNode.tsx, SendGmailEmailNode.tsx

Como funciona

1. Elegir en Add Node > Activities una acción: Create Activity, Get Activities, Get Activity, Update Activity, Delete Activity, Get Google Calendar Events, Create Google Calendar Event, Send Gmail Email, Send Email (Broadcast) o Unsubscribe from email broadcast.
2. Completar los IDs, fechas, destinatarios o contenido solicitados por el nodo.
3. Conectar la salida con los pasos que consumen la actividad, evento o resultado de envío.

Reglas y validaciones

• Google Calendar y Gmail solo muestran integraciones marcadas como disponibles para automatizaciones.
• Get Google Calendar Events usa calendario, fechas y máximo de resultados; Create Google Calendar Event admite asistentes y Google Meet.
• El correo broadcast utiliza un remitente SES verificado y HTML propio o plantilla.

Backend

• Servicios: automation-node-system-create-activity, automation-node-system-get-activities, automation-node-system-get-activity, automation-node-system-update-activity, automation-node-system-delete-activity, automation-node-system-get-google-calendar-events, automation-node-system-create-google-calendar-event, automation-node-system-send-gmail-email, automation-node-system-send-email-broadcast, automation-node-system-unsubscribe-from-email-broadcast
• Efectos: crea, actualiza o elimina actividades; crea o consulta eventos; envía correo o registra una baja.

Relaciones

• Requiere: integraciones activas cuando el nodo las usa.
• Dispara / afecta: Actividades, Google Calendar, Gmail y correo broadcast.

Notas

El campo de contenido de Send Gmail Email admite versión HTML y texto plano, además de CC y BCC.

id: automation-editor modulo: automatizaciones app: crm nombre: Editor visual tipo: vista

Editor visual

Construye el flujo publicado de una automatización mediante nodos y conexiones, y permite probarlo antes de depender de un trigger.

Que se logra

• Resultado: Permite diseñar, probar, publicar y activar un proceso conectado con los datos y acciones nativas de Apex.
• Caso de uso: Una clínica configura: cuando se crea una reserva, envía WhatsApp de confirmación, crea una actividad de recordatorio y notifica al profesional.
• Se combina con: Triggers, familias de nodos, Monitoreo de ejecuciones y Visor de ejecución.

Donde esta

• Ruta: /[orgId]/automations/[automationId]
• Acceso en UI: Automations > seleccionar una automatización
• Componente(s): AutomationsView.tsx

Como funciona

1. Crear o abrir una automatización desde Automations.
2. Pulsar el nodo Start para añadir uno o más triggers; usar el + de una conexión o arrastrar desde un handle vacío para abrir Add Node.
3. Elegir un nodo del catálogo, conectarlo con la rama anterior y pulsarlo para completar su diálogo o panel lateral.
4. Seleccionar nodos para copiarlos, pegarlos o eliminarlos; el editor impide formar ciclos.
5. Añadir notas adhesivas o anotaciones de dibujo desde las herramientas del lienzo.
6. Pulsar Publish para guardar nodos y conexiones. Usar Run Execution con un payload guardado o JSON para probar y abrir el visor.
7. Activar Active para que el flujo publicado responda a triggers; Duplicate crea una copia y Download descarga el flujo.

Reglas y validaciones

• Publish guarda el lienzo actual; el interruptor Active habilita o deshabilita respuestas a triggers.
• El editor bloquea conexiones circulares. Delay aparece como Coming Soon y no se puede añadir.
• Las variables se basan en la última ejecución: primero entrada del nodo, luego el ancestro completado más próximo y, como último origen, payload inicial.

Backend

• Servicios: automations (get/patch), automation-run (create), automations-executions (create/find), automation-node-executions (find) y automation-node-* (create)
• Efectos: publicar cambia el flujo que utilizan las ejecuciones; la prueba crea una ejecución y redirige a su visor.

Relaciones

• Requiere: permiso can_access_automations.
• Dispara / afecta: triggers, ejecuciones y las acciones configuradas en cada nodo.

Notas

Una automatización bloqueada por detección de bucle se puede reactivar desde la barra solo por administradores o propietarios.

id: automation-folders modulo: automatizaciones app: crm nombre: Organización en carpetas tipo: vista

Organización en carpetas

Crea carpetas para agrupar automatizaciones y filtra la lista mediante la carpeta elegida.

Que se logra

• Resultado: Ordena flujos por equipo, proceso o área para que una organización grande pueda mantener el inventario operativo.
• Caso de uso: Una franquicia: agrupa automatizaciones de ventas, reservas y soporte para que cada responsable encuentre y mantenga su conjunto de flujos.
• Se combina con: Editor visual y el listado de Automations.

Donde esta

• Ruta: /[orgId]/automations
• Acceso en UI: Automations > barra lateral de carpetas
• Componente(s): AutomationSidebar.tsx

Como funciona

1. Entrar a Automations y abrir la barra lateral.
2. Crear una carpeta desde su control de alta e indicar el nombre.
3. Asignar una carpeta al crear o editar una automatización.
4. Elegir una carpeta para mostrar solamente los flujos de ese grupo.

Reglas y validaciones

• Una carpeta no modifica la publicación, el interruptor Active ni el flujo de sus automatizaciones.

Backend

• Servicios: automations-categories (find/create/patch/remove), automations (find/create/patch)
• Efectos: la categoría asignada determina la agrupación mostrada en la lista.

Relaciones

• Requiere: permiso can_access_automations.
• Dispara / afecta: organización visual de la lista.

Notas

Por confirmar: si eliminar una carpeta reasigna automáticamente las automatizaciones contenidas.

id: chat-with-ai modulo: automatizaciones app: crm nombre: Chat con IA tipo: accion

Chat con IA

Envía instrucciones y datos del flujo a un modelo de IA y devuelve su respuesta para los pasos siguientes.

Que se logra

• Resultado: Obtiene una salida de IA dentro del flujo para clasificar, resumir o redactar contenido que los nodos posteriores pueden usar.
• Caso de uso: Un e-commerce: cuando llega una consulta libre, la IA identifica intención y redacta una respuesta; luego el flujo envía el mensaje y crea un deal si hay interés.
• Se combina con: Mensajería de conversaciones, Flow Control y Contact actions.

Donde esta

• Ruta: /[orgId]/automations/[automationId]
• Acceso en UI: Automation editor > Add Node
• Componente(s): nodes/ChatWithAiNode/*

Como funciona

1. Elegir Chat With AI en Add Node > AI.
2. Escribir las instrucciones y el mensaje, e insertar variables del trigger o nodos anteriores.
3. Elegir el modelo disponible y guardar el nodo.

Reglas y validaciones

• La salida del modelo queda disponible para nodos posteriores.

Backend

• Servicios: automation-node-system-chat-with-ai (create), automation-node-executions (create)
• Efectos: realiza una solicitud de IA y adjunta la respuesta al payload de ejecución.

Relaciones

• Requiere: configuración de IA disponible para la organización.
• Dispara / afecta: datos de la ejecución y saldo de Wallet si el proveedor factura uso.

Notas

Cada ejecución registra en Wallet el consumo de entrada y salida de IA según los precios configurados para el modelo seleccionado; por eso el costo cambia con el modelo y los tokens utilizados.

id: company-actions modulo: automatizaciones app: crm nombre: Acciones de empresas tipo: accion

Acciones de empresas

Crea empresas o recupera una empresa concreta para usar sus datos en el flujo.

Que se logra

• Resultado: Crea o consulta empresas para que los nuevos leads y operaciones queden asociados a su cuenta comercial.
• Caso de uso: Una agencia B2B: cuando llega un formulario corporativo, crea la empresa si no existe y vincula el contacto antes de abrir una oportunidad.
• Se combina con: Trigger: formulario enviado, Contact actions y Deal actions.

Donde esta

• Ruta: /[orgId]/automations/[automationId]
• Acceso en UI: Automation editor > Add Node
• Componente(s): CreateCompanyNode.tsx, GetCompanyDialog.tsx

Como funciona

1. Elegir Create Company o Get Company en Add Node > Companies.
2. Para crear, indicar Company Name y un Owner opcional; para consultar, proporcionar Company ID.
3. Usar el registro creado o consultado en nodos posteriores.

Reglas y validaciones

• El nombre es obligatorio al crear una empresa; el ID es obligatorio al consultarla durante la ejecución.

Backend

• Servicios: automation-node-system-create-company, automation-node-system-get-company
• Efectos: crea una empresa o devuelve sus datos al payload de ejecución.

Relaciones

• Requiere: datos válidos de empresa o un ID existente.
• Dispara / afecta: Companies y nodos posteriores.

Notas

El propietario puede mapearse desde una variable.

id: contact-actions modulo: automatizaciones app: crm nombre: Acciones de contactos tipo: accion

Acciones de contactos

Agrupa los nodos que crean, buscan, consultan o actualizan contactos y distribuyen asignaciones.

Que se logra

• Resultado: Crea, localiza y actualiza contactos, incluida la distribución ponderada entre miembros, para mantener un CRM accionable.
• Caso de uso: Una inmobiliaria: al enviar un formulario, busca el contacto, actualiza sus datos y distribuye el lead entre asesores según pesos configurados.
• Se combina con: Trigger: formulario enviado, Acciones de deals y Mensajería de conversaciones.

Donde esta

• Ruta: /[orgId]/automations/[automationId]
• Acceso en UI: Automation editor > Add Node
• Componente(s): CreateContactDialog.tsx, UpdateContactNode.tsx, TeamMemberDistributionDialog.tsx

Como funciona

1. Elegir Create Contact, Update Contact, Find Contact, Get Contact o Team Member Distribution en Add Node > Contacts.
2. Completar los identificadores o criterios con texto fijo o variables del flujo.
3. Conectar la salida con el nodo que consumirá el contacto o usuario resultante.

Campos y opciones

Reglas y validaciones

• Find Contact exige un valor de búsqueda y limita el resultado a 50.
• La distribución ponderada exige que los pesos sumen 100 %.

Backend

• Servicios: automation-node-system-create-contact, automation-node-system-update-contact, automation-node-system-find-contact, automation-node-system-get-contact, automation-node-system-team-member-distribution y automation-node-executions (create)
• Efectos: crea o actualiza contactos y entrega los registros o usuario seleccionado a la ejecución.

Relaciones

• Requiere: permiso para Automatizaciones y datos válidos del contacto.
• Dispara / afecta: Contactos y nodos posteriores que reciben sus datos.

Notas

Los IDs que proceden de un trigger pueden dejarse vacíos al guardar y asignarse desde variables antes de probar.

id: conversation-ai-control modulo: automatizaciones app: crm nombre: Control de IA en conversación tipo: accion

Control de IA en conversación

Controla el contexto y la reanudación de un asistente IA dentro de una conversación.

Que se logra

• Resultado: Controla cuándo el asistente IA pierde el contexto anterior o vuelve a atender una conversación con una instrucción específica.
• Caso de uso: Un soporte técnico: cuando el ticket se resuelve, corta el contexto de IA; si el cliente responde de nuevo, reanuda la IA con instrucciones de postventa.
• Se combina con: Trigger: conversación actualizada, Mensajería de conversaciones y Asistentes IA.

Donde esta

• Ruta: /[orgId]/automations/[automationId]
• Acceso en UI: Automation editor > Add Node
• Componente(s): ConversationAIContextCutDialog.tsx, ResumeConversationWithAiNode.tsx

Como funciona

1. Elegir Cut AI Context o Resume with AI en Add Node > Conversations.
2. Indicar la conversación con un ID o variable.
3. Para reanudar, escribir una instrucción, elegir un asistente o Keep current, y decidir si responde de inmediato.

Reglas y validaciones

• Resume with AI admite Send a message now y Reset AI context.
• Si no envía ahora, la instrucción queda pendiente y se consume con el siguiente mensaje entrante.

Backend

• Servicios: automation-node-system-conversation-ai-context-cut, automation-node-system-resume-conversation-with-ai
• Efectos: borra memoria de IA o asigna/reanuda un asistente; puede producir una respuesta proactiva.

Relaciones

• Requiere: una conversación con IA accesible.
• Dispara / afecta: asignación, memoria y respuestas de asistentes IA.

Notas

Las plantillas de reanudación requieren seleccionar un asistente concreto.

id: conversation-messages modulo: automatizaciones app: crm nombre: Mensajería de conversaciones tipo: accion

Mensajería de conversaciones

Reúne los nodos para buscar, abrir, actualizar y enviar mensajes en conversaciones de los canales conectados.

Que se logra

• Resultado: Opera conversaciones omnicanal desde el flujo: busca contexto, inicia chats y envía mensajes, SMS o plantillas de WhatsApp.
• Caso de uso: Una tienda: cuando se abandona un formulario, inicia WhatsApp, envía una plantilla aprobada y actualiza la conversación para que ventas la retome.
• Se combina con: Triggers de conversación, Chat With AI y Control de IA en conversación.

Donde esta

• Ruta: /[orgId]/automations/[automationId]
• Acceso en UI: Automation editor > Add Node
• Componente(s): nodes/Conversation.tsx, SendConversationMessageNode.tsx

Como funciona

1. En Add Node > Conversations, elegir Send Message, Get Conversation, Find Conversation, Check Instagram Follower, Initiate WhatsApp, Initiate SMS, Send WhatsApp Template o Update Conversation.
2. Mapear el ID de contacto o conversación desde un trigger o nodo anterior.
3. Configurar contenido, canal, plantilla o campos de conversación y publicar el flujo.

Campos y opciones

Reglas y validaciones

• El seguimiento de Instagram exige consentimiento de mensajería; un comentario aislado no es suficiente.
• Para SMS el número saliente debe estar activo. Los adjuntos de Send Message se cargan a S3.

Backend

• Servicios: automation-node-system-send-conversation-message, automation-node-system-get-conversation, automation-node-system-find-conversation, automation-node-system-check-instagram-follower, automation-node-system-whatsapp-conversation-initiate, automation-node-system-sms-conversation-initiate, automation-node-system-send-whatsapp-template, automation-node-system-update-conversation
• Efectos: envía comunicaciones, inicia hilos o actualiza el enrutamiento de una conversación.

Relaciones

• Requiere: canales configurados y destinatarios válidos.
• Dispara / afecta: Conversaciones, Mensajes, WhatsApp, SMS e Instagram.

Notas

El selector de variables permite guardar IDs vacíos que se resolverán durante una ejecución.

id: deal-actions modulo: automatizaciones app: crm nombre: Acciones de deals tipo: accion

Acciones de deals

Agrupa las acciones para crear y modificar deals y consultar sus productos o contactos observadores.

Que se logra

• Resultado: Crea, consulta y actualiza oportunidades, productos y watchers para que el pipeline avance con señales reales del cliente.
• Caso de uso: Una empresa B2B: cuando un lead responde a una campaña, crea un deal, asigna watchers y añade los productos consultados al seguimiento comercial.
• Se combina con: Trigger: contacto creado, Búsqueda de productos y Acciones de actividades.

Donde esta

• Ruta: /[orgId]/automations/[automationId]
• Acceso en UI: Automation editor > Add Node
• Componente(s): CreateDealNode.tsx, UpdateDealDialog.tsx, GetDealsDialog.tsx

Como funciona

1. Elegir un nodo en Add Node > Deals.
2. Definir IDs y campos con valores fijos o variables de pasos anteriores.
3. Publicar y utilizar la salida de la acción en la siguiente rama.

Campos y opciones

Reglas y validaciones

• Add Deal Watcher no admite el contacto principal del deal y restaura una relación eliminada en lugar de duplicarla.

Backend

• Servicios: automation-node-system-create-deal, automation-node-system-update-deal, automation-node-system-get-deal, automation-node-system-get-deals, automation-node-system-get-deal-products, automation-node-system-get-deal-watchers, automation-node-system-add-deal-watcher
• Efectos: crea o modifica deals y sus observadores, o devuelve datos de consulta para nodos posteriores.

Relaciones

• Requiere: IDs accesibles de la organización.
• Dispara / afecta: Deals, líneas de producto y observadores.

Notas

Los nodos que reciben un ID en tiempo de ejecución validan ese valor en backend al ejecutarse.

id: estimate-actions modulo: automatizaciones app: crm nombre: Creación de estimates tipo: accion

Creación de estimates

Crea un estimate de ventas con sus líneas de producto y configuración documental.

Que se logra

• Resultado: Genera una cotización desde los datos ya capturados por el flujo, con sus líneas, moneda y plantilla.
• Caso de uso: Una empresa de servicios: cuando un prospecto acepta una propuesta por WhatsApp, crea un estimate con el servicio solicitado y lo deja listo para seguimiento.
• Se combina con: Deal actions, Búsqueda de productos y Mensajería de conversaciones.

Donde esta

• Ruta: /[orgId]/automations/[automationId]
• Acceso en UI: Automation editor > Add Node
• Componente(s): CreateEstimateDialog.tsx

Como funciona

1. Elegir Create Estimate en Add Node > Estimates.
2. Indicar Contact ID, moneda, fechas, estado, propietario y plantilla documental.
3. Añadir líneas de producto manualmente o pegar el arreglo en modo JSON; completar descuentos, notas y campos personalizados.

Reglas y validaciones

• El contacto es obligatorio y las líneas pueden configurarse en modo manual o JSON.

Backend

• Servicios: automation-node-system-create-estimate
• Efectos: crea el estimate y sus líneas para la organización.

Relaciones

• Requiere: contacto y moneda de la organización.
• Dispara / afecta: Estimates y documentos de ventas.

Notas

Por confirmar: qué estados de estimate admite el servicio en todas las configuraciones.

id: execution-monitoring modulo: automatizaciones app: crm nombre: Monitoreo de ejecuciones tipo: vista

Monitoreo de ejecuciones

Lista las ejecuciones de automatizaciones y permite abrir su recorrido, reintentar una ejecución o iniciar una prueba manual.

Que se logra

• Resultado: Da trazabilidad operativa para localizar ejecuciones, revisar su estado y volver a lanzar casos cuando la interfaz lo permite.
• Caso de uso: Un negocio de soporte: filtra ejecuciones fallidas de SLA, abre cada una y reintenta el caso después de corregir el dato del ticket.
• Se combina con: Visor de ejecución y Editor visual.

Donde esta

• Ruta: /[orgId]/automations-executions
• Acceso en UI: Automations > View Executions
• Componente(s): AutomationsExecutionsView y páginas de ejecuciones

Como funciona

1. Abrir View Executions desde la lista o desde el editor.
2. Filtrar por automatización, estado o periodo y elegir una fila.
3. Abrir la ejecución para inspeccionar el recorrido completo en Automation execution viewer.
4. Usar el control de reintento cuando la ejecución lo permita, o lanzar Run Execution desde el editor con un payload de prueba.

Reglas y validaciones

• Las ejecuciones manuales no esperan un trigger externo.
• El historial se asocia a una automatización concreta, incluida la enviada como filtro en la URL.

Backend

• Servicios: automations-executions (find/get/create/patch), automation-node-executions (find), automation-run (create)
• Efectos: crear o reintentar produce ejecuciones y estados de nodo que se pueden abrir en el visor.

Relaciones

• Requiere: permiso can_access_automations.
• Dispara / afecta: acciones de las ramas ejecutadas.

Notas

Por confirmar: qué estados concretos habilitan el botón de reintento en todas las variantes de la pantalla.

id: execution-viewer modulo: automatizaciones app: crm nombre: Visor de ejecución tipo: vista

Visor de ejecución

Reconstruye en el lienzo el flujo ejecutado y muestra el estado, la entrada, la configuración y la salida de cada nodo.

Que se logra

• Resultado: Permite explicar qué ocurrió en una ejecución concreta, qué nodo siguió el flujo y qué datos produjo.
• Caso de uso: Un equipo de operaciones: ante una reserva sin confirmación, revisa paso a paso si falló la búsqueda de horario, el mensaje o la creación de la reserva.
• Se combina con: Monitoreo de ejecuciones y Editor visual.

Donde esta

• Ruta: /[orgId]/automations-executions/viewer/[executionID]
• Acceso en UI: Automation execution viewer
• Componente(s): AutomationExecutionViewer y NodeExecutionPanel

Como funciona

1. Abrir una ejecución desde View Executions o después de Run Execution.
2. Revisar los nodos y conectores coloreados según el resultado de cada paso.
3. Pulsar un nodo para abrir su panel y comparar el payload recibido, su configuración y el resultado producido.
4. Identificar el paso con error para corregir el flujo o los valores de una futura prueba.

Reglas y validaciones

• El visor usa el flujo guardado con la ejecución y no depende del estado actual del editor.
• Los datos de variables se muestran por paso para poder seguir una rama condicional.

Backend

• Servicios: automations-executions (get), automation-node-executions (find), automations (get)
• Efectos: no ejecuta ni modifica el flujo; solo presenta el registro de la ejecución.

Relaciones

• Requiere: una ejecución accesible de la organización.
• Dispara / afecta: no produce acciones adicionales.

Notas

Por confirmar: si el visor conserva el flujo de ejecuciones muy antiguas cuando su automatización ya fue eliminada.

id: flow-control modulo: automatizaciones app: crm nombre: Control de flujo tipo: accion

Control de flujo

Agrupa los nodos que dirigen una rama o transforman datos entre acciones.

Que se logra

• Resultado: Define ramas, variables, búsquedas de referencia, transformaciones y llamadas HTTP para adaptar el flujo a cada caso.
• Caso de uso: Un operador turístico: según destino y disponibilidad, bifurca el flujo, transforma los datos del viajero y termina solo la rama que no aplica.
• Se combina con: Cualquier trigger y los nodos de CRM, conversaciones, reservas o integraciones HTTP.

Donde esta

• Ruta: /[orgId]/automations/[automationId]
• Acceso en UI: Automation editor > Add Node
• Componente(s): NodeSelectionMenu.tsx, ConditionSidebar.tsx, JavaScriptDialog.tsx

Como funciona

1. En Add Node > Flow Control, elegir Condition, HTTP, JavaScript Transform, Lookup Value, Set Variable o End.
2. Conectar el nodo a la rama; Condition abre sus salidas para cada resultado.
3. Abrir el nodo y completar sus datos antes de publicar.

Campos y opciones

Reglas y validaciones

• JavaScript Transform solo admite una función transform; bloquea imports, consola y temporizadores.
• End bloquea guardar si su JSON no es válido.
• Delay aparece como Coming Soon y no puede agregarse.

Backend

• Servicios: automation-node-http, automation-node-system-javascript, automation-node-system-lookup-value, automation-node-system-set-variable, automation-node-system-end y automation-node-executions (create)
• Efectos: la condición controla la rama; HTTP llama sistemas externos; los demás enriquecen, transforman o cierran el payload.

Relaciones

• Requiere: una automatización y valores disponibles en la ejecución.
• Dispara / afecta: la información disponible para los nodos posteriores.

Notas

El selector de variables toma datos de la última ejecución y no mezcla datos de ejecuciones distintas.

id: meta-conversions modulo: automatizaciones app: crm nombre: Conversiones de Meta tipo: accion

Conversiones de Meta

Recupera o registra atribución de Meta y envía una conversión mediante Meta CAPI.

Que se logra

• Resultado: Centraliza la atribución del contacto y registra una conversión en Meta CAPI desde el momento comercial que ocurre en Apex.
• Caso de uso: Una tienda que capta prospectos por anuncios: cuando un deal se gana, recupera la fuente del contacto y envía a Meta la conversión para medir campañas.
• Se combina con: Contact actions, Deal actions y Flow Control.

Donde esta

• Ruta: /[orgId]/automations/[automationId]
• Acceso en UI: Automation editor > Add Node
• Componente(s): GetContactSourcesDialog.tsx, SendMetaConversionDialog.tsx

Como funciona

1. Elegir Get Contact Sources, Set Contact Source o Send Meta Conversion en Add Node > Meta Conversions.
2. Para buscar atribución, mapear el contacto y escoger WhatsApp, Facebook o ambos; se puede preferir una conversación.
3. Para registrar una fuente, indicar contacto, tipo, UTM, canal, IDs Meta y metadata JSON.
4. Para convertir, elegir cómo localizar atribución, evento, canal y, para Purchase, moneda y valor.

Reglas y validaciones

• Send Meta Conversion puede omitir contactos sin anuncio Meta cuando se activa Skip if no Meta ad found.
• El resultado de Get Contact Sources expone meta_source_id, recomendado para enviar la conversión.

Backend

• Servicios: automation-node-system-get-contact-sources, automation-node-system-set-contact-sources, automation-node-system-send-meta-conversion
• Efectos: crea/actualiza atribución y envía el evento de conversión a Meta.

Relaciones

• Requiere: configuración de conversiones de Meta y atribución o identificador de contacto.
• Dispara / afecta: Contact Sources y Meta Conversions.

Notas

Purchase exige moneda y valor.

id: notes-actions modulo: automatizaciones app: crm nombre: Notas internas tipo: accion

Notas internas

Crea una nota interna asociada a un contacto o a un deal.

Que se logra

• Resultado: Deja contexto interno estructurado en el contacto o deal sin depender de que un usuario transcriba información.
• Caso de uso: Una inmobiliaria: tras una conversación calificada, guarda en el deal una nota con el presupuesto y la zona de interés para el asesor.
• Se combina con: Mensajería de conversaciones, Contact actions y Deal actions.

Donde esta

• Ruta: /[orgId]/automations/[automationId]
• Acceso en UI: Automation editor > Add Node
• Componente(s): CreateNoteNode.tsx

Como funciona

1. Elegir Create Note en Add Node > Notes.
2. Seleccionar Note Type entre deal y contact.
3. Indicar el ID correspondiente y escribir Note Content, con variables si es necesario.

Reglas y validaciones

• El contenido de la nota es obligatorio y solo se muestra el ID que corresponde al tipo elegido.

Backend

• Servicios: automation-node-system-create-note
• Efectos: crea una nota interna vinculada al contacto o deal.

Relaciones

• Requiere: un contacto o deal existente.
• Dispara / afecta: historial del contacto o deal.

Notas

La nota no envía notificaciones desde este nodo.

id: product-search modulo: automatizaciones app: crm nombre: Búsqueda de productos tipo: accion

Búsqueda de productos

Busca productos del catálogo y expone las coincidencias a los pasos siguientes.

Que se logra

• Resultado: Encuentra productos del catálogo dentro de una automatización para continuar el flujo con una opción comercial relevante.
• Caso de uso: Un distribuidor: cuando un prospecto pregunta por una categoría, busca productos por texto o semántica y usa el resultado antes de crear el deal.
• Se combina con: Chat With AI, Deal actions y Create Estimate.

Donde esta

• Ruta: /[orgId]/automations/[automationId]
• Acceso en UI: Automation editor > Add Node
• Componente(s): SearchProductDialog.tsx

Como funciona

1. Elegir Search Product en Add Node > Products.
2. Escribir Search Term, elegir AI + Text Search, AI Semantic Search Only o Text Search Only, y definir entre 1 y 50 resultados.
3. Usar los productos devueltos, incluidos sus campos personalizados, en una condición, estimate o mensaje.

Reglas y validaciones

• El término de búsqueda es obligatorio; los modos que usan IA pueden generar costo.

Backend

• Servicios: automation-node-system-search-product
• Efectos: consulta el catálogo mediante texto, búsqueda semántica o ambas.

Relaciones

• Requiere: productos de la organización.
• Dispara / afecta: datos disponibles en la ejecución.

Notas

La búsqueda semántica registra en Wallet un consumo basado en los tokens de la consulta de embeddings y el cargo incluye el margen configurado por la plataforma. La búsqueda de texto no realiza esa consulta de embeddings.

id: reservation-actions modulo: automatizaciones app: crm nombre: Acciones de reservas tipo: accion

Acciones de reservas

Consulta disponibilidad y administra reservas desde un flujo.

Que se logra

• Resultado: Consulta disponibilidad y crea, actualiza o recupera reservas como parte de una respuesta operativa automática.
• Caso de uso: Una clínica: cuando un paciente confirma por WhatsApp, consulta horarios, crea la reserva y responde con la cita confirmada.
• Se combina con: Trigger: reserva creada/actualizada, Mensajería de conversaciones y Reservations.

Donde esta

• Ruta: /[orgId]/automations/[automationId]
• Acceso en UI: Automation editor > Add Node
• Componente(s): CreateReservationDialog.tsx, UpdateReservationDialog.tsx

Como funciona

1. Elegir Get Reservations Available Slots, Create Reservation, Update Reservation o Get Reservation en Add Node > Reservations.
2. Definir servicio, fecha o ID de reserva usando datos fijos o variables.
3. Utilizar los slots devueltos antes de crear una reserva.

Reglas y validaciones

• La consulta de slots exige servicio y fecha; el recurso preferido es opcional.
• La actualización requiere ID y permite cambiar servicio, contacto, fecha, tamaño, recurso, estado, notas y campos personalizados.

Backend

• Servicios: automation-node-system-get-reservations-available-slots, automation-node-system-create-reservations, automation-node-system-update-reservations, automation-node-system-get-reservation
• Efectos: crea o modifica reservas y devuelve la disponibilidad o el registro solicitado.

Relaciones

• Requiere: servicios de reservas configurados.
• Dispara / afecta: Reservations y sus recursos.

Notas

Por confirmar: los estados disponibles dependen de la configuración de Reservations.

id: series-actions modulo: automatizaciones app: crm nombre: Acciones de Series tipo: accion

Acciones de Series

Inscribe un contacto en una Series o lo retira de una Series concreta o de todas.

Que se logra

• Resultado: Inscribe o retira contactos de una serie desde un flujo, para que las secuencias se ajusten al estado real del cliente.
• Caso de uso: Una academia: cuando un alumno reserva una demo, se suscribe a la serie de preparación; si compra, se le retira de la serie de captación.
• Se combina con: Trigger: reserva creada, Contact actions y Series.

Donde esta

• Ruta: /[orgId]/automations/[automationId]
• Acceso en UI: Automation editor > Add Node
• Componente(s): SubscribeToSeriesDialog.tsx, UnsubscribeFromSeriesDialog.tsx

Como funciona

1. Elegir Subscribe to Series o Unsubscribe from Series en Add Node > Series.
2. Mapear Contact ID.
3. Elegir una Series para suscribir o retirar; para la baja, activar Unsubscribe from all series si debe aplicarse a todas.

Reglas y validaciones

• La suscripción exige una Series y el nodo omite la acción si la Series está inactiva.

Backend

• Servicios: automation-node-system-subscribe-to-series, automation-node-system-unsubscribe-from-series
• Efectos: crea o elimina la suscripción de la Series.

Relaciones

• Requiere: contacto y Series existentes.
• Dispara / afecta: Campaigns > Series.

Notas

La baja puede ejecutarse sin elegir una Series cuando se activa la opción para todas.

id: ticket-actions modulo: automatizaciones app: crm nombre: Acciones de tickets tipo: accion

Acciones de tickets

Actualiza tickets y ejecuta acciones de Helpdesk sobre ellos.

Que se logra

• Resultado: Convierte cambios de soporte en acciones repetibles: asignación, respuesta, notas y seguimiento del ticket sin intervención manual.
• Caso de uso: Una mesa de ayuda SaaS: cuando entra un ticket prioritario, lo asigna al equipo de guardia, añade una nota interna y responde con el primer paso.
• Se combina con: Trigger: ticket de Helpdesk creado/actualizado y Mensajería de conversaciones.

Donde esta

• Ruta: /[orgId]/automations/[automationId]
• Acceso en UI: Automation editor > Add Node
• Componente(s): UpdateTicketDialog.tsx, HelpdeskTicketActionDialog.tsx

Como funciona

1. Elegir Update Ticket en Tickets, o Update Helpdesk Ticket, Assign Helpdesk Ticket, Add Helpdesk Note, Send Helpdesk Reply o Add Helpdesk Watcher en Helpdesk.
2. Mapear el ID del ticket y completar la acción: estado, prioridad, responsable, asistente IA, pipeline, nota, respuesta u observador.
3. Publicar el flujo y revisar la ejecución desde el visor.

Reglas y validaciones

• Update Ticket permite cambiar estado, prioridad, usuario, asistente IA, pipeline y etapa.

Backend

• Servicios: automation-node-system-update-ticket, automation-node-system-helpdesk-ticket-action
• Efectos: actualiza, asigna, anota, responde o añade un observador al ticket.

Relaciones

• Requiere: ticket accesible y valores válidos para la acción.
• Dispara / afecta: Tickets y Helpdesk.

Notas

Por confirmar: la lista exhaustiva de campos para cada variante de Helpdesk Ticket Action está distribuida entre sus acciones internas.

id: trigger-activity-created modulo: automatizaciones app: crm nombre: Trigger: actividad creada tipo: automatizacion

Trigger: actividad creada

Se ejecuta tras crear una actividad que coincida con los filtros de autor, responsable, tipo y finalización.

Que se logra

• Resultado: Convierte una actividad nueva en una respuesta coordinada de ventas u operación.
• Caso de uso: Una agencia: cuando se crea una llamada de seguimiento, envía al responsable un email y añade un watcher al deal relacionado.
• Se combina con: Acciones de actividades, Acciones de deals y Mensajería de conversaciones.

Donde esta

• Ruta: /[orgId]/automations/[automationId]
• Acceso en UI: Automation editor > Start node > Add Trigger
• Componente(s): ActivityCreatedConfig.tsx

Como funciona

1. En el nodo Start, agregar este trigger y abrir su configuración.
2. Definir los filtros disponibles y guardar con Save Configuration.
3. Activar el interruptor del trigger y publicar el flujo con Publish.

Campos y opciones

Reglas y validaciones

• Todos los filtros son opcionales.

Backend

• Servicios: automations-webhooks (configuración), automation-run (inicio), automations-executions (ejecución).
• Hooks relevantes: activities/hooks/automationActivityOnCreated.js.
• Efectos: una coincidencia inicia el flujo publicado con el registro o evento que produjo el trigger como datos iniciales.

Relaciones

• Requiere: una automatización publicada y el trigger activo.
• Dispara / afecta: los nodos conectados desde Start y el historial de ejecuciones.

Notas

• Los filtros vacíos equivalen a cualquier valor.

id: trigger-activity-date-based modulo: automatizaciones app: crm nombre: Trigger: fecha de actividad tipo: automatizacion

Trigger: fecha de actividad

Se ejecuta cuando llega el inicio o fin de una actividad, o un intervalo antes o después, y la actividad pasa los filtros.

Que se logra

• Resultado: Ejecuta una acción antes o después de una fecha de actividad para recordar reuniones y activar seguimiento.
• Caso de uso: Una agencia: 15 minutos antes de una reunión, envía WhatsApp al contacto; después de la fecha, crea una tarea de seguimiento si la actividad no se completó.
• Se combina con: Acciones de actividades, Mensajería de conversaciones y Acciones de deals.

Donde esta

• Ruta: /[orgId]/automations/[automationId]
• Acceso en UI: Automation editor > Start node > Add Trigger
• Componente(s): ActivityDateBasedConfig.tsx

Como funciona

1. En el nodo Start, agregar este trigger y abrir su configuración.
2. Definir los filtros disponibles y guardar con Save Configuration.
3. Activar el interruptor del trigger y publicar el flujo con Publish.

Campos y opciones

Reglas y validaciones

• Con On no se guarda intervalo.
• Fecha y hora se leen en la zona horaria de la organización. Sin hora válida, no dispara.
• El proceso se ejecuta por ventanas de un minuto, no antes del instante objetivo; deduplica entregas.
• Sin estado explícito, antes/en usa actividades no completadas; después no filtra por completada.

Backend

• Servicios: automations-webhooks (configuración), automation-run (inicio), automations-executions (ejecución).
• Hooks relevantes: cron-activity-date-based; src/lib/date-based-automation-triggers/run.js.
• Efectos: una coincidencia inicia el flujo publicado con el registro de actividad como datos iniciales.

Relaciones

• Requiere: una automatización publicada y el trigger activo.
• Dispara / afecta: los nodos conectados desde Start y el historial de ejecuciones.

Notas

• Una modificación de la fecha u hora que cambie el minuto objetivo puede originar una nueva ejecución.
• El recordatorio de producto de 10 minutos (schedule-activity-reminder) es independiente de este trigger.

id: trigger-activity-updated modulo: automatizaciones app: crm nombre: Trigger: actividad actualizada tipo: automatizacion

Trigger: actividad actualizada

Se ejecuta cuando cambia una actividad y coincide con un cambio monitorizado.

Que se logra

• Resultado: Reacciona a un cambio relevante de una tarea, reunión o llamada para cerrar el siguiente paso del proceso.
• Caso de uso: Una asesoría: cuando una actividad queda completada, crea la siguiente tarea y actualiza el deal para evitar seguimientos perdidos.
• Se combina con: Acciones de actividades y Acciones de deals.

Donde esta

• Ruta: /[orgId]/automations/[automationId]
• Acceso en UI: Automation editor > Start node > Add Trigger
• Componente(s): ActivityUpdatedConfig.tsx

Como funciona

1. En el nodo Start, agregar este trigger y abrir su configuración.
2. Definir los filtros disponibles y guardar con Save Configuration.
3. Activar el interruptor del trigger y publicar el flujo con Publish.

Campos y opciones