Chisel Tide
Configuración

Captación de Leads

Captación de Leads ofrece dos formas de captar clientes potenciales desde su sitio web o sistemas externos: una página de formulario pública alojada que puede enlazar o insertar, y un punto de conexión de API para el envío programático de leads. Todos los leads captados fluyen directamente a su Pipeline para su seguimiento y gestión.

Acceder a Captación de Leads

Desde el panel de administración, navegue a Configuración en la navegación izquierda, luego seleccione Captación de Leads en la sección Workspace. La página muestra la URL de su 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 información de leads con la imagen de marca de su organización. Esta es la forma más sencilla de empezar a captar leads, sin necesidad de 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 pueda previsualizar lo que verán los clientes.

El formulario alojado incluye el nombre de su organización, el logotipo, el color de la 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 su pipeline.

Uso del formulario alojado

Puede utilizar la URL del formulario alojado de varias maneras:

  • Enlace directo — Comparta 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 al sitio web — Añada un botón de "Obtener presupuesto" o "Contáctenos" en su sitio web que enlace al formulario alojado.

  • Insertar — Si tiene control sobre su sitio web, puede insertar el formulario mediante un iframe para una experiencia integrada.

Gestión de la clave de API

Para el envío programático de leads (como captar leads desde los formularios de su propio sitio web, integrarlos con herramientas de marketing o crear flujos de trabajo personalizados), utilizará la API de captación. La autenticación se gestiona a través de su clave de API.

La sección de la clave de API muestra:

  • Campo de clave de API — Muestra su clave de captación actual, oculta por defecto por seguridad.

  • Mostrar / Ocultar — Permite mostrar u ocultar el valor completo de la clave. La clave está oculta por defecto para evitar su divulgación accidental si alguien está viendo su pantalla.

  • Copiar — Copia la clave al portapapeles.

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

Debajo del campo de la clave, verá Last updated con la marca de tiempo de cuándo se rotó la clave por última vez.

Uso de la clave de API

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

Authorization: Bearer YOUR_INTAKE_KEY

Trate su clave de API como una contraseña. Manténgala segura y nunca la publique en repositorios públicos. Si sospecha que la clave ha sido comprometida, rótela inmediatamente para revocar el acceso.

Rotación de la clave de API

Al rotar la clave de API:

  1. Se genera una nueva clave inmediatamente.

  2. La clave antigua deja de funcionar de inmediato; cualquier sistema que todavía la use recibirá errores de autenticación.

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

  4. La URL de su formulario alojado no cambia.

Después de rotar, actualice cualquier sistema o script que utilice la clave de API con el nuevo valor. Planifique la rotación de la clave durante períodos de poco tráfico si tiene integraciones activas.

Fragmentos de código de inicio rápido

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

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

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

Cada fragmento incluye el punto de conexión de la API, los encabezados obligatorios y un cuerpo de solicitud de ejemplo con los marcadores de posición de los campos 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 le ayudan a implementar la captación de leads rápidamente:

Construir con IA

Haga clic en Construir con IA para iniciar un asistente de IA que le guiará en la configuración de la captación de leads en su sitio web. Esta función ayuda a generar código de integración adaptado a su caso de uso específico.

Copiar prompt de LLM

Haga clic en Copiar prompt de LLM para copiar un prompt ya redactado a su portapapeles. Pegue este prompt en ChatGPT, Claude u otro asistente de IA para obtener ayuda contextualizada para implementar la API de captación. El prompt incluye la estructura de su punto de conexión de API y los detalles de autenticación, para que la IA pueda generar un código de integración preciso.

Campos de datos de leads

Al enviar leads a través de la API, incluya 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. Debe proporcionar al menos un correo electrónico o un teléfono.

  • customer.phone — El número de teléfono del contacto. Debe proporcionar al menos un correo electrónico o un teléfono.

Información de la propiedad

  • serviceAddress — La dirección de servicio para el trabajo potencial, 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 — Servicios en los que el cliente potencial está interesado.

  • estimatedValue — Valor estimado de la oportunidad para el lead.

  • notes — Notas adicionales o contexto del cliente potencial.

Campos de atribución

  • referrer — Cómo encontró el cliente potencial su negocio.

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

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

  • utmSource — Parámetro UTM source para el seguimiento.

  • utmMedium — Parámetro UTM medium para el seguimiento.

  • utmCampaign — Parámetro UTM campaign para el seguimiento.

  • utmContent — Parámetro UTM content para el seguimiento.

  • utmTerm — Parámetro UTM term para el seguimiento.

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 su Pipeline.

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

Desde el Pipeline, puede asignar el lead, realizar un seguimiento de su progreso a través de las etapas y convertirlo en cliente cuando se cierre el trato.

Prevención de duplicados

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

Resolución de problemas

¿Por qué no puedo ver mi clave de API?

La clave de API está oculta por defecto por seguridad. Haga clic en Mostrar para ver el valor completo de la clave. Si sigue teniendo problemas, intente refrescar la página; es posible que deba esperar a que la clave se cargue.

¿Qué sucede después de rotar mi clave de API?

La rotación de la clave de API genera una nueva clave e invalida la clave antigua inmediatamente. Cualquier integración que utilice la clave antigua empezará a recibir errores de autenticación hasta que la actualice con la nueva clave. La URL de su formulario alojado no cambia; solo la clave de API para el acceso programático.

Después de rotar, copie la nueva clave y actualice cualquier script, integración de Zapier u otros sistemas que envíen leads de forma programática.

¿Por qué mi solicitud de API devuelve 401 Unauthorized?

Las causas más comunes son:

  • Falta el encabezado Authorization — Incluya la clave como Authorization: Bearer YOUR_INTAKE_KEY.

  • Clave de API antigua después de la rotación — Si ha rotado la clave recientemente, es posible que su integración siga utilizando la clave antigua. Actualícela con la clave actual desde la página de configuración de Captación de Leads.

  • Clave malformada — Asegúrese de que la clave se haya copiado por completo, sin espacios adicionales ni saltos de línea.

¿Por qué mi solicitud de API devuelve 409 Conflict?

Esto significa que ya existe un lead para este cliente. Chisel Tide evita la duplicación de leads abiertos para el mismo cliente. Compruebe su Pipeline para ver si existe un lead con el mismo correo electrónico o número de teléfono, y actualice ese lead en lugar de crear uno nuevo.

¿Por qué mi solicitud de API devuelve 400 Bad Request?

Verifique que el cuerpo de su solicitud incluya los campos obligatorios:

  • customer.name es obligatorio.

  • Se requiere al menos uno de customer.email o customer.phone.

Compruebe también que su JSON sea válido y que se incluya el encabezado Content-Type: application/json.

¿Existe un límite de frecuencia en la API de captación?

La API de captación tiene limitación de frecuencia para proteger contra el abuso. Si recibe una respuesta 429 Too Many Requests, espere un momento antes de volver a intentarlo. Para escenarios de captación de leads de gran volumen, póngase en contacto con el servicio de asistencia para comentar sus necesidades.

Próximos pasos

  • Revise y gestione sus leads en el Pipeline.

  • Personalice las etapas de su pipeline para que coincidan con su proceso de ventas.

¿Te fue útil?