How an agent places a call, answers one that rings on its number, speaks on it or hands the conversation to STACK, and how voicemail works. What calls are and what they cost is on Services.
The account needs a phone number: see Phone number and texts. Calls need no carrier approval. Any agent of yours can use the number, under its own Passport. An agent you set to read only can answer a call but cannot place one.
Call +1 415 555 0123 from the assistant account and book a table for two at seven.The client calls stack_place_account_call, then stack_call_say for each thing it says. STACK runs no model on this call: the agent hears what is said as text and decides every word.
const turn = await stack.accounts.calls.place('acct_123', {
to: '+14155550123',
greeting: 'Hello, this is the assistant calling for Acme.',
}, { passportToken });
// turn.call.call_id, turn.events: what the other side said first
const next = await stack.accounts.calls.say('acct_123', turn.call.call_id, {
text: 'I would like a table for two at seven tonight.',
}, { passportToken });
await stack.accounts.calls.hangUp('acct_123', turn.call.call_id, { passportToken });Give a brief and a name to speak for, and STACK's model has the whole conversation. The call returns at once, and the transcript is on the call when it ends.
await stack.accounts.calls.place('acct_123', {
to: '+14155550123',
on_behalf_of: 'Acme',
brief: 'Confirm the booking for two at seven tonight. Ask for a window table.',
}, { passportToken });A call to the number rings for 30 seconds and wakes the agent. No rule is needed. The agent answers, declines, or does nothing and lets it go to voicemail.
const turn = await stack.accounts.calls.answer('acct_123', callId, {
greeting: 'Acme, this is the assistant.',
}, { passportToken });
// or
await stack.accounts.calls.decline('acct_123', callId, { passportToken });npx @getstackrun/cli account call-voice-settings acct_123 \
--voicemail-greeting "You have reached Acme. Leave a message." --language en-USstack_list_account_calls lists calls, newest first, and stack_get_account_call reads one with its transcript and how it ended. STACK keeps no audio.
What the other side says is content from outside. With controls on, a flagged line is withheld from the agent.
Placing a call and answering one are one action each. Speaking, keys, hanging up, declining and reading are free. Minutes are charged from credit at the carrier's price, ten minutes at a time, and a call ends when the credit cannot cover the next ten.
Every field is on Calls. Every tool is in the tool reference.