uWebChat Documentation
SuiteChatVoice
ENNL

The Settings page is divided into tabs (depending on your permissions):

  • AI Settings — keys and endpoints for AI features (requires UWEBCHATVOICE.SETTINGS.VIEW/EDIT)
  • Security — portal users and roles (requires UWEBCHATVOICE.SECURITY.VIEW/EDIT)

11.1 AI Settings

Azure AI Speech (transcription)

For automatic transcription of recordings (§7.3) you need an Azure Speech resource.

  1. In Azure, create a Cognitive Services Speech resource
  2. Copy the key and region
  3. Open Settings → AI Settings → Transcription / Speech
  4. Paste key and region; click Save

The portal stores the key securely. You can remove it with Delete in the same tab.

Azure AI Foundry (summaries)

For AI summaries (§7.4) you need an Azure AI Foundry deployment (e.g. GPT-4o).

  1. In Azure AI Foundry configure a chat-completion deployment
  2. Open Settings → AI Settings → AI Summary
  3. Enter endpoint URL and key
  4. Click Save

ElevenLabs (Voice Prompt Generator)

For TTS generation (§6.3):

  1. Create an ElevenLabs account, generate an API key
  2. Open Settings → AI Settings → ElevenLabs
  3. Paste key, click Save

Voices can be loaded without the key (public API), but generation requires the key.

11.2 Security tab

Managing portal users

Tenant admins see all contacts of their organisation here from the central customer system. Per user you manage which portal roles they have.

  1. Open Settings → Security tab
  2. Find a user (search field with debounce)
  3. Tick the desired roles on/off
  4. Changes are synced immediately with the central customer system

Available roles

The portal only shows roles that are specifically created for the Voice Portal:

  • Universal - uWebChat Voice - Admin (full rights)
  • Universal - uWebChat Voice - Supervisor
  • Universal - uWebChat Voice - Agent
  • Custom roles starting with Universal - uWebChat Voice

Multi-tenant isolation

A tenant admin sees only contacts of their own tenant. The link is made via sipcustomer → account → contacts. Cross-tenant modification is technically impossible.

Audit

Every role assignment or removal is recorded in the Audit Log (§8.3).

Pitfalls

  • "Speech key invalid" — wrong region chosen. Check the Azure Portal for the correct pair.
  • Summary doesn't work but transcription does — AI Summary endpoint must be configured separately.
  • User gets a role but can't do anything — the role is assigned, but logout/login is required to activate the new permissions.