Custom Fields (Campos personalizados)

Listar campos personalizados

GET /v1/custom-fields

Solo lectura. Retorna las definiciones de campos personalizados para clientes. Útil para saber qué UUIDs usar al filtrar o al crear/actualizar clientes.

Query Parameters:

Parámetro	Tipo	Default	Descripción
orderBy	string	sortOrder	Campo para ordenar
order	string	asc	Dirección del orden

Respuesta exitosa: 200 OK

{
  "total": 3,
  "items": [
    {
      "id": "dd0e8400-e29b-41d4-a716-446655440009",
      "name": "Tipo de cliente",
      "type": "select",
      "required": true,
      "options": ["regular", "premium", "vip"],
      "sortOrder": 1,
      "showInMinisite": 1,
      "requiredInMinisite": 0,
      "showInIaAgent": 1,
      "requiredInIaAgent": 0
    },
    {
      "id": "ee0e8400-e29b-41d4-a716-446655440010",
      "name": "Fuente de referencia",
      "type": "text",
      "required": false,
      "options": null,
      "sortOrder": 2,
      "showInMinisite": 0,
      "requiredInMinisite": 0,
      "showInIaAgent": 0,
      "requiredInIaAgent": 0
    }
  ]
}

Schema de CustomField:

Campo	Tipo	Descripción
id	string	UUID del campo (usar como fieldId al crear/actualizar clientes y como field en filtros)
name	string	Nombre descriptivo
type	string	Tipo: text, select, number, etc.
required	boolean	Si es requerido
options	array | null	Opciones disponibles (para tipo select)
sortOrder	integer	Orden de visualización
showInMinisite	integer	Visible en minisite (0/1)
requiredInMinisite	integer	Requerido en minisite (0/1)
showInIaAgent	integer	Visible para agente IA (0/1)
requiredInIaAgent	integer	Requerido para agente IA (0/1)