Skip to main content

General & Authentication

The General and Authentication tabs contain the core assistant configuration and integration settings.

General Tab

Edit Assistant

Basic Settings

FieldDescription
Assistant NameDisplay name (max 30 characters)
Greeting MessageWelcome message shown to users
AvatarUpload an avatar image for the assistant
DomainThe domain this assistant serves
Sidebar BrandingCustom branding text (max 100 characters)

User Resolution

FieldDescription
Default RoleFallback role when user resolution fails
User Resolver Webhook URLWebhook endpoint for identifying users
User Resolver Timeout (ms)Maximum wait time (1000–30000 ms)

See User Resolution for implementation details.

API Key

The General tab also provides an API key for this assistant:

  • Generate or regenerate the API key
  • Copy the key to clipboard
  • The key is used for embedding the assistant in your application

Integration Guide

A read-only section showing how to embed the assistant:

  1. Add the script tag to your HTML
  2. Add the web component
  3. Optional configuration parameters

Authentication Tab

User Identity Resolver (BYOA)

SettingDescription
User Resolver Webhook URLEndpoint that resolves user identity
Timeout (ms)Maximum wait time (1000–30000 ms)

How it works:

  1. User opens the assistant widget
  2. Diosc sends user credentials to your webhook
  3. Your webhook returns user identity (name, email, roles)
  4. Diosc uses this to personalize the session

CORS Configuration

SettingDescription
Allowed OriginsList of origins permitted to embed the assistant
Allowed HeadersHeaders forwarded from the client (add common headers with one click)