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.

Do · Actions · supported

Advanced: run command text

Advanced fallback for power users. Prefer the friendly bot actions above when possible.

action.run_command · 2.8.0

Browse all entries

Requirements and availability

An existing supported command on the selected platform; no TikTok option is offered.

Picker contexts: automation, timer, command, pad.

Behavior

Resolve command text; blank does nothing. Dispatch a registered command first, then full command routing for custom/Marketplace commands. Uses broadcaster automation authority, bypassing public-command enabled/platform checks where supported. This is not a shell or arbitrary script action.

Configure in the app

Open: Do → Advanced Actions (commands only) → Add action

Steps

Choose action category Chat Bot Commands, select Advanced: run command text, and click Add action.
Expand the action card. Configure the Fields below; check Editor defaults for your context and any operation-dependent fields.
Choose resource values from real app pickers. Set output Platform separately from the trigger Where setting when the action offers it.
Use Move action up / Move action down to position this action, then save the containing command, automation, timer or SheevPad button.

Limitations

Arbitrary command text does not have one safe TikTok response contract; use the corresponding friendly action instead.
Picker availability does not supply missing event variables. Check prerequisites and originating provider.
An action return value is not automatically a sequence variable. Only documented producers create template outputs.

Fields

Field Input / options Defaults / limits Availability

Field	Input / options	Defaults / limits	Availability
Command text `command`	text	Editor defaults: {"automation":null,"timer":null,"command":null,"pad":null} Example hint: !quote or !sr {message}	Supports variables
Platform `platform`	select Same platform as event: event Twitch: twitch YouTube: youtube Kick: kick	Editor defaults: {"automation":"event","timer":"all","command":"event","pad":"all"}	Literal value / selected resource

Command text
command

text

Editor defaults: {"automation":null,"timer":null,"command":null,"pad":null}

Example hint: !quote or !sr {message}

Supports variables

Platform
platform

select

Same platform as event: event
Twitch: twitch
YouTube: youtube
Kick: kick

Editor defaults: {"automation":"event","timer":"all","command":"event","pad":"all"}

Literal value / selected resource

Contract details

Declared Contexts: [ "timer", "automation" ]
Picker Contexts: [ "automation", "timer", "command", "pad" ]
Hidden From Picker: false
Required Variables: []
Failure Behavior: See the behavior for local skips/errors and context entries for sequence continuation.
Outputs: []

Examples

Illustrative configuration; replace fixture resources in the editor. This is not an import file.

{
  "command": "!quote",
  "platform": "twitch"
}

Related entries

Source and verification

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

src/features/automations.js — ACTION_REGISTRY.run_command
public/index.html — getBuilderActionEntries / createDefaultAction

Source revision: 472fb34b484eeef0b663d28cacb628a7b9f14ff1