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 · gated

Set Bot Voice

Activate a saved voice or create a custom one from action text and command variables. Response Rules still apply.

action.ai_personality_set · 2.8.0

Browse all entries

Requirements and availability

A.I. account access; saved voice or voice-generation service.

Picker contexts: automation, timer, command, pad.

Behavior

Saved mode activates profileId. Custom mode generates and activates a voice from customGuidance; empty guidance fails. The Bot Voice editor is synchronized.

Configure in the app

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

Steps

Choose action category A.I., select Set Bot Voice, 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
Voice source `mode`	select Saved voice: saved Custom voice instructions: custom	Declared UI default: `saved` Editor defaults: {"automation":"saved","timer":"saved","command":"saved","pad":"saved"}	Literal value / selected resource
Saved voice `profileId`	ai_personality_select	Editor defaults: {"automation":"","timer":"","command":"","pad":""}	Literal value / selected resource Shown when: {"mode":["","saved"]}
Custom voice instructions `customGuidance`	textarea	Editor defaults: {"automation":"","timer":"","command":"","pad":""} Maxlength: 500 Example hint: Describe how the bot should sound, or use variables such as {message}.	Supports variables Shown when: {"mode":"custom"}

Voice source
mode

select

Saved voice: saved
Custom voice instructions: custom

Declared UI default: saved

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

Literal value / selected resource

Saved voice
profileId

ai_personality_select

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

Literal value / selected resource

Shown when: {"mode":["","saved"]}

Custom voice instructions
customGuidance

textarea

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

Maxlength: 500

Example hint: Describe how the bot should sound, or use variables such as {message}.

Supports variables

Shown when: {"mode":"custom"}

Contract details

Declared Contexts: [ "timer", "automation", "command", "pad" ]
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.

{
  "mode": "saved",
  "profileId": "fixture-voice"
}

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.ai_personality_set
public/index.html — getBuilderActionEntries / createDefaultAction

Source revision: 472fb34b484eeef0b663d28cacb628a7b9f14ff1