curl --request POST \
--url 'https://api.scanova.io/lead/L9c2f4a1e/convert/' \
--header 'Authorization: YOUR_API_KEY'
{
"id": 512,
"form_id": "F3b9c1a2",
"lead_id": "L9c2f4a1e"
}
Clientes potenciales y formularios
Convertir una lista de leads en un Formulario
POST /lead//convert/
POST
/
lead
/
{lead_id}
/
convert
/
curl --request POST \
--url 'https://api.scanova.io/lead/L9c2f4a1e/convert/' \
--header 'Authorization: YOUR_API_KEY'
{
"id": 512,
"form_id": "F3b9c1a2",
"lead_id": "L9c2f4a1e"
}
Migra una lista de leads heredada a un Formulario — el generador de captura de leads actual y recomendado de Scanova.
Al convertir una lista de leads:
Requiere una clave de API de gestión con cuota
MANAGEMENT_API (o MANAGEMENT_API_SANDBOX), enviada como el valor sin procesar del encabezado Authorization — consulte el resumen de la API de gestión.string
requerido
El
lead_id de la lista de leads. Sin cuerpo de solicitud.curl --request POST \
--url 'https://api.scanova.io/lead/L9c2f4a1e/convert/' \
--header 'Authorization: YOUR_API_KEY'
{
"id": 512,
"form_id": "F3b9c1a2",
"lead_id": "L9c2f4a1e"
}
- Se crea un nuevo Formulario a partir de las definiciones de campo de la lista de leads.
- Cada código QR actualmente adjunto a la lista de leads se vuelve a vincular al nuevo Formulario.
- Los webhooks activos se migran al mecanismo de webhooks del Formulario (los propios webhooks de la lista de leads se marcan como inactivos).
- Cualquier notificación de leads configurada para esta lista de leads se migra a notificaciones de Formulario.
- La lista de leads se marca como
is_converted: true— a partir de este momento deja de aparecer en Listar listas de leads o Listar listas de leads activas, y las ediciones/entradas/exportaciones adicionales pasan por los endpoints de Formularios en su lugar.
Esto no es idempotente de forma amigable: llamar a la conversión por segunda vez en una lista de leads ya convertida devuelve
404, ya que la búsqueda filtra por listas no convertidas. No hay “deshacer” — verifique is_converted (mediante Obtener una lista de leads, que devolverá 404 una vez convertida) antes de reintentar.400 bajo data si los datos del formulario transformado fallan inesperadamente la validación del esquema de Formulario (un caso límite poco común por desviación de forma, no algo que una lista de leads bien formada debería activar).
Relacionado
- Listar listas de leads — listas de leads elegibles para conversión.
- Gestión de formularios — dónde reside el recurso convertido después.
- Resumen de la API de gestión — el esquema de autenticación y la arquitectura de cuotas a la que pertenece este endpoint.
Autorizaciones
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.
Respuesta
201
Converted.
¿Esta página le ayudó?