A Documentation Workflow Built for Valant EHR
Clinical documentation inside Valant EHR rarely fails because clinicians lack dedication. It fails because the cognitive load of narrating a psychiatric encounter, scoring an instrument, and simultaneously structuring a defensible progress note exceeds what any human can sustain across a full panel. Valant is a purpose-built behavioral-health platform supporting intake, telehealth, e-prescribing, outcome measures, and templated documentation for psychiatry group practices. Merry AI sits one layer above that workflow, converting the spoken encounter into a structured draft that lands in the correct native field.
The critical distinction our engineering team enforces is that Merry AI never claims a native FHIR write API into Valant. Valant is a closed clinical system that does not publish an open write endpoint for third-party AI scribes, and any vendor promising direct API chart-commit is either misrepresenting the architecture or introducing latency and marketplace fees you should not accept. Instead, Merry AI operates as a browser-native Chrome Extension that writes into the DOM of your already-authenticated Valant session, treating the rendered clinical note exactly as your keyboard would.
Behavioral health documentation carries regulatory weight that general medical charting does not. Peer-reviewed analysis published through the National Library of Medicine underscores that health information technology must safely integrate behavioral health without eroding the segregation protections that psychotherapy and substance-use records depend upon. Every architectural decision below is downstream of that principle.
Why DOM Injection Beats API Marketplace Integration
Traditional integration models force practices into a false choice between expensive marketplace API listings and error-prone manual copy-paste. The API route demands vendor certification, per-transaction fees, OAuth provisioning, and a synchronization layer that introduces round-trip latency measured in seconds. Manual copy-paste, meanwhile, reintroduces transcription drift and abandons the structured field mapping that Valant's audit-critical templates require. DOM injection resolves the tension by writing locally, instantly, and without any server-side dependency.
The comparison below quantifies the operational difference across the three approaches a psychiatry group might evaluate.
| Architecture | Deployment Overhead | Latency | Annual Fee |
|---|---|---|---|
| Traditional API Marketplace Integration | High: vendor certification, OAuth provisioning, IT firewall changes | 2–6s sync round-trip | Per-seat + per-transaction marketplace fees |
| Manual Copy-Paste | Low: none, but high human effort | 30–90s per note, error-prone | Hidden cost of clinician burnout |
| Merry AI DOM Injection | Minimal: 1-minute Chrome install, no IT | 0.4s field mapping | Flat practice-partner subscription |
Because the write happens inside the authenticated browser session, there is no separate credential to rotate and no external endpoint exposed to the internet. The extension requests a narrowly scoped host permission limited to your Valant domain and cannot read any tab outside that origin. This is the same trust boundary your browser already enforces for your login, extended precisely and no further.
DOM Field Mapping and Selector Stability
Field mapping is the engineering discipline that separates a reliable scribe from a fragile one. Merry AI maintains a resilient selector map targeting Valant's progress-note textarea, Mental Status Exam grids, assessment blocks, and plan fields. Rather than depending on brittle positional guesses, the extension identifies fields by stable structural attributes and dispatches synthetic input events that Valant's own front-end validates as legitimate clinician entry. When Valant ships a UI update, our selector map is versioned and updated centrally, so clinicians experience continuity without reconfiguration.
Streaming Latency and the 0.4-Second Target
Sub-second responsiveness is not a vanity metric; it is what keeps the scribe invisible during the encounter. Audio streams to our processing layer, returns structured content, and maps to the target DOM node in roughly 0.4 seconds. That responsiveness lets the clinician verify the draft in real time rather than reconstructing the visit from memory hours later, which is where documentation integrity degrades most severely.
Preserving 42 CFR Part 2 and Psychotherapy Note Segregation
Regulatory segregation is the single most important design constraint in behavioral-health AI. HHS guidance on 42 CFR Part 2 requires that substance-use counseling notes remain walled off from the general record and disclosed only under specific consent. HIPAA similarly grants psychotherapy notes heightened protection that evaporates the instant those impressions are folded into the ordinary chart. Merry AI is engineered so that AI output populates only the routine progress-note and MSE fields you designate.
Our workflow deliberately refuses to auto-write into psychotherapy-note containers or Part 2-segregated areas. You choose the template before the session, the extension maps content only to the intended native fields, and sensitive process analysis stays in Valant's separately controlled notes region governed by consent boundaries. This preserves the legal architecture that makes those records defensible.
Template Selection Before the Encounter
Valant's own implementation guidance recommends standardizing editable templates against payer requirements before go-live, and Merry AI aligns to that sequence. Clinicians select their SOAP, DAP, BIRP, intake, or medication-management structure ahead of the session from the Template Center. You can Access 1,000+ EHR Clinical Templates to standardize your note architecture across the group before your first mapped encounter.
CPT G2211 Capture and Billing Integrity
Longitudinal psychiatric care is precisely the scenario CMS designed HCPCS add-on code G2211 to recognize. Per CMS guidance, G2211 applies when the office or outpatient E/M visit serves as the continuing focal point for a patient's care or supports ongoing management of a single serious or complex condition. Psychiatry group practices managing chronic mood, psychotic, or comorbid substance-use presentations frequently meet this standard yet under-capture the add-on because the documentation narrative does not surface the continuity relationship.
Merry AI structures the drafted note to make that longitudinal relationship explicit, capturing the medical-necessity language, treatment-plan linkage, and time elements that substantiate both the base E/M level and the G2211 add-on. Because clinicians no longer select E/M level by history and exam volume but by medical decision-making and time, the scribe's structured output directly supports accurate leveling.
Clinician-Authored Record and Signature Control
Automation must never displace clinical authorship. Every draft Merry AI injects is exactly that, a draft. Nothing commits to the Valant chart until the clinician reviews, edits, and signs. You remain the author of record, satisfying Valant's provider-authentication requirement and preserving the accountability that any audit or licensing board demands. The 0% data-retention posture under our executed BAA means no audio or transcript persists beyond the session.
Getting Your Practice Live on Merry AI + Valant
Deployment for a psychiatry group follows a deliberately short path. Install the Chrome Extension from the Web Store, select your standardized templates, and begin mapping notes into Valant the same day. There is no marketplace certification queue, no firewall change request, and no multi-week integration project. For prescribing practices, we recommend completing Valant's EPCS setup in parallel since that process can take several weeks independent of Merry AI.
A structured workflow audit ensures your field mapping, template segregation, and coding capture align with your specific payer mix and compliance policies before go-live. Schedule a 15-Minute Workflow Audit to review your Valant configuration, or Explore Merry AI Practice Partner Plans to see how flat-rate pricing replaces per-transaction marketplace fees for your entire group.




