Kivicare Telemed Addon
Integration Reference

Database Mappings Table

The plugin uses a custom table to maintain the link between WordPress and Zoom. This prevents unnecessary API requests by caching the meeting details locally.


📋 Table Name: wp_kc_appointment_zoom_mappings

ColumnTypeDescription
idbigintPrimary Key (Auto Increment).
appointment_idbigintID of the KiviCare Appointment.
zoom_idvarchar(191)The raw ID for the meeting in Zoom.
zoom_uuidvarchar(191)The unique UUID for the specific meeting instance.
start_urllongtextThe host-only link used by the Doctor.
join_urllongtextThe attendee link used by the Patient.
passwordvarchar(191)The meeting passcode.
created_atdatetimeWhen the mapping was created.

🛠️ Accessing Data Programmatically

Developers can use the KCTAppointmentZoomMapping model to retrieve data:

use KCTApp\models\KCTAppointmentZoomMapping;

// Find mapping for a specific appointment
$mapping = KCTAppointmentZoomMapping::where('appointment_id', $id)->first();

if($mapping) {
    echo "Zoom Join URL: " . $mapping->join_url;
}

🗑️ Data Cleanup

When an appointment is deleted in KiviCare, the plugin hooks into the deletion event to:

  1. Cancel the meeting on Zoom using the zoom_id.
  2. Delete the corresponding row from this mapping table.

Next: Plugin REST API Endpoints

Suggestions & Improvements

Your email address will not be published. Required fields are marked *