SK Voice · Developers

She answers the phone.
You read the events.

SK Voice's integration surface is deliberately small: point your number at her, subscribe to call events, and read what she writes into the suite — contacts, bookings, tickets — over the same APIs every product shares.

Fig 01 · the integration surface
your number telephony provider SK Voice answer · understand · act sk crm · call sessions sk calendar · bookings sk tickets · escalations your webhooks call events, signed one MCP backbone underneath · scoped keys · everything audited
⚠ Pre-launch note. Endpoint shapes and event names below follow the platform conventions and the designed contract; they're being reconciled against the implemented API before docs go live. Treat this page as the shape of the integration, and docs.softknack.com/voice as the source of truth at launch.
Quickstart

Subscribe to her calls in one request.

Register a webhook, take a test call, watch the events arrive — signed, idempotent, retried on failure like every webhook on the platform.

curl -X POST https://api.softknack.com/voice/v1/webhooks \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://yourapp.com/hooks/sk-voice",
    "events": ["call.completed", "call.escalated"]
  }'
Events

Six events tell the whole story.

call.started

A real caller connected (robocalls never fire events). Includes caller match if the contact is known.

call.completed

The full record: duration, language, sentiment, outcome tag, recording and transcript links, and IDs of everything created.

call.escalated

Handed to a human — includes the trigger (sentiment, rule, explicit request) and the live transcript so far.

call.message_taken

Nobody was available; a structured message was captured and a ticket opened. Ticket ID included.

appointment.booked

A booking made mid-call — same payload shape as SK Calendar's own event, because it is SK Calendar's event.

knowledge.updated

The owner changed SK Voice's knowledge (by voice or dashboard). Versioned; useful for compliance trails.

Platform guarantees

Same rails as every Softknack product.

Signed webhooks HMAC-SHA256

Every delivery signed; verify with the shared helper. At-least-once delivery with the platform retry schedule and dead-letter replay.

Idempotency Idempotency-Key

Dedupe on event id. Replays of the same key return the original result — safe consumers by default.

One contact ID everywhere ctc_*

The caller SK Voice heard is the same contact your chat widget, tickets and invoices reference. Prefixed ULIDs across the suite.

MCP tools mcp.softknack.com

Call summaries, outcomes and knowledge are exposed as scoped MCP tools — your own agents can read what SK Voice did and act on it.

Full reference at launch

Auth, pagination, errors and the complete event schemas live in the docs hub — written once for the whole platform.

docs.softknack.com/voice →

Point a number at her. Read the events.

The 50-call demo works for integration testing too — test keys, real events.

Start the free demo