Phone

Tools in the phone scope, callable over space-mcp (tools/call) or space-api (REST) with a wks_live_* key that grants phone.

control_call_campaign

Scope: phone:run

Pause, resume, or cancel a running/scheduled call campaign.

create_call_campaign

Scope: phone:write

Create a DRAFT outbound call campaign: a Cloud Agent dials each contact in an audience. Requires (before it can start) a voice-enabled cloud_agent_id, an audience_id, and an active from_phone_number_id — none are required to draft. call_script_id is optional. Use list_cloud_agents / list_audiences / list_phone_numbers / list_call_scripts to discover ids.

create_call_script

Scope: phone:write

Create a reusable call script a Cloud Agent follows on a voice call. opening_line is what the agent says first; instructions set tone/guardrails; goals are ordered objectives; end_action is what happens when the call wraps up. Supports {{merge_tags}} like {{contact.first_name}} and {{space.name}}. A call script is OPTIONAL for a call — the agent's own persona drives the call; a script layers a specific opening + goals + end action on top.

create_sms_campaign

Scope: phone:write

Create a DRAFT SMS campaign (broadcast or drip). A connected SMS-capable number is NOT required to draft — only to send. Defaults the sender to the space's first eligible number when one exists.

create_sms_template

Scope: phone:write

Create a reusable SMS template. Supports {{merge_tags}} like {{first_name}}.

delete_call_script

Scope: phone:write

Delete a call script. Call campaigns referencing it keep running but lose the script override.

get_call_campaign

Scope: phone:read

Get one call campaign plus a sample of its per-contact dial runs (dispositions, durations).

get_call_recording

Scope: phone:read

Fetch a recorded call's playback URL (freshly signed, 1h) and its transcript when one exists. Pass the call id from list_call_history. Returns recorded:false when the call wasn't recorded.

get_call_script

Scope: phone:read

Get one call script including its opening line, instructions, goals, and end-of-call action.

get_sms_campaign

Scope: phone:read

Get one SMS campaign, including its drip steps if it's a drip.

list_call_campaigns

Scope: phone:read

List outbound call campaigns in the space, optionally filtered by status.

list_call_history

Scope: phone:read

List recent calls in the space.

list_call_scripts

Scope: phone:read

List reusable call scripts (voice scripts a Cloud Agent follows on a call) in the space.

list_phone_numbers

Scope: phone:read

List active phone numbers in the space.

list_sms_campaigns

Scope: phone:read

List SMS campaigns (broadcasts + drip sequences) in the space.

list_sms_templates

Scope: phone:read

List reusable SMS templates in the space.

make_call

Scope: phone:run

Place an outbound phone call handled live by a voice-enabled cloud agent in this space (consequential, billable — voice minutes charge the space wallet). The agent speaks with the callee in real time. Requires to (E.164). cloud_agent_id is optional when exactly one agent in the space owns a phone number. Use purpose to tell the agent why it is calling and what to accomplish.

send_sms

Scope: phone:run

Send an SMS from a space number (consequential, billable). Requires to (E.164) and message.

send_sms_campaign

Scope: phone:run

Consequential + billable: schedule a broadcast SMS send (scheduled_at defaults to now) or start a drip. Requires a sender number, an audience, and message content.

start_call_campaign

Scope: phone:run

Consequential + billable: launch a call campaign. Validates it has a voice-enabled agent, an audience, and an active sender number, then schedules it — the runner enrolls the audience and starts dialing on its next tick.

update_call_campaign

Scope: phone:write

Edit a draft/paused/scheduled call campaign (agent, audience, sender, script, throttling, retry, time window).

update_call_script

Scope: phone:write

Edit a call script. Passing goals REPLACES the full goal list.

update_sms_campaign

Scope: phone:write

Edit a draft/paused/scheduled SMS campaign. Passing steps REPLACES all drip steps.

update_sms_template

Scope: phone:write

Edit an SMS template (name, body, variables).