When · Triggers · supported
TikTok gift
Fires once when a TikTok gift or gift streak is finalized.
trigger.tiktok_gift · 2.8.0
Requirements and availability
Connected supported event provider; enabled automation and matching filters.
Picker contexts: automation.
Incoming providers: tiktok.
Behavior
Finalized gift/streak only; optional gift name is exact case-insensitive. Count and diamond thresholds both apply.
Configure in the app
Open: Bot → Automations → + New → When
Steps
- Choose Trigger category: Monetization.
- Choose Trigger event: TikTok gift.
- 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 |
|---|---|---|---|
Gift name (blank = any)gift_name | text | Trigger filter | |
Minimum count (0 = any)min_count | number | Declared UI default: Min: 0 | Trigger filter |
Minimum diamonds (0 = any)min_diamonds | number | Declared UI default: Min: 0 | 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": "tiktok_gift",
"triggerPlatform": "tiktok",
"triggerFilters": {
"gift_name": "",
"min_count": 0,
"min_diamonds": 0
}
}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.tiktok_gift
- src/features/automation-provider-capabilities.js — AUTOMATION_TRIGGER_PLATFORMS.tiktok_gift
Source revision: 472fb34b484eeef0b663d28cacb628a7b9f14ff1