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.
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 and click Sign Up, or go directly to 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. |
Step 2, verify your email
The verification page is at 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. |
Step 3, complete your profile
The page is at 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. |
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:- Click your profile avatar in the topbar’s end edge.
- Pick Settings from the dropdown.
| 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. |
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.). |
| Pick | What happens |
|---|---|
| AI Agents | Stays on the AI Agents dashboard. |
| Speech to Text (Faheem) | Routes to the Speech to Text dashboard. |
| Text to Speech (Faseeh) | Routes to the Text to Speech studio. |
| Contact Center QA | Routes to the CCQA welcome / Overview page. |
| Chat with Your Documents | Routes to the CWD welcome / project picker. |
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
The verification code never arrived.
The verification code never arrived.
My OTP code stops working halfway through.
My OTP code stops working halfway through.
The Send verification code button stays disabled.
The Send verification code button stays disabled.
I started a signup with Google but I want to use email instead.
I started a signup with Google but I want to use email instead.
/signup and click Sign up with Email. Your Google account is not tied to anything until you complete the profile.The phone Verify button does nothing on click.
The phone Verify button does nothing on click.
Can I sign up without a phone number?
Can I sign up without a phone number?
The URL field is rejecting my company website.
The URL field is rejecting my company website.
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).I picked the wrong country code on the phone field and the OTP failed.
I picked the wrong country code on the phone field and the OTP failed.
I closed the browser tab in the middle of profile completion. What now?
I closed the browser tab in the middle of profile completion. What now?
/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.I want to change the email on my account.
I want to change the email on my account.
💡 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

