Overview: How therappai works
Explains the mental-health engine, AI therapy model, content system, user sessions.
therappai provides a set of AI-powered mental-wellbeing features through a simple REST API. This overview explains the core systems behind the platform so you understand how everything fits together before integrating individual endpoints.
The platform is built around a few key components: users, AI therapy sessions, content, mood tracking, and safety tools. Each component can be used independently or combined to create a complete wellbeing experience in your product.
1. Users
Every interaction begins with a user account. After a user signs up or logs in, the API issues an access token that your application uses to make requests on their behalf.
Users can:
authenticate
update profile data
store personal wellbeing settings
access content and therapy sessions
User identity is tied directly to session history, moods, tasks, and emergency contacts.
2. AI Therapy Sessions
therappai offers three types of AI-powered support:
Chat therapy
Users send messages, and the AI therapist replies with guidance, reflection, or emotional support.
Voice therapy
Users send audio messages for a more natural conversation style (optional).
Video therapy (AI avatar)
A video-based interaction where an AI avatar speaks the response generated by the therapy engine.
Session flow (for all modes)
User sends a message (text or audio)
therappai processes context, tone, and safety signals
An AI therapist response is generated
Optional: response delivered as audio or video
Sessions are stateless per call — your app can store or display history however you prefer.
3. Content Library (CBT, DBT, Mindfulness)
therappai includes a growing library of structured mental-health content:
CBT exercises
DBT skills
Mindfulness practices
Grounding tools
Short wellbeing routines
Your application can fetch content lists, individual exercises, transcripts, and progress for each user.
This allows you to build educational or therapeutic flows alongside AI sessions.
4. Mood Tracking & Insights
Users can record their daily mood using a simple scale and optional notes. The API stores each entry and allows your application to:
list past mood logs
view trends over time
surface insights and patterns
build dashboards or wellbeing summaries
Mood tracking can be integrated into daily check-ins, routines, or onboarding flows.
5. Daily Tasks & Routines
therappai generates lightweight wellbeing tasks to help users build habits and improve resilience.
Your app can:
fetch daily tasks
display them in your UI
mark them as completed
This system is designed to be simple for v1 and easy to extend in future releases.
6. Crisis Buddy & Safety
Users can store trusted contacts for safety purposes.
Crisis Buddy enables:
saving emergency contacts
retrieving contact details
updating or removing contacts
Your app chooses how to use this information (e.g., display it, link to dialer, provide quick access in stressful moments).
Note: therappai does not contact emergency services. It is a user-controlled safety feature, not an automated alert system (v1).
Putting It All Together
A typical therappai-powered workflow looks like:
User signs up
User logs in and receives tokens
User starts a therapy session (chat/voice/video)
User accesses CBT/DBT content
User logs mood entries
User completes daily tasks
User stores emergency contacts
Each part is independent — you can integrate one feature or all of them.
Last updated