Importar leads

Importa leads a PropPilot para iniciar campañas de outreach proactivo. Esta guía cubre la importación CSV, las fuentes de leads y la configuración de plantillas HSM.

Importación CSV

Paso 1: Prepara tu CSV

Crea un archivo CSV con la información del lead:

Columnas obligatorias:

Columna	Formato	Ejemplo
name	Texto	"Juan Pérez"
phone	E.164	"+971501234567"

Columnas opcionales:

Columna	Formato	Ejemplo
email	Correo	"juan@ejemplo.com"
source	Texto	"Property Show 2024"
notes	Texto	"Interesado en 2BR"
budget	Texto	"$500k-$750k"
preferred_location	Texto	"Centro"

Paso 2: Descarga la plantilla

1. Ve a Proactive Leads → pestaña Leads
2. Haz clic en Import
3. Haz clic en Download Template
4. Usa la plantilla para asegurar el formato correcto

Paso 3: Sube el archivo

1. Haz clic en Import o Upload CSV
2. Selecciona tu archivo CSV preparado
3. Espera al procesamiento del archivo

Paso 4: Mapea las columnas

Si las columnas no se mapean automáticamente:

1. Revisa la vista previa del mapeo
2. Empareja las columnas del CSV con los campos de PropPilot
3. Salta las columnas que no necesites

Paso 5: Vista previa de la importación

Antes de confirmar:

• Revisa filas de muestra
• Comprueba si hay errores de validación
• Verifica los formatos de los números de teléfono

Paso 6: Confirmar la importación

1. Haz clic en Import o Confirm
2. Los leads se añaden con estado Pending
3. Consulta el resumen de resultados de la importación

Validación de la importación

El sistema valida:

Comprobación	Error si falla
Formato del teléfono	Número de teléfono inválido
Campos obligatorios	Falta nombre o teléfono
Duplicados	Teléfono ya existe
Formato del archivo	Estructura CSV inválida

Gestionar errores

Si algunas filas fallan:

1. Revisa el informe de errores
2. Corrige los problemas en el CSV
3. Reimporta solo las filas fallidas

Fuentes de leads

Configura de dónde se originan los leads para su tracking y segmentación.

Acceder a las fuentes de leads

1. Ve a Proactive Leads
2. Haz clic en la pestaña Lead Sources

Crear una fuente

1. Haz clic en Add Source
2. Rellena los detalles:

Campo	Descripción
Name	Identificador de la fuente
Type	Landing page, Form, API, CRM, Partner, Manual
Description	Detalles adicionales

Tipos de fuente

Tipo	Caso de uso
Landing Page	Envíos de formularios web
Form	Integraciones de formularios externos
API	Ingestión programática de leads
CRM Import	Exportaciones masivas de CRM
Partner	Proveedores de leads externos
Manual	Leads introducidos a mano

Asignar fuente a leads

Al importar:

1. Selecciona la fuente del lead
2. Todos los leads importados quedan etiquetados con esa fuente

Esto habilita:

• Reporting basado en la fuente
• Atribución de campañas
• Tracking de ROI por fuente

Plantillas HSM

Las plantillas HSM (Highly Structured Message) de WhatsApp son obligatorias para iniciar conversaciones.

Acceder a las plantillas

1. Ve a Proactive Leads
2. Haz clic en la pestaña HSM Templates

Entender las plantillas HSM

Las plantillas HSM son:

• Formatos de mensaje preescritos
• Aprobados por Meta antes de su uso
• Obligatorios para el primer contacto por WhatsApp
• Pueden incluir variables (nombre, etc.)

Crear una plantilla

1. Haz clic en Create Template
2. Rellena los detalles de la plantilla:

Campo	Descripción
Name	Identificador interno
Category	Marketing, Utility, Authentication
Language	Idioma de la plantilla
Header	Cabecera opcional (texto, imagen, vídeo)
Body	Contenido principal del mensaje
Footer	Texto de pie opcional
Buttons	Botones de CTA opcionales

Usar variables

Incluye personalización con variables:

Hola {{1}},

Tenemos nuevas propiedades en {{2}} que coinciden con tus preferencias.

¿Te gustaría saber más?

Variables:

• {{1}} = Nombre del contacto
• {{2}} = Ubicación preferida
• Hasta 10 variables soportadas

Categorías de plantilla

Categoría	Propósito	Tiempo de aprobación
Marketing	Promociones, anuncios	Revisión más larga
Utility	Actualizaciones, confirmaciones	Revisión más rápida
Authentication	OTP, verificación	Revisión más rápida

Enviar para aprobación

1. Completa el contenido de la plantilla
2. Haz clic en Submit for Approval
3. La plantilla se envía a Meta para revisión
4. El estado cambia a Pending Approval

Estado de aprobación

Estado	Significado
Draft	Aún no enviada
Pending	En revisión por Meta
Approved	Lista para usar
Rejected	Rechazada (consulta el motivo)

Si se rechaza

Motivos habituales de rechazo:

• Contenido engañoso
• Falta información de opt-out
• Uso incorrecto de variables
• Violaciones de política

Para corregirlo:

1. Revisa el motivo del rechazo
2. Edita el contenido de la plantilla
3. Reenvíala para aprobación

Enviar outreach

Selecciona leads

1. Ve a la pestaña Leads
2. Filtra los leads (p. ej., estado Pending)
3. Selecciona los leads para outreach

Elige plantilla

1. Haz clic en Send Message o Start Campaign
2. Selecciona una plantilla HSM aprobada
3. Vista previa del mensaje con las variables rellenas

Configura el envío

Opción	Descripción
Send Now	Entrega inmediata
Schedule	Enviar a una hora concreta
Batch Size	Leads por lote
Delay	Tiempo entre lotes

Confirma y envía

1. Revisa los ajustes finales
2. Haz clic en Send o Start Campaign
3. Monitoriza el progreso en tiempo real

Monitorizar campañas

Estado en tiempo real

Sigue la entrega de mensajes:

• En cola
• Enviado
• Entregado
• Leído
• Respondido

Métricas de interacción

Consulta el rendimiento de la campaña:

• Tasa de entrega
• Tasa de lectura
• Tasa de respuesta
• Tasa de interacción

Actualizaciones del estado del lead

A medida que avanza el outreach:

• Pending → Processing → Sent → Engaged
• Las entregas fallidas se marcan adecuadamente
• Las respuestas activan la interacción de la IA

Integración por API

Importación programática de leads

Para integraciones con CRM o automatización:

POST /api/proactive-leads
Authorization: Bearer YOUR_API_KEY

{
  "leads": [
    {
      "name": "Juan Pérez",
      "phone": "+971501234567",
      "email": "juan@ejemplo.com",
      "source": "crm_export",
      "metadata": {
        "budget": "$500k",
        "interest": "apartamento de 2BR"
      }
    }
  ]
}

Notificaciones por webhook

Recibe actualizaciones cuando:

• Cambia el estado de un lead
• Un lead responde
• Se completa una campaña

Buenas prácticas

Calidad del lead

• ✅ Verifica que los números de teléfono sean válidos
• ✅ Asegúrate de tener consentimiento adecuado
• ✅ Elimina duplicados antes de importar
• ✅ Incluye metadatos relevantes

Plantillas

• ✅ Mantén los mensajes concisos
• ✅ Incluye una propuesta de valor clara
• ✅ Añade información de opt-out
• ✅ Pruébalas antes de envíos masivos

Campañas

• ✅ Empieza con lotes pequeños
• ✅ Monitoriza las tasas de entrega
• ✅ Respeta las diferencias de zona horaria
• ✅ Mide y optimiza con el tiempo

Evita

• ❌ Importar leads sin consentimiento
• ❌ Usar mensajería agresiva
• ❌ Ignorar entregas fallidas
• ❌ Enviar a horas extrañas
• ❌ Superar los rate limits de WhatsApp

Resolución de problemas

Errores de importación

Error	Solución
Teléfono inválido	Usa formato E.164 (+prefijo de país)
Duplicado encontrado	Elimina o salta los duplicados
Falta obligatorio	Añade columnas de nombre y teléfono

Fallos de entrega

Problema	Causa	Solución
Número inválido	El teléfono no existe	Verifica el número
No está en WhatsApp	Usuario no registrado	Prueba con correo
Bloqueado	Usuario bloqueó la empresa	Respeta y elimina
Rate limited	Demasiados mensajes	Reduce el tamaño del lote

Problemas con plantillas

Problema	Solución
Rechazada	Revisa y corrige el contenido
Error de variables	Comprueba la sintaxis de variables
Categoría incorrecta	Usa la categoría adecuada

¿Qué sigue?

Vuelve a la documentación principal:

Gestionar contactos →