> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ravvio.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Account

> Step-by-step guide to creating your Ravvio account with email verification or Google OAuth

## Account Creation Overview

Ravvio offers two convenient ways to create your account: traditional email signup with verification or quick Google OAuth integration. Both methods provide full access to the platform features.

<img src="https://mintcdn.com/ravvio/_L8X6ofEXB51J7A7/images/signup-form.png?fit=max&auto=format&n=_L8X6ofEXB51J7A7&q=85&s=580a1db8b7d66c424982e12fc23339a1" alt="Registration form interface" width="1898" height="858" data-path="images/signup-form.png" />

### Available Signup Methods

<CardGroup cols={2}>
  <Card title="Email Signup" icon="mail">
    **Traditional Registration**

    Create account with email verification via 6-digit OTP
  </Card>

  <Card title="Google OAuth" icon="chrome">
    **Quick Registration**

    Sign up instantly using your Google account
  </Card>
</CardGroup>

## Email Signup Process

### Step-by-Step Registration

<Steps>
  <Step title="Initial Registration">
    **Account Information:**

    * Enter your Company name
    * Provide a valid Company address
    * Create a secure password
    * Submit registration form

    **System Validation:**

    * Checks if email already exists in database
    * Validates password strength requirements
    * Hashes password for secure storage
    * Prepares email verification process
  </Step>

  <Step title="Email Verification Setup">
    **OTP Generation:**

    * System generates 6-digit verification code
    * Sets 10-minute expiration time for security
    * Stores verification data temporarily in email\_verifications table
    * Prepares verification email with OTP

    **Verification Email Sent:**

    * Professional verification email delivered to your inbox
    * Contains 6-digit OTP code for account activation
    * Includes expiration time (10 minutes from generation)
    * Clear instructions for completing verification

          <img src="https://mintcdn.com/ravvio/_L8X6ofEXB51J7A7/images/verification-email.png?fit=max&auto=format&n=_L8X6ofEXB51J7A7&q=85&s=4e35438bb0174b640544dcebca110e84" alt="Email inbox with OTP email" width="1598" height="764" data-path="images/verification-email.png" />
  </Step>

  <Step title="OTP Verification">
    **Complete Account Activation:**

    * Enter the 6-digit OTP from your email
    * System validates OTP against stored verification data
    * Checks expiration time (must be within 10 minutes)
    * Creates your permanent user account upon successful verification

          <img src="https://mintcdn.com/ravvio/_L8X6ofEXB51J7A7/images/otp-verification.png?fit=max&auto=format&n=_L8X6ofEXB51J7A7&q=85&s=72fc727676a33b6a5e779733f47e2738" alt="6-digit code entry screen" width="674" height="629" data-path="images/otp-verification.png" />
  </Step>

  <Step title="Account Creation">
    **Final Account Setup:**

    * User record created in main users table
    * Email marked as verified with timestamp
    * Temporary verification data cleaned up
    * Welcome email automatically sent

          <img src="https://mintcdn.com/ravvio/_L8X6ofEXB51J7A7/images/account-created.png?fit=max&auto=format&n=_L8X6ofEXB51J7A7&q=85&s=d6916a6f763b70f43a3bc0aeab782c88" alt="Success message and dashboard redirect" width="378" height="406" data-path="images/account-created.png" />
  </Step>
</Steps>

### Email Verification Features

<AccordionGroup>
  <Accordion title="OTP Security">
    **Security Measures:**

    * 6-digit numerical code for easy entry
    * 10-minute expiration window for security
    * Single-use verification code
    * Automatic cleanup of expired codes

    **Verification Benefits:**

    * Confirms email ownership and deliverability
    * Prevents fraudulent account creation
    * Ensures communication reliability
    * Complies with security best practices
  </Accordion>

  <Accordion title="Resend Functionality">
    **OTP Resend Options:**

    * Request new OTP if original expires
    * Multiple resend attempts allowed
    * New 10-minute window with each resend
    * Same email address validation maintained

    **Resend Process:**

    * Click "Resend OTP" on verification page
    * New 6-digit code generated instantly
    * Fresh verification email sent immediately
    * Previous OTP automatically invalidated
  </Accordion>
</AccordionGroup>

## Google OAuth Signup

### Quick Registration Process

<Steps>
  <Step title="Google Authentication">
    **OAuth Flow:**

    * Click "Continue with Google" button
    * Redirected to Google OAuth consent screen
    * Authorize Ravvio to access basic profile information
    * Google returns user profile data (name, email, Google ID)

          <img src="https://mintcdn.com/ravvio/_L8X6ofEXB51J7A7/images/google-oauth.png?fit=max&auto=format&n=_L8X6ofEXB51J7A7&q=85&s=418b4f3ae4ef6d2297de46d72b6e7d1f" alt="Google sign-in button and consent" width="1603" height="631" data-path="images/google-oauth.png" />
  </Step>

  <Step title="Account Verification">
    **System Checks:**

    * Verifies if Google ID already exists in database
    * Checks for existing email with different provider
    * Validates Google OAuth token and user information
    * Determines if this is new signup or existing user login
          <img src="https://mintcdn.com/ravvio/_L8X6ofEXB51J7A7/images/google-oauth2.png?fit=max&auto=format&n=_L8X6ofEXB51J7A7&q=85&s=a720ebe4502b8e139d400d78a724e5f3" alt="Google sign-in button and consent" width="1571" height="789" data-path="images/google-oauth2.png" />
  </Step>

  <Step title="Account Creation or Login">
    **New Google User:**

    * Creates new user account with Google provider
    * Email automatically verified (trusted OAuth provider)
    * Unique user ID generated for account

    **Existing User Scenarios:**

    * Existing Google user: Logs in directly
    * Same email, different provider: Shows appropriate message
    * Links Google account if upgrading from email signup
  </Step>

  <Step title="Immediate Access">
    **Instant Platform Access:**

    * No email verification required
    * Automatic login after successful OAuth
    * Full platform features immediately available
    * Welcome email sent in background
  </Step>
</Steps>

### Google OAuth Benefits

<CardGroup cols={2}>
  <Card title="Quick Setup" icon="zap">
    **Instant Registration:**

    * No password creation required
    * Skip email verification process
    * Immediate access to platform
    * Trusted authentication provider
  </Card>

  <Card title="Enhanced Security" icon="shield">
    **OAuth Security:**

    * Google-managed authentication
    * No password storage in Ravvio
    * Advanced security features from Google
    * Secure token-based access
  </Card>
</CardGroup>

## Post-Registration Automatic Setup

### Default Agent Creation

<AccordionGroup>
  <Accordion title="Automatic Agent Provisioning">
    **Default Agent Setup:**

    * System automatically creates default AI agent for new user
    * Agent configured with basic settings and capabilities
    * Ready for immediate customization and deployment
    * Ensures every user has functional agent from start

    **Agent Configuration:**

    * Default system prompt and personality
    * Basic knowledge base structure
    * Standard widget appearance settings
    * Integration code ready for website deployment
  </Accordion>

  <Accordion title="Agent Service Integration">
    **Backend Process:**

    * AgentService.ensureUserHasAgent() called automatically
    * Creates agent if none exists for user
    * Links agent to user account permanently
    * Provides foundation for platform usage

    **Failure Handling:**

    * Account creation succeeds even if agent creation fails
    * Warning logged for manual resolution
    * User can create agent manually if needed
    * Support team notified for assistance
  </Accordion>
</AccordionGroup>

### Welcome Email System

<Steps>
  <Step title="Welcome Email Delivery">
    **Automated Welcome:**

    * Professional welcome email sent immediately after registration
    * Personalized with user's name and registration details
    * Includes platform overview and getting started information
    * Links to documentation and support resources
          <img src="https://mintcdn.com/ravvio/_L8X6ofEXB51J7A7/images/welcome-mail.png?fit=max&auto=format&n=_L8X6ofEXB51J7A7&q=85&s=a3a93f4e7cb7bd8845b16b1261aae8a9" alt="Google sign-in button and consent" width="919" height="721" data-path="images/welcome-mail.png" />
  </Step>

  <Step title="Email Template Features">
    **Welcome Content:**

    * Platform introduction and key features overview
    * Quick start guide and next steps
    * Links to documentation and tutorials
    * Support contact information and resources
  </Step>

  <Step title="Admin Notifications">
    **Internal Notifications:**

    * Admin team notified of new user registrations
    * User details shared for potential onboarding support
    * Registration method tracked (email vs Google)
    * Analytics updated for user acquisition metrics
  </Step>
</Steps>

## Account Creation Validation

### Email Verification Process

<AccordionGroup>
  <Accordion title="Verification Flow">
    **Step-by-Step Verification:**

    1. User receives email with 6-digit OTP
    2. Enters OTP on verification page
    3. System validates OTP and expiration time
    4. Creates permanent user account
    5. Sends confirmation and welcome emails
    6. Redirects to dashboard with active session

    **Validation Rules:**

    * OTP must match exactly (6 digits)
    * Must be entered within 10-minute window
    * Only unused OTPs accepted
    * Email address must match registration
  </Accordion>

  <Accordion title="Error Handling">
    **Common Issues:**

    * Expired OTP: Shows clear message with resend option
    * Invalid OTP: Prompts to check email and re-enter
    * Email not received: Provides resend functionality
    * Multiple attempts: Allows reasonable retry attempts

    **User Support:**

    * Clear error messages with actionable solutions
    * Resend OTP option always available
    * Support contact information provided
    * Troubleshooting tips included in emails
  </Accordion>
</AccordionGroup>

## Troubleshooting Account Creation

### Common Issues and Solutions

<CardGroup cols={2}>
  <Card title="Email Verification Problems" icon="mail">
    **Common Issues:**

    * Verification email not received
    * OTP expired before entry
    * Email in spam/junk folder
    * Multiple registration attempts
  </Card>

  <Card title="Google OAuth Issues" icon="alert-triangle">
    **Potential Problems:**

    * Google account access restrictions
    * Browser blocking OAuth popup
    * Network connectivity issues
    * Corporate firewall restrictions
  </Card>
</CardGroup>

### Resolution Steps

<AccordionGroup>
  <Accordion title="Email Verification Troubleshooting">
    **Verification Issues:**

    * Check spam/junk folders for verification email
    * Use resend OTP function for new code
    * Ensure email address entered correctly
    * Contact support if problems persist

    **Technical Solutions:**

    * Clear browser cache and cookies
    * Try different browser or device
    * Disable ad blockers temporarily
    * Check internet connectivity
  </Accordion>

  <Accordion title="Google OAuth Troubleshooting">
    **OAuth Problems:**

    * Allow popups from Ravvio domain
    * Try incognito/private browsing mode
    * Clear Google account sessions
    * Use email signup as alternative

    **Access Issues:**

    * Verify Google account is active
    * Check corporate/school restrictions
    * Try different Google account
    * Contact IT support for corporate accounts
  </Accordion>
</AccordionGroup>

<Note>
  **Account Verification**: Email verification is required for email signups to ensure deliverability and account security. Google OAuth users are automatically verified.
</Note>

<Tip>
  **Quick Start**: After account creation, you'll automatically have a default AI agent created and ready for customization. Check your dashboard to begin setup.
</Tip>

<Warning>
  **OTP Expiration**: Email verification codes expire after 10 minutes for security. Request a new code if yours has expired.
</Warning>
