Manual de uso · Configuración

Paso a paso

Gestionar una cuenta y cerrar su Acuerdo de Servicio

El CRM Comercial es la herramienta interna del equipo de Marko, no algo que un proveedor cliente vea. Este manual recorre la ficha de una cuenta —registrar un contacto, agendar el siguiente toque— desde darla de alta a mano cuando no viene del pipeline automático, hasta el otro extremo del embudo: configurar el plan de un cliente y generar su Acuerdo de Servicio. La bandeja del día con sus cinco contadores tiene su propio manual (Trabajar la bandeja del día del CRM); aquí sólo se cruza por ella de paso.

Los pasos

Parte 1 · Entrar al CRM

1. Inicia sesión con una cuenta que tenga el flag staff (o admin).

   

   Qué deberías verAterrizas directo en CRM Comercial —a un Staff puro OnboardingGuard no lo manda a /onboarding ni a /dashboard, porque nunca tiene roles—. Arriba, cinco contadores (Vencidas, Hoy, Trials ≤10d, Sin agenda, Mi cartera) y debajo la lista mezclando leads del pipeline con empresas que ya son clientes, cada fila con su badge de origen.
   Los nombres de esta captura son inventadosLa bandeja mezcla leads reales del equipo comercial de Marko. Para este manual se sustituyeron nombre de empresa, contacto, correo y monto de cada fila por datos ficticios antes de capturar; la forma de la pantalla es real, el contenido no. El detalle de los cinco contadores y cómo se prioriza la lista está en el manual de la bandeja del día.

Parte 2 · Alta manual de una cuenta

2. Pulsa + Nueva cuenta, arriba a la derecha.

   

   Qué deberías verLa ventana Nueva cuenta, con Razón social (obligatoria), RUT (opcional), Contacto, Origen, Correo y Teléfono.
   Para qué es esta pantallaSirve para los inbound y referidos que no vienen del pipeline automático de Compra Ágil: alguien que escribió por WhatsApp, un contacto de un evento. Si el prospecto viene de ese pipeline, ya tiene ficha y no hace falta crearla a mano.

3. Completa Razón social y el resto de los campos que tengas. Deja el RUT vacío si el prospecto todavía no lo dio.

   

   Qué deberías verEl aviso bajo el RUT: «Opcional. Si el prospecto todavía no lo dio, déjalo vacío: la cuenta se crea con un identificador provisional y queda marcada para completar el RUT después.» Origen ofrece referido, inbound, manual, evento y linkedin.
   El RUT malo cruza mal para siempreSi lo escribes, se usa para cruzar contra BigQuery y contra las empresas ya registradas. Un RUT mal tecleado no se detecta aquí: mejor dejarlo vacío que arriesgarse a escribirlo mal.

4. Pulsa Crear cuenta.

   

   Qué deberías verUn aviso de éxito y la ficha de la cuenta nueva se abre sola. Búscala por su nombre y la verás con el badge RUT pendiente si la dejaste sin RUT, y un identificador provisional del tipo sinrut-<empresa>.
   Si la cuenta ya existía, no se duplicaEl alta comprueba antes de crear: si ya hay una cuenta con ese RUT o esa razón social, la ventana avisa «Esa cuenta ya existía; se abre su ficha» y te lleva directo a la que ya estaba, en vez de crear una segunda.

Parte 3 · La ficha de la cuenta

5. Pulsa cualquier fila de la lista para abrir su ficha.

   

   Qué deberías verCuatro bloques a la izquierda —Contacto, Actividad en ChileCompra (12 meses) y Cuenta en Marko— y a la derecha Registrar toque y Próxima acción. En una cuenta recién creada, ChileCompra dice «Sin datos de compras al Estado» y Marko, «Todavía no se ha registrado en Marko».
   Por qué se pide por función y no por SDKLa ficha llama a crmGetAccount en vez de leer Firestore directo: así el acceso a los datos de esa empresa queda registrado en staffAccessLog, la auditoría del rol.

6. En Registrar toque, elige el Tipo, el Resultado y escribe qué pasó.

   

   Qué deberías verTipo ofrece Llamada, WhatsApp, Correo enviado, Respuesta recibida, Reunión agendada, Reunión hecha y Nota. Resultado —Sin respuesta, Conversado, Agendado, Rechazo— sólo aparece si el tipo no es Nota: una nota al margen no tiene resultado. Mover a estado es opcional.
   El «qué pasó» es lo que de verdad quedaEs el único campo de texto libre del toque: lo que escribas ahí es lo que se lee después en el historial, junto al resultado elegido.

7. Pulsa Registrar toque.

   

   Qué deberías verEl badge de estado, junto al nombre, cambia al que elegiste —aquí, de sin contactar a contactado—. El formulario se vacía, listo para el próximo toque, y en el Historial de toques aparecen dos filas nuevas: el toque en sí y, si moviste el estado, un evento Cambio de estado aparte.
   Si la cuenta no tenía ficha en leads, se crea solaUna empresa que llega por ChileCompra o por trial puede no tener ficha de lead todavía. El primer toque la crea de camino: ensureLead arma la ficha antes de escribir el evento, para que la subcolección de historial nunca quede colgando de un documento que no existe.

8. En Próxima acción, elige fecha y tipo —o usa mañana / en una semana—.

   

   Qué deberías verEl panel amarillo de sin próxima acción agendada mientras esté vacío. Tipo ofrece followup, discovery, demo, cierre, cobranza y otro. Debajo, el Historial de toques con lo que ya registraste.
   Por esto existe este panelDe 414 leads medidos al construir el CRM, uno solo tenía la próxima acción agendada. La bandeja del día se construye entera sobre esta fecha: sin ella, una cuenta viva no aparece como cayéndose aunque lleve semanas sin que nadie la toque.

9. Pulsa Agendar.

   

   Qué deberías verEl panel deja de estar en amarillo y el texto cambia a «acción en N días» (o «acción para hoy», «vencida hace N días» según la fecha). El historial suma un evento Agenda con el tipo y la fecha comprometida.

10. Cierra la ficha y búscala de nuevo en la lista.

    

    Qué deberías verLa fila con el estado y la próxima acción ya al día, sin recargar la página: la ficha escribe sobre la misma cuenta que está en la lista, así que el cambio se ve de inmediato.

Parte 4 · Cerrar el ciclo: plan y Acuerdo de Servicio

Esto no se hace desde la ficha del CRM. Cambiar el plan de un cliente y generar su Acuerdo de Servicio vive en Configuración → Empresas, la misma pestaña que usa el administrador de plataforma — a un Staff se le recorta a sólo dos acciones por fila.

11. Abre Configuración en el menú lateral.

    

    Qué deberías verUna sola pestaña, Empresas, con un candado junto al nombre. Las otras catorce pestañas del hub —Mi Empresa, Cuentas, Integraciones…— no se te muestran: configuran una empresa activa que un Staff no tiene.
    Por URL directa te vuelve a dejar entrarAbrir /company-settings a mano, con la sesión recién cargada, rebota primero al login y de ahí de vuelta a /crm — el guard todavía no restauró la sesión de Firebase Auth. Entra siempre por el enlace de Configuración del menú, no escribiendo la URL: la navegación dentro de la app sí funciona a la primera.

12. Busca la empresa y abre el menú de tres puntos de su fila.

    

    Qué deberías verSólo dos acciones: Configurar Plan y Acuerdo de Servicio. Al administrador de plataforma el mismo menú le trae siete: Editar, Configurar compras ágiles, Cargar créditos, Migrar a BigQuery, Configurar indicadores operativos y las dos que ve el Staff.

13. Pulsa Configurar Plan.

    

    Qué deberías verUn formulario con Plan, Estado del Pago, Precio Licencia (UF), Inicio Prueba Gratis y Fin del Trial. Elige un plan y pulsa Guardar Cambios.
    🔴 Verificado el 2026-09-02: en QA esto fallaCon la cuenta Staff, guardar responde con el toast crudo internal y el plan no cambia. No es un error tuyo: la función crmUpdateCompanyPlan —la que debería escribir el plan por un camino acotado para Staff— no está desplegada en marko-devenv (comprobado con firebase functions:list --project marko-devenv: no aparece en la lista). Para un Administrador de plataforma, que guarda directo con el SDK, esta pantalla sí funciona. Este manual no llegó a ver un guardado exitoso como Staff en QA.

14. Cierra esa ventana y abre Acuerdo de Servicio en el mismo menú.

    

    Qué deberías verEl nombre de la empresa bajo el título y, si todavía no tiene ninguno, «Esta empresa todavía no tiene acuerdos generados» con el botón Generar acuerdo. Si ya tuviera acuerdos, aquí saldría la tabla con su estado, plan, versión y fecha.

15. Pulsa Generar acuerdo.

    

    Qué deberías verEl formulario: Id del plan, Nombre del plan, Modalidad (Mensual/Anual), Tarifa en UF, Implementación en UF, Vigencia del enlace (días) —15 por defecto— y Servicios adicionales, con un botón para agregarlos de a uno.
    Los montos van sin IVAEl propio formulario lo recuerda: «Los valores van en UF y sin IVA, según la cláusula TERCERO del contrato: se facturan al valor de la UF del día de emisión.»

16. Completa los términos y las Observaciones —van al Anexo A del contrato—.

    

    Qué deberías verEl formulario relleno, listo para el botón Generar y obtener enlace. El firmante no se elige aquí: por debajo, la función toma el nombre, correo y teléfono del contacto que ya tiene guardada la empresa —el mismo que se ve en Configuración → Empresas—, no algo que se escriba en esta ventana.

17. Pulsa Generar y obtener enlace.

    

    Qué deberías ver, en un ambiente donde esto funcionaUn aviso «Acuerdo generado. Copia el enlace y envíaselo al cliente.» y un panel Enlace de firma con el texto «Cópialo ahora y envíaselo al cliente por WhatsApp. No se guarda en claro: si lo pierdes, tendrás que generar un enlace nuevo.» junto a un campo de sólo lectura con la URL y un botón Copiar. Marko no manda ese enlace por ti: ni por correo ni por WhatsApp — lo copias y lo envías tú.
    🔴 Verificado el 2026-09-02: en QA esto también falla, y con un mensaje que puede confundirCon la cuenta Staff, el intento responde «No se pudo generar el acuerdo · No perteneces a esta empresa» — un mensaje que suena a que hay que estar adentro de la empresa, y un Staff nunca lo está por diseño. La función createServiceAgreement sí está desplegada en marko-devenv, pero la versión que corre ahí todavía no reconoce el flag staff del acceso transversal de MRKO-327 — el mismo desfase que Configurar Plan. No se generó ningún acuerdo, ni se disparó ningún correo: la función revienta antes de escribir nada.

Lo que todavía no hace

• No hay forma de borrar una cuenta creada por error. Ni desde la ficha ni desde la lista: la única acción de escritura del CRM sobre una cuenta nueva es crearla.
• No se puede editar el contacto ya guardado —nombre, correo, teléfono— desde esta pantalla una vez creada la cuenta. El único dato de contacto editable vive en Configuración → Empresas, y sólo para empresas que ya son clientes.
• El badge «no contactar» no tiene botón. Sólo se ve si el dato ya viene así en Firestore; ninguna pantalla del CRM lo activa.
• El CRM no envía nada por ti. Ni el correo al lead, ni el enlace de firma del Acuerdo de Servicio: los datos de contacto y el enlace se muestran para que tú los copies y los mandes por tu cuenta.
• El CRM no cambia datos operativos de la empresa —facturas, banco, inventario, OC—: sólo campos comerciales (stage, próxima acción, dueño, notas, etiquetas) y, en Configuración → Empresas, el plan y el Acuerdo de Servicio.
• Configurar Plan y Acuerdo de Servicio, para el rol Staff, no funcionan hoy en QA (marko-devenv): las funciones detrás no tienen desplegado el alcance de MRKO-327. No se pudo verificar si convemarco (producción) tiene el mismo problema.
• No hay historial de cambios de plan visible en esta pantalla: se ve el plan actual, no quién lo cambió ni cuál era el anterior.

Para consultar después

Cuando algo no sale