Welcome to Ambient Health

Ambient Health is your comprehensive family health management platform that brings together medical records, AI-powered health insights, and seamless communication tools.

What You Can Do

• Manage Family Profiles: Create and manage health profiles for your entire family
• AI Health Assistant: Chat with specialized AI health assistants for personalized guidance
• Medical Records: Store and access medical records securely in one place
• Health Tracking: Track wellness through customizable questionnaires
• Wearable Integration: Connect fitness trackers and health devices

Getting Started

1. Download the Ambient Health app from TestFlight (iOS) or Play Store (Android)
2. Create your account using email/password or magic link
3. Complete your health profile
4. Add family members to your family unit
5. Start chatting with your AI health assistant

Need help? Check out our other support articles or contact our team.

Authentication & Account Setup

Ambient Health supports multiple authentication methods to ensure secure and convenient access to your health data.

Sign In Methods

Magic Link Authentication

• Request a magic link via email
• Click the link to sign in instantly
• No password required
• Expires after one-time use

Email & Password

• Traditional username/password authentication
• Secure password requirements
• Password recovery available

OAuth Integration

• Sign up with Ambient for partner applications
• Seamless integration with third-party healthcare platforms
• Automatic profile creation

Account Security

Your security is our top priority:

• All data is encrypted in transit and at rest
• Multi-factor authentication available
• Session management with refresh tokens
• Automatic logout on suspicious activity

Troubleshooting

Can't receive magic link?

• Check your spam folder
• Verify your email address is correct
• Try resending after 60 seconds

Forgot your password?

• Use the "Forgot Password" link on the sign-in page
• Check your email for reset instructions
• Create a new secure password

Creating and Managing Family Units

Family units allow you to group related individuals and manage their health information together.

Creating a Family

1. Navigate to the Families section
2. Tap "Create Family"
3. Enter a family name
4. Optionally add tags for organization
5. You'll automatically become the family admin

Adding Family Members

Create New Profile

1. Go to your family unit
2. Tap "Add Member"
3. Fill in their basic information
4. Specify their relationship to you
5. Set their age or date of birth

Invite Existing Users

1. Tap "Invite Member"
2. Enter their email address
3. They'll receive an invitation link
4. Once accepted, they'll join your family

Family Member Permissions

As a family admin, you can:

• View all family members' profiles
• Access their medical records (with permission)
• Manage family invitations
• Update family information
• Remove members

Privacy & Sharing

Each family member can control:

• What health data is shared with the family
• Which medical records are visible
• Questionnaire response privacy
• Chat history sharing

Best Practices

• Keep contact information up to date
• Regularly review family member profiles
• Use tags to organize large families
• Set up emergency contacts for each member

Managing Medical Records

Ambient Health integrates with major healthcare providers to centralize your medical records.

Supported Sources

Particle Health Integration

• Connects to thousands of healthcare providers
• Automatically syncs medical records
• Includes labs, medications, vitals, and more
• HIPAA-compliant and secure

Epic MyChart

• Direct integration with Epic systems
• Real-time data synchronization
• Access to appointment history
• Lab results and imaging reports

Manual Upload

• Upload documents directly
• Supports PDF, images, and text files
• OCR for automatic data extraction
• Secure encrypted storage

Importing Records

From Particle Health

1. Go to Medical Records section
2. Select "Import from Particle Health"
3. Upload your driver's license or enter info manually
4. Verify your identity
5. Records sync automatically

From Epic MyChart

1. Navigate to Medical Records
2. Choose "Connect Epic MyChart"
3. Select your healthcare provider
4. Authorize access
5. Data syncs in real-time

Manual Upload

1. Tap "Upload Document"
2. Select files from your device
3. Add title and category
4. Optionally tag the document
5. Save to your records

Viewing Medical Records

Your medical records are organized by:

• Labs: Blood tests, urinalysis, imaging results
• Medications: Current and past prescriptions
• Vitals: Blood pressure, heart rate, temperature
• Documents: Insurance cards, referrals, notes
• Visits: Appointment summaries and diagnoses

Sharing Records

Share specific records with:

• Family members in your unit
• Healthcare providers
• AI health assistants for better recommendations
• Partner applications (with your consent)

Privacy & Security

• All records encrypted end-to-end
• Access logs track who views your data
• Granular permission controls
• HIPAA-compliant storage
• Delete records anytime

Using the AI Health Assistant

The Ambient Health AI Assistant provides personalized health guidance based on your medical history and current needs.

Creating a Chat

1. Go to the Chat section
2. Tap "New Chat"
3. Select a specialized agent (optional)
4. Name your chat for easy reference
5. Start asking questions

Specialized Agents

Choose from specialized health assistants:

• General Health: Primary care guidance
• Pediatrics: Child health and development
• Chronic Conditions: Disease-specific support
• Mental Health: Emotional wellness support
• Nutrition: Diet and meal planning
• Fitness: Exercise and activity guidance

What the AI Can Help With

Health Questions

• Symptom assessment (not diagnosis)
• Medication information
• Treatment options overview
• Prevention strategies
• Lifestyle recommendations

Medical Record Insights

• Explain lab results in plain language
• Track health trends over time
• Identify potential concerns
• Medication interaction checks
• Coordinate care recommendations

Family Health

• Age-appropriate health guidance
• Family health history analysis
• Genetic risk factor discussions
• Preventive care schedules
• Vaccination recommendations

Best Practices

Be Specific: Provide details about symptoms, timing, and severity Share Context: Include relevant medical history Ask Follow-ups: Don't hesitate to ask for clarification Use Voice: Speak your questions naturally Save Important Chats: Bookmark helpful conversations

Important Notes

⚠️ The AI Assistant is not a replacement for professional medical advice.

• Always consult a licensed healthcare provider for diagnoses
• Seek emergency care for urgent medical issues
• Verify AI recommendations with your doctor
• Use as a supplement to professional care

Privacy & Data Use

• Chats are private and encrypted
• Your data trains the AI to serve you better
• No data shared without your permission
• Delete conversations anytime
• Export chat history for your records

Completing Health Questionnaires

Health questionnaires help track your wellness journey and provide your AI assistant with comprehensive health information.

Types of Questionnaires

Default Health Assessment

• Comprehensive baseline health evaluation
• Covers medical history, lifestyle, and goals
• One-time initial assessment
• Updates your health profile

Partner-Specific Questionnaires

• Customized by healthcare providers
• Disease-specific assessments
• Treatment monitoring tools
• Research participation surveys

Family Member Questionnaires

• Age-appropriate questions
• Developmental milestones
• Family health history
• Caregiver assessments

Answering Questions

Text Responses

• Type your answers directly
• Support for detailed explanations
• Option to skip non-required questions
• Save and continue later

Audio Responses

• Speak your answers naturally
• Automatic transcription
• Hands-free convenience
• Great for longer responses

Multiple Choice

• Quick selection options
• Single or multiple answers
• Rating scales (1-10)
• Yes/No questions

Tracking Progress

View your completion status:

• Overall percentage complete
• Sections remaining
• Time estimate to finish
• Last updated timestamp

Using Your Responses

Questionnaire data helps:

• Personalize AI recommendations
• Track health changes over time
• Identify potential health concerns
• Coordinate care with providers
• Generate health summaries

Privacy Controls

You control who sees your responses:

• Keep private for AI use only
• Share with specific family members
• Allow provider access
• Include in health summaries
• Export for personal records

Best Practices

• Answer honestly for accurate insights
• Update responses as your health changes
• Complete sections in one sitting when possible
• Use audio for faster completion
• Review your answers before submitting

Connecting Wearable Devices

Integrate fitness trackers and health monitoring devices to provide your AI assistant with real-time health data.

Supported Devices

Fitness Trackers

• Apple Watch
• Fitbit
• Garmin
• Samsung Galaxy Watch
• Wear OS devices

Health Monitors

• Blood pressure monitors
• Continuous glucose monitors
• Smart scales
• Sleep trackers
• Heart rate monitors

Connecting Your Device

1. Open Settings in Ambient Health
2. Select "Connected Devices"
3. Choose your device type
4. Follow authentication steps
5. Grant necessary permissions
6. Data syncs automatically

Available Metrics

Track comprehensive health data:

• Activity: Steps, distance, active minutes
• Heart Health: Heart rate, HRV, blood pressure
• Sleep: Duration, quality, stages
• Nutrition: Calorie intake/expenditure
• Vitals: SpO2, temperature, respiratory rate
• Body Metrics: Weight, BMI, body composition

Data Synchronization

Automatic Sync

• Data updates in real-time
• Runs in the background
• Low battery impact
• Offline queue for missed syncs

Manual Sync

• Pull to refresh
• Force sync from device
• Resolve sync conflicts
• Check sync status

Using Wearable Data

Your AI assistant uses wearable data to:

• Provide personalized fitness recommendations
• Identify health trends and patterns
• Alert you to concerning changes
• Track progress toward health goals
• Correlate symptoms with activity levels

Privacy & Permissions

Control your wearable data:

• Choose which metrics to sync
• Set data sharing preferences
• Delete historical data
• Revoke device access anytime
• Export raw data for analysis

Troubleshooting

Device won't connect?

• Check Bluetooth is enabled
• Ensure device is charged
• Update device firmware
• Reinstall Ambient Health app

Data not syncing?

• Verify permissions in device settings
• Check internet connection
• Force close and reopen app
• Manually trigger sync

Incorrect readings?

• Calibrate your device
• Wear device properly
• Check sensor placement
• Compare with manual measurements

Delete Your Data & Account

You have the right to request deletion of your Ambient Health account and all associated data at any time.

What Gets Deleted

When you request account deletion, we will permanently remove:

• Personal Information: Your name, email, phone number, and contact details
• Health Data: All medical records, health profiles, and wellness information
• Family Information: Family units, member profiles, and relationships
• Chat History: All conversations with AI health assistants
• Documents: Uploaded files, images, and medical documents
• Wearable Data: Activity, sleep, and health metrics from connected devices
• Account Settings: Preferences, notifications, and app settings

What We Retain

For legal and security purposes, we may retain certain information for a limited time:

• Transaction Records: Billing and payment history (required by law for 7 years)
• Audit Logs: Security and access logs (90 days for HIPAA compliance)
• Legal Holds: Data subject to legal proceedings or investigations

After the retention period, all remaining data is permanently deleted.

How to Request Deletion

Option 1: Request via Email

Send an email to privacy@ambienthealth.io with:

• Subject: "Account Deletion Request"
• Your registered email address
• Confirmation that you want to permanently delete your account

We will process your request within 30 days and send you a confirmation email.

Option 2: In-App Deletion (Coming Soon)

We're working on adding self-service account deletion directly in the Ambient Wallet App settings.

Important Notes

⚠️ Account deletion is permanent and cannot be undone.

• You will lose access to all your health data
• Family members in your family unit will need to be reassigned to another admin or removed
• Any active subscriptions will be cancelled
• You cannot reuse your email address for a new account for 90 days

Partial Data Deletion

If you only want to delete specific data without closing your account, you can:

• Remove individual documents: Delete specific files from your documents section
• Clear chat history: Delete conversations with AI assistants
• Disconnect wearables: Remove device connections and their data
• Leave family units: Remove yourself from family groups
• Delete health records: Remove specific medical records (imported records may need to be re-requested from providers)

For partial deletion requests, please email support@ambienthealth.io with details about what you'd like to remove.

Timeline

• Immediate: Your account access is disabled
• 30 Days: Active data deletion begins
• 90 Days: All data removed from backups and archives
• 7 Years: Transaction records retained per legal requirements

Verification

For security, we may ask you to verify your identity before processing deletion requests. This helps protect your account from unauthorized deletion attempts.

Questions?

If you have questions about data deletion or retention policies, contact us at:

• Email: privacy@ambienthealth.io
• Phone: (347) 845-3532

Privacy and Data Security

At Ambient Health, protecting your health information is our highest priority.

Data Protection

Encryption

• End-to-end encryption for all data
• TLS 1.3 for data in transit
• AES-256 encryption at rest
• Encrypted database backups
• Secure key management

HIPAA Compliance

• Fully HIPAA-compliant infrastructure
• Business Associate Agreements
• Regular security audits
• Incident response procedures
• Staff training and certification

Access Controls

• Role-based permissions
• Multi-factor authentication
• Session timeout protection
• Activity logging and monitoring
• Suspicious activity alerts

Your Privacy Rights

You have complete control:

• Access: View all your health data
• Export: Download your complete data
• Delete: Remove data permanently
• Restrict: Control who can view data
• Portability: Transfer data to other services

Data Sharing

We never share your data without explicit consent:

• No selling of health information
• No advertising based on health data
• No third-party access without permission
• Transparent data use policies
• Opt-in for research participation

Family Privacy

Within families:

• Parents control children's data (under 13)
• Teens have privacy settings (13-17)
• Adults control their own data
• Granular sharing permissions
• Emergency access protocols

AI Data Use

Your data helps improve AI recommendations:

• Used to personalize your experience
• Aggregated anonymously for model training
• Never shared with other users
• Opt-out available anytime
• Clear data retention policies

Third-Party Integrations

When connecting external services:

• Review permissions carefully
• Revoke access anytime
• Data sharing is logged
• Minimal data shared
• Third parties must be HIPAA-compliant

Security Best Practices

Protect your account:

• Use a strong, unique password
• Enable two-factor authentication
• Don't share your login credentials
• Log out on shared devices
• Review activity logs regularly
• Report suspicious activity immediately

Data Retention

How long we keep your data:

• Active accounts: Indefinitely
• Deleted accounts: 30-day recovery period
• Backups: 90 days
• Audit logs: 7 years (HIPAA requirement)
• Anonymized research data: Long-term

Breach Notification

In the unlikely event of a data breach:

• Immediate investigation
• Notification within 72 hours
• Clear explanation of impact
• Steps to protect yourself
• Free credit monitoring if needed

Contact Security Team

Questions or concerns?

• Email: security@ambienthealth.io
• Report incidents immediately
• Annual security reports available
• Transparency reports published quarterly

API Access and Integration

Build healthcare applications with the Ambient Health API.

Getting Started

Request API Access

1. Contact our partnerships team
2. Complete partner application
3. Review API documentation
4. Receive API credentials
5. Start building in sandbox

Authentication

• OAuth 2.0 authorization flow
• Client credentials for server-to-server
• JWT access tokens
• Refresh token rotation
• Secure credential storage required

API Endpoints

Comprehensive API coverage:

• Auth: User authentication and sessions
• Profiles: User and family profiles
• Families: Family management
• Chats: AI assistant conversations
• Medical Records: Health data access
• Questionnaires: Health assessments
• Wearables: Device data integration
• Partners: Partner-specific features

Rate Limits

Stay within our rate limits:

• 100 requests per minute (standard)
• 1000 requests per minute (enterprise)
• Burst allowance for temporary spikes
• Rate limit headers in responses
• Automatic retry with exponential backoff

Webhooks

Real-time notifications for:

• New medical records available
• Questionnaire completions
• Chat message received
• Wearable data updated
• Family member added
• Authorization granted/revoked

SDKs and Libraries

Official SDKs available:

• Node.js/TypeScript
• Python
• Ruby
• Go
• More coming soon

Use Cases

What you can build:

• Telehealth platforms: Integrate health data
• Care coordination: Connect providers
• Research platforms: Collect consented data
• Wellness apps: Sync wearable data
• Insurance portals: Streamline enrollment

Compliance

API usage must comply with:

• HIPAA regulations
• State privacy laws
• Terms of service
• Data use agreements
• Security requirements

Support

Developer resources:

• API documentation at /docs
• Interactive API explorer
• Sample applications
• Developer community forum
• Dedicated technical support
• Regular API webinars

Best Practices

For optimal integration:

• Implement proper error handling
• Use webhooks instead of polling
• Cache responses appropriately
• Follow rate limits
• Keep credentials secure
• Test in sandbox environment
• Monitor API health status

Common Issues and Solutions

Quick solutions to common problems.

Authentication Issues

Can't Sign In

Problem: Unable to log in with email/password Solutions:

• Verify email address is correct
• Check if caps lock is on
• Try password reset
• Clear browser cache
• Try different browser

Magic Link Not Working

Problem: Magic link expired or invalid Solutions:

• Request a new magic link
• Check spam/junk folder
• Ensure you clicked the link in the correct browser
• Link expires after 10 minutes
• Only works once

Account Locked

Problem: Too many failed login attempts Solutions:

• Wait 15 minutes before trying again
• Use password reset function
• Contact support if issue persists

App Performance

Slow Loading

Problem: App takes long time to load Solutions:

• Check internet connection
• Clear app cache
• Update to latest version
• Restart device
• Reinstall app

Crashes or Freezes

Problem: App crashes or becomes unresponsive Solutions:

• Force close and restart app
• Update to latest version
• Check device storage space
• Restart device
• Report crash to support

Data Sync Issues

Medical Records Not Appearing

Problem: Imported records not showing up Solutions:

• Check sync status
• Verify provider connection
• Allow 24-48 hours for initial sync
• Try manual refresh
• Check permissions with provider

Wearable Data Not Syncing

Problem: Device data not updating Solutions:

• Ensure device is connected
• Check Bluetooth/WiFi connection
• Grant necessary permissions
• Force manual sync
• Reconnect device

Chat Issues

AI Not Responding

Problem: Chat messages not getting responses Solutions:

• Check internet connection
• Verify message was sent
• Wait a few moments for processing
• Try refreshing the chat
• Check service status page

Can't Send Messages

Problem: Unable to send chat messages Solutions:

• Check text length (max 5000 characters)
• Verify internet connection
• Clear message draft and try again
• Check if chat was archived
• Create new chat if needed

Family Management

Can't Add Family Member

Problem: Error when adding family member Solutions:

• Verify all required fields are filled
• Check relationship field is selected
• Ensure unique profile information
• Try again after a few minutes
• Contact support with error message

Invitation Not Received

Problem: Family invitation email not arriving Solutions:

• Check spam/junk folder
• Verify email address is correct
• Resend invitation
• Check recipient's email settings
• Try alternative email address

File Upload Issues

Upload Fails

Problem: Can't upload documents or images Solutions:

• Check file size (max 10MB)
• Verify file format is supported
• Check internet connection
• Try different file
• Use lower resolution image

Poor Image Quality

Problem: Uploaded images are blurry Solutions:

• Use higher resolution images
• Ensure good lighting when taking photo
• Hold device steady
• Clean camera lens
• Try uploading from computer

Account Management

Can't Update Profile

Problem: Profile changes not saving Solutions:

• Check all required fields
• Verify valid date formats
• Check internet connection
• Try one field at a time
• Clear cache and try again

Email Change Not Working

Problem: Unable to change email address Solutions:

• Verify new email is not already in use
• Check confirmation email
• Ensure old email is accessible
• Wait for verification link
• Contact support if blocked

Payment & Subscription

Payment Failed

Problem: Subscription payment declined Solutions:

• Verify card details are correct
• Check card expiration date
• Ensure sufficient funds
• Try different payment method
• Contact your bank

Can't Cancel Subscription

Problem: Unable to cancel subscription Solutions:

• Navigate to Settings > Subscription
• Follow cancellation prompts
• Check for confirmation email
• Contact support for assistance
• Verify cancellation was processed

Still Need Help?

If your issue isn't listed:

1. Check our status page for known issues
2. Search our knowledge base
3. Contact support with:

• Detailed description of issue
• Steps you've already tried
• Screenshots if relevant
• Device and app version
• Error messages

Contact Support:

• Email: support@ambienthealth.io
• In-app: Settings > Help & Support
• Response time: Usually within 24 hours