La clave de API está oculta de forma predeterminada por seguridad. Haz clic en Reveal para mostrar el valor completo de la clave. Si sigues teniendo problemas, intenta actualizar la página; es posible que debas esperar a que se cargue la clave.
Captación de clientes potenciales
La captación de clientes potenciales ofrece dos formas de recopilar posibles clientes 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 clientes potenciales mediante programación. Todos los clientes potenciales capturados pasan directamente a tu Pipeline para su seguimiento y gestión.
Acceso a la captación de clientes potenciales
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 recopila información de clientes potenciales con la imagen de marca de tu organización. Es la forma más sencilla de empezar a recopilar clientes potenciales, sin necesidad de programar.
La URL del formulario se muestra en un campo de solo lectura con dos controles:
Copy — Copia la URL al 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 cliente potencial 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 en tu sitio web un botón «Solicitar presupuesto» o «Contáctanos» que enlace al formulario alojado.
Inserción — 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 clientes potenciales mediante programación —por ejemplo, al recopilar clientes potenciales de tus propios formularios 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 — Permite mostrar u ocultar el valor completo de la clave. La clave está oculta de forma predeterminada para evitar que se divulgue accidentalmente si alguien está viendo tu pantalla.
Copy — Copia la clave al 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.
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_KEYTrata tu clave de API como una contraseña. Mantenla segura y nunca la guardes en repositorios públicos. Si sospechas que la clave se ha visto comprometida, rótala inmediatamente para revocar el acceso.
Rotación de la clave de API
Cuando rotas la clave de API:
Se genera inmediatamente una clave nueva.
La clave anterior deja de funcionar de inmediato; cualquier sistema que siga utilizándola recibirá errores de autenticación.
La nueva clave se muestra en pantalla y está lista para usarse.
La URL de tu formulario alojado cambia a un valor nuevo, 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 clientes potenciales proporciona ejemplos de código listos para usar para enviar clientes potenciales mediante programación. Hay dos formatos disponibles:
cURL — Para realizar pruebas desde la línea de comandos o integrarse 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 requeridos y un cuerpo de solicitud de ejemplo con los marcadores de posición del campo de clave ya rellenados.
Solicitud cURL de ejemplo
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 clientes potenciales:
Créalo con IA
En la sección Build it with AI, haz clic en Copy LLM prompt para copiar un prompt preescrito 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 Intake API.
Copiar prompt para LLM
Haz clic en Copy LLM prompt para copiar un prompt preescrito al portapapeles. Pega este prompt en ChatGPT, Claude u otro asistente de IA para obtener ayuda contextualizada al implementar la Intake API. El prompt incluye la estructura del endpoint de tu API y los detalles de autenticación, de modo que la IA pueda generar código de integración preciso.
Campos de datos del cliente potencial
Al enviar clientes potenciales 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 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, incluida la calle, la ciudad, el estado y el código postal.
poolType — El tipo de piscina (enterrada, elevada, etc.).
intake.estimatedPoolSize — Tamaño estimado de la piscina.
Detalles del cliente potencial
intake.serviceInterest — Los servicios que interesan al posible cliente.
intake.estimatedValueCents — Valor estimado de la oportunidad para el cliente potencial.
intake.notes — Notas o contexto adicionales proporcionados por el posible cliente.
Campos de atribución
referrer — Cómo encontró el posible cliente tu empresa.
landingPage — La URL de la página de destino donde se capturó el cliente potencial.
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 clientes potenciales, los posibles clientes pueden adjuntar imágenes de la piscina o del equipo a la consulta. Las fotos enviadas aparecen en el cliente potencial del pipeline, para que tu equipo de ventas pueda ver las condiciones del lugar antes de la primera visita.
Cómo entran los clientes potenciales en el pipeline
Cuando se envía un cliente potencial, ya sea mediante el formulario alojado o la API, Chisel Tide crea automáticamente un nuevo registro de cliente potencial:
Se crea un registro de cliente con la información de contacto enviada.
Se crea un cliente potencial en la primera etapa abierta de tu Pipeline.
El cliente potencial aparece en el tablero de tu Pipeline, listo para su seguimiento.
Desde el Pipeline, puedes asignar el cliente potencial, seguir su progreso por las etapas y convertirlo en cliente cuando se cierre la oportunidad.
Prevención de duplicados
Si alguien envía un cliente potencial para un cliente que ya tiene un cliente potencial 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 posible cliente.
Solución de problemas
¿Por qué no puedo ver mi clave de API?
¿Qué ocurre después de rotar mi clave de API?
Al rotar la clave de API se genera una clave nueva y la anterior se invalida inmediatamente. Las integraciones que utilicen la clave anterior empezarán a recibir errores de autenticación hasta que las actualices con la clave nueva. La rotación de la clave también cambia la URL de tu formulario alojado, por lo que debes actualizar los enlaces o elementos insertados que utilicen la URL anterior.
Después de rotarla, copia la clave nueva y actualiza cualquier script, integración de Zapier u otro sistema que envíe clientes potenciales mediante programación.
¿Por qué mi solicitud de API devuelve 401 Unauthorized?
Las causas más comunes son:
Falta el encabezado Authorization — Incluye la clave como
Authorization: Bearer YOUR_INTAKE_KEY.Clave de API anterior después de la rotación — Si has rotado la clave recientemente, es posible que tu integración siga utilizando la clave anterior. Actualízala con la clave actual de la página de configuración de Lead Intake.
Clave con formato incorrecto — Asegúrate de que la clave se haya copiado completa, sin espacios adicionales ni saltos de línea.
¿Por qué mi solicitud de API devuelve 409 Conflict?
Esto significa que ya existe un cliente potencial para este cliente. Chisel Tide evita que haya clientes potenciales abiertos duplicados para el mismo cliente. La detección de clientes potenciales abiertos duplicados utiliza actualmente la dirección de correo electrónico enviada; comprueba si existe en tu Pipeline un cliente potencial con el mismo correo y actualiza ese cliente potencial en lugar de crear uno nuevo.
¿Por qué mi solicitud de API devuelve 400 Bad Request?
Verifica que el cuerpo de la solicitud incluya los campos obligatorios:
customer.namees obligatorio.Se requiere al menos uno de estos campos:
customer.emailocustomer.phone.
Comprueba también que tu JSON sea válido y que se incluya el encabezado Content-Type: application/json.
¿La Intake API tiene un límite de solicitudes?
La Intake API tiene límites de solicitudes para protegerla contra usos indebidos. Si recibes una respuesta 429 Too Many Requests, espera unos instantes antes de volver a intentarlo. Para escenarios de captación de clientes potenciales de gran volumen, contacta con soporte para hablar de tus necesidades.
Siguientes pasos
Revisa y gestiona tus clientes potenciales en el Pipeline.
Personaliza las etapas de tu pipeline para adaptarlas a tu proceso de ventas.