onTrigger

Hacktionbase.onTrigger(handler)
Hacktionbase.onTrigger(key, handler)

interface TriggerEvent {
  id: string;                       // Trigger document ID
  key: string;                      // Stable trigger key (e.g. "create_project")
  data: Record<string, string>;     // Fields extracted from the user message
  executionEventId: string;         // Unique ID for this execution (dedupe)
  userId: string | null;            // Set only when the session is identified
  anonymousId: string;              // Always present — the session identity
  occurredAt: string;               // ISO timestamp
  context: {
    tenantId: string;
    userId: string | null;          // Same as top-level userId
    anonymousId: string;            // Same as top-level anonymousId
    accountId: string | null;       // Current account (via identify({ account }))
  };
}

const unsubscribe = Hacktionbase.onTrigger('open_billing', (event) => {
  window.location.href = '/billing';
});

// Later, when you no longer need the handler
unsubscribe();

Hacktionbase.onTrigger('create_project', (event) => {
  const { name, plan } = event.data;
  document.querySelector('#project-name').value = name ?? '';
  document.querySelector('#project-plan').value = plan ?? 'starter';
  Hacktionbase.close();
});

Hacktionbase.onTrigger((event) => {
  analytics.track('chat_trigger_fired', {
    key: event.key,
    executionEventId: event.executionEventId
  });
});