# Wellbeing App Integration Guide

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).