Getting Started
Everything a new user or administrator needs to get up and running with the AMC Portal.
What is the AMC Portal?
The AMC Portal is a centralized management platform for Aura Medical Centers. It handles clinical operations, client management, transportation fleet, billing, and administration — all in one place. It supports multiple levels of care including IOP (Intensive Outpatient Program) and OP (Outpatient), with PHP expansion planned.
Accessing the Portal
Navigation Structure
The portal sidebar provides access to all sections. Your visible sections depend on your assigned role. The Company section appears for Administrators only, and Administration is restricted to Platform-level access.
Roles & Permissions
The portal uses role-based access control (RBAC). Each user is assigned one of 8 roles that determines what sections and actions they can access.
| Role | Access Level | Primary Use |
|---|---|---|
| Administrator | Full company access | Company admins — manage users, settings, all data |
| Clinical Director | Clinical + Reports | Oversee clinical programs, review all client records |
| Therapist | Clinical (assigned clients) | Document sessions, manage assigned client records |
| Billing Specialist | Billing + Clients (read) | Process claims, manage authorizations |
| Driver | Transportation only | View assigned trips, vehicle data |
| Receptionist | Clients + Attendance | Check-in clients, manage attendance |
| Case Manager | Clients + Clinical (read) | Coordinate client services and referrals |
| Support Staff | Limited read access | General operations support |
Dashboard
The dashboard is the home screen of the portal, providing a real-time overview of key metrics and activity.
Overview
The dashboard displays summary statistics relevant to your role — active clients, today's attendance, fleet status, recent activity, and quick-access shortcuts. Administrators see company-wide metrics; clinicians see their assigned caseload.
Clinical
The Clinical section manages all clinical documentation for clients enrolled in IOP and OP levels of care. Access and fields vary by service level.
Clinical Subsections
Service Level Configuration
Each clinical subsection can be configured per service level (IOP vs OP). Fields and requirements differ based on the level of care. Administrators configure which fields are required for each service level under Company Settings.
Roles with Clinical Access
Clinical Director Therapist Administrator
CRM
The CRM manages leads, referral sources, and the intake pipeline for prospective clients.
Leads & Referrals
Track prospective clients from first contact through admission. Log referral source, insurance information, and initial contact notes. Convert leads to active clients once admitted.
Clients
Central management of all active and archived client records.
Client List
The clients list supports multi-select with bulk actions including status changes, bulk discharge, and bulk export. Use the search bar and filters to locate clients by name, ID, service level, or status.
Client Profile
Each client profile contains: demographics, contact information, emergency contacts, insurance details, assigned therapist, service level, admission/discharge dates, and linked clinical records.
Important Notes
Attendance
Track and manage daily client attendance across service levels and programs.
Daily Attendance
Log attendance for IOP and OP sessions. Mark clients as Present, Absent, Excused, or Late. Attendance records are linked to billing and clinical documentation requirements.
Transportation
Fleet management and driver coordination for client transportation. Powered by the Tesla Fleet API.
Fleet Management
The fleet section provides real-time monitoring of all connected Tesla vehicles. The current fleet consists of three vehicles: CHIVICHANA, LUNA, and TORNADO 2.0.
Each vehicle card displays:
- Current state (Online, Asleep, Offline)
- Battery level and estimated range
- Current location (GPS)
- Climate and lock status
- Last sync timestamp
Smart Polling
The fleet uses configurable refresh intervals to balance real-time data with Tesla API cost management. Vehicles in sleep state are polled less frequently to avoid unnecessary wake cycles.
Waking a Vehicle
Vehicle Snapshot History
Vehicle data is automatically saved to the VehicleSnapshots database on every data refresh. This allows the fleet view to display last known data even when vehicles are offline or Tesla API is unavailable.
Map View
The Map tab shows real-time GPS locations of all vehicles on an interactive map. Markers update automatically every 5 seconds while the map tab is active.
Drivers
The Drivers tab manages the driver roster — assignments, license information, and contact details.
Driver Administrator
Billing
Manage insurance authorizations, claims, and payment tracking.
Overview
The Billing section handles insurance verification, authorization management, claim submission, and ERA/payment posting. Integrations with Availity, Florida Medicaid (FLMMIS), Change Healthcare, and Waystar are planned.
Reports
Analytics and operational reporting across all portal sections.
Overview
The Reports section will provide analytics on client census, attendance rates, clinical outcomes, billing performance, and fleet utilization. Advanced analytics and custom report builder are in development.
My Hub
Personal space for each user — profile, tasks, and personal settings.
Profile & Settings
Update your name, contact information, phone number (used for 2FA), and password. Your phone number must be in international format (e.g., +13051234567) for SMS verification to work.
Tasks
View and manage personal tasks assigned to you or created by you. Tasks can be linked to clients or be standalone action items.
Company Settings
Company-level configuration available to Administrators. Accessed via Company → Settings.
General Tab
Configure company profile information: name, NPI number, phone, address, timezone, contact email, fax, and social media links.
Integrations Tab
Enable and configure company-level API integrations. Each integration card shows its connection status and has a toggle to enable/disable.
| Integration | Status | Purpose |
|---|---|---|
| Tesla Fleet API | ● Live | Vehicle monitoring — requires OAuth authorization |
| Twilio SendGrid | ● Live | Email notifications — requires API Key, From Email, From Name |
| Twilio SMS | Soon | SMS appointment reminders |
| Zoom | Soon | Telehealth video sessions |
| Google Calendar | Soon | Appointment sync (user-level) |
Other Company Sections
- Users & Staff — Invite users, assign roles, manage status
- Roles & Permissions — View role definitions and permissions matrix
- Templates — Email and document templates
- Logs — Company-level activity and error logs
Integrations Reference
Full reference for all integrations — platform-level and company-level.
Platform-Level (Administration)
Configured once by a Platform Administrator and applies to all companies.
| Integration | Fields Required | Purpose |
|---|---|---|
| Twilio Verify | Account SID, Auth Token, Verify Service SID | 2FA SMS codes for all portal users |
Tesla Fleet API — OAuth Flow
SendGrid Email
SG.), From Email, and From Name in Company Settings.Administration
Platform-level controls. Restricted to Platform Administrators only.
API Integrations
Read-only catalog of all available integrations across all companies. Shows connection status per integration. Credentials are configured per company under Company → Settings → Integrations. Platform-level integrations (Twilio Verify) are configured here.
Templates
Manage platform-wide email and document templates used across all companies.
System Config
Platform-level configuration settings including environment variables and feature flags.
Platform Logs
System-wide logs with filtering by level (info, warning, error) and category (email, auth, clients, users, system). Use logs to diagnose integration failures, authentication issues, and API errors.
Support
Internal support ticket system for platform issues. Submit tickets to the LDTelecom development team.
FAQ
Common questions and answers about the AMC Portal.
I'm not receiving the 2FA SMS code
Ensure your phone number is saved in My Hub → Profile in international format (+13051234567). Use the Resend Code link on the verification screen. If the issue persists, contact your Administrator to verify the Twilio Verify configuration under Administration → API Integrations.
My Tesla vehicle shows "Offline" or "Unknown"
Vehicles go to sleep when idle to preserve battery. Click Wake on the vehicle card. If the vehicle remains offline after 30 seconds, check the Tesla integration status under Company → Settings → Integrations. You may need to re-authorize the OAuth connection.
SendGrid shows "Error" after saving credentials
Verify the API key starts with SG. and has the Mail Send permission enabled in your SendGrid dashboard. Re-enter the credentials and save again.
Can I delete a client record?
No — client deletion is intentionally restricted in the portal UI to protect data integrity and audit trails. If a record must be deleted, contact a Platform Administrator who can perform the deletion through the ZCQL console.
How do I reset a user's password?
Administrators can use Company → Users & Staff to resend a welcome email with a temporary password. Users can also use the Forgot Password link on the login screen.
How often is vehicle location data updated?
When the Map tab is active, vehicle data refreshes every 5 seconds. The Vehicles tab uses smart polling intervals that vary based on vehicle state to minimize Tesla API usage costs.
Changelog
History of portal updates, new features, fixes, and deprecations. Updated with every deployment.
- new Two-Factor Authentication (2FA) via Twilio Verify for all portal users
- new Device trust — skip 2FA for 30 days on recognized devices
- new Company Settings → Integrations tab with toggle ON/OFF, status badges, and credential forms
- new Administration → API Integrations redesigned as platform catalog — no credentials stored here
- new Twilio Verify configured as platform-level integration in Administration
- new SendGrid test email row — shown when connected, hidden when configuring
- new Generic test row pattern for all communication integrations (email, SMS)
- imp Tesla status now synced to CompanyIntegrations on OAuth callback
- imp Fleet fallback: vehicles persist in VehicleSnapshots for offline display
- imp Integration status validation uses credential format check (no live API call on save)
- fix email-api now reads SendGrid credentials from CompanyIntegrations table
- fix tesla-api getSettings now merges CompanyIntegrations credentials
- fix Portal color consistency — gold updated to #F5A623 throughout
- new Clinical section with 7 subsections (Diagnoses, MTP & TPR, FARS, Brief Assessment, GAD-7/PHQ-9, Discharge)
- new Tesla Fleet API integration with real-time vehicle monitoring
- new Smart polling intervals for Tesla API cost efficiency
- new Automatic trip tracking and VehicleSnapshots persistence
- new SendGrid email integration for notifications
- new Role-based access control for 8 roles
- new Multi-select client management with bulk actions
- imp Fleet map with real-time GPS markers updating every 5 seconds
- new Initial portal launch on Zoho Catalyst + Cloudflare Pages
- new Core sections: Dashboard, Clients, Attendance, CRM, Billing, Reports, My Hub
- new Authentication with HMAC token and httpOnly cookies
- new Forgot password / temporary password flow
- new Company Settings — General tab
- new Administration — Templates, System Config, Logs, Support