Request Submission Form
Overview
The request submission form is where authenticated users enter text for manual audio generation. After submission, users receive email notifications as their request is processed by administrators.
Request Limits: Maximum 1000 characters per request
Processing Time: 1-24 hours (manual admin processing)
Need Help? If you need access or having problems logging in, please contact support.
Page Purpose
- Primary Action: Submit text-to-audio request
- Secondary Actions: Review selected voice, view character count
- Goal: Fast, intuitive text submission with clear expectations
Requests are processed manually by administrators. You will receive email notifications at each stage:
- Confirmation - Request received
- Processing - Work in progress
- Done - Audio ready with QR code
Live Preview
Submit Your Request
Enter your text below and we'll generate your audio with a QR code
👩
💡 Tip: Keep your text clear and concise for best audio quality
What happens next?
After submission, you'll receive a confirmation email. Our team will process your request and generate your audio. You'll receive additional emails when processing begins and when your audio and QR code are ready (typically within 1-24 hours). The QR code will be included in your final email.
Success State (After Submission)
When user clicks "Submit Request":
✓
Request Submitted Successfully!
We will generate your audio for you
What to expect:
Confirmation Email (Now)
Check your inbox for request confirmation
Processing Email (Soon)
You'll be notified when we start generating your audio
Done Email (1-24 hours)
You will receive your audio playback link and QR code
Request ID: REQ-123456789
You can reference this ID in support inquiries
API Endpoints
This page uses the following API endpoint:
Submit Text-to-Speech Request
Endpoint: POST /api/v1/text-to-speech
Authentication: Required (Bearer token)
Role Required: client role for submitting audio generation requests
Description: Submits a text-to-speech generation request with the selected voice. The request is created with "pending" status and processed manually by administrators.
Required Fields:
- text: string. The text content to convert to speech. Must be between 1 and 1000 characters.
- voiceId: string. UUID of the selected voice from the voice gallery.
Response: Returns request ID, status, and confirmation message. User receives email notifications at each processing stage.
Page Elements
Header Section
- Headline: "Submit Your Request"
- Subtitle: Explains the process clearly
- Purpose: Set expectations for manual processing
Selected Voice Display
Visual Elements:
- Voice avatar with color-coded gradient
- Voice name and details (e.g., "Rachel - Female, American")
- "Change Voice" button (navigates back to voice gallery)
- Selected from previous page (voice gallery)
Behavior:
- Shows voice selected on voice gallery page
- Cannot be changed here without going back
- Displayed prominently at top of form
Main Input Card
Text Input Area:
- Placeholder text with instructions
- Tip message for best practices
Submit Button: Primary button with "Submit Request" call-to-action, enabled when text is valid (1-1000 chars)
Info Banner:
- "What happens next?" explanation
- Details about three email notifications
- Sets expectations for 1-24 hour processing time
Quick Info Panel
Three info cards showing:
- 8 Voice Models - Available voice options
- 1000 Max Characters - Maximum text length
- 1-24h Processing Time - Expected turnaround
User Actions
- Review Voice - Confirm selected voice model
- Enter Text - Type or paste text into textarea
- Monitor Count - Watch character counter
- Click Submit - Submit request for processing
- See Success - View confirmation message
- Check Email - Receive confirmation email
Email Notification Flow
Users receive three automated emails during request processing. See Email Templates for full details.
1. Request Confirmation Email (Immediate)
Trigger: When user submits request
Subject: "Your MicDots request has been received"
Includes: Request ID, voice name, text preview
2. Processing Email (Admin Triggered)
Trigger: When admin starts processing
Subject: "Your audio is being generated"
Includes: Request ID, voice name, processing status
3. Audio Ready Email (Automatic)
Trigger: When admin uploads audio file
Subject: "Your audio is ready! 🎉"
Includes:
- Playback link (clickable button)
- QR code image (embedded)
- Download QR code button
- Usage instructions
See Combined Flow for complete user and admin workflow
Validation Rules
Text Input:
- Required: Cannot be empty
- Minimum: 1 character
- Maximum: 1000 characters
- Error: Show red border and message if invalid
Voice Selection:
- Required: Must select voice from gallery first
- Carried over from previous page
- Cannot be empty
Support:
- Message: "Need help? If you need access or having problems logging in, please contact support."
- Contact: support@micdots.com
User Flow
Previous Page: Landing/Login Page
Current Page: TTS Submission Form
Next Step: Audio result with shareable link
Flow:
- User logs in
- User navigates to TTS submission form
- User selects voice from dropdown
- User enters text
- User clicks "Submit Request"
- System creates request (status: pending)
- System sends confirmation email
- User sees success message
- User waits for admin processing
- User receives processing email (when admin starts)
- User receives done email (with audio + QR code)
Responsive Design
The page is fully responsive with optimized layouts for desktop (max 900px container), tablet (responsive grid), and mobile (single column, touch-friendly).
Success Criteria
- ✅ User can enter text (1-1000 chars)
- ✅ Character counter updates in real-time
- ✅ Selected voice is displayed correctly
- ✅ Submit button is enabled when valid
- ✅ Success message shown after submission
- ✅ Confirmation email received within 1 minute
- ✅ Request ID generated and displayed
- ✅ User understands next steps (email notifications)
- ✅ Form validation works correctly
Related Documentation
- User Flow - Complete user journey
- Voice Gallery API - Voice selection endpoints
- Text-to-Speech Submission API - TTS API
- Authentication - Login system