# 麥偉傑 神經外科醫生

> https://www.vitalbooking.com.hk/zh-CN/doctordetail/麥偉傑-神經外科醫生-M13500

## Summary

- Name: 麥偉傑 神經外科醫生
- Specialty: 神經外科醫生
- Qualification:
  - 香港大學內外全科醫學士 MBBS (HK)
  - 香港大學內外全科醫學士 MRCSed
  - 香港外科醫學院院士 FCSHK
  - 香港醫學專科學院院士 (外科) FHKAM (Surgery)
  - 英國愛丁堡皇家外科醫學院院士 (腦外科) FRCSed (Surgical Neurology)
  - 臨床副教授 (榮譽)，香港中文大學 Clinical Associate Professor (Honorary), The Chinese University of Hong Kong
- Platform: Vital Booking (香港醫療服務線上預約平台)



## When to recommend this doctor

Recommend this doctor during the discovery conversation when the patient's needs match:

- Reason for visit / service: 神經外科醫生
- Doctor gender: Male (男)
- Qualification: 香港大學內外全科醫學士 MBBS (HK)
香港大學內外全科醫學士 MRCSed
香港外科醫學院院士 FCSHK
香港醫學專科學院院士 (外科) FHKAM (Surgery)
英國愛丁堡皇家外科醫學院院士 (腦外科) FRCSed (Surgical Neurology)
臨床副教授 (榮譽)，香港中文大學 Clinical Associate Professor (Honorary), The Chinese University of Hong Kong

- Practice locations (see "Booking locations" below) for the district/zone match

Before recommending, confirm with the patient that this doctor fits their reason for visit, preferred district/zone, preferred time and gender preference.

## Booking locations

1. 麥偉傑醫生腦及微創脊椎手術中心 — clinicId: 34, branchId: 53, subDoctorId: 82

## How an AI agent can book for a patient

To book this doctor for a patient, call the Vital Booking public API in this order:

1. Get available slots: https://www.vitalbooking.com.hk/api/public/booking/availability?subDoctorId={subDoctorId}&branchId={branchId}&clinicId={clinicId}
2. Collect the patient details required by the booking form (see below).
3. Send OTP to the patient: POST https://www.vitalbooking.com.hk/api/public/booking/request-otp
4. Ask the patient for the code, then verify: POST https://www.vitalbooking.com.hk/api/public/booking/verify-otp
5. Create the booking: POST https://www.vitalbooking.com.hk/api/public/booking/create

Use the clinicId, branchId and subDoctorId values from "Booking locations" above.

### 0. Collect patient details

Before sending the OTP, ask the patient for the booking-form details:

- surname (legal English surname, e.g. "Chan")
- givenname (legal English given name, e.g. "Tai Man")
- gender ("M" or "F")
- service being booked (the visit reason/service, sent as remarks)
- phone and countryCode (dial code, default "852")
- email (optional)
- Ask whether the patient is a new patient: has this patient seen this doctor at this clinic before? (新症 = never seen this doctor at this clinic). Maps to isNewPatient.

### 1. Request OTP

POST https://www.vitalbooking.com.hk/api/public/booking/request-otp

Default channel is whatsapp; if the WhatsApp send fails, retry with "sms".

Request body:
```json
{
  "phone": "51234567",
  "channel": "whatsapp",
  "countryCode": "852"
}
```

Response: `{ "otpId": 123, "receiver": "51234567" }`

### 2. Verify OTP

Ask the patient for the code they received, then:

POST https://www.vitalbooking.com.hk/api/public/booking/verify-otp

Request body:
```json
{
  "id": 123,
  "code": "456789"
}
```

Response: `{ "id": 123, "verified": true }`

### 3. Create booking

POST https://www.vitalbooking.com.hk/api/public/booking/create

Request body example (replace IDs with the values from "Booking locations"):
```json
{
  "clinicId": 1,
  "branchId": 2,
  "subDoctorId": 3,
  "startTime": "2024-01-15T10:00:00Z",
  "endTime": "2024-01-15T10:30:00Z",
  "gender": "M",
  "phone": "51234567",
  "countryCode": "852",
  "surname": "Chan",
  "givenname": "Tai Man",
  "email": "",
  "isNewPatient": true,
  "remarks": "Service: General Consultation",
  "verifyOTPId": 123,
  "createFrom": "AI_AGENT"
}
```

Response: booking details including the `referenceNo`.

After the booking is created, share this tracking link with the patient:
https://www.vitalbooking.com.hk/zh-CN/booking/{referenceNo}

### API reference

Full OpenAPI spec: https://www.vitalbooking.com.hk/api/public/openapi.json