> ## 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.

# SmartInterview: Integration with Askia

### **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:

1. **Embed (Widget)** – inside the survey
2. **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

**Steps:**

1. Get iframe embed code from SmartInterview
2. Add a **free-format question** in Askia
3. Paste iframe into HTML template
4. Pass the respondent ID using `%IntvwIdentifier%` or similar

**Advantages:**

* No page redirects
* Better user experience
* Works with Askia logic (quotas, routing)

**Limitations:**

* 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:**

```text highlight={6-7} theme={null}
Askia → SmartInterview → Askia
```

**Steps:**

1. Create SmartInterview survey
2. Set Return URL (back to Askia)
3. Add a link or auto-redirect in Askia
4. Pass parameters (like respondent ID)

**Advantages:**

* Works everywhere (no iframe issues)
* Cleaner dedicated interview page

**Limitations:**

* 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

***

## Need Help?

Contact: [**info@smartinterview.ai**](mailto:info@smartinterview.ai)