Documentation Index
Fetch the complete documentation index at: https://docs.smartinterview.ai/llms.txt
Use this file to discover all available pages before exploring further.
Introduction
SmartInterview’s AI-powered vocal interviews can be combined with Askia surveys (AskiaDesign / AskiaWeb) to add qualitative depth to quantitative research. Askia supports:- Custom HTML
- Free-format questions
So you can integrate SmartInterview in two ways:
- Embed (Widget) – inside the survey
- Redirect – send users to SmartInterview and back
What Askia Supports
| Feature | Support |
|---|---|
| Custom HTML | Yes |
| iframe embedding | Yes |
| URL redirects | Yes |
| JavaScript support | Yes |
| Variable interpolation | Yes (%Var%, AskiaScript) |
| Recommended integration | Widget (embed) or Redirect |
Important Note on Themes
- SmartInterview has themes for Sphinx, LimeSurvey, Decipher, and Qualtrics
- No Askia theme yet
- Use Default theme (clean & neutral)
- Askia theme is planned for the future
Integration Methods
Option A: Widget (Embed) — Recommended
Embed SmartInterview directly inside Askia. How it works:- User stays inside Askia
- SmartInterview appears inline via iframe
- Get iframe embed code from SmartInterview
- Add a free-format question in Askia
- Paste iframe into HTML template
- Pass the respondent ID using
%IntvwIdentifier%or similar
- No page redirects
- Better user experience
- Works with Askia logic (quotas, routing)
- Some servers may block iframes
- No perfect visual match (no native theme yet)
Option B: Redirect
Send users to SmartInterview, then bring them back. Flow:- Create SmartInterview survey
- Set Return URL (back to Askia)
- Add a link or auto-redirect in Askia
- Pass parameters (like respondent ID)
- Works everywhere (no iframe issues)
- Cleaner dedicated interview page
- User leaves survey → possible drop-off
- Slightly worse UX than embed
Redirect Setup Overview
Step 1: SmartInterview Setup
- Create survey
- Leave
user_id = null - Add Return URL with placeholders:
{{ResumeID}}{{IntvwId}}
Step 2: Askia Setup
Two options:- Manual link (recommended)
- Auto redirect via JavaScript
Step 3: Return to Askia
- SmartInterview replaces parameters automatically
- Respondent resumes the survey where they left
What Data Gets Captured
All URL parameters:- Stored in SmartInterview responses
- Available as metadata
- Can be used for logic & filtering
- Passed back to Askia
Visual Styling
- Default theme used (neutral UI)
- You can:
- Adjust container styling in Askia
- Match background & spacing
Display Conditions
You can personalize interviews using Askia data. Example:- Pass
Wave=2 - Show the question only if
Wave = 2
Summary: Which Option to Choose
Use Widget (Embed) if:
- You want a seamless experience
- You need inline vocal questions
Use Redirect if:
- iframe is blocked
- You want a simpler setup
Recommendation
Why SmartInterview Alone Can Be Better
Using Askia + SmartInterview can cause:- Respondent fatigue (redirects)
- Split data across platforms
- More maintenance
SmartInterview vs Askia (Simplified)
| Capability | Askia | SmartInterview |
|---|---|---|
| Surveys | Yes | Yes |
| Logic & conditions | Yes | Yes |
| AI vocal interviews | No | Yes |
| Transcription | No | Yes |
| AI follow-ups | No | Yes |
| Sentiment analysis | No | Yes |
Key Benefits of SmartInterview
1. Faster Setup
- No complex scripting
- Visual builder
2. Better Engagement
- Higher completion rates
- More detailed responses
3. Deeper Insights
- AI follow-ups
- Sentiment + coding
- Automatic analysis
Quick Start Checklist
- Check iframe support
- Create SmartInterview survey
- Set Default theme
- Configure Return URL
- Add iframe or redirect
- Test full flow