Captación de leads

Lead Intake ofrece dos formas de capturar clientes potenciales desde tu sitio web o sistemas externos: una página de formulario público alojada que puedes enlazar o incrustar, y un endpoint de API para enviar leads de forma programática. Todos los leads capturados se incorporan directamente a tu Pipeline para su seguimiento y gestión posterior.

Acceso a Lead Intake

Desde el panel de administración, ve a Configuración en la navegación izquierda y luego selecciona Lead Intake en la sección Workspace. La página muestra la URL de tu formulario alojado, la clave de la API de captación y fragmentos de código para la integración.

URL del formulario alojado

La URL del formulario alojado es una página de acceso público que captura información de leads con la marca de tu organización. Es la forma más sencilla de empezar a recopilar leads; no requiere programación.

La URL del formulario se muestra en un campo de solo lectura con dos controles:

• Copiar — Copia la URL al portapapeles para pegarla en correos electrónicos, publicaciones en redes sociales u otros canales.

• Abrir formulario — Abre el formulario alojado en una nueva pestaña del navegador para que puedas ver cómo lo verán los clientes.

El formulario alojado incluye el nombre de tu organización, el logotipo, el color de marca y la información de contacto. Cuando alguien envía el formulario, Chisel Tide crea automáticamente un nuevo lead en la primera etapa de tu pipeline.

Uso del formulario alojado

Puedes usar la URL del formulario alojado de varias maneras:

• Enlace directo — Comparte la URL en correos electrónicos, mensajes de texto o publicaciones en redes sociales. Los clientes hacen clic en el enlace y completan el formulario directamente.

• Enlace en el sitio web — Añade un botón de "Solicitar presupuesto" o "Contáctanos" en tu sitio web que enlace al formulario alojado.

• Incrustar — Si tienes control sobre tu sitio web, puedes incrustar el formulario mediante un iframe para ofrecer una experiencia fluida.

Gestión de claves de API

Para el envío programático de leads —como capturar leads desde los formularios de tu propio sitio web, integrarte con herramientas de marketing o crear flujos de trabajo personalizados— usarás la Intake API. La autenticación se gestiona mediante tu clave de API.

La sección de la clave de API muestra:

• Campo de clave de API — Muestra tu clave de captación actual, ocultada de forma predeterminada por seguridad.

• Mostrar / Ocultar — Alterna para mostrar u ocultar el valor completo de la clave. La clave se oculta de forma predeterminada para evitar su divulgación accidental si alguien está viendo tu pantalla.

• Copiar — Copia la clave al portapapeles.

• Rotar — Genera una nueva clave de API e invalida la anterior de inmediato.

Debajo del campo de la clave, verás Última actualización con la marca de tiempo de la última vez que se rotó la clave.

Uso de la clave de API

Tu clave de API autentica las solicitudes a la Intake API. Inclúyela en el encabezado Authorization como token Bearer:

Authorization: Bearer YOUR_INTAKE_KEY

Rotación de la clave de API

Cuando rotas la clave de API:

1. Se genera una nueva clave de inmediato.

2. La clave anterior deja de funcionar enseguida; cualquier sistema que aún la use recibirá errores de autenticación.

3. La nueva clave se muestra en pantalla y está lista para usarse.

4. La URL de tu formulario alojado no cambia.

Después de rotarla, actualiza cualquier sistema o script que use la clave de API con el nuevo valor. Si tienes integraciones activas, planifica la rotación durante periodos de bajo tráfico.

Fragmentos de código de inicio rápido

La página de Lead Intake ofrece ejemplos de código listos para usar para enviar leads de forma programática. Hay dos formatos disponibles:

• cURL — Para pruebas desde la línea de comandos o para integraciones con sistemas backend.

• JavaScript — Para integración en el lado del cliente del sitio web.

Cada fragmento incluye el endpoint de la API, los encabezados requeridos y un cuerpo de solicitud de ejemplo con los marcadores de posición del campo de clave completados.

Ejemplo de solicitud cURL

curl -X POST "https://your-domain.com/api/v1/intake/leads" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_INTAKE_KEY" \
  -d '{
    "customer": {
      "name": "Jane Smith",
      "email": "[email protected]",
      "phone": "555-123-4567"
    }
  }'

Herramientas de integración con IA

Dos opciones de integración asistida por IA te ayudan a implementar la captación de leads rápidamente:

Crear con IA

Haz clic en Crear con IA para abrir un asistente de IA que te guía en la configuración de la captación de leads en tu sitio web. Esta función ayuda a generar código de integración adaptado a tu caso de uso específico.

Copiar prompt para LLM

Haz clic en Copiar prompt para LLM para copiar al portapapeles un prompt preescrito. Pega este prompt en ChatGPT, Claude u otro asistente de IA para obtener ayuda contextual al implementar la Intake API. El prompt incluye la estructura de tu endpoint de API y los detalles de autenticación, para que la IA pueda generar código de integración preciso.

Campos de datos del lead

Al enviar leads mediante la API, incluye la información del cliente en el cuerpo de la solicitud. Están disponibles los siguientes campos:

Campos obligatorios

• customer.name — El nombre del contacto (obligatorio).

Información de contacto

• customer.email — La dirección de correo electrónico del contacto. Debes proporcionar al menos uno de los dos: email o teléfono.

• customer.phone — El número de teléfono del contacto. Debes proporcionar al menos uno de los dos: email o teléfono.

Información de la propiedad

• serviceAddress — La dirección del servicio para el posible trabajo, incluyendo calle, ciudad, estado y código postal.

• poolType — El tipo de piscina (enterrada, sobre el suelo, etc.).

• estimatedSize — Tamaño estimado de la piscina.

Detalles del lead

• serviceInterest — En qué servicios está interesado el prospecto.

• estimatedValue — Valor estimado del trato para el lead.

• notes — Notas adicionales o contexto del prospecto.

Campos de atribución

• referrer — Cómo encontró el prospecto tu negocio.

• landingPage — La URL de la página de destino donde se capturó el lead.

• campaign — Identificador de la campaña de marketing.

• utmSource — Parámetro de origen UTM para seguimiento.

• utmMedium — Parámetro de medio UTM para seguimiento.

• utmCampaign — Parámetro de campaña UTM para seguimiento.

• utmContent — Parámetro de contenido UTM para seguimiento.

• utmTerm — Parámetro de término UTM para seguimiento.

Carga de fotos

Cuando la carga de fotos está habilitada para la captación de leads, los prospectos pueden adjuntar imágenes de la piscina o del equipo junto con la consulta. Las fotos enviadas aparecen en el lead del pipeline para que tu equipo de ventas pueda ver las condiciones del lugar antes de la primera visita.

Cómo entran los leads en el Pipeline

Cuando se envía un lead —ya sea a través del formulario alojado o de la API— Chisel Tide crea automáticamente un nuevo registro de lead:

1. Se crea un registro de cliente con la información de contacto enviada.

2. Se crea un lead en la primera etapa de tu Pipeline.

3. El lead aparece en tu tablero de Pipeline, listo para su seguimiento.

Desde el Pipeline, puedes asignar el lead, seguir su progreso por las etapas y convertirlo en cliente cuando se cierre el trato.

Prevención de duplicados

Si alguien envía un lead para un cliente que ya tiene un lead abierto en tu pipeline, Chisel Tide devuelve un error de duplicado en lugar de crear un registro duplicado. Esto evita que tu pipeline se llene de entradas duplicadas para el mismo prospecto.

Solución de problemas

Siguientes pasos

• Revisa y gestiona tus leads en el Pipeline.

• Personaliza las etapas de tu pipeline para que se adapten a tu proceso de ventas.