Weyvox documentation
Weyvox is a communication app for iPhone (iOS) built around a personal AI voice agent. It combines free messaging and calls between users with a real phone line and an AI agent that can make and answer phone calls and complete tasks on your behalf. This documentation describes what Weyvox does and how each part works.
Overview
Weyvox is an iPhone (iOS) app. It has four main tabs:
- Contacts — the people you can message and call.
- Messages — your chats and calls.
- Weyvox — the personal AI agent (chat with it, give it tasks).
- Settings — your profile, phone numbers, balance, tariffs, notifications, data, and agent configuration.
What is free and what is paid, at a glance:
- Free: all messages (text, photos, video, files, voice, location) and audio calls between Weyvox users, plus the first 5 GB of media storage.
- Paid, charged from a prepaid in-app balance: calls to regular phone numbers, use of the AI agent (chat, calls, tasks), storage above 5 GB, and buying and maintaining a real phone number.
You only pay for the paid features, and only when you use them. Current prices are always shown inside the app under Settings → Tariffs.
Getting started
Create an account
Weyvox uses your phone number as your identity — no email is required. Enter your phone number and Weyvox sends a one-time confirmation code by SMS. Enter the code to verify the number.
Set up your profile
After verification, complete your profile: first name, last name, date of birth, and gender. A profile photo is optional. The date of birth cannot be in the future. You can edit all of this later in Settings → Account → Personal information.
Permissions
Weyvox asks for permissions as needed: access to your contacts (to find other Weyvox users and place calls), notifications (for messages and incoming calls), and the microphone (for calls and voice messages). You control every permission in your iPhone settings.
Finding people
People you know are found by their phone number: if someone in your contacts uses Weyvox, you can message and call them for free.
Messaging
Open the Messages tab to chat. Messaging between Weyvox users is free and unlimited.
What you can send
- Text, photos, video, files, voice messages, and location.
- Several photos or videos can be sent together as a single album message.
Working with messages
- Reply to a specific message with a quote, forward a message to another chat, or add an emoji reaction.
- Edit or delete your own messages.
Saved messages
Every account has a personal “to self” notepad chat — Saved messages — for keeping links, files, photos, or notes. Open it in Settings → Account → Saved messages.
Blocking
Open a contact's profile and tap Block (or Unblock). Manage all blocked contacts in Settings → Account → Blocked numbers.
Notifications
Set message notifications, sound, and preview style (full text / name only / no preview) in Settings → Notifications. To mute one chat, open the contact's profile or chat info and choose how long to mute it.
Chat wallpapers
In a chat's settings you can set a wallpaper — either a ready image from the built-in library or your own photo. Custom wallpapers are kept in your storage.
Calls
Calls between Weyvox users (free)
Audio calls between Weyvox users go over the internet, in high definition, and are completely free — for both the caller and the person answering. No carrier and no minutes are involved.
Calls to regular phone numbers
To call regular (non-Weyvox) phones, you need a real phone number in the app (see Phone numbers). Such calls are paid and are charged from your balance after the call ends, once the exact cost is known.
Call history
Calls appear in your history and in the relevant chats. You can see outgoing, incoming, completed, and missed (unanswered) calls. For calls to regular numbers, the cost of the call is shown next to it once the call has been rated.
Phone numbers
Personal number vs. real (operator) number
Your personal number is the number you verified when signing up. It identifies you to other Weyvox users, and messaging and calls between Weyvox users are free.
A real (operator) number is a separate phone number you can buy inside the app so you can call regular phones and receive incoming calls from them. You do not need a real number for anything inside Weyvox — only to reach regular phone numbers.
Getting a real number
In Settings, open the phone-number purchase section, choose a country, and pick a number from the list. Some numbers require identity verification (KYC) under regulatory rules — if so, the app shows exactly which documents or details are needed, and you upload them during the purchase. Many numbers require no documents.
Buying a number has a one-time connection fee and a monthly service fee, both charged from your balance. After purchase, the number is sent for activation with the carrier, which is not always instant.
Number subscription
A real number carries a monthly service fee — a subscription that is charged automatically from your balance once a month. If your balance is insufficient, the number is suspended; you have 20 days to top up before the number is removed.
The Weyvox AI agent
The AI agent is the heart of Weyvox. It is available on the Weyvox tab. When it speaks on a call, it identifies itself as an AI assistant acting for you.
What the agent can do
- Chat with you and understand your conversations.
- Call regular numbers on your behalf and get things done (for example, ask a question, arrange a booking, or handle a routine call).
- Carry out multi-step tasks in the background.
- Remember important facts about you so it can help without asking again.
- Look up information on the internet when needed.
- Write a short note summarising a call afterward.
Chatting with the agent
Open the Weyvox tab and type or dictate a request — the agent replies. A one-to-one chat with a person also has a button to bring the agent into that specific conversation (available when agent access to chats is enabled in the agent's settings).
Asking the agent to call for you
Give the agent a task such as “call and find out…”. The agent places the call itself and returns the result and a short note. If the number belongs to another Weyvox user, the call goes through the app; to call a regular number, you need your own real number. Agent calls are a paid feature, charged from your balance.
Agent tasks
Agent tasks are multi-step assignments the agent carries out on its own in the background — for example, gathering information or handling something over several steps. You see progress and results on the Agent tasks page, and you get a notification when a task finishes or needs your input. Complex tasks are charged by actual usage.
Agent memory
The agent can remember useful facts about you to help more effectively. You can review, manage, and fully clear this memory on the agent memory page. Each user's memory is isolated and used only for that user's requests.
Voice and “brain”
In the agent's settings you can choose the voice it uses on calls and its “brain” — the underlying model that determines its capabilities and the price per usage. A more capable brain answers better but costs more for the same amount of work. Current model prices are shown under Settings → Tariffs → AI agent.
AI call notes
An AI call note is a short summary of a conversation (typically 2–4 sentences) that Weyvox prepares automatically after a call, based on a recording of the call. It is a paid feature, because it includes transcribing the conversation to text and processing it with AI.
- You can specify what the note should focus on, or turn the feature off entirely in Settings → Call notes.
- When notes are enabled on a call to a regular number, Weyvox plays an audible notice to the other party that the call is being recorded for a note.
- Recording of calls may be regulated where you or the other party are located; enable notes only where you are permitted to record.
Balance & billing
Topping up
Open Settings → Top up balance and choose an amount. Payment is processed through the App Store (Apple). Your balance is only spent on paid actions: calls to regular numbers, the AI agent, and storage above the free allowance.
How charging works
Paid features are charged from your prepaid balance based on your actual usage. Where a price cannot be known in advance (such as a call to a regular number), the charge is applied after the action completes and the exact amount is known. All current prices are listed inside the app.
Seeing your spending
Open Settings → Balance & usage to see your current balance and a daily spending history. For recent days you can expand a detailed breakdown of each operation.
Tariffs
Open Settings → Tariffs to see current prices, grouped by feature: operator call, AI agent, AI note, memory, and storage.
When the balance runs out
Free features — chats and calls between Weyvox users — keep working. Paid actions become unavailable until you top up again.
Refunds
Because top-ups are made through Apple, refunds are governed by App Store rules. Funds already spent on services (calls, the agent, storage) are non-refundable.
Data & storage
Storage allowance
The first 5 GB of media storage is free. Above that, storage is billed per full gigabyte per month; partial gigabytes are not charged. Only real media files stored on the servers count toward storage — photos, video, audio, other files from chats, and your own custom chat wallpapers. Message text, links, and data that live only on your phone are not counted.
Managing storage
Open Settings → Account → Data & storage to see usage broken down by category (Photos, Video, Audio, Files, Wallpapers). Each category has a delete option to free space; the counter updates immediately.
How deletion works
- Deleting media from your storage cannot be undone.
- If you delete a file that others in a shared chat still keep, it disappears from your storage but stays with them (ownership passes to them). If no one keeps the file anymore, it is permanently erased from the servers.
- Media may be cached locally on your device for fast display; the cache is only a local copy.
Deleting your account
Open Settings → Account → Delete account. Weyvox deletes your data and media, releases your real phone numbers with the carrier, and cancels the number subscription. Shared chats remain with the other people, but your access to them is lost. This action cannot be undone.
Privacy
Your number, calls, and data belong to you, with per-user data isolation and transparent controls. See the Privacy Policy for full details.
Languages
The Weyvox app interface is available in multiple languages. The AI agent speaks the language of the call and can adapt to the other party; English and Ukrainian are supported, among others. Language settings are in Settings → App & AI language.
Availability & support
Weyvox is an iPhone (iOS) app and is preparing for release on the App Store. For help, contact support.weyvox@gmail.com. See also the FAQ.