# AI Support That Resolves — Not Deflects > **Drop in one React Native component and your app gets AI support that answers questions, navigates users to the right screen, fills forms, and resolves issues end-to-end — with live human backup when needed. No custom API connectors required — the app UI is already the integration.** **Two names, one package — pick whichever you prefer:** ```bash npm install @mobileai/react-native # — or — npm install react-native-agentic-ai ``` ### 🤖 AI Support Agent — Answers, Acts, and Resolves Inside Your App

AI Support Agent navigating the app and resolving user issues end-to-end

--- [![npm](https://img.shields.io/npm/v/@mobileai/react-native?label=%40mobileai%2Freact-native)](https://www.npmjs.com/package/@mobileai/react-native) [![npm](https://img.shields.io/npm/v/react-native-agentic-ai?label=react-native-agentic-ai)](https://www.npmjs.com/package/react-native-agentic-ai) [![license](https://img.shields.io/npm/l/@mobileai/react-native)](https://github.com/MobileAIAgent/react-native/blob/main/LICENSE) [![platform](https://img.shields.io/badge/platform-iOS%20%7C%20Android-brightgreen)]() **Two names, one package** — install either: `@mobileai/react-native` or `react-native-agentic-ai` > ⭐ If this helped you, [star this repo](https://github.com/MobileAIAgent/react-native) — it helps others find it! --- ## 💡 The Problem With Every Support Tool Today Intercom, Zendesk, and every chat widget all do the same thing: send the user instructions in a chat bubble. *"To cancel your order, go to Orders, tap the order, then tap Cancel."* That's not support. That's documentation delivery with a chat UI. **This SDK takes a different approach.** Instead of telling users where to go, it — with the user's permission — goes there for them. --- ## 🧠 How It Works — The App's UI Is the Integration Layer Every other support tool needs you to build API connectors: endpoints, webhooks, action definitions in their dashboard. Months of backend work before the AI can do anything useful. This SDK reads your app's live UI natively — every button, label, input, and screen — in real time. **There's nothing to integrate. The UI is already the integration.** The app already knows how to cancel orders, update addresses, apply promo codes — it has buttons for all of it. The AI just uses them. **No OCR. No image pipelines. No selectors. No annotations. No backend connectors.** ### Why This Matters in the Support Context The most important insight: UI control is only uncomfortable when it's unexpected. In a support conversation, the user has already asked for help — they're in a *"please help me"* mindset: | Context | User reaction to AI controlling UI | |:---|:---| | Unprompted (out of nowhere) | 😨 "What is happening?" | | **In a support chat — user asked for help** | 😊 "Yes please, do it for me" | | **User is frustrated and types "how do I..."** | 😮‍💨 "Thank God, yes" | --- ## 🎟️ The 5-Level Support Ladder The SDK handles every tier of support automatically — from a simple FAQ answer to live human chat: ``` ┌──────────────────────────────────────────────────────┐ │ Level 1: Knowledge Answer │ │ Answers from knowledge base — instant, zero UI │ │ "What's your return policy?" → answered directly │ ├──────────────────────────────────────────────────────┤ │ Level 2: Show & Guide │ │ AI navigates to exact screen, user acts last │ │ "Settings → Notifications. It's right here. ☘️" │ ├──────────────────────────────────────────────────────┤ │ Level 3: Do & Confirm (Copilot — default) │ │ AI fills forms, user confirms the final action │ │ "I've typed your new address. Tap Save to confirm." │ ├──────────────────────────────────────────────────────┤ │ Level 4: Full Resolution (Autopilot) │ │ AI completes entire flow with one permission gate │ │ "Done! Order #4521 cancelled. Refund in 3-5 days." │ ├──────────────────────────────────────────────────────┤ │ Level 5: Human Escalation │ │ Live agent via WebSocket — seamless handoff │ │ Billing dispute, legal issues, edge cases │ └──────────────────────────────────────────────────────┘ ``` ### Example conversations

Level 1 — Knowledge Answer

``` User: "What's your return policy?" AI: "You can return items within 30 days. Full refund in 5-7 business days." [from knowledge base — no UI needed] ```

Level 2 — Show & Guide

``` User: "How do I turn on price alerts?" AI: "That's in Settings → Notifications. Want me to take you there?" User: "Yes" AI: [navigates to Settings → scrolls to Notifications section] AI: "Here it is. The Price Alerts toggle is right here. ☘️" [user taps the toggle themselves] ```

Level 3 — Do & Confirm (Copilot, default)

``` User: "I need to change my shipping address" AI: "Sure! I'll navigate to your address settings." [navigates to Profile → Address] AI: "What's the new address?" User: "15 Omar St, Nasr City, Cairo" AI: [types the address into the fields] AI: "I've filled in '15 Omar St, Nasr City, Cairo'. Tap Save to confirm." [user taps Save themselves] ```

Level 4 — Full Resolution (Autopilot)

``` User: "Cancel my last order" AI: "Order #4521 — Margherita pizza, $12.99. Want me to cancel it?" User: "Yes" AI: [navigates to Orders → finds #4521 → taps Cancel → taps Confirm] AI: "Done! Order #4521 is cancelled. Refund arrives in 3-5 days." ```

Level 5 — Human Escalation

``` User: "I was charged twice for my order" AI: "I can see your order history, but billing disputes need a human agent." [triggers escalate → live agent chat via WebSocket] ```

--- ## ⚙️ Why Not Intercom or Zendesk? | | Intercom Fin | Zendesk AI | **This SDK** | |:---|:---|:---|:---| | **Answer questions** | ✅ | ✅ | ✅ Knowledge base | | **Navigate user to right screen** | ❌ | ❌ | ✅ App-aware navigation | | **Fill forms for the user** | ❌ | ❌ | ✅ Types directly into fields | | **Execute in-app actions** | Via API connectors *(must build)* | Via API connectors | ✅ Via UI — zero backend work | | **Voice support** | ❌ | ❌ | ✅ Gemini Live | | **Human escalation** | ✅ | ✅ | ✅ WebSocket live chat | | **Mobile-native** | ❌ WebView overlay | ❌ WebView | ✅ React Native component | | **Setup time** | Days–weeks (build connectors) | Days–weeks | **Minutes** (`` wrapper) | | **Price per resolution** | $0.99 + subscription | $1.50–2.00 | You decide | ### The moat No competitor can do Levels 2–4. Intercom and Zendesk answer questions (Level 1) and escalate to humans (Level 5). The middle — **app-aware navigation, form assistance, and full in-app resolution** — is uniquely possible because this SDK reads the React Native Fiber tree. That can't be added with a plugin or API connector. --- ## ✨ What's Inside ### Support Your Users #### 🦹 AI Support Agent — Resolves at Every Level The AI answers questions, guides users to the right screen, fills forms on their behalf, or completes full task flows — with voice support and human escalation built in. All in the existing app UI. Zero backend integration. - **Zero-config** — wrap your app with ``, done. No annotations, no selectors, no API connectors - **5-level resolution** — knowledge answer → guided navigation → copilot → full resolution → human escalation - **Copilot mode** (default) — AI pauses once before irreversible actions (order, delete, submit). User always stays in control - **Human escalation** — live chat via WebSocket, CSAT survey, ticket dashboard — all built in - **Knowledge base** — policies, FAQs, product data queried on demand — no token waste #### 🎤 Real-time Voice Support — Users Speak, AI Acts Full bidirectional voice AI powered by the Gemini Live API. Users speak their support request; the agent responds with voice AND navigates, fills forms, and resolves issues simultaneously. - **Sub-second latency** — real-time audio via WebSockets, not turn-based - **Full resolution** — same navigate, type, tap as text mode — all by voice - **Screen-aware** — auto-detects screen changes and updates context instantly > 💡 **Speech-to-text in text mode:** Install `expo-speech-recognition` for a mic button in the chat bar — letting users dictate instead of typing. Separate from voice mode. #### 🍎 Siri & Spotlight — Trigger Actions Hands-Free (iOS 16+) Every `useAction` you register automatically becomes a **Siri shortcut** and **Spotlight action**. One config plugin added at build time — no Swift required — and users can say: > *"Hey Siri, track my order in MyApp"* > *"Hey Siri, checkout in MyApp"* > *"Hey Siri, cancel my last order in MyApp"*

Setup — Expo Config Plugin

```json // app.json { "expo": { "plugins": [ ["@mobileai/react-native/withAppIntents", { "scanDirectory": "src", "appScheme": "myapp" }] ] } } ``` After `npx expo prebuild`, every registered `useAction` is available in Siri and Spotlight automatically. **Or generate manually:** ```bash # Scan useAction calls → intent-manifest.json npx @mobileai/react-native generate-intents src # Generate Swift AppIntents code npx @mobileai/react-native generate-swift intent-manifest.json myapp ```

> ⚠️ iOS 16+ only. Android equivalent (Google Assistant App Actions) is on the roadmap. --- ### Supercharge Your Dev Workflow #### 🔌 MCP Bridge — Test Your App in English, Not Code Your app becomes MCP-compatible with one prop. Connect any AI — Antigravity, Claude Desktop, CI/CD pipelines — to remotely read and