Skip to content

Audience Access

Audience Access is where you decide who can reach the live experience and how open the rollout should be.

User management view with access mode, add-user actions, and user list

Access modes

The core decision is the access mode:

  • Open: anyone who reaches the experience can enter, and the workspace records them
  • Whitelist: only users you allow can access

For early stakeholder pilots, Whitelist is usually the safer choice.

What operators do here

From this page, operators can:

  • switch the access mode
  • add users one by one
  • import users by CSV when the audience is larger
  • review who has joined and whether they are active
  • open a user detail page and manage that user's per-agent interaction mode

Choose the right channel

When you add a user manually or import a CSV, choose the channel that issued those External User ID values. Codeer uses the channel to normalize and store the identity correctly.

  • Web, Widget, Browser Extension, and Slack identities use generic normalization.
  • LINE, Messenger, and Instagram identities keep their original letter casing.

Use Widget for embedded web widgets. Use Web for the web client; they are both web-based, but Codeer stores them as separate channel types.

If the workspace has only one channel type configured, Codeer can preselect it. If the workspace has multiple channel types, choose the channel explicitly before adding or importing users.

CSV import format

Use CSV import when you need to add many allowed users at once.

The CSV must include these required columns:

  • External User ID: the stable user identifier from your system
  • Name: the user's display name

These columns are optional:

  • Email
  • Phone
  • Company
  • Job Title
  • Note

Use this header format:

External User ID,Email,Name,Phone,Company,Job Title,Note

Example row:

host-user-123,john@example.com,John Doe,0912345678,ABC Inc,Manager,Early pilot user

External User ID is the canonical identity for the client user. It must be present, must not be duplicated in the CSV after channel-specific normalization, and must not already exist in the workspace. Email is optional profile data and is validated only when provided.

Agent routing and human handoff

When a user has interacted with one or more agents, the user detail page shows an agent routing table.

Use it to see:

  • which agents the user has talked to
  • whether each agent is currently in AI or Human mode for this user
  • whether human mode came from an agent handoff, a manual CRM change, or an automatic timeout
  • when human mode expires, if a timeout is set

Operators with edit permission can switch a published, handoff-enabled agent from AI to Human, or switch an active human interaction back to AI.

For setup details, see Human Handoff.

External-user usage limits

Audience Access also includes advanced settings for live external users:

  • Contact email: the email shown in billing or usage-limit messages when users need help.
  • Monthly end-user credit cap: an optional per-external-user monthly workspace credit limit.
  • Credit cap message: an optional localized message shown when a user reaches the cap. Empty locales use the default message shown in the form preview.

Use these settings for controlled pilots or cost-sensitive public channels. Leave the cap empty when you do not want a per-user monthly limit.

A practical rollout rule

Use the narrowest access model that matches the current phase:

  • early pilot: Whitelist
  • broader testing: still controlled, but with a larger allowed list
  • open launch: Open, if that is the product decision

If you want a tightly controlled web pilot, keep this aligned with your channel settings as well.

What to review regularly

Even in a healthy rollout, check this page often enough to answer:

  • who has entered recently
  • whether the allowed audience still matches the rollout plan
  • whether old pilot users should be removed or blocked