Beta reference. Prepared from development builds for this version. This reference does not describe the current stable release.

A verified stable reference is not available yet. Choose a prepared beta version above.

When · Triggers · supported

Imported app event

Fires when an installed action library event stream receives a matching mapped event. Choose a specific library and event stream for normal use.

trigger.imported_app_event · 2.8.0

Browse all entries

Requirements and availability

Connected supported event provider; enabled automation and matching filters.

Picker contexts: automation.

Incoming providers: app.

Behavior

Optional library/stream IDs compare case-insensitively. A mapped key with no expected value must be nonempty; otherwise compare its string value case-insensitively. Package mappings can add arbitrary event.<key> variables.

Configure in the app

Open: Bot → Automations → + New → When

Steps

Choose Trigger category: Broadcast software & installed apps.
Choose Trigger event: Imported app event.
Fill the Trigger filters below, set Cooldown (seconds), then open Where and choose a supported Platform.
Open Do, add actions, then Create Automation or Save Changes.

Trigger filters

Field	Input / options	Defaults / limits	Availability
Action library `library_id`	action_library_dropdown		Trigger filter
Event stream `subscription_id`	action_library_subscription_dropdown		Trigger filter
Mapped value key (optional) `event_key`	text	Example hint: state, user, scene	Trigger filter
Mapped value equals (optional) `event_value`	text	Example hint: ready	Trigger filter

Contract details

Cooldown: Automation cooldownSec defaults 0; keyed by automation ID and event platform; held in memory until restart.
Delay: No additional trigger delay.

Examples

Trigger selection and filter defaults; supply a real target/pattern when required.

{
  "triggerType": "imported_app_event",
  "triggerPlatform": "app",
  "triggerFilters": {
    "library_id": "",
    "subscription_id": "",
    "event_key": "",
    "event_value": ""
  }
}

Related entries

Source and verification

Source-reviewed for 2.8.0. Connected-service validation remains subject to release UAT.

src/features/automations.js — TRIGGER_REGISTRY.imported_app_event
src/features/automation-provider-capabilities.js — AUTOMATION_TRIGGER_PLATFORMS.imported_app_event

Source revision: 472fb34b484eeef0b663d28cacb628a7b9f14ff1