Guía de instalación y uso

Todo lo necesario para instalar Maps by Vexco, configurarla, usarla y, si hace falta, desinstalarla.

¿Prefieres verlo? Recorrido en vídeo de tres minutos.

1. Instalar

1. Pulsa Instalar en HubSpot (o «Instalar» en la ficha del Marketplace).
2. Elige la cuenta de HubSpot y revisa los permisos. Todos son de solo lectura: empresas, contactos, negocios y sus esquemas, más los propietarios. Tickets, inmuebles y objetos personalizados son opcionales.
3. Acepta. HubSpot te lleva a los ajustes de la app. La capa de Empresas viene activada y empieza a leerse sola.

Necesitas ser superadministrador o tener permiso para instalar apps en la cuenta.

2. Capas

Una capa pinta los registros de un objeto. Puedes tener hasta 10. En Ajustes → Capas:

• Añadir capa o empezar con una plantilla: «Empresas por sector», «Empresas por propietario», «Contactos por etapa del ciclo de vida», «Contactos por propietario».
• Ubicación: la dirección en varias propiedades (calle, código postal, ciudad, provincia, país), en una sola propiedad, o latitud y longitud si ya las tienes. Si las direcciones no traen país, pon el país por defecto (p. ej. ES).
• Título, subtítulo y propiedades que se ven al pulsar el pin (hasta 12).
• Color fijo o según una propiedad con opciones (etapa, sector, propietario…), forma del pin y tamaño fijo o según un número (importe, empleados…).
• Filtros: solo se pintan los registros que los cumplen (p. ej. «Etapa del negocio no es Cerrado perdido»).
• Reordena las capas con las flechas y duplica una capa para hacer variantes.

3. Funciones

En Ajustes → Funciones enciendes o apagas cada cosa que verán los usuarios: agrupar pines, mapa de calor, leyenda, buscador, lista de lo que se ve, «Solo los míos», radio, dibujar zona, medir, «Cómo llegar», rutas, exportar CSV, pantalla completa, «Mi ubicación», recordar la vista y lo que muestra la tarjeta de la ficha. Hay tres conjuntos rápidos: Sencillo, Equipo comercial en la calle y Todo.

En Ajustes → Mapa: estilo por defecto y estilos disponibles, unidad (km o millas), radio y número de los «registros cercanos», zoom al abrir una ficha y vista inicial.

4. Aspecto

En Ajustes → Aspecto: título del mapa, color de acento (de la paleta o el tuyo en #rrggbb), tema claro, oscuro o según el estilo del mapa, panel a la izquierda o a la derecha, abierto o plegado, tamaño de los pines, color de los grupos y esquinas redondeadas o rectas. El botón Ver el mapa abre la vista previa con lo guardado.

5. Direcciones

Las direcciones se convierten en coordenadas una vez y se guardan; solo se recalculan si cambian. Por defecto se usa el servicio incluido. Si tienes muchísimas direcciones o prefieres tu proveedor, en Ajustes → Direcciones puedes poner tu propia clave de Google Maps, OpenCage, Geoapify o Mapbox (se prueba antes de guardarla y se guarda cifrada).

El servicio incluido tiene un máximo diario compartido. Si un día se alcanza, las direcciones pendientes se procesan solas al día siguiente y la pestaña Estado lo avisa.

6. Usar el mapa

Ábrelo desde la página de la app (menú de apps → Maps by Vexco) o desde la tarjeta de una ficha. Puedes abrirlo en un modal o en una pestaña nueva.

• Panel: buscador (tecla /), capas con su leyenda y recuento, filtros por valor, «Solo los míos» y mapa de calor.
• En pantalla: la lista de lo que se ve, por nombre o distancia.
• Herramientas: radio, dibujar zona, medir y exportar CSV. La zona y el radio dan la lista de registros de dentro, para exportarla o añadirla a la ruta.
• Pin: abre la ficha con sus propiedades, «Abrir en HubSpot», «Cómo llegar», «Añadir a la ruta» y «Cerca». Si varios registros comparten punto, sale una lista.
• Ruta: hasta 10 paradas, reordenables, con «Optimizar orden» y apertura en Google Maps.
• Botones del mapa: ver todo, estilo, «Mi ubicación» y pantalla completa (estas dos, cuando el navegador lo permite).

En el móvil el panel es una hoja inferior. Prueba la demo con datos inventados.

7. Tarjeta de la ficha

En una ficha de empresa, contacto, negocio u otro objeto, pulsa Personalizar → añade la tarjeta Map de Maps by Vexco a la pestaña que quieras → Guardar. La tarjeta muestra la dirección, los registros cercanos y Ampliar mapa, que abre el mapa centrado en el registro.

8. Estado

La app lee HubSpot cada 5 minutos y procesa las direcciones nuevas o cambiadas. En Ajustes → Estado ves por capa cuántos registros hay en el mapa, pendientes, sin dirección y no encontrados, con Sincronizar ahora, Reintentar no encontradas y Volver a empezar, y la lista de direcciones que no se encontraron, con enlace a cada registro para corregirlas.

9. Desinstalar

En HubSpot: Marketplace → Apps conectadas → Maps by Vexco → Acciones → Desinstalar. La app deja de acceder a tu cuenta al momento y borra todo lo que guarda de ella (pines, caché de direcciones y ajustes) a los 30 días. Si quieres el borrado inmediato, escríbenos a javier@vexcosolutions.com. Tus registros de HubSpot no se tocan nunca.