Avatar Configuration

Overview

The SDK provides runtime configuration properties to position, scale, and theme the avatar to seamlessly integrate with your website's UI layout.

Full Avatar Options Reference

Asiyst.init({
  projectId: "proj_9f8a2b3c4d",
  publicKey: "pk_live_8e7d6c5b4a3f2e1d",
  avatar: {
    enabled: true,
    position: "bottom-right", // 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left'
    offset: { x: 24, y: 32 },  // Distance in pixels from screen edge
    scale: 1.0,               // 0.8 (compact) to 1.4 (large)
    soundEffects: true,       // Audio chimes on greeting
    autoShowDelayMs: 3000,    // Display greeting after 3 seconds
    zIndex: 9999,             // CSS stacking layer
  },
});

Custom CSS Positioning & Offsets

If your website contains a persistent cookie consent banner, adjust the vertical offset so the avatar hovers gracefully above it:

offset: { x: 20, y: 90 }