Events

Detailed catalog of telemetry event payloads, tracking schemas, client emitters, and webhook triggers.

Overview

Every user interaction, conversational turn, guidance milestone, and system state change emits a structured telemetry event. These events power your dashboard charts and can be ingested into your internal data warehouse.

Standard Analytics Events Catalog

Event Name	Category	Trigger Condition
`avatar.impression`	Engagement	Avatar enters viewport for >= 1s
`avatar.clicked`	Engagement	User clicks the avatar model
`conversation.started`	Dialogue	New chat session initialized
`message.sent`	Dialogue	User submits a prompt
`message.received`	Dialogue	Assistant completes response
`guidance.started`	Guided Tour	User starts an interactive guide
`guidance.step_completed`	Guided Tour	User finishes an individual step
`guidance.completed`	Guided Tour	User finishes all steps in tour
`feedback.submitted`	Quality	User rates a message (up/down)

Event Payload Schema Example:

{ "eventId": "evt_01h8x9a2b", "eventType": "guidance.step_completed", "projectId": "proj_9f8a2b3c4d", "sessionId": "sess_88a91b2c", "visitorId": "vis_992140", "timestamp": "2026-09-28T03:45:12.102Z", "properties": { "flowId": "tour_checkout_setup", "stepIndex": 2, "stepTitle": "Enter API Secret Key", "durationMs": 4200 }

}

Custom Business Event Tracking

Log application-specific conversion milestones with Asiyst.track():

import { Asiyst } from "@asiyst/sdk";
// Track when a visitor upgrades their plan during an assistant interaction
Asiyst.track("subscription_upgraded", {
  previousPlan: "Free Starter",
  newPlan: "Pro Enterprise",
  annualValue: 1188.00,
  assistedByAvatar: true,
});

Exporting Raw Events

Download unaggregated raw JSON event logs for internal ETL pipelines:

curl "https://asiyst.com/api/v1/projects/proj_9f8a2b3c4d/analytics/events?limit=500" \

-H "Authorization: Bearer $ASIYST_API_TOKEN"