Marko Manual de uso · Comercial

Paso a paso

Buscar y desbloquear un contacto de adquisiciones

Inteligencia de Contactos de Adquisiciones encuentra a los encargados de compras de organismos públicos y te deja revelar su email y teléfono, pagando créditos. Buscar es gratis e ilimitado; desbloquear cuesta 1 crédito real de tu empresa, y no hay forma de deshacerlo. Este manual te lleva por las dos búsquedas, te enseña a distinguir un contacto ya pagado de uno nuevo, y sólo entonces desbloquea uno.

Qué vas a conseguir

Encontrar los encargados de compras de cualquier organismo público que compra por Mercado Público o Compra Ágil — nombre, unidad y actividad son gratis — y decidir con criterio cuándo vale la pena gastar un crédito para ver su email y teléfono completos.

Para quién

Admin, Manager, Ejecutivo y Ejecutivo Avanzado (nav.service.ts y el ALLOWED_ROLES del componente, verificados iguales). Capturado con una cuenta Ejecutivo: es el rol que más lo usa en el día a día comercial.

Qué necesitas antes

Al menos 1 crédito disponible en tu empresa. El plan gratuito parte con 5 al mes; si llegas a 0, sólo un admin de la plataforma Marko puede cargarte más — tu propio Manager no puede.

Cuánto toma

Buscar es instantáneo (hasta ~6 s si nadie más buscó ese organismo hoy). Desbloquear tarda 1-2 s y es inmediato para toda la empresa.

Antes de seguir: un desbloqueo no se deshace Cada clic en «Desbloquear (1 crédito)» que confirmes debita 1 crédito real del saldo de tu empresa — el mismo saldo que usan tus compañeros — de forma atómica e irreversible. La única protección que tienes es que es idempotente: si el contacto ya lo desbloqueó alguien de tu empresa antes, volver a pedirlo no cobra de nuevo (unlockContact.ts, comprobado en el paso 7). Pero un contacto nuevo, mal elegido, es un crédito gastado para siempre. Revisa bien antes de confirmar.

Los pasos

  1. Abre el menú lateral Comercial y entra a Contactos de Adquisiciones.

    Menú lateral Comercial desplegado, con la entrada Contactos de Adquisiciones resaltada como activa
    Qué deberías verLa entrada está al final del grupo Comercial, junto a las demás pantallas de venta — en el menú (nav.service.ts) convive con Cotizaciones y Oportunidades Compra Ágil, aunque el documento funcional la agrupe con Operaciones.
  2. La primera vez que entras, se abre un modal explicativo con los pasos y los planes de crédito. Ciérralo con Entendido.

    Modal informativo Inteligencia de Contactos de Adquisiciones, con los tres pasos de uso y la tabla de planes de créditos
    Qué deberías verTres pasos (buscar, ver la lista, desbloquear) y cuatro planes: Incluido (5 créditos/mes, gratis), Starter (50/mes, 0,5 UF/mes), Pro (200/mes, 1 UF/mes, marcado «Recomendado») y Pack adicional (100 créditos que no expiran, 0,75 UF). Puedes volver a abrir este mismo modal cuando quieras haciendo clic en el badge de créditos del encabezado — no vuelve a aparecer solo una segunda vez, queda una marca en el localStorage de tu navegador.
  3. Sin escribir nada, la pantalla ya te muestra un listado: los organismos con más contactos disponibles.

    Listado inicial de organismos con más contactos, encabezado por Universidad de Chile con 1012 contactos, y el saldo de créditos disponible arriba a la derecha
    Qué deberías verUna tabla de Organismo, RUT y Contactos, ordenada de mayor a menor cobertura — es el mismo listado para todas las empresas, cacheado 24 h. Arriba a la derecha, el badge verde Créditos disponibles con el saldo de tu empresa.
  4. Si ya tienes el RUT del organismo, escríbelo completo (formato XX.XXX.XXX-X) y pulsa Buscar.

    Ficha de I Municipalidad de la Pintana con 118 contactos, tabla de encargados de compras con nombres, unidad, actividad, y email y teléfono enmascarados
    Qué deberías verVa directo a la ficha del organismo — sin lista intermedia — con una tabla de Encargado, Unidad / Área, Actividad (número de oportunidades y la fecha de la más reciente), Email y Teléfono. Los dos últimos salen enmascarados con un candado — s••••@dominio.cl, +56 2 2345 •••• — para cualquier contacto que tu empresa no haya desbloqueado todavía.
    Un RUT exacto, nunca un fragmento La búsqueda por RUT filtra siempre por institucion.rut exacto — nunca por nombre a nivel de contactos. Si escribes un RUT incompleto o con un formato distinto de XX.XXX.XXX-X, el campo se marca en rojo con el aviso «Ingresa el RUT del organismo (XX.XXX.XXX-X) o parte de su nombre (mín. 3 caracteres).» antes de dejarte pulsar Buscar.
  5. Si no tienes el RUT a mano, escribe parte del nombre del organismo (mínimo 3 caracteres) y pulsa Buscar.

    Búsqueda por nombre municipalidad maipu, con un resultado: I Municipalidad de Maipu, RUT 69.070.900-7, 21 contactos
    Qué deberías verUna lista de organismos coincidentes — aquí, uno solo — con su RUT y su número de Contactos. La búsqueda es multi-palabra: «municipalidad maipu» encuentra «I MUNICIPALIDAD DE MAIPU» aunque el orden y los acentos no calcen exacto. Haz clic en la fila para entrar a sus contactos, igual que en el paso 4.
  6. Ya dentro de un organismo, usa el campo Filtrar por nombre o unidad... para acotar la lista que ya cargó, sin volver a consultar el servidor.

    Filtro de contactos con el texto soto escrito, mostrando una sola fila que coincide
    Qué deberías verLa tabla se acota al instante a las filas cuyo Encargado o Unidad / Área contengan el texto — es un filtro en memoria sobre lo ya descargado, no dispara una nueva llamada. Bórralo con la × del campo para volver a ver la lista completa.
  7. Antes de gastar un crédito, mira si el contacto que te interesa ya tiene la insignia verde Desbloqueado — puede que otra persona de tu empresa ya lo haya pagado.

    Tabla de contactos con la mayoría enmascarados y candado, y uno con insignia verde Desbloqueado mostrando email y teléfono completos
    Qué deberías verUn contacto ya desbloqueado por tu empresa muestra su email y teléfono completos, con ícono verde, y en la columna Acción una insignia Desbloqueado en vez del botón — no hay nada que pagar ni que pulsar. El desbloqueo es por empresa, no por persona: si tu compañero ya lo pagó, tú lo ves completo sin gastar nada.
  8. Para un contacto todavía enmascarado, pulsa Desbloquear (1 crédito) y confirma en la ventana «Desbloquear contacto».

    Modal Desbloquear contacto, con el nombre del encargado, la unidad, el aviso de que se debitará 1 crédito y el saldo actual
    Qué deberías verEl nombre y la unidad del contacto, el aviso «Se debitará 1 crédito de tu cuenta» y tu saldo actual antes de cobrar. El botón Cancelar no cuesta nada — úsalo si no estás seguro.
    Este modal no distingue si falta el email o el teléfono La confirmación es genérica: dice «email y teléfono» aunque el contacto sólo tenga uno de los dos cargado en la base, o incluso ninguno. Lo comprobamos en el código (unlockContact.ts): la transacción sólo verifica el saldo, nunca la cobertura real del contacto. Puedes pagar 1 crédito y, tras confirmar, ver el teléfono en blanco () porque nunca existió ese dato. Ver la nota del paso 9.
  9. Confirma con Desbloquear (1 crédito) y revisa el resultado en la fila y en el saldo del encabezado.

    Fila del contacto recién desbloqueado con email y teléfono completos e insignia verde Desbloqueado, y el saldo de créditos del encabezado bajado en 1
    Qué deberías verLa fila cambia al instante: candado por email y teléfono completos, insignia verde Desbloqueado. Arriba, el badge Créditos disponibles baja en 1 — en esta captura, de 97 a 96 créditos, verificado en vivo. Además aparece un aviso de éxito: «Contacto desbloqueado. Te quedan <saldo> crédito(s).» (texto verificado en contactos-lista.component.ts, método unlock()).
    El límite real de búsquedas no es el que dice el mensaje Si buscas demasiado en poco tiempo, la app puede mostrarte «Has superado el límite de búsquedas por hora (20). Inténtalo en unos minutos.» Es un mensaje engañoso: el tope real que aplica el servidor son 300 búsquedas por empresa y por hora (RATE_LIMIT_MAX en searchOrgContacts.ts, searchOrganismos.ts y getTopOrganismos.ts), no 20. Es un freno anti-abuso, no la monetización — no deberías verlo nunca en uso normal.

Cómo funcionan los créditos

Lo que todavía no hace

Cuando algo no sale

Lo que vesQué pasa
«Acceso restringido» (pantalla completa, con candado)Tu cuenta no tiene ninguno de los cuatro roles permitidos en esta empresa. El mensaje completo: «No tienes permiso para acceder al módulo de Inteligencia de Contactos de Adquisiciones. Comunícate con el administrador de tu empresa si crees que es un error.»
«Ingresa el RUT del organismo (XX.XXX.XXX-X) o parte de su nombre (mín. 3 caracteres).»Pulsaste Buscar (o saliste del campo) con el buscador vacío.
«Para buscar por nombre ingresa al menos 3 caracteres.»Escribiste menos de 3 caracteres y no tiene forma de RUT.
«El RUT ingresado no es válido. Asegúrate de usar el formato XX.XXX.XXX-X.»El servidor rechazó el RUT (invalid-argument) al buscar contactos.
«Has superado el límite de búsquedas por hora (20). Inténtalo en unos minutos.»Tope anti-abuso superado (resource-exhausted) — el número real es 300/hora, ver la nota del paso 9.
«Sin créditos disponibles. Contacta a soporte para adquirir más créditos.»Intentaste desbloquear con el saldo de tu empresa en 0 (failed-precondition). El botón Desbloquear ya viene apagado en ese caso — este mensaje sólo aparece si el saldo bajó a 0 justo entre que cargó la pantalla y que confirmaste.
«El contacto no fue encontrado.»El contacto que intentabas desbloquear ya no existe en la base (not-found) — vuelve a buscar el organismo para refrescar la lista.
«Debes iniciar sesión para usar esta funcionalidad.» / «Debes iniciar sesión para realizar esta acción.»Tu sesión expiró a mitad de una búsqueda o de un desbloqueo — son dos textos distintos para el mismo caso, según en qué acción te pasó.
«No se pudo desbloquear el contacto. Inténtalo nuevamente.»Mensaje genérico de respaldo, para cualquier error que el sistema no clasificó en uno de los anteriores. No te cobra el crédito: la transacción de Firestore es atómica y sólo descuenta si termina de escribir el desbloqueo completo.