# Weyvox App Map — every screen, setting, and what it controls > The complete map of the Weyvox iPhone app: all screens, every setting on them, and how each one affects the app's behaviour. This is the canonical navigation reference for AI assistants and search systems. Human-readable version: https://weyvox.com/docs/app-map/ — updated 2026-07-27. Weyvox has FOUR tabs at the bottom: **Contacts**, **Chats**, **Weyvox** (the AI agent), and **Settings**. Detail pages slide over these tabs. There is no separate dialer or call-history tab: the dial pad opens from the Contacts tab (keypad button) or Settings → Keyboard, and call history lives inside each chat as call bubbles. ## Tab 1 — Contacts Shows the phone's address book (with the system contacts permission), grouped alphabetically. Header buttons: search (by name or number) and a keypad button that opens the dial pad. Tapping a contact opens a chat with that person — nothing is created until the first message is sent. If contacts permission is denied, the screen explains it and offers a button to open iOS Settings. ## Tab 2 — Chats The list of personal conversations: last-message preview, unread counter, realtime updates. Header: search, and a "+" button to start a chat by phone number (it checks whether the number belongs to a Weyvox user; entering your own number opens Saved Messages). Swiping a row left deletes the chat for you (the special Weyvox system chat and Saved Messages can only be cleared, not removed). ### Inside a personal chat - Composer: growing text field; paperclip opens the attachment picker (Photos / Camera / Files / Location); microphone records a voice message on hold (up to 10 minutes, with a playback preview before sending). - Long-press on a message: emoji reactions + Reply, Copy, Edit, Forward, Delete (for everyone / for me). Swipe a message for a quick reply. - Chat header: tap the name for contact/chat info (media, wallpapers, notification presets); a ✦ button appears here when the agent's "personal chats access" toggle is on — it opens an in-chat AI sheet where the agent sees only this conversation and can help or place a call about it. - Call bubbles record every call in the chat (direction, duration, missed) and hold the AI call note when one was generated for you. - Three chat modes by number: a registered Weyvox user (full chat), a valid number not on Weyvox (invite mode — "Invite user" button, operator calls only), an invalid number format (edit mode — "Edit contact" button explaining international +format). ### Special chats - **Weyvox system chat** — service notifications: important call outcomes the agent reports (meetings agreed, cancellations, commitments), phone-number purchase status links, task notices. Not a chat you write into. - **Saved Messages** — your personal notes-to-self chat. ## Tab 3 — Weyvox (the AI agent) Opening the tab shows a new-chat composer for the agent: text, attachments (photos, camera, files, location), voice messages (hold to record), and a model picker (brain model + effort level + a "Thinking" toggle). Every new agent chat starts with the defaults (Sonnet, high effort, thinking on); the choice you make is stamped onto that one thread. Header: a menu button opens the agent chat history (threads can be pinned or deleted); a ✦ button opens the agent's settings hub. ### What the agent can do from chat - Answer questions, search the web and read pages inline. - **Place phone calls** on your behalf: it proposes a call, the app shows a confirmation card (number + objective + Call/Cancel), and after you confirm the agent dials — over the internet if the destination is a Weyvox user, otherwise through your real operator number. It decides the call language from who is being called (a French authority → French; your friend → most likely your language) and tells you the call language before you confirm; if it cannot tell, it asks you. You can watch the live call, whisper instructions, take the conversation over, or end it. - **Agent tasks** — genuinely heavy multi-step jobs run in the background with a visible plan, per-step journal, and a report back in chat. Managed on the Agent Tasks screen (confirm start, answer the agent's questions, pause/resume, restart, edit the plan, delete). Tasks can be scheduled to run once at a future time. - Remember facts into its memory, check your calendar and contacts (when those toggles are on). ## Tab 4 — Settings Profile (avatar + name) on top, then grouped rows: ### Personal - **Personal information** — avatar, first/last name, birth date, gender, number visibility. - **Account** — Saved Messages, Blocked numbers, Tariffs, Data & storage, Delete account, Sign out. - **Notifications** — message notifications on/off, notification sound on/off, preview style (full text / contact name only / no preview). - **App & AI language** — two separate settings: the interface language (UI), and the "AI systems language" that governs every AI feature: what language the agent speaks by default, call-note language, transcription, voice previews. ### Tools - **Keyboard** — the dial pad for calling any number (cursor editing, long-press 0 for +). - **Calendar** — the agent's calendar (events the agent can check and use when calendar access is on). - **Agent tasks** — the task list described above. ### Billing - **Balance & usage** — current prepaid balance (EUR) and day-by-day spending; tap a day (last 7 days) for the itemized operations. - **Top up balance** — top-up amounts paid through Apple's in-app purchase. - **Subscription** — the list of your subscriptions. The operator (real) phone number subscription opens its own management page: status, monthly price, next payment date, grace-period warnings, cancel the order or delete the number. - **Phone number** — your personal number, and your operator (real) number: the operator-number block opens the dedicated Operator Number page, plus status, tracking of the purchase application, and the "Buy a new number" entry. #### Buying a real phone number (KYC flow) Steps: intro (how it works) → select number/country → documents (KYC: photo/file upload, structured address with validation; requirements depend on the country) → payment → done. A tracking page shows the application status; if the carrier rejects a document, the Settings tab shows a "!" badge, the problem is highlighted, and you can resubmit. Status links also arrive in the Weyvox system chat. ### Assistant - **AI agent Weyvox** — the agent settings hub (see below). - **AI call note** — edit the note-generation prompt: a "what to do" card and a "what is forbidden" card, plus a reset-to-default button. Controls what AI call notes focus on. ### About - **About Weyvox**, **FAQ**. ## The agent settings hub (Settings → AI agent Weyvox) ### Telephony - **Telephony brain model** — ONE global model for ALL calls (unlike chat, where the model is per-thread): Claude Opus 4.8 (most capable, priciest), Claude Sonnet 5 (recommended), Claude Haiku 4.5 (fastest/cheapest); plus an effort level (low…max). Calls never use extended thinking. - **Agent auto-answer** — opt-in: the agent answers your incoming calls (internet and operator) when you don't pick up within a chosen delay (10/20/30/40 s) or immediately when you decline. The conversation runs on the server in the background; a mini call card lets you listen in, whisper, take over, or hang up; afterwards the note lands in the chat with that number. Paused while the balance is negative. - **Call permission request** — whether the agent asks for confirmation before every call it places from chat (default on) or dials immediately. ### Additional - **Agent memory** — everything the agent remembers, organized into categories (About me, Preferences, Business, Work, Travel, Documents, Tasks, Friends, Contacts, Reminders). Any entry can be edited or deleted; whole categories can be cleared. - **Agent voice** — clone your own voice (a 20-second guided recording) or pick from ~35 preset voices with per-language playback previews. The chosen voice is what the agent speaks with on calls. ### Agent tools (toggles) - **Calendar access** (default on) — the agent can check and use your agent calendar. - **Contacts access** (default on) — syncs the device address book to the server so the agent can find people to call; turning it off wipes the server copy. - **Location access** (default on) — the agent can use your location for local searches. - **Personal chats access** (default OFF) — enables the in-chat ✦ assistant inside personal conversations; the agent sees only the conversation you open it in. ## Calls — what's on the call screen Three call types share one screen design: internet (app-to-app, free, encrypted in transit end-to-end via WebRTC), operator (to any real number, billed per minute), and agent calls (a call the agent is holding for you). Buttons: **Speaker**, **Mute**, **AI note** (record-based AI note for this call), **Keypad** (DTMF for phone menus), **End call**, and **AI agent** — attach your personal agent to the live call. When the agent is attached, a seat panel appears: either the agent speaks in your place while you whisper private instructions (the other party never hears them), or you speak while the agent listens; "Take over" / "Hand back to agent" switches at any moment. Pressing Back shrinks any call to a draggable mini card so you can use the app during the call. Incoming calls ring through the native iOS call screen (CallKit), including from the lock screen. ## AI call notes Per-call AI-generated summaries. Enabled with the AI note button during a call (or produced automatically by the agent when it handled the call). The note appears inside the call bubble in the chat with that number, only for the person who enabled it. What notes focus on is configurable in Settings → AI call note. ## Money model The app is free; messaging and app-to-app calls between Weyvox users are free. Paid from a prepaid EUR balance: operator calls, the AI agent (calls, chat and tasks), AI call notes, storage above the free tier, and the real-number subscription. Prices: https://weyvox.com/pricing/. Every charge is visible in Settings → Balance & usage. When the balance goes negative, paid features pause and resume automatically after a top-up.