Skip to main content

Experts

Experts are the people you interview using InsightAgent.

How Experts Work​

In InsightAgent, expert information is captured when you create an interview. Each interview includes details about the expert you're interviewing:

  • Name (required) - Expert's full name
  • Title (required) - Job title or position
  • LinkedIn/Bio URL - Link to professional profile
  • Employment History - Previous roles (optional, helps AI contextualize)

Adding Expert Information​

When creating a new interview:

  1. Go to Interviews > New Interview
  2. Fill in the expert details section
  3. Add employment history if relevant to the interview
  4. Continue with interview setup

Expert information is stored with the interview and used by the AI agent to contextualize the conversation.

Expert Portal​

Experts access interviews through a simple, ungated interface:

  • No account required
  • Single-click join via unique link
  • Works on any modern browser (Chrome, Firefox, Safari, Edge)
  • Mobile-friendly
  • Microphone access required

When an expert receives an interview link, they can join directly without signing up or logging in.

Expert Join URL Format​

https://app.insightagent.io/call/{interview-id}/join

Interface Language​

The join page can be shown in the expert's own language. Add a lang parameter with an ISO 639-1 code:

https://app.insightagent.io/call/{interview-id}/join?lang=ja

This controls the interface the expert sees — buttons, status messages, microphone and connection prompts. It is separate from the language the interviewer speaks, which comes from the interview's own configuration. The two can differ: an expert can read the page in their own language while the interview itself is conducted in another.

  • Omit the parameter and the interface is in English.
  • Experts can also change the language themselves on the page, and their choice is remembered.
  • An unrecognised or unsupported code falls back to English rather than showing a partly translated page.

An expert's own choice takes precedence over the link. The order is: the language they picked on the page, then ?lang=, then English. This is deliberate — a link sent last month should not silently override a preference someone set themselves — but it has one consequence worth knowing when testing: once the picker has been used in a browser, that browser no longer shows first-open behaviour. To see what a new expert sees, use a private window.

Matching the Interface to the Interview​

For most interviews the language you want is the one the interview is conducted in — a Japanese interview with a Japanese-speaking expert reads best with a Japanese page around it:

https://app.insightagent.io/call/{interview-id}/join?lang=ja

We do not add this automatically. A copied link is always plain, and the expert lands in English unless you say otherwise. That is deliberate: the expert's language is not always the interview's language — a Japanese-language interview may be with an expert who would rather read the interface in English, and they can change it on the page either way.

If you build join links programmatically and want them to match, read the interview's language from agentVersion.language on Get Interview and append it:

GET /api/interviews/{id}
→ { "agentVersion": { "language": "ja", ... }, ... }

https://app.insightagent.io/call/{id}/join?lang=ja

Note that agentVersion is returned by the single-interview endpoint only, not by the list endpoint — so building links in bulk means fetching each interview.

Privacy​

Expert data is:

  • Stored securely with encryption
  • Only visible to your account members
  • Never shared with third parties
  • Tied to specific interviews