The Telehealth page atDocumentation Index
Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
Use this file to discover all available pages before exploring further.
/pm/telehealth lists all telehealth sessions for the current organization, showing platform, modality, status, and a direct link to the session URL when available.
Overview
The Telehealth page fetches records frompm_telehealth_sessions scoped to the current organization (soft-deleted records are excluded). Each card shows the platform name, telehealth modality, session status badge, relative creation time, and duration in minutes when recorded. A direct external-link icon opens the session URL in a new tab when a URL is present. Sessions are created through the scheduling flow, not directly from this page.
Who it’s for
Requires permissionpm.telehealth_sessions.view (PM_PERMISSIONS.TELEHEALTH_SESSIONS_VIEW). Users with pm.telehealth_sessions.create additionally see the “New Session” button (currently disabled in the UI).
Before you start
- You must hold the
pm.telehealth_sessions.viewpermission. - At least one telehealth appointment must exist and have been processed by the session-creation flow before any sessions appear here.
Steps
Navigate to Telehealth
Go to
/pm/telehealth. The page loads and displays all non-deleted telehealth sessions for your organization, ordered newest first.Review session status
Each card shows the platform name, modality (e.g., “audio video”), and a status badge. Badge variants are: default (active), secondary (completed), destructive (no show), outline (all other statuses).
Key concepts
Telehealth modality
Telehealth modality
The modality field records how the session was conducted. Observable values from the mutation hook:
audio_video, audio_only, store_forward, remote_monitoring. The UI renders the modality by replacing underscores with spaces.Session statuses
Session statuses
Observable status values:
active, completed, no_show. Any other value renders with an outline badge. The page displays the raw status string from the database.Empty state
Empty state
When no sessions exist, a card with the message “No telehealth sessions found. Sessions are created when scheduling a telehealth appointment.” is shown.
Error state
Error state
A red destructive text message “Failed to load sessions.” appears inline above the list if the query returns an error.
Related
Practice Management
Overview of the Practice Management core.
Governance & parity
Documentation coverage and governance.
This page documents shipped product behavior. It is not medical, legal, or
billing advice. Verify against your organization’s policies and applicable
regulations before using it for clinical, compliance, or billing decisions.
Protected health information (PHI) shown in the product is governed by your
tenant’s access controls and is never exposed in this documentation.
Documentation sources
Documentation sources
- src/routes/pm.tsx
- src/cores/pm/pages/TelehealthSessionListPage.tsx
- src/cores/pm/hooks/useTelehealthSessions.ts
- src/platform/permissions/constants.ts