Whitepaper LeadVantage

1. Introducción

La captación de leads en 2025 es un proceso fragmentado. Los equipos de ventas y marketing usan múltiples herramientas: una para encontrar negocios, otra para gestionar contactos, otra para enviar mensajes y otra para analizar resultados. Cada integración es un punto de fricción, cada cambio de contexto es tiempo perdido.

LeadVantage nace para resolver este problema. Una sola plataforma que cubre todo el ciclo: descubrimiento (scraping de Google Maps, Instagram, LinkedIn), gestión (CRM visual Kanban con pipeline, tags y segmentos), conexión (WhatsApp Business API con campañas multi-step y chat 1:1) e inteligencia (IA integrada para smart compose, chatbot automático, sentiment analysis y lead scoring).

Este whitepaper te guía paso a paso por cada funcionalidad del producto, desde la configuración inicial hasta estrategias avanzadas de uso.

2. Visión general de LeadVantage

LeadVantage es una plataforma SaaS diseñada para equipos que necesitan captar leads de forma masiva y eficiente. Está pensada para:

• Agencias de marketing que generan leads para sus clientes
• Equipos B2B que construyen listas de prospectos
• E-commerce y retail que buscan proveedores y distribuidores
• Restaurantes y hostelería que mapean competencia y hacen promociones

El producto se organiza en 7 módulos principales accesibles desde el sidebar del dashboard:

1. Dashboard — KPIs, gráficos, pipeline visual
2. Scraper — Google Maps, Instagram, LinkedIn
3. Leads — CRM Kanban con drag & drop
4. Campañas — Secuencias multi-step de WhatsApp
5. Mensajes — Bandeja unificada con IA
6. Tareas — Recordatorios y seguimientos
7. Settings — Negocio, IA, WhatsApp, equipo, billing

3. Arquitectura del dashboard

El dashboard está construido con Next.js 15 (App Router) y utiliza una arquitectura cliente-servidor con API routes. Los datos se almacenan en PostgreSQL mediante Prisma ORM.

Estructura de navegación

El sidebar izquierdo contiene los 7 módulos. El topbar superior muestra notificaciones, búsqueda y perfil. Cada módulo tiene su propia ruta bajo /dashboard/[modulo].

Organización de datos

Los datos se organizan por organización. Cada usuario pertenece a una o más organizaciones. Dentro de una organización, los leads, campañas, mensajes, tareas y configuraciones son compartidos según el rol del usuario (Owner, Admin, Agent).

4. Primeros pasos: Onboarding

4.1. Crear cuenta y organización

1. Ve a leadvantage.es/auth/signup
2. Introduce tu email y contraseña
3. Verifica tu email (revisa tu bandeja de entrada)
4. Al primer login, se crea automáticamente tu organización
5. Ya tienes acceso al dashboard con el plan FREE (14 días de trial PRO)

4.2. Configurar perfil de negocio

Ve a Settings → Negocio y completa:

• Nombre de la empresa
• Tipo de negocio (restaurant, automotive, retail, etc.)
• Descripción — qué haces y qué ofreces
• Teléfono y email de contacto
• Website
• Value propositions — tus ventajas competitivas (se usan en la IA)
• Target industries — a qué sectores te diriges

4.3. Conectar WhatsApp Business API

Para enviar y recibir mensajes WhatsApp necesitas conectar la WhatsApp Business API de Meta:

1. Ve a Settings → WhatsApp
2. Necesitarás una cuenta de Meta Business y un número de WhatsApp Business
3. Introduce tu Phone Number ID (de Meta Business Manager)
4. Introduce tu Access Token (generado en Meta Business Manager)
5. Introduce tu Verify Token (para webhooks)
6. Configura el webhook en Meta Business Manager apuntando a https://leadvantage.es/api/webhooks/whatsapp
7. Verifica la conexión enviando un mensaje de prueba

4.4. Configurar proveedor de IA

Ve a Settings → IA y configura:

1. Proveedor: selecciona entre OpenAI, Anthropic Claude, Google Gemini, OpenRouter o endpoint personalizado
2. Modelo: elige el modelo según el proveedor (ej: GPT-4o, Claude 3.5 Sonnet, Gemini 2.0 Flash)
3. API Key: introduce tu clave de API del proveedor seleccionado
4. Chatbot: activa/desactiva el chatbot automático
5. Persona del chatbot: define el tono y estilo (ej: "Eres un asistente comercial amable y profesional de [tu empresa]")

5. Scraper de Google Maps — Guía completa

El scraper de Google Maps es la herramienta principal de captación de leads. Extrae datos de negocios directamente desde Google Maps con precisión de geolocalización.

5.1. Cómo buscar

1. Ve a Dashboard → Scraper
2. Selecciona la fuente Google Maps
3. Introduce una keyword (ej: "restaurantes", "dentistas", "ferreterías")
4. Introduce una ubicación (ej: "Madrid", "Barcelona", "Calle Gran Vía 50")
5. Opcional: usa el map picker para seleccionar un punto en el mapa
6. Configura el radio de búsqueda en kilómetros
7. Establece el máximo de resultados (ej: 100, 500)

5.2. Filtros avanzados

Antes de ejecutar la búsqueda, puedes aplicar filtros:

• Rating mínimo: solo negocios con X estrellas o más
• Categoría: filtrar por categoría de Google Maps
• Con/sin web: solo negocios que tienen/no tienen sitio web
• Número de reseñas: mínimo de reseñas

5.3. Selección de campos de datos

Elige qué datos extraer de cada negocio:

• Nombre (obligatorio)
• Teléfono
• Email
• Dirección
• Website
• Rating y reseñas
• Redes sociales (Instagram, LinkedIn detectados en la web)
• Horarios de apertura
• Categoría

5.4. Ejecución y monitoreo

Al lanzar la búsqueda, se crea un job de scraping con estado:

• Pending — en cola
• Running — ejecutándose
• Completed — finalizado con resultados
• Failed — error (revisa el mensaje de error)

Puedes ver el progreso en tiempo real y los resultados cuando el job completa.

5.5. Importación al CRM

Una vez completado el job, cada resultado puede importarse al CRM como un lead individual. También puedes importar todos los resultados a la vez con el botón "Importar todos".

5.6. Exportación CSV

Descarga los resultados en formato CSV para usarlos en otras herramientas (Excel, Google Sheets, tu CRM externo, etc.).

6. Scraper de Instagram y LinkedIn

Además de Google Maps, LeadVantage soporta scraping de Instagram y LinkedIn para extraer datos de contacto de perfiles públicos.

6.1. Instagram

• Búsqueda por hashtag: encuentra publicaciones y perfiles asociados
• Búsqueda por ubicación: negocios etiquetados en una zona
• Búsqueda por perfil: extrae datos de un perfil específico

Datos extraíbles: nombre, bio, email (si está en la bio), teléfono, enlace externo, número de seguidores.

6.2. LinkedIn

• Búsqueda por término: encuentra perfiles por cargo, sector o empresa
• Búsqueda por perfil: extrae datos de un perfil específico via URL

Datos extraíbles: nombre, cargo, email, teléfono, ubicación, conexiones. Requiere API key de ProxycURL configurada en Settings.

7. CRM Kanban — Gestión visual de leads

El CRM de LeadVantage ofrece dos vistas: Kanban (columnas con drag & drop) y Lista (tabla con filtros).

7.1. Vista Kanban

Los leads se organizan en columnas según su pipeline stage. Arrastra y suelta para cambiar el estado de un lead. Cada tarjeta muestra: nombre, teléfono, fuente, tags, score y número de mensajes.

7.2. Pipeline stages personalizables

Cada organización puede crear sus propios stages con:

• Nombre personalizado (ej: "Nuevo", "Contactado", "Calificado", "Ganado", "Perdido")
• Color (para identificación visual)
• Orden (posición en el Kanban)
• Marcar como stage "Won" o "Lost"

7.3. Crear lead manual

Puedes crear leads manualmente con todos los campos: nombre, teléfono, email, dirección, website, categoría. El lead se crea con estado "Nuevo" y fuente "Manual".

7.4. Importación masiva CSV

Sube un archivo CSV con mapeo automático de campos. El sistema detecta las columnas y las asocia con los campos del lead.

7.5. Tags y segmentos

Asigna tags a los leads para categorizarlos (ej: "hot", "vip", "restaurant", "madrid"). Filtra por tags para ver segmentos específicos. Los tags se pueden crear, asignar y filtrar dinámicamente.

7.6. Score de leads

Cada lead tiene dos scores:

• Score base: calculado automáticamente según datos del lead (rating, web, categoría, etc.)
• AI Score: puntuación generada por IA basada en el contexto y comportamiento

7.7. Notas y actividades

Cada lead tiene un historial completo de actividades: mensajes enviados/recibidos, cambios de estado, tags añadidos, notas internas, tareas creadas y score actualizado. Las notas son internas (no se envían al lead).

7.8. Asignación de leads

Asigna leads a miembros del equipo. Cada usuario ve sus leads asignados en su vista. Los Admins y Owners pueden ver y reasignar todos los leads.

8. Campañas WhatsApp multi-step

Las campañas permiten enviar secuencias automatizadas de mensajes WhatsApp a un grupo de leads.

8.1. Crear campaña

1. Ve a Dashboard → Campañas
2. Click en "Nueva campaña"
3. Nombre y descripción
4. Selecciona el segmento objetivo (por tag, estado, fuente)

8.2. Builder de secuencia

Añade pasos a la secuencia. Cada paso tiene:

• Tipo: WhatsApp Auto, WhatsApp Manual, Llamada, Tarea
• Template: mensaje a enviar (con variables dinámicas)
• Delay: horas de espera antes del paso

8.3. Tipos de paso

• WhatsApp Auto: envío automático vía API
• WhatsApp Manual: crea una tarea para que un agente envíe el mensaje manualmente
• Llamada: crea una tarea de llamada telefónica
• Tarea: crea una tarea genérica asociada al lead

8.4. Templates

Crea templates con variables dinámicas: {{name}}, {{company}}, {{phone}}. Los templates se categorizan: Marketing, Utility, Authentication (conforme a las categorías de Meta).

8.5. Activar y monitorizar

Una campaña puede estar en estado: Borrador, Activa, Pausada o Completada. Monitoriza el progreso: enviados, entregados, leídos y respuestas en tiempo real.

9. Mensajería WhatsApp 1:1

La bandeja de mensajes unificada te permite chatear 1:1 con tus leads desde una sola interfaz.

9.1. Bandeja de entrada

Lista de conversaciones con: nombre del lead, último mensaje, timestamp y contador de mensajes. Filtra por estado del lead y busca por nombre o teléfono.

9.2. Smart Compose

La IA sugiere respuestas basadas en el contexto de la conversación, la información del negocio y la persona del chatbot. Puedes usar la sugerencia tal cual, editarla o ignorarla.

9.3. Chatbot automático

Cuando está activado, el chatbot responde automáticamente a mensajes entrantes. La persona configurada en Settings → IA define el tono y comportamiento. Los mensajes del bot se marcan con un icono de robot.

9.4. Sentiment Analysis

Cada mensaje recibido se analiza para detectar el sentimiento (positivo, neutral, negativo) y la intención (compra, pregunta, queja, etc.). Esta información aparece junto al mensaje y en los datos del lead.

9.5. Plantillas rápidas

Inserta templates predefinidos en el chat con un clic. Útil para respuestas frecuentes: confirmación de cita, envío de catálogo, etc.

10. IA: Configuración avanzada

10.1. Proveedores soportados

• OpenAI: GPT-4o, GPT-4o-mini, GPT-4-turbo, GPT-3.5-turbo, o1-mini, o1-preview
• Anthropic: Claude 3.5 Sonnet, Claude 3.5 Haiku, Claude 3 Opus
• Google Gemini: Gemini 2.0 Flash, Gemini 1.5 Pro, Gemini 1.5 Flash
• OpenRouter: DeepSeek, Llama 3.3, Mistral Large, Qwen 2.5
• Custom: cualquier endpoint compatible con la API de OpenAI (Azure, local, etc.)

10.2. Configuración de persona

La persona del chatbot define cómo se comunica la IA. Ejemplo:

Eres un asistente comercial de [tu empresa].
Eres amable, profesional y conciso.
Tu objetivo es agendar demos con leads interesados.
Si el lead pregunta por precios, indica que dependen del plan
y ofrece una llamada de 15 minutos.
Nunca inventes información sobre el producto.

10.3. Cuándo usar cada función

• Smart Compose: para sugerir respuestas rápidas en chat 1:1
• Chatbot: para respuestas automáticas fuera de horario o cuando hay mucho volumen
• Auto-reply: para confirmaciones inmediatas (ej: "Gracias por tu mensaje, te respondemos pronto")
• Sentiment: para priorizar leads con intención de compra

11. Sistema de tareas y recordatorios

Las tareas te ayudan a mantener el seguimiento de leads organizado. Cada tarea puede asociarse a un lead específico.

Crear tarea

1. Ve a Dashboard → Tareas o desde el perfil de un lead
2. Título, descripción, prioridad (Low, Medium, High, Urgent)
3. Fecha límite
4. Lead asociado (opcional)

Las tareas con fecha pasada y no completadas se marcan como "Overdue". Recibirás notificaciones cuando una tarea esté próxima a vencer.

12. Configuración de negocio

El perfil de negocio en Settings → Negocio es fundamental para el buen funcionamiento de la IA. Los campos value propositions y target industries se usan como contexto en Smart Compose y Chatbot.

Ejemplo de value propositions:

• "Captación automática de leads desde Google Maps"
• "CRM visual con pipeline personalizable"
• "WhatsApp masivo con IA integrada"
• "Setup en minutos, sin curva de aprendizaje"

13. Gestión de equipo

LeadVantage soporta tres roles de usuario:

• Owner: acceso total, puede gestionar billing y eliminar la organización
• Admin: acceso total excepto billing y eliminación
• Agent: acceso a leads, mensajes, campañas y tareas. Sin acceso a Settings

Para invitar usuarios, el Owner o Admin debe ir a Settings → Equipo e introducir el email del nuevo miembro.

14. Billing y suscripciones

Los pagos se gestionan a través de Stripe. Los planes disponibles son:

• FREE: sin coste, funcionalidades limitadas
• STARTER (29€/mes): hasta 500 leads/mes, 1 usuario, scraper 500/mes
• PRO (79€/mes): leads ilimitados, IA completa, 3 usuarios, campañas masivas
• BUSINESS (199€/mes): todo incluido, usuarios ilimitados, API access, soporte prioritario

El trial de 14 días da acceso a todas las funciones de PRO sin tarjeta de crédito. Al finalizar, la cuenta pasa automáticamente a FREE.

15. API Reference

LeadVantage ofrece una API REST para integraciones personalizadas (disponible en plan BUSINESS).

Autenticación

Todas las requests requieren un header Authorization: Bearer YOUR_API_KEY. El API key se genera en Settings → Integraciones.

Endpoints principales

GET  /api/leads?orgId=XXX&limit=50    # Listar leads
POST /api/leads                          # Crear lead
GET  /api/leads/:id                      # Obtener lead
PUT  /api/leads/:id                      # Actualizar lead
DEL  /api/leads/:id                      # Eliminar lead

GET  /api/campaigns?orgId=XXX            # Listar campañas
POST /api/campaigns                      # Crear campaña
POST /api/campaigns/:id/activate         # Activar campaña

GET  /api/messages?orgId=XXX&leadId=YYY  # Mensajes de un lead
POST /api/messages                        # Enviar mensaje

POST /api/scraper/jobs                    # Crear job de scraping
GET  /api/scraper/jobs/:id                # Estado del job

GET  /api/pipeline?orgId=XXX              # Pipeline stages
POST /api/pipeline                         # Crear stage

Ejemplo: crear lead

curl -X POST https://leadvantage.es/api/leads \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Restaurante Ejemplo",
    "phone": "+34600123456",
    "email": "info@ejemplo.com",
    "source": "MANUAL",
    "orgId": "your-org-id"
  }'

Rate limits

100 requests por minuto por API key. Contacta con soporte para límites personalizados.

16. Mejores prácticas y tips

Estrategia de scraping

• Usa keywords específicas ("dentistas Madrid centro" mejor que "dentistas")
• Filtra por rating mínimo (4.0+) para priorizar negocios establecidos
• Extrae redes sociales para tener múltiples canales de contacto
• No scrapees más de 500 resultados por job para evitar timeouts

Templates de WhatsApp que convierten

• Personaliza siempre con {{name}}
• Mantén mensajes cortos (menos de 150 caracteres)
• Incluye una pregunta abierta para fomentar respuesta
• No vendas en el primer mensaje, genera interés

Cuándo usar auto vs manual

• Auto: primer contacto, confirmaciones, follow-ups programados
• Manual: negociación, respuestas a objeciones, cierre

Configuración óptima de IA

• Usa GPT-4o-mini para volumen alto (rápido y barato)
• Usa Claude 3.5 Sonnet para conversaciones complejas (mejor razonamiento)
• Define la persona del chatbot con ejemplos concretos
• Revisa las respuestas del bot periódicamente y ajusta la persona

17. FAQ extendido

¿Cuántos leads puedo extraer?

Depende del plan: FREE (sin scraping), STARTER (500/mes), PRO y BUSINESS (ilimitados). El número máximo de resultados por job es configurable hasta 1000.

¿El scraping es legal?

El scraping de datos públicos de Google Maps es legal conforme a la jurisprudencia europea actual. Sin embargo, debes usar los datos de conformidad con el RGPD y respetar los términos de servicio de las plataformas.

¿Puedo usar mi propio número de WhatsApp?

No. WhatsApp Business API requiere un número dedicado registrado en Meta Business Manager. No puedes usar tu número personal.

¿Qué pasa si cancelo mi suscripción?

La cuenta pasa a plan FREE. Tus datos se conservan 30 días antes de su eliminación. Puedes exportar tus leads en CSV durante ese período.

¿La IA puede enviar mensajes sin supervisión?

Sí, si el chatbot está activado. Pero recomendamos supervisión humana en conversaciones críticas. Puedes desactivar el chatbot en cualquier momento.

¿Puedo integrar LeadVantage con mi CRM existente?

Sí, mediante la API REST (plan BUSINESS) o importando/exportando CSV en cualquier plan.