Wellbeing App Integration Guide

Patterns for consumer apps & coaches.

If you're building a consumer wellbeing app, a coaching product, or a mental-health companion, therappai can power your core support features with AI therapy, mood tracking, routines, and therapeutic content.

This guide outlines common integration patterns and recommended flows for consumer-facing apps that want to embed therappai’s capabilities quickly and responsibly.

---

Why Wellbeing Apps Use therappai

Developers choose therappai because it provides:

• Instant, on-demand AI therapy (chat, voice, video)

• A structured content library (CBT, DBT, mindfulness)

• Daily routines and wellbeing tasks

• Mood tracking and emotional insights

• A clean, predictable API

• No AI safety or clinical logic to build manually

You can focus on your UX, design, features, and engagement while therappai handles the therapeutic engine under the hood.

---

Common Integration Models for Wellbeing Apps

Below are the most popular patterns among mental-health, wellness, and coaching products.

---

1. Chat-Based Support Companion

The most common integration is adding therappai as a support companion directly inside your app.

Typical UI:

• chat bubble interface

• message feed

• typing indicator

• daily “check-in” chat prompts

Developer flow:

1. User logs in → your app stores tokens

2. User opens chat

3. Your app sends messages to /chatting/

4. Display AI replies in chat UI

5. Repeat for as long as needed

Ideal for:

• journaling apps

• anxiety/depression support tools

• coaching or habit apps

• lifestyle apps looking to add guided support

---

2. Video Coaching / Avatar Therapy Mode

Many wellbeing apps embed AI video therapy as a more immersive or premium experience.

Typical uses:

• guided emotional check-ins

• daily reflection sessions

• structured self-help lessons

• personalised “therapist-style” coaching

Developer flow:

1. Display video avatar UI

2. User submits a message

3. Call /liveavatar/generate/

4. Play returned video

5. Loop for next message

This is perfect for apps that want higher engagement, emotional presence, or a signature experience.

---

3. Content-First Wellbeing App

Some wellbeing apps focus on CBT tools, mindfulness, grounding exercises, and short practices — where AI therapy is secondary.

Use therappai’s Content Library to populate:

• practice libraries

• recommendations

• guided routines

• “tool of the day” feeds

• mindfulness sections

Developer flow:

1. Fetch content → /content/

2. Display exercise lists

3. Open detailed content pages via /content/{id}/

4. Track progress or favourites

5. Pair content with moods or chat

---

4. Mood Tracking & Insights App

Apps that focus on emotional awareness often use mood tracking as a key feature.

They combine:

• daily mood check-ins

• AI reflections

• personalised content suggestions

Developer flow:

1. User submits mood → /moods/

2. Fetch history → /moods/

3. Show patterns & charts

4. Pair insights with suggested content or AI chat

This works well for:

• journaling apps

• mental-health trackers

• stress & burnout tools

---

5. Routine & Habit Wellness App

Some apps blend mental-wellbeing habits with structured routines.

Use therappai’s daily tasks to power:

• daily wellbeing routines

• streak systems

• “Today’s task” prompts

• small habit loops for emotional resilience

Developer flow:

1. Fetch tasks → /tasks/

2. Show daily list

3. Mark completed

4. Track routines over time

---

Recommended App Flow (Most Popular)

This combined flow gives users the best holistic experience:

1. Daily mood check-in

2. AI chat response

3. Content recommendation (matching mood)

4. Daily task or routine

5. Optional video session for deeper engagement

6. End-of-day reflection

This creates a meaningful and consistent wellbeing journey.

---

Design Tips for Consumer Apps

Keep it warm and supportive

therappai already generates compassionate responses — design your UI to match this tone.

Guide users intentionally

Use simple buttons like:

• “Start a chat”

• “Try a grounding exercise”

• “Watch a video reflection”

Offer fast access

Make support available from:

• home screen

• mood check-ins

• content pages

• crisis support menu

Add visual calm

Use:

• soft colours

• clean typography

• minimal animations

Build routine loops

Daily tasks, mood logs, and short content sessions create daily engagement.

---

Privacy & User Trust

Mental-wellbeing apps require thoughtful design.

Remember:

• Never expose user messages or mood logs to other users

• Avoid pushing users to “share” mental-health data

• Make Crisis Buddy optional — never forced

• Be transparent about what’s stored and why

therappai handles safety filtering; you control UX and presentation.

---

Example Integration Architecture

Your App (iOS/Android/Web)
   ↓
Your Backend (optional)
   ↓
therappai API (therapy, content, mood, routines)

If you’re building a purely client-side app, you can even call the API directly (with secure token storage).