AchieveApex: app links

Generado desde achieveApex-Frontend/public/ai-docs el 2026-10-15. Contiene 19 archivos de la app links. Para el contexto general del producto ver apex-resumen.md.

Links

Short links branded, actividad y analitica.

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

Modulos

Funcionalidades internas

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

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

Actividad de Links

Registro de eventos individuales generados por los smart links.

Para que sirve

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

Que lo hace diferente

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

Acceso

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

Alcance tecnico

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

Funcionalidades internas

Relaciones

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

Limitaciones y notas

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

id: activity-stream modulo: activity app: links nombre: Consultar actividad de links tipo: vista

Consultar actividad de links

Muestra eventos individuales de smart links con su tipo, confianza, QR, dispositivo, país y contexto CRM.

Que se logra

• Resultado: investiga la actividad concreta detrás de una métrica y abre los registros CRM relacionados cuando existen.
• Caso de uso: un ejecutivo comprueba si un enlace de propuesta recibió visitas antes de retomar el deal.
• Se combina con: confianza y atribución, analítica y timeline CRM.

Donde esta

• Ruta: /[orgId]/links/activity
• Acceso en UI: Links > Activity``
• Componente(s): Link Activity page

Como funciona

1. Abra Activity.
2. Revise los eventos más recientes.
3. Use el contexto CRM para abrir registros relacionados cuando esté disponible.

Reglas y validaciones

• Un request técnico no prueba que un contacto específico abrió el enlace.
• Las asociaciones CRM son contexto de destinatario, no identidad verificada.

Backend

• Servicios: smart-link-events (find).

Relaciones

• Requiere: acceso a Links.
• Afecta: investigación de engagement.

id: event-confidence modulo: activity app: links nombre: Interpretar confianza y atribución tipo: vista

Interpretar confianza y atribución

Distingue solicitudes técnicas, automatización probable, interacción humana probable y evidencia verificada.

Que se logra

• Resultado: evita interpretar como apertura humana las solicitudes de crawlers, vistas previas o escáneres.
• Caso de uso: una agencia reporta resultados de campaña sin inflar el interés de prospectos por tráfico automatizado.
• Se combina con: actividad de links, atribución CRM y analítica.

Donde esta

• Ruta: /[orgId]/links/activity
• Acceso en UI: Links > Activity``
• Componente(s): Link Activity page

Como funciona

1. Abra un evento en Activity o el detalle de un link.
2. Revise su clasificación de confianza.
3. Interprete el vínculo CRM como atribución, no como confirmación de identidad.

Reglas y validaciones

• Automated probable cubre scanners, previews y crawlers conocidos.
• Human probable se basa en evidencia del bridge; Verified requiere evidencia explícita.

Backend

• Servicios: smart-link-events (find), smart-link-engagement (create).

Relaciones

• Requiere: eventos existentes.
• Afecta: lectura correcta de métricas.

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

Analítica de Links

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

Para que sirve

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

Que lo hace diferente

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

Acceso

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

Alcance tecnico

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

Funcionalidades internas

Relaciones

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

Limitaciones y notas

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

id: analytics-overview modulo: analytics app: links nombre: Ver analítica agregada tipo: vista

Ver analítica agregada

Resume métricas agregadas de todos los smart links cargados y destaca los enlaces con mayor actividad.

Que se logra

• Resultado: detecta qué enlaces concentran solicitudes, visitas humanas probables y actividad QR.
• Caso de uso: una agencia prioriza las campañas que generan interacción antes de ajustar su inversión.
• Se combina con: analítica por enlace y actividad de links.

Donde esta

• Ruta: /[orgId]/links/analytics
• Acceso en UI: Links > Analytics``
• Componente(s): Links Analytics page

Como funciona

1. Abra Analytics.
2. Revise requests, visitantes, humanos probables, automatización y QR.
3. Seleccione un enlace para profundizar.

Reglas y validaciones

• Las métricas distinguen actividad técnica de probabilidad de interacción humana.
• Los totales de enlace son de vida útil.

Backend

• Servicios: smart-links (find), smart-link-events (find).

Relaciones

• Requiere: acceso a Links.
• Afecta: seguimiento general.

id: daily-trends modulo: analytics app: links nombre: Consultar tendencia diaria por período tipo: vista

Consultar tendencia diaria por período

Grafica requests, humanos probables y actividad QR por día para el enlace seleccionado.

Que se logra

• Resultado: observa cuándo cambia la actividad de un enlace en períodos de 7, 14 o 30 días.
• Caso de uso: una agencia compara el impacto diario de un QR distribuido en una campaña reciente.
• Se combina con: analítica por enlace y actividad de links.

Donde esta

• Ruta: /[orgId]/links/[linkId]
• Acceso en UI: Smart Link Detail > 7d/14d/30d``
• Componente(s): SmartLinkDailyTrendChart.tsx

Como funciona

1. Abra el detalle de un enlace.
2. Seleccione 7d, 14d o 30d.
3. Compare las series diarias con los totales de vida útil.

Reglas y validaciones

• La tendencia se agrupa por días UTC.
• Las tarjetas de resumen no se limitan al período seleccionado.

Backend

• Servicios: smart-link-events (find con tendencia diaria).

Relaciones

• Requiere: smart link existente.
• Afecta: análisis temporal.

id: link-detail-analytics modulo: analytics app: links nombre: Analizar un smart link tipo: vista

Analizar un smart link

Muestra las métricas de vida útil, mezcla de dispositivo/país y eventos recientes de un enlace específico.

Que se logra

• Resultado: diagnostica la respuesta de una campaña concreta por actividad, país y dispositivo.
• Caso de uso: una inmobiliaria compara la respuesta móvil y los países de un enlace de propiedad compartido.
• Se combina con: tendencia diaria, Activity y atribución CRM.

Donde esta

• Ruta: /[orgId]/links/[linkId]
• Acceso en UI: Links > Smart Links > link row
• Componente(s): SmartLinkDetailView.tsx

Como funciona

1. Abra una fila de enlace.
2. Revise las tarjetas de resumen.
3. Si hay prueba A/B, use Record conversions para ver WhatsApp automático, formulario web, snippet y nodo de automatización.
4. Consulte países, dispositivos y eventos recientes.
5. Copie o edite el enlace si necesita ajustar la campaña.

Reglas y validaciones

• El país se conserva como código ISO.
• La atribución CRM no convierte engagement probable en identidad verificada.

Backend

• Servicios: smart-links (get), smart-link-events (find).

Relaciones

• Requiere: smart link existente.
• Afecta: diagnóstico de una campaña.

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

Smart Links

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

Para que sirve

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

Que lo hace diferente

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

Acceso

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

Alcance tecnico

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

Funcionalidades internas

Relaciones

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

Limitaciones y notas

• No se deben incluir datos personales en el slug.

id: create-smart-link modulo: smart-links app: links nombre: Crear un smart link tipo: accion

Crear un smart link

Crea un enlace corto de apx.red hacia una URL HTTP(S), con opciones de medición y atribución.

Que se logra

• Resultado: publica un enlace corto medible hacia un destino web y puede asociarlo a contexto CRM.
• Caso de uso: una agencia crea un enlace de campaña para un prospecto y conoce su actividad posterior.
• Se combina con: QR dinámico, seguimiento UTM y atribución CRM.

Donde esta

• Ruta: /[orgId]/links
• Acceso en UI: Links > Create smart link``
• Componente(s): CreateSmartLinkDialog.tsx

Como funciona

1. Seleccione Create smart link.
2. Pegue el destino.
3. Defina el back-half o use Generate.
4. Si activa A/B test, lea la guía de conversión: WhatsApp crea el contact source solo; un formulario web debe conservar apx_click y luego enviar click_token con contact_id.
5. Configure medición, vencimiento, CRM o UTM y confirme.

Reglas y validaciones

• La URL de destino debe ser HTTP(S) y no puede volver a apx.red.
• El slug no debe contener datos personales.
• El título puede completarse desde el destino.

Backend

• Servicios: smart-links (create).
• Efectos: genera URL corta y métricas iniciales.

Relaciones

• Requiere: acceso a Links.
• Afecta: redirects, QR, actividad y analítica.

id: crm-attribution modulo: smart-links app: links nombre: Asociar un smart link con CRM tipo: configuracion

Asociar un smart link con CRM

Relaciona el enlace con un contacto, empresa o deal para dar contexto de atribución en eventos y timeline CRM.

Que se logra

• Resultado: permite leer la actividad de un enlace desde el contexto del contacto, empresa o deal previsto.
• Caso de uso: un equipo comercial relaciona una propuesta compartida con el deal correspondiente para revisar sus eventos.
• Se combina con: Activity, Analytics y timeline CRM.

Donde esta

• Ruta: /[orgId]/links
• Acceso en UI: Create smart link > Related CRM records``
• Componente(s): RelatedEntitySelector.tsx

Como funciona

1. Expanda Related CRM records.
2. Seleccione registros o revise la guía de query parameters.
3. Cree o edite el enlace.

Reglas y validaciones

• La asociación identifica al destinatario previsto, no una identidad verificada.
• Los query parameters de CRM prevalecen sobre las asociaciones guardadas.

Backend

• Servicios: smart-links (create/patch), smart-link-events (find).
• Efectos: los eventos guardan la atribución disponible.

Relaciones

• Requiere: registros del CRM de la misma organización.
• Afecta: Activity, Analytics y timeline CRM.

id: custom-slug modulo: smart-links app: links nombre: Personalizar el slug del enlace tipo: configuracion

Personalizar el slug del enlace

Permite definir o generar el identificador final de una URL corta de apx.red.

Que se logra

• Resultado: entrega una URL corta identificable para una campaña sin incluir datos personales.
• Caso de uso: una inmobiliaria genera un enlace corto para una propiedad y lo comparte en su material promocional.
• Se combina con: QR dinámico y redirección medida.

Donde esta

• Ruta: /[orgId]/links
• Acceso en UI: Create smart link > Back-half
• Componente(s): CreateSmartLinkDialog.tsx

Como funciona

1. Pegue una URL de destino.
2. Escriba el valor de Back-half o seleccione Generate.
3. Cree el enlace para obtener la URL corta.

Reglas y validaciones

• El slug forma parte de la URL pública apx.red.
• No debe contener datos de contacto, deals u otra información personal.
• Editar un enlace existente no cambia el slug.

Backend

• Servicios: smart-links (create/patch).
• Efectos: el middleware de redirect resuelve el enlace usando el slug.

Relaciones

• Requiere: una URL de destino válida.
• Afecta: URL corta, QR, redirects y métricas.

Notas

• El slug no cambia al editar el enlace, para no invalidar URLs o QR ya distribuidos.

id: edit-smart-link modulo: smart-links app: links nombre: Editar, desactivar y eliminar smart links tipo: accion

Editar, desactivar y eliminar smart links

Permite actualizar destino, nombre, modo de acceso o estado sin cambiar el código corto, y retirar enlaces del listado.

Que se logra

• Resultado: corrige o retira una campaña manteniendo intacto el código corto cuando el enlace sigue activo.
• Caso de uso: una agencia cambia la página de destino de un QR ya impreso sin volver a distribuirlo.
• Se combina con: QR dinámico, vencimiento y analítica.

Donde esta

• Ruta: /[orgId]/links
• Acceso en UI: Link row > More
• Componente(s): EditSmartLinkDialog.tsx, SmartLinksView.tsx

Como funciona

1. Abra More sobre la fila.
2. Seleccione Edit destination para cambiar datos.
3. Si el A/B test no está en Off, revise la guía de conversión antes de elegir destinos WhatsApp o landing.
4. Ajuste Status para desactivar.
5. Use Delete para eliminar.

Reglas y validaciones

• La edición no cambia el slug ni el QR.
• Un enlace desactivado, vencido o eliminado no redirige.

Backend

• Servicios: smart-links (patch/remove).
• Efectos: el redirect rechaza enlaces inactivos.

Relaciones

• Requiere: smart link existente.
• Afecta: redirects y disponibilidad del QR.

id: link-expiration modulo: smart-links app: links nombre: Definir vencimiento del enlace tipo: configuracion

Definir vencimiento del enlace

Configura cuándo un smart link debe dejar de redirigir a visitantes.

Que se logra

• Resultado: limita la disponibilidad de una campaña sin cambiar su URL corta ni QR.
• Caso de uso: una academia deja de redirigir el enlace de inscripción al cerrar la convocatoria.
• Se combina con: editar enlaces y QR dinámico.

Donde esta

• Ruta: /[orgId]/links
• Acceso en UI: Create smart link > Expiration
• Componente(s): CreateSmartLinkDialog.tsx

Como funciona

1. Abra Create smart link.
2. Complete el destino y las opciones necesarias.
3. Establezca una fecha en Expiration, si el enlace debe ser temporal.
4. Cree el enlace.

Reglas y validaciones

• El vencimiento es opcional.
• Un enlace vencido no redirige, aunque su código QR o URL corta sigan siendo los mismos.

Backend

• Servicios: smart-links (create/patch).
• Hooks relevantes: la comprobación de estado del redirect rechaza enlaces vencidos.
• Efectos: evita que el destino se abra después de la fecha configurada.

Relaciones

• Requiere: smart link.
• Afecta: redirect, QR y disponibilidad de campañas temporales.

Notas

• La ficha confirma la configuración al crear el enlace; no afirma una interfaz específica para modificarla después.

id: link-settings modulo: smart-links app: links nombre: Consultar configuración de Links tipo: vista

Consultar configuración de Links

Explica el dominio administrado apx.red, los modos de redirección, la atribución y el tratamiento de privacidad de las métricas.

Que se logra

• Resultado: permite interpretar el alcance del dominio, la medición y la privacidad antes de compartir enlaces.
• Caso de uso: un equipo de marketing elige entre rapidez y medición según el tipo de campaña.
• Se combina con: redirección medida y confianza de eventos.

Donde esta

• Ruta: /[orgId]/links/settings
• Acceso en UI: Links navigation > Settings``
• Componente(s): Links Settings page

Como funciona

1. Abra Settings desde Links.
2. Consulte el dominio corto y los modos de medición.
3. Revise las definiciones de confianza y privacidad.

Reglas y validaciones

• Las IP se convierten en hash y no se muestran como dato crudo.
• El país se obtiene de cabeceras CDN o una base local de geolocalización.

Backend

• Servicios: no realiza una configuración persistente confirmada; se apoya en smart-links y eventos.

Relaciones

• Requiere: acceso a Links.
• Afecta: comprensión de las métricas.

id: record-conversions modulo: smart-links app: links nombre: Registrar conversiones de Apex Link tipo: accion

Registrar conversiones de Apex Link

Explica cómo contar una conversión de prueba A/B y cómo asociar el Apex Link como origen del contacto.

Que se logra

• Resultado: quien configura el enlace entiende que WhatsApp crea el origen del contacto solo, y que un formulario web debe enviar click_token y contact_id.
• Caso de uso: una agencia compara dos landings y luego marca deal ganado con el nodo de automatización.
• Se combina con: pruebas A/B, contact sources y Mark Apex Link Conversion.

Donde esta

• Ruta: /[orgId]/links y /[orgId]/links/[linkId]
• Acceso en UI: Create smart link > A/B test, Edit destination y Record conversions
• Componente(s): SmartLinkConversionGuide.tsx, SmartLinkConversionSetup.tsx, MarkSmartLinkConversionDialog.tsx

Como funciona

1. WhatsApp: el primer mensaje inbound que sigue incluyendo #TOKEN (6 caracteres; los mensajes antiguos [APX-TOKEN] de 10 también) crea o encuentra el contacto, escribe el contact source, marca la conversión y cuenta una conversación en la variante del clic. Un botón web que abre WhatsApp debe incluir el mismo apx_click como #TOKEN.
2. Formulario web: el destino solo recibe apx_click. Conserve ese token, cree el contacto y envíe click_token más contact_id a POST /smart-link-conversion.
3. Snippet de landing: cuenta la conversión de la prueba A/B. No crea contacto ni contact source.
4. Nodo Mark Apex Link Conversion: busca el clic más reciente ya asociado a ese contacto. En web solo funciona después del paso 2.

Reglas y validaciones

• Contar la prueba A/B no es lo mismo que crear un contact source.
• El snippet solo no permite que el nodo de automatización encuentre el clic.
• Si la API recibe contact_id, Apex rellena el evento de clic original y escribe el origen smart-link.

Backend

• Servicios: smart-link-conversion, contacts-sources, automation-node-system-mark-smart-link-conversion.
• Efectos: conversión por click_token, atribución CRM opcional y nodo posterior.

Relaciones

• Requiere: Apex Link con destino URL o WhatsApp.
• Afecta: resultados A/B, timeline del contacto y automatizaciones.

id: redirect-measurement modulo: smart-links app: links nombre: Redirigir y medir visitas tipo: integracion

Redirigir y medir visitas

Resuelve enlaces cortos y mide requests, redirects, vistas del bridge y engagement sin almacenar IP cruda.

Que se logra

• Resultado: lleva al visitante al destino y registra evidencia diferenciada de actividad técnica o humana probable.
• Caso de uso: una empresa de eventos mide el interés de un enlace compartido sin tratar escáneres de seguridad como asistentes.
• Se combina con: seguimiento UTM, Activity y Analytics.

Donde esta

• Ruta: https://apx.red/{slug}
• Acceso en UI: Abrir enlace corto
• Componente(s): smart-link-redirect.js

Como funciona

1. Un visitante abre la URL corta.
2. El sistema valida estado y vencimiento.
3. Según el modo, redirige inmediatamente o muestra un bridge de medición.
4. El visitante llega al destino con UTM aplicables.

Reglas y validaciones

• Fast prioriza la redirección inmediata.
• Measured agrega evidencia de navegador para clasificar interacción humana probable.
• Solicitudes automatizadas se clasifican separadamente.

Backend

• Servicios: smart-link-engagement (create), smart-link-events; middleware smart-link-redirect.
• Efectos: cookie de visitante, evento y redirect HTTP.

Relaciones

• Requiere: enlace activo.
• Afecta: Activity y Analytics.

id: smart-link-qr modulo: smart-links app: links nombre: Generar código QR dinámico tipo: accion

Generar código QR dinámico

Muestra, copia o descarga un QR PNG que apunta al smart link y conserva su funcionamiento si cambia el destino.

Que se logra

• Resultado: produce un QR reutilizable cuya visita se identifica como QR y sigue el destino actual del enlace.
• Caso de uso: una empresa de eventos imprime un QR en una invitación y mide su actividad en Apex.
• Se combina con: editar enlace y analítica de Links.

Donde esta

• Ruta: /[orgId]/links
• Acceso en UI: Link row > More > View QR code``
• Componente(s): SmartLinkQrDialog.tsx

Como funciona

1. Abra el menú del enlace.
2. Seleccione View QR code.
3. Copie la URL o descargue el PNG.

Reglas y validaciones

• El QR incluye el parámetro que identifica la visita como QR.
• Cambiar el destino no requiere reimprimir el QR.

Backend

• Servicios: smart-links (get); la generación se hace en frontend con qrcode.

Relaciones

• Requiere: smart link existente.
• Afecta: métricas de QR.

id: utm-tracking modulo: smart-links app: links nombre: Configurar seguimiento UTM tipo: configuracion

Configurar seguimiento UTM

Guarda parámetros UTM para añadirlos al destino en el momento del redirect sin revelar seguimiento en la URL corta.

Que se logra

• Resultado: conserva el origen de campaña en el destino sin hacer más larga la URL compartida.
• Caso de uso: una agencia distingue el tráfico de una campaña de correo y un código QR hacia la misma página.
• Se combina con: redirección medida y analítica de Links.

Donde esta

• Ruta: /[orgId]/links
• Acceso en UI: Create smart link > Campaign tracking``
• Componente(s): CreateSmartLinkDialog.tsx

Como funciona

1. Abra Campaign tracking.
2. Complete los parámetros UTM necesarios.
3. Cree o guarde el enlace.

Reglas y validaciones

• Los UTM no se añaden a la URL apx.red.
• No sobrescriben parámetros UTM que ya existan en el destino.

Backend

• Servicios: smart-links (create/patch); middleware smart-link-redirect.

Relaciones

• Requiere: smart link.
• Afecta: URL final de visitantes.