# 黃希晴 牙醫

> https://www.vitalbooking.com.hk/en/doctordetail/黃希晴-兒童齒科-D04439

## Summary

- Name: 黃希晴 牙醫
- Specialty: Dentist · 兒童齒科
- Qualification:
  - 香港大學牙醫學士 BDS (HK)
  - 香港大學牙醫碩士 (兒童齒科) MDS (Paed Dent)(HK)
  - 英國皇家外科醫學院兒童齒科院員M Paed Dent RCS (Eng)
  - 愛丁堡皇家外科醫學院兒童齒科學院員 M Paed Dent RCSEd
  - 格拉斯哥皇家醫學院兒童齒科院員M Paed Dent RCPS (Glasg)
- 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: Dentist · 兒童齒科
- Doctor gender: Female (女)
- Qualification: 香港大學牙醫學士 BDS (HK) 
香港大學牙醫碩士 (兒童齒科) MDS (Paed Dent)(HK)
英國皇家外科醫學院兒童齒科院員M Paed Dent RCS (Eng) 
愛丁堡皇家外科醫學院兒童齒科學院員 M Paed Dent RCSEd 
格拉斯哥皇家醫學院兒童齒科院員M Paed Dent RCPS (Glasg)

- 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. Pong’s Prosthodontics Centre — clinicId: 33, branchId: 52, subDoctorId: 81

## 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/en/booking/{referenceNo}

### API reference

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