API de creación de leads

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

---

Endpoint

POST https://507fy.solfy.net/webhook/lead-creation

---

Autenticación

Cada proveedor dispone de un token único facilitado por Solfy. Debe incluirse en la cabecera Authorization usando el esquema Bearer.

Authorization: Bearer <tu_token_solfy>

Token por proveedor

El token es exclusivo e intransferible. Si está ausente, mal formado o no autorizado, el servidor responderá con HTTP 401 o 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
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

curl -X POST https://507fy.solfy.net/webhook/lead-creation \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <tu_token_solfy>" \
  -d '{
    "properties": {
      "email": "cliente@ejemplo.com",
      "firstname": "Juan",
      "lastname": "García",
      "phone": "+34612345678",
      "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.

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 recibido y procesado correctamente.

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

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

HTTP 400 — Campos faltantes o error en los datos

Falta uno o más campos obligatorios, o los datos no han podido procesarse. Revisar el body antes de reenviar.

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

HTTP 401 — Token inválido o ausente

El token no está presente o no sigue el formato correcto (Bearer <token>).

{
  "status": "error",
  "message": "Missing authorization token"
}

HTTP 403 — Sin permisos

El token es válido pero no tiene permisos para realizar esta operación. Contactar con Solfy.

{
  "status": "error",
  "message": "Insufficient permissions"
}

HTTP 409 — Contacto ya existe

El lead ha sido rechazado porque el contacto ya existe en nuestro CRM.

{
  "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 recibido y procesado correctamente.
400	Campos obligatorios ausentes, vacíos o datos incorrectos.
401	Token de autenticación inválido o ausente.
403	Token válido sin permisos suficientes. Contactar Solfy.
409	Contacto duplicado / ya existe en nuestro CRM.
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.