Captación de leads

La captación de leads ofrece dos formas de obtener clientes potenciales desde tu sitio web o sistemas externos: una página de formulario público alojada que puedes enlazar o insertar, y un endpoint de API para enviar leads mediante programación. Todos los leads capturados pasan directamente a tu Pipeline para su seguimiento y gestión.

Acceder a la captación de leads

Desde el panel de administración, ve a Settings en la navegación izquierda y selecciona Lead Intake en la sección Workspace. La página muestra la URL de tu formulario alojado, la clave de 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 la información de los leads con la imagen de 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:

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

• Open form — Abre el formulario alojado en una nueva pestaña del navegador para que puedas previsualizar lo que verán los clientes.

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

Usar el formulario alojado

Puedes usar la URL del formulario alojado de varias formas:

• 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 del sitio web — Añade en tu sitio web un botón «Obtener un presupuesto» o «Contáctanos» que enlace al formulario alojado.

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

Gestión de claves de API

Para enviar leads mediante programación —por ejemplo, para capturarlos desde los formularios de tu propio sitio web, integrarlos con herramientas de marketing o crear flujos de trabajo personalizados— usarás la API de captación. 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 motivos de seguridad.

• Reveal / Hide — Alterna entre mostrar u ocultar el valor completo de la clave. La clave está oculta de forma predeterminada para evitar que se revele accidentalmente si alguien está viendo tu pantalla.

• Copy — Copia la clave en el portapapeles.

• Rotate — Genera una nueva clave de API e invalida inmediatamente la anterior.

Debajo del campo de la clave, verás Last updated con la fecha y hora en que se rotó la clave por última vez.

Usar la clave de API

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

Authorization: Bearer YOUR_INTAKE_KEY

Rotar la clave de API

Al rotar la clave de API:

1. Se genera inmediatamente una nueva clave.

2. La clave anterior deja de funcionar de inmediato; los sistemas que aún la utilicen recibirán errores de autenticación.

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

4. La URL de tu formulario alojado cambia a un nuevo valor, por lo que debes actualizar los enlaces o elementos insertados que utilicen la URL anterior.

Después de rotarla, actualiza con el nuevo valor todos los sistemas o scripts que utilicen la clave de API. Si tienes integraciones activas, planifica la rotación durante periodos de poco tráfico.

Fragmentos de código de inicio rápido

La página de captación de leads proporciona ejemplos de código listos para usar para enviar leads mediante programación. Hay dos formatos disponibles:

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

• JavaScript — Para la integración en sitios web del lado del cliente.

Cada fragmento incluye el endpoint de la API, los encabezados obligatorios y un cuerpo de solicitud de ejemplo con los marcadores de posición del campo de clave ya 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 rápidamente la captación de leads:

Crearlo con IA

En la sección Build it with AI, haz clic en Copy LLM prompt para copiar un prompt prediseñado que puedes usar en un asistente de IA externo. Pega el prompt en ChatGPT, Claude u otro asistente de IA para obtener ayuda contextualizada al implementar la API de captación.

Copiar prompt de LLM

Haz clic en Copy LLM prompt para copiar un prompt prediseñado en el portapapeles. Pega este prompt en ChatGPT, Claude u otro asistente de IA para obtener ayuda contextualizada al implementar la API de captación. El prompt incluye la estructura del endpoint de tu 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. Los siguientes campos están disponibles:

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 estos datos: correo electrónico o teléfono.

• customer.phone — El número de teléfono del contacto. Debes proporcionar al menos uno de estos datos: correo electrónico o teléfono.

Información de la propiedad

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

• intake.poolType — El tipo de piscina (enterrada, elevada, etc.).

• intake.estimatedPoolSize — Tamaño estimado de la piscina.

Detalles del lead

• intake.serviceInterest — Los servicios que interesan al cliente potencial.

• intake.estimatedValueCents — Valor estimado de la oportunidad para el lead.

• intake.notes — Notas o contexto adicionales proporcionados por el cliente potencial.

Campos de atribución

• intake.referrerName — Cómo encontró el cliente potencial tu negocio.

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

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

• intake.utm.source — Parámetro de fuente UTM para el seguimiento.

• intake.utm.medium — Parámetro de medio UTM para el seguimiento.

• intake.utm.campaign — Parámetro de campaña UTM para el seguimiento.

• intake.utm.content — Parámetro de contenido UTM para el seguimiento.

• intake.utm.term — Parámetro de término UTM para el seguimiento.

Carga de fotos

Cuando la carga de fotos está habilitada para la captación de leads, los clientes potenciales pueden adjuntar imágenes de la piscina o del equipo a su consulta. Las fotos enviadas aparecen en la línea de tiempo de actividad del cliente vinculado, que puedes abrir desde el lead del pipeline.

Cómo entran los leads en el pipeline

Cuando se envía un lead —ya sea mediante el formulario alojado o 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 abierta de tu Pipeline.

3. El lead aparece en el tablero de tu 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 la oportunidad.

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 cliente potencial.

Solución de problemas

Siguientes pasos

• Revisa y gestiona tus leads en el Pipeline.

• Personaliza las etapas de tu pipeline para adaptarlas a tu proceso de ventas.