API de creación de leads de externos

Guía de integración para proveedores externos de generación de leads.

Endpoint

POST https://507fy.solfy.net/webhook/fdccc7ea-2764-42b9-87fd-19d33b637706

Autenticación

Cada proveedor dispone de un token único facilitado por Solfy. Debe incluirse en la cabecera Authorization de cada petición.

Authorization: Bearer <tu_token_solfy>

Token por proveedor

El token es exclusivo e intransferible. Si está ausente o es incorrecto, el servidor responderá con HTTP 403.

Formato de la petición

Cabeceras

Cabecera	Valor
`Content-Type`	`application/json`
`Authorization`	`Bearer <tu_token_solfy>`

Body JSON

El cuerpo debe contener un objeto properties con los campos del lead.

Campo	Tipo	Requerido	Descripción
`email`	string	✅	Email del lead. Actúa como identificador único.
`firstname`	string	✅	Nombre.
`lastname`	string	—	Apellidos.
`phone`	string	✅	Teléfono. Formato recomendado: `+34XXXXXXXXX`
`provincia`	string	✅	Provincia. Ej: `Madrid`, `Barcelona`.
`zip`	string	✅	Código postal (5 dígitos).
`tipo_de_lead`	string	✅	Producto de interés. Ver valores permitidos.
`procedencia_lead`	string	✅	Nombre del proveedor. Acordar con Solfy.
`comentarios_proveedor`	string	—	Notas adicionales sobre el lead. Texto libre.

Ejemplo

POST /webhook/fdccc7ea-2764-42b9-87fd-19d33b637706 HTTP/1.1
Host: 507fy.solfy.net
Content-Type: application/json
Authorization: Bearer <tu_token_solfy>

{
  "properties": {
    "email":                 "cliente@ejemplo.com",
    "firstname":             "Juan",
    "lastname":              "García",
    "phone":                 "+34612345678",
    "provincia":             "Madrid",
    "zip":                   "28001",
    "tipo_de_lead":          "Aerotermia",
    "procedencia_lead":      "NombreProveedor",
    "comentarios_proveedor": "Interesado en sustitución de caldera"
  }
}

Valores permitidos

`tipo_de_lead`

Enviar exactamente uno de estos valores. Cualquier otro valor será rechazado.

Valor
`Aerotermia`
`Fotovoltaica`
`Industrial`
`Industrial (prospección)`
`Baterías`
`Mantenimiento`
`Otros`

`procedencia_lead`

Texto acordado con Solfy. Se asignará un valor fijo a cada proveedor para garantizar una segmentación limpia en los reportes.

Respuestas

`HTTP 200` — Éxito

El lead ha sido creado correctamente.

{
  "message": "Lead received",
  "id_lead": "12345678"
}

id_lead es el identificador del contacto en el sistema de Solfy.

`HTTP 400` — Campos faltantes

Falta uno o más campos obligatorios. Corregir el body antes de reenviar.

{
  "status": "error",
  "message": "Missing required field"
}

`HTTP 409` — Lead duplicado

El lead ya existe.

{
  "status": "error",
  "message": "Contact already exists"
}

`HTTP 500` — Error interno

Reintentar pasados unos minutos. Si persiste, contactar con Solfy.

{
  "status": "error",
  "message": "Could not be processed, please try again later or ask for support"
}

Resumen

Código	Significado
`200`	Lead creado correctamente.
`400`	Campos obligatorios ausentes o vacíos.
`403`	Token de autenticación inválido o ausente.
`409`	El lead ya existe.
`500`	Error interno. Reintentar o contactar soporte.

Soporte

Para incidencias técnicas o para solicitar el token de acceso, contactar con el equipo de Solfy indicando el código de error recibido y el timestamp de la petición fallida.