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

Send chat message (delayed)

Send a message after a delay. Useful for countdowns before ad breaks.

action.chat_delay · 2.8.0

Browse all entries

Requirements and availability

Connected output chat when the scheduled callback runs.

Picker contexts: automation, timer, command, pad.

Behavior

Schedule delivery and immediately continue the sequence. Missing delay_sec is 0 at runtime (editor initializes 30); runtime clamps only the lower bound to 0. Resolve message at delivery with local {delay}. Errors are logged inside the delayed callback.

Configure in the app

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

Steps

Choose action category Chat Bot Commands, select Send chat message (delayed), 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

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
Message `message`	textarea	Editor defaults: {"automation":"","timer":"","command":"","pad":""} Example hint: ⚠️ Ad break in {delay}s!	Supports variables
Delay (seconds) `delay_sec`	number	Declared UI default: `30` Editor defaults: {"automation":30,"timer":30,"command":30,"pad":30} Min: 1 Max: 3600	Literal value / selected resource
Send to `platform`	select Same platform as event: event Twitch + YouTube + Kick: all Twitch only: twitch YouTube only: youtube Kick only: kick TikTok only: tiktok	Editor defaults: {"automation":"event","timer":"all","command":"event","pad":"all"}	Literal value / selected resource

Message
message

textarea

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

Example hint: ⚠️ Ad break in {delay}s!

Supports variables

Delay (seconds)
delay_sec

number

Declared UI default: 30

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

Min: 1

Max: 3600

Literal value / selected resource

Send to
platform

select

Same platform as event: event
Twitch + YouTube + Kick: all
Twitch only: twitch
YouTube only: youtube
Kick only: kick
TikTok only: tiktok

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: [ "variable.action.chat_delay.delay" ]

Examples

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

{
  "message": "The delay was {delay} seconds.",
  "delay_sec": 30,
  "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.chat_delay
public/index.html — getBuilderActionEntries / createDefaultAction

Source revision: 472fb34b484eeef0b663d28cacb628a7b9f14ff1