English
📞 Leads and follow-ups
Before you start
A Lead is a potential patient's enquiry record. A Follow Up is a dated task for a patient. Use the correct area for the work.
The walkthrough uses fictional DEMO ENQUIRY / 教學查詢. It does not send phone calls, WhatsApp messages or emails.
1. Find a lead before creating one
- Open Leads from the left menu.
- Use Search to check for an existing record.
- Compare the name, phone, email and language before selecting a record.
- The pencil button edits the row. The trash button is for deletion.
2. Create a lead
- Select Create Lead.
- Enter Name and English Name as appropriate.
- Check ID Type, Document No., Gender, Birth and Preferred Language. Do not invent missing identity details.
- Check the Area Code and Phone No.. Add backup phone and email only when needed.
- Review From, Tags and Notes. This example uses Manual as its source.
- Review Accept WhatsApp Marketing and Accept Email Marketing against the person's actual consent. A preselected checkbox is not proof of consent.
- Select Create once. Wait for the dialog to close.
- Confirm the new row and its contact details. Cancel leaves the new draft unsaved.
3. Edit a lead
- Find the correct row and select its pencil button.
- In Edit Lead, change the intended fields.
- Select Save. Reopen the same row to check the saved result.
This example updates Notes. It keeps both marketing boxes off. Saving a contact record does not itself send a message.
4. Convert a lead to a patient
- Check identity and search Patients first. Avoid creating a duplicate patient.
- Save any edits, then reopen the lead's pencil button.
- Review the record and select Convert to Patient.
This button completed the conversion immediately in the demonstrated interface. There was no second confirmation dialog. Do not use it just to preview a patient form.
- Check that the lead is no longer in the lead list.
- Open Patients. Find the same person and check the new patient number and contact details.
The example became patient #8. Conversion does not mean an appointment has been booked. Continue with the patient's actual next task.
5. Find follow-ups in the worklist
- Open Follow Ups from the left menu.
- Check the selected clinic and Filters. The initial view uses Me and Today.
- Choose the date range you need: Today, Next 7 days, Past, or a date in the calendar.
- Review Pending, In Progress, Completed and Cancelled. Status buttons can be toggled; more than one can be selected.
- Check Me, Unassigned or Select assignee. Selecting a named assignee replaces the broad owner selection.
- Read Date, Patient, Description, Status, Assigned to and Linked appointment in the result.
Selecting an active status, date shortcut or owner filter again can clear that choice. Do not assume an empty list means the task was deleted. In particular, tomorrow's work is not in Today's list.
The worklist itself directs you to create follow-ups from a patient profile or consultation.
6. Create a follow-up from a patient
- Open Patients, select the correct patient and choose Follow Ups.
- Select New Follow Up.
- Check the patient name in the drawer.
- Fill Description with the task that needs doing.
- Set Date. Choose Assign to, or leave it Unassigned if that is intended.
- Select Create follow up once.
- Check the saved card, due date, assignee and Pending status.
No appointment scheduled means the dated task has no linked booking. A follow-up date alone does not reserve a doctor's time. To create from a consultation, see Consultations.
7. Edit the date, task or assignee
- Select the follow-up card or its worklist row.
- In Follow Up Details, review Description, Date and Assign to.
- Change the intended fields. Use the clear control beside an assignee only when the task should become unassigned.
- Select Save changes when it appears.
- Check the saved values and Timeline. The example moves the due date from 16 to 17 October 2026.
Closing a changed drawer can show Discard unsaved changes?. Cancel keeps you in the editor; Discard changes leaves without saving those edits.
8. Change the follow-up status
- Open the status selector in the card, worklist row or detail drawer.
- Choose the status that matches the work actually done.
- Check the new status and Timeline entry. In this example, choosing a status saved it immediately.
| Status | Use it for |
|---|---|
| Pending | Work still waiting to be handled. |
| In Progress | Work currently being handled. |
| Completed | The follow-up task has been completed. |
| Cancelled | The follow-up task will not proceed. |
The left worklist status buttons filter results. They do not change a patient's follow-up status.
9. Add a progress update
- In Timeline, type the result in Add an update….
- Select Add update.
- Check the saved entry, author and time. The input becoming empty alone is not enough; find the new entry.
In the example, the update explicitly says no real contact was made. For real work, record what actually happened. An update does not automatically mark the task Completed.
10. Schedule a linked appointment
- In the follow-up details, find Linked appointment.
- Select Schedule appointment.
- Check the preselected patient and doctor.
- Review Department, Date, Time, End Time, Consultation Mode, equipment and Notes. The follow-up date is a starting point; verify the booking itself.
- Select Create, or Cancel to leave without creating the booking.
- Check the linked card's date, time, doctor and appointment status. The example creates a fictional 17 October 2026, 12:00 appointment.
- If that booking needs a change, use Edit on the linked card and follow appointment editing.
11. Complete a follow-up without cancelling the booking
Choose Completed only when the task is finished, then check the linked appointment separately.
The example still shows an Unsigned appointment after the follow-up becomes Completed. Completing a task did not cancel the booking.
12. Cancel and unlink an appointment
Use this when the appointment itself should be cancelled, not merely when the follow-up task is complete.
- In Linked appointment, select Cancel and unlink appointment.
- Read The appointment will be cancelled and removed from this follow up.
- Select Cancel to keep it, or Cancel and unlink to perform the stated action.
- Check No linked appointment and the Appointment cancelled and unlinked Timeline entry.
The demonstration cancels only its fictional booking. Its follow-up stays Completed. If the booking is already cancelled, the confirmation can instead offer Unlink appointment; read the actual dialog before acting.
13. Find the completed task again
- Return to Follow Ups.
- Choose a date range that includes the task.
- Include Completed and the correct assignee in the filters.
- Open the row to review its history.
Before you leave
Check the correct person, saved follow-up date, assignee, status, latest update and booking state. Lead conversion, task completion and appointment cancellation are separate actions.
❓ FAQ
Where is the New Follow Up button?
Create from the patient’s Follow Ups tab or a consultation. The main Follow Ups worklist provides filters and existing tasks.
Does Convert to Patient show another confirmation?
It converted the example immediately. Check identity and duplicates first. Save edits before using it, then check Patients for the result.
Do the marketing checkboxes send a message?
This workflow stores the choices. It does not send a campaign. Check actual consent; a default checked box is not proof of consent. External sending and connections are outside this guide.
Why is my follow-up not in the list?
Check clinic, date, selected statuses, Me, Unassigned and any named assignee. Today excludes future tasks. Include Completed if the task has already been completed.
Does selecting a worklist filter change the task?
No. Filters change which rows you see. Change a task’s status using that row, card or detail drawer’s status selector.
Does Add update complete the task?
No. It saves a dated Timeline note. Set the task status separately after the work is complete.
Does changing the follow-up date move its appointment?
Treat the dates separately. Change the linked booking through Edit and check its saved date and time. Changing the task’s Date is not a substitute for editing the booking.
Does Completed cancel the linked appointment?
No. The demonstrated Completed follow-up still showed its Unsigned linked booking until the separate cancellation action was used.
Does Cancel and unlink only hide the appointment?
No. For an active booking, the confirmation says it will cancel the appointment and remove the link. Read the actual wording. Use Cancel to leave it unchanged.
Why is Add update disabled?
It is disabled when there is no update text. Enter the intended note, add it once, then find the saved Timeline entry.
Can I delete a lead using the pencil?
No. The pencil edits and the trash button deletes. The walkthrough keeps existing lead records and uses conversion for its fictional example. Do not confirm deletion simply to close a dialog.
Why did my changes disappear after closing the drawer?
If you chose Discard changes, those edits were not saved. Save changes applies edited task fields; Add update saves a Timeline note. Check the relevant saved result before leaving.
Next
Review the patient record, manage appointments, or continue a consultation.