Your own UI on the dialer, with DialerSeat.connect
A headless dialer places the calls and leaves the screen to you. DialerSeat.connect({ session, leads }) starts one with no interface: it still holds the phone line, places the calls, detects answering machines, plays the audio and sends every webhook. Your page listens to its state event and draws whatever it likes, and your buttons call its methods: start, stop, hangup, skip and disposition.
Checked 2026-11-15 against the sources linked at the end.
Start it
const dialer = DialerSeat.connect({ session: SESSION_TOKEN, leads })
dialer.on('state', (s) => {
// s.status: idle, calling, connected, ended, preview_ready
// s.lead, s.call, s.queue, s.stats, s.showDisposition, s.dispositions, s.presence
render(s)
})
startButton.onclick = () => dialer.setAvailable().start()
endButton.onclick = () => dialer.hangup()
outcome.onclick = () => dialer.disposition('APPT_SET', notes.value)What your buttons can call
- setAvailable(on), start(), stop(): the same as making the agent available and starting or stopping the dial sequence.
- dial(lead): click to call one lead now.
- hangup(), skip(): end the call, or end it and move on without an outcome.
- disposition(code, notes): save the outcome; the dialer moves on.
- setMode(mode), setCampaign(id), setRedial(1 | 2 | 3), mute(on), hold(on).
- setLeads(leads): replace the list. showCard() and hideCard(): a guidance card for this call.
- getState(): the latest state.
Between headless and the full screen
You don't have to draw everything. The dialer's parts can sit anywhere on your page as HTML tags or with attach(): the queue, a slim call bar for a CRM header, the lead card and script, the wrap-up sheet, today's stats and a manager's team board. Pressing a button in any part is pressing it in the dialer.
Related: components and headless, a click-to-call button in your CRM, ways to put the dialer in and webhook signature checker.
Sources
More: the developer FAQ, the comparisons, Answering machine detection (AMD), explained for developers, Salesforce Open CTI retirement: what it means, Webhook signature verification failed? Find the cause, Do-not-call API: what the national registry offers, Moving from VICIdial's API to an embedded dialer, A click-to-call button in your CRM, A live status board for managers, or the quickstart, free in sandbox mode.