> ## Documentation Index > Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt > Use this file to discover all available pages before exploring further. # Virtual / Telehealth Group Therapy Integration > Feature ID: CL-55 Status: Planned Spec Reference: CL-55 virtual telehealth group therapy Last Updated: 2026-05-09 **Feature ID:** CL-55 **Status:** Planned **Spec Reference:** [CL-55 virtual telehealth group therapy](../../../specs/cl/specs/CL-55-virtual-telehealth-group-therapy.md) **Last Updated:** 2026-05-09 *** ## Overview CL-55 extends CL-14 group therapy documentation and CL-24 telehealth documentation patterns for virtual and hybrid group sessions, plus non-group multi-party clinical encounters. It integrates with PM-13 for telehealth session lifecycle and PM-07 through CL-39 for charge suggestions. CL-55 does not own telehealth vendor configuration, durable join URLs, or final charge creation. *** ## Ownership Boundaries | Concern | Owner | Contract | | --------------------------------------------------------------------- | ------------- | ----------------------------------------------------------------------------------------------------- | | Group clinical documentation and attendance | CL-14 / CL-55 | `cl_group_sessions`, `cl_group_attendance`, CL-55 metadata extensions | | Telehealth vendor configuration, durable join URLs, session lifecycle | PM-13 | `pm_telehealth_sessions`; see `CL-PM-TELEHEALTH.md` and `PM-13-telehealth-integration-INTEGRATION.md` | | Telehealth clinical documentation patterns | CL-24 | Consent/session documentation patterns consumed by CL-55 | | Billing and final modifiers/charges | PM-07 | PM owns charges; CL-55 publishes suggestions only | | Modifier and code validation | PF-70 / PF-96 | Code library and jurisdiction profiles | | Multi-party clinical encounter record | CL-55 | `cl_multi_party_encounters`, `cl_multi_party_participants` | *** ## Data Contracts ### CL-55 stores * `cl_group_sessions.pm_telehealth_session_id`: UUID-only reference to PM-13 `pm_telehealth_sessions.id`; no direct FK. * `cl_group_session_telehealth_metadata`: clinical telehealth metadata, contingency plan support, recording consent state, technology failures, PM-13 session reference, and non-PHI vendor session reference. * `cl_multi_party_encounters` and `cl_multi_party_participants`: CL-owned N-party encounter records for crisis/family/interpreter/care-team sessions. ### CL-55 does not store * Durable patient/provider join URLs. * Telehealth vendor credentials or account configuration. * Final charge, claim, payment, or ledger fields. * PHI in event payloads or application logs. *** ## Event Contracts Events use `cl_pm_events` unless the platform event registry assigns a different channel during implementation. Payloads are UUID-only and PHI-free. ### `cl_virtual_group_started` **Publisher:** CL-55 **Consumers:** PM-07, PF-10/FW-16 if configured **Trigger:** Facilitator starts a virtual or hybrid group. | Field | Type | Required | Notes | | -------------------------- | ------ | -------- | ----------------------------------- | | `event_type` | string | Yes | `cl_virtual_group_started` | | `organization_id` | uuid | Yes | Tenant isolation | | `timestamp` | string | Yes | ISO 8601 event time | | `session_id` | uuid | Yes | `cl_group_sessions.id` | | `schedule_id` | uuid | No | PM-04 schedule reference if present | | `pm_telehealth_session_id` | uuid | No | PM-13 session reference | | `modality` | string | Yes | `virtual` or `hybrid` | | `started_at` | string | Yes | ISO 8601 session start | | `facilitator_id` | uuid | Yes | Staff profile id | | `attendee_count` | number | Yes | Count only; no attendee identities | | `correlation_id` | uuid | No | Idempotency/audit chain | ### `cl_virtual_group_concluded` **Publisher:** CL-55 **Consumers:** PM-07 **Trigger:** Facilitator completes a virtual or hybrid group. | Field | Type | Required | Notes | | -------------------------- | --------- | -------- | ---------------------------------------------------------------------- | | `event_type` | string | Yes | `cl_virtual_group_concluded` | | `organization_id` | uuid | Yes | Tenant isolation | | `timestamp` | string | Yes | ISO 8601 event time | | `session_id` | uuid | Yes | `cl_group_sessions.id` | | `schedule_id` | uuid | No | PM-04 schedule reference if present | | `pm_telehealth_session_id` | uuid | No | PM-13 session reference | | `modality` | string | Yes | `virtual` or `hybrid` | | `concluded_at` | string | Yes | ISO 8601 session end | | `duration_minutes` | number | Yes | Actual documented service duration | | `participant_count` | number | Yes | Present attendee count | | `modifier_suggestions` | string\[] | Yes | Jurisdiction-resolved suggestions, e.g. Arizona default `["95", "HQ"]` | | `jurisdiction_profile_id` | uuid | No | PF-96 profile used for suggestion | | `correlation_id` | uuid | No | Idempotency/audit chain | ### PHI logging guidelines * **Allowed:** UUIDs, modality, counts, durations, modifier codes, jurisdiction profile id, timestamps. * **Prohibited:** Patient/member names, DOB, addresses, phone/email, clinical content, session URLs, recording URLs, raw patient location, recording transcripts. * **Retention:** Event audit may be logged to `pf_audit_logs`; application logs must avoid PHI. *** ## Platform Integration Layer Usage * `@/platform/scheduling`: PM-04 schedule context and PM-13 telehealth session lookup. * `@/platform/clinical`: CL-39 billing adapter and jurisdiction-aware billing suggestion composition. * `@/platform/permissions`: PF-30 permission gates for `cl.group.virtual.*` and `cl.multi_party.*`. * `@/platform/notifications`: Optional PF-10 reminders and technology-failure notifications. *** ## Security and Compliance * RLS uses CL SECURITY DEFINER helpers with UPDATE `WITH CHECK`. * SUD/Part 2 group content remains gated through CL-11 before display, save, export, or AI use. * Recording consent evidence is auditable and append-only for non-admin users. * PM-13 vendor sessions must meet HIPAA/BAA requirements before use with PHI-bearing clinical workflows. *** ## Related Docs * [CL-PM-TELEHEALTH.md](./CL-PM-TELEHEALTH.md) * [PM-13 Telehealth Integration](./telehealth-integration-integration.md) * [CL-PM-GROUP-SESSIONS.md](./CL-PM-GROUP-SESSIONS.md) * [CL-24 Telehealth Documentation Integration](./telehealth-documentation-compliance-integration.md) * [CROSS\_CORE\_INTEGRATIONS.md](./CROSS_CORE_INTEGRATIONS.md)