logo
Uncovia/Documentation

Projects

Targeted Respondents

Uncovia projects can run in two access modes:

  • Public link: anyone with the share URL can start a new conversation
  • Invite-only links: only respondents with a generated link can start or resume a conversation

Targeted respondent links are available on Pro, Business, and Enterprise plans.

Use targeted respondent links when you want to:

  • send a unique link to a specific person
  • attach one or more respondent identities such as email, identifier, user ID, or name
  • keep the link alive until that conversation is finished
  • stop the link from being reused once the conversation is completed

Use Invite-only links when you also want to block starts from the normal public share link.

How It Works#

  1. Open the project's Share page.
  2. Choose the Invite section.
  3. Add one or more respondent identities.
  4. Generate a respondent link manually, or create links programmatically via the API.
  5. Uncovia creates the conversation immediately and stores the identities on it.
  6. Send that link to the intended respondent.
  7. When the respondent opens the link, Uncovia loads that pre-created conversation.
  8. The same link resumes the same conversation until it is completed.
  9. Once the conversation is completed, the link stops working.

Respondent Identities#

Each invited conversation can have multiple identities. Common identity types are:

  • email
  • name
  • identifier
  • uuid
  • user_id
  • account_id

Uncovia also extracts directly identifying respondent details from completed conversations during AI post-processing. Extracted emails are stored as email identities. The legacy respondent_email field may still exist on older conversations, but new AI-extracted emails should be read from identities.

Security Model#

Targeted respondent links are bearer links. Anyone who has the full link can open it.

That means:

  • Uncovia enforces that an invited conversation can only be started through its valid generated link
  • public projects can still receive regular non-invited conversations through the normal share link
  • Uncovia does not verify the respondent’s mailbox or identity in v1
  • if you need stronger identity guarantees, launch the link from your own authenticated product surface

Programmatic Access#

Respondent links can also be generated programmatically with organization API keys when your workspace has access to organization API keys.

See:

PreviousEmail CollectionNextWriting Effective Questions