> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wittify.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# First-Time Setup
> End-to-end walk-through of creating a Wittify account, completing your profile, and getting the dashboard ready for your first product. Every screen, every field, every button.
This page walks you through the very first time you open Wittify, from the signup form to the dashboard. Five steps total: **sign up**, **verify your email**, **complete your profile**, **review profile settings**, and **pick your product**. The page mirrors what the app shows you in the order it shows it.
## Before you start
You need a working email inbox you can read for the next ten minutes (the verification code expires within that window). If you'd rather sign up with **Google**, **Microsoft**, or **GitHub**, you can skip the email step entirely and jump to **Complete Your Profile**.
## Step 1, sign up
Open [https://app.wittify.ai](https://app.wittify.ai) and click **Sign Up**, or go directly to [https://app.wittify.ai/signup](https://app.wittify.ai/signup).
You see a two-panel layout. The dark gradient panel on the start edge is for branding (Wittify wordmark, headline, feature pills, Saudi Tech logo for visitors detected from Saudi Arabia). The form panel is what you interact with.
The form panel has, top to bottom:
| Area | What you see |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| Topbar | **Language switcher** (EN / AR, preserves the current page) and **theme toggle** (light / dark / system) |
| Heading | **Create your account** |
| Sub-heading | *Enter your email and we'll send you a verification code.* |
| Social provider grid | A 2x2 grid: **Google**, **Microsoft**, **GitHub**. (**Apple** is hidden today, available when re-enabled.) |
| Divider | **or continue with** |
| Email field | Placeholder `name@company.com`. |
| Button | **Send verification code**. Disabled while the email field is empty. While the request is in flight, the label flips to a spinner. |
| Terms text | *By continuing, you agree to our Terms of Service and Privacy Policy.* |
| Footer link | *Already have an account?* **Sign in** |
### If you pick a social provider
Click **Google**, **Microsoft**, or **GitHub**. The provider's authorization page opens (a popup on most browsers, a full redirect on Safari and iOS). Authorize, and you're returned to Wittify already signed in. First-time social signups skip the email step and go directly to **Complete Your Profile**.
If you cancel the provider flow, the popup closes and you're back at the signup form. No data is created.
### If you sign up with email
Type your email, click **Send verification code**. On click, validation runs:
| Validation failure | Inline message |
| ------------------ | ---------------------------------------------------- |
| Empty | *Email is required.* |
| Wrong format | *Please enter a valid email address.* |
| Already used | *This email is already registered. Sign in instead.* |
A success toast appears: *Verification code sent.* You're routed to the OTP verification page automatically.
## Step 2, verify your email
The verification page is at [https://app.wittify.ai/verify-otp](https://app.wittify.ai/verify-otp). It shows:
| Element | Notes |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Heading | **Verify your email** |
| Sub-heading | *We sent a code to* `your@email.com`. *It's valid for 10 minutes.* |
| Code field | Eight slots displayed as `XXXX-XXXX`. Letters and digits accepted (case-insensitive). The cursor jumps slot by slot as you type. Pasting the full code from the email auto-fills every slot. |
| Submit button | **Verify**. Disabled until all eight slots are filled. While the request is in flight, the label flips to a spinner. |
| Resend row | *Didn't get the code?* **Resend code**. Disabled for 60 seconds after each send; the countdown shows next to the link. |
| Wrong-code error | *Incorrect code. Please try again.* The slots flash red and clear. |
| Expired-code error | *This code has expired. Send a new one.* |
On success, you're routed to the **Profile Completion** page.
## Step 3, complete your profile
The page is at [https://app.wittify.ai/profile-completion](https://app.wittify.ai/profile-completion). The same page handles both first-time email signups and first-time social signups (the password section is hidden for social signups, since your provider already authenticates you).
The fields are arranged in a single card. Required fields show a small red asterisk in the label.
| Field | Notes |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **First Name** \* | Plain text, capped at 50 characters. |
| **Last Name** \* | Same rules. |
| **Phone Number** \* | Two parts. The leading dropdown lists 50 countries with flag and dial code; the trailing input takes the local number. After you save, a verification sub-flow sends a code to your phone via WhatsApp or SMS. |
| **Password** \* | Hidden for Google / Microsoft / GitHub signups. Required for email signups. Must be at least 8 characters with one uppercase letter and one digit. Validation: *Password must be at least 8 characters with an uppercase letter and a number.* |
| **Confirm Password** \* | Must match Password. Validation: *Passwords do not match.* |
| **Company Name** \* | Plain text, capped at 100 characters. |
| **URL** | Optional. Must start with `https://`. Validation: *Please enter a valid https\:// URL.* |
| **Continue** button | Solid primary. Disabled until every required field is filled and validations pass. While saving, a spinner replaces the label. |
### Phone OTP sub-flow
After you fill in the phone number and tab away, a small **Verify** action appears next to the input. Click it. A modal asks how to deliver the code: **WhatsApp** or **SMS**. Pick one.
| Element | Notes |
| --------------------- | ------------------------------------------------------------------- |
| Code input | 6 digits. The slots auto-advance. |
| **Verify** | Disabled until 6 digits are entered. |
| **Resend code** | Disabled for 60 seconds after each send. |
| Wrong code | *Incorrect code. Please try again.* The slots flash red and clear. |
| Reached attempt limit | *Too many attempts. Try again in 5 minutes.* |
| Success | The phone field shows a green check chip with the label *Verified*. |
On submit, the form posts your details and you land on the dashboard.
## Step 4, review your profile settings
You can change everything you just entered (and a few things you didn't see) from the **Profile Settings** page. To open it from anywhere in the app:
1. Click your **profile avatar** in the topbar's end edge.
2. Pick **Settings** from the dropdown.
Or navigate to [https://app.wittify.ai/settings/profile](https://app.wittify.ai/settings/profile).
The page is split into cards:
| Card | What it holds |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------- |
| **Personal Information** | Avatar (Upload Image / Remove Image), First Name, Last Name, Email (read-only), Contact Number with country dropdown. |
| **Preferences** | Time Zone with a **Detect** button next to it that reads your browser zone. |
| **Company** | Company Name, Website URL (https only). |
| **Security** | Two-factor authentication switch, **Reset Password** button at the top of the page. |
| Footer action bar | **Discard Changes**, **Save Changes**, **Delete Account**. |
The deep dive is on [Profile Settings](/en/Account/Profile-Settings).
## Step 5, pick your first product
You're on the **AI Agents dashboard** by default. The empty-state version is the first thing you see if you have no agents yet:
| Section | What it shows |
| ------------------------ | ----------------------------------------------------------------------------------------------- |
| Hero greeting | *Welcome to Wittify · Sandbox · Free*. The plan badge mirrors your current plan. |
| **How Wittify Works** | Five icon cards explaining the build flow. |
| **Build Your Agent Now** | Three cards: **Text Agent**, **Voice Agent**, **Hybrid Agent**. Click any to launch the wizard. |
| **Connected channels** | A row of seven channel logos showing where you can deploy. |
| **Upgrade strip** | Plan-aware. Shown for Sandbox / Starter / Scale / Pro. Hidden on Enterprise. |
| **Use Cases** | A 14-card grid with example agents (Customer Support, HR Assistant, Government Services, etc.). |
To switch to a different product, open the **system switcher** at the top of the sidebar (right under the Wittify logo). Pick:
| Pick | What happens |
| ---------------------------- | --------------------------------------------------------------------------------------- |
| **AI Agents** | Stays on the AI Agents dashboard. |
| **Speech to Text (Faheem)** | Routes to the [Speech to Text dashboard](/en/Systems/Speech-to-Text/Overview). |
| **Text to Speech (Faseeh)** | Routes to the [Text to Speech studio](/en/Systems/Text-to-Speech/Overview). |
| **Contact Center QA** | Routes to the [CCQA welcome / Overview page](/en/Systems/Contact-Center-QA/Overview). |
| **Chat with Your Documents** | Routes to the [CWD welcome / project picker](/en/Systems/Chat-with-Documents/Overview). |
## Account-wide things to know on day one
| Setting | Where | Why it matters |
| --------------------------- | -------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| **Notification Settings** | Sidebar **System → Notification Settings** | Five email toggles. All on by default. Turn off the daily digest if your inbox is sensitive to noise. |
| **Plans and Subscriptions** | Profile dropdown → **Plans & Subscriptions** | First page is **Overview** with current plan, usage, and the Upgrade card. |
| **User Activities** | Profile dropdown → **User Activities** | Audit log of every login and account change. |
| **Theme** | Topbar theme toggle | Saved per browser. Defaults to **Dark**. |
| **Language** | Topbar language switcher | Saved in the URL. The interface mirrors RTL when you switch to Arabic. |
## Common questions
Check your spam / junk folder first. The code is valid for ten minutes. If nothing shows up, click **Resend code** on the OTP page (disabled for 60 seconds after each send). If a typo on signup is the cause, go back to the signup form and re-enter the right address.
The code expires after ten minutes. If you let the page sit too long, request a new one with **Resend code**.
The email field is empty or the format is invalid. Make sure there's a single email like `name@company.com`. The button enables the moment the format check passes.
Sign out (avatar dropdown → **Log Out**), then go back to `/signup` and click **Sign up with Email**. Your Google account is not tied to anything until you complete the profile.
That happens when the phone field is empty or the format is invalid. Pick the right country code first, then type the local number, then click **Verify**.
No. Phone verification is required for every account. The phone is also used as a second factor if you turn on two-factor authentication.
Only `https://` URLs are accepted. `http://` and other schemes are rejected client-side. Type the full https URL or leave the field empty (it's optional).
Re-open the country dropdown, pick the right code, then click **Verify** again. The phone form does not send a duplicate code if you change the dial code; you need to actively click **Verify** to trigger a new send.
Sign back in at `/login` with your email and the verification step you finished, you'll land back on the **Profile Completion** page with the data you already entered prefilled. Pick up from where you left off.
Email is read-only on **Profile Settings**. Changing it requires re-verifying ownership of the new address; today that's a separate flow handled by support, not exposed in the app.
***
> 💡 **Need help getting started?**
> Book a **free onboarding session** with one of our Customer Success Engineers and get personalized guidance on setting up your first Wittify product.
>
> 📅 **Book here:** [Schedule a Free Onboarding Session](https://calendly.com/d/cv9n-48c-kr2/wittify-ai-support-team)