Events

Event telemetry pipeline, client triggers, webhooks, and conversion tracking.

Overview

The Asiyst event pipeline records user interactions, assistant guidance outcomes, and operational lifecycle milestones. Events power your real-time analytics dashboard and trigger external webhooks.

Event Types

System Events: session.started, assistant.mounted, avatar.loaded.

Interaction Events: widget.opened, message.sent, suggestion.clicked.

Guidance Events: element.highlighted, route.navigated, conversion.completed.

Tracking Custom Events

Send application-specific conversion events from the SDK:

import { Asiyst } from "@asiyst/sdk";
// Record a checkout or signup conversion assisted by the avatar
Asiyst.track("purchase_completed", {
  orderId: "ord_9921",
  amount: 149.00,
  currency: "USD",
});

Webhook Delivery

Subscribe to project events in the Asiyst Webhooks console (/dashboard/api/webhooks). When an event occurs, Asiyst dispatches an HTTP POST with an HMAC SHA-256 signature header (X-Asiyst-Signature).

See Webhook Security and Event Reference.