TR Try tools
← Whole catalogue

PBX Search

Part of the catalogue. The same key, envelope and billing cover every other endpoint too.

PBX Audio Chunk · PBX Domain Dictionary · PBX Events · PBX Ingest Transcript · PBX Night Twin Last Report · PBX Night Twin Run · PBX Open Promises · PBX Promises Export · PBX Redact · PBX Register · PBX Search · PBX Synthetic Caller Run · PBX Live Whisper Suggest

  • No account needed to try any endpoint on this page.
  • Deterministic endpoints answer from cache in single-digit milliseconds.
  • Every response carries a receipt: credits charged, cache status, duration.

Free try on this page → when you need a key, Proceed to pay · API access.

POST/v1/pbx/audio/chunk
Request
{
  "call_id": "call_msp_001",
  "pbx_id": "pbx_otel_msp_demo",
  "uri": "https://customer.example/rec/call_msp_001.wav",
  "t_ms": 12000
}
no request sent yet
Response
Press Run to try free — no key needed.
13endpoints
data points banked
time series
median response

Why this exists

Built for hostile input

A Turkish address arrives as "Cd." or "Cad." or "Caddesi", with the flat number glued to the building number. Generic parsers drop half of it silently. This one tells you what it could not place.

Every number carries its provenance

Each archived point stores the source URL and a content hash of the page it came from, and the archive is committed to a Merkle root anchored in Bitcoin. Every commitment — with its cutoff, leaf count and anchors — is published at /proof, so you can check for yourself how current the latest one is. The bulletins themselves are public and anyone can read them; what this adds is that a number you quote can be shown to be the number we held on that date, and that it has not been edited since.

You only pay for work

Repeated inputs come from cache and cost zero credits. If a response ever fails its own schema, the call is refunded automatically.

Endpointsexpand any row to see the parameters and call it live

PBX Search13

/v1/pbx/audio/chunk PBX Audio Chunk 1 credit

Notify an optional audio chunk / customer URI for a live or archived call (idle $0).

Prefer customer storage URI. Temsor keeps a pointer; STT only while a call is active.

Parameters

call_id* string
pbx_id string
uri string Customer-side media URI (preferred).
bytes_b64 string Optional small demo chunk; production prefers URI.
t_ms integer
POST/v1/pbx/audio/chunk
Request
{
  "call_id": "call_msp_001",
  "pbx_id": "pbx_otel_msp_demo",
  "uri": "https://customer.example/rec/call_msp_001.wav",
  "t_ms": 12000
}
no request sent yet
Response
Press Run to try free — no key needed.
/v1/pbx/dictionary PBX Domain Dictionary deterministic 1 credit

Domain dictionary v0 (hotel: room type, AC, check-out; MSP: tariff, IMEI, refund) — boosts search + Fact extract.

GET /v1/pbx/dictionary?domain=otel|msp|all. Idle $0, no LLM. Synonyms feed archive search and transcript Fact extraction.

Parameters

domain "otel" | "msp" | "all" Domain slice: otel | msp | all default "all"
POST/v1/pbx/dictionary
Request
{
  "domain": "otel"
}
no request sent yet
Response
Press Run to try free — no key needed.
/v1/pbx/events PBX Events 1 credit

Ingest a signed ARI / Stasis event batch into the demo index (idle when no calls).

Demo stub stores events in memory/file. BridgeEnter → transfer crumbs. Utterance/text → open Promise docs via heuristic (no LLM).

Parameters

pbx_id string PBX id that emitted the ARI batch.
events* object[] ARI / Stasis event batch. Utterance/text fields trigger heuristic promise extract.
POST/v1/pbx/events
Request
{
  "pbx_id": "pbx_otel_msp_demo",
  "events": [
    {
      "type": "StasisStart",
      "channel": "PJSIP/101-0001",
      "application": "temsor"
    }
  ]
}
no request sent yet
Response
Press Run to try free — no key needed.
/v1/pbx/ingest/transcript PBX Ingest Transcript 1 credit

Heuristic TR promise extractor from transcript text — creates open Promise docs (idle $0, no LLM).

Detects promise-like sentences (söz, vaat, edeceğiz, iade, iptal, yarın…). Optional persist_promises=false for live POC extract without writing. Also wired via utterance text on POST /v1/pbx/events.

Parameters

transcript* string TR utterance / transcript text to scan for promises.
call_id string
pbx_id string
who string
ext string
persist_promises boolean When false, extract only (POC dry-run). When true, create Promise docs status=open. default true
POST/v1/pbx/ingest/transcript
Request
{
  "transcript": "Temsilci Ayşe: Oda 412 kliması yarın 10:00'da onarılacak, söz veriyorum.",
  "persist_promises": true
}
no request sent yet
Response
Press Run to try free — no key needed.
/v1/pbx/night-twin/last PBX Night Twin Last Report 1 credit

GET last gece-ikizi report persisted on forge volume (null if never run). Idle $0.

GET /v1/pbx/night-twin/last — last report from POST /v1/pbx/night-twin/run. No LLM/Telnyx.

Parameters

POST/v1/pbx/night-twin/last
Request
{}
no request sent yet
Response
Press Run to try free — no key needed.
/v1/pbx/night-twin/run PBX Night Twin Run 1 credit

Evre-2 stub: scan open promises older than N hours → broken_candidate list (iptal/iade/söz). Idle $0, no LLM.

POST /v1/pbx/night-twin/run {pbx_id?, older_than_hours?}. Heuristic night twin — still-open promises older than N hours whose text matches iptal/iade/söz. Persists last report on forge volume. No Telnyx/LLM.

Parameters

pbx_id string Optional PBX scope; falls back to x-temsor-pbx-key scope.
older_than_hours number Scan open promises whose call is older than this many hours. default 24
POST/v1/pbx/night-twin/run
Request
{
  "older_than_hours": 24
}
no request sent yet
Response
Press Run to try free — no key needed.
/v1/pbx/promises PBX Open Promises 1 credit

List broken/open promises from the call graph — the hotel/MSP sales demo list.

GET /v1/pbx/promises?status=open returns open/unclosed promises. Scoped by x-temsor-pbx-key when set.

Parameters

status "open" | "kept" | "broken" | "unknown" | "all" Promise status filter; sales demo uses open. default "open"
POST/v1/pbx/promises
Request
{
  "status": "open"
}
no request sent yet
Response
Press Run to try free — no key needed.
/v1/pbx/promises/export PBX Promises Export 1 credit

Export open/broken promises as CSV or JSON — hotel/MSP unclosed-promise sales list.

GET /v1/pbx/promises/export?status=open&format=csv|json. Scoped by x-temsor-pbx-key when set. Idle $0.

Parameters

status "open" | "kept" | "broken" | "unknown" | "all" Promise status filter; sales demo uses open (unclosed promises). default "open"
format "csv" | "json" Export format. default "csv"
POST/v1/pbx/promises/export
Request
{
  "status": "open",
  "format": "csv"
}
no request sent yet
Response
Press Run to try free — no key needed.
/v1/pbx/redact PBX Redact 1 credit

KVKK forget: anonymize/delete Person phones + Promise text by id or phone; always audits a Redaction doc (audio may stay on customer disk).

Hardened redaction. mode=anonymize|delete. Lookup by target_id or phone. Media files remain customer-side when URI-only.

Parameters

target_type "promise" | "call" | "person" | "fact" | "utterance" Index document type. Optional when `phone` is set.
target_id string Document id (prm_*, per_*, call_*, fact_*).
phone string Caller phone — finds Person phones (+ linked Promise text).
reason string KVKK / forget reason.
mode "anonymize" | "delete" anonymize (default) scrubs fields; delete removes docs.
POST/v1/pbx/redact
Request
{
  "target_type": "promise",
  "target_id": "prm_001",
  "reason": "KVKK talep",
  "mode": "anonymize"
}
no request sent yet
Response
Press Run to try free — no key needed.
/v1/pbx/register PBX Register 1 credit

Register a pilot PBX; returns pbx_id + API key once (hashed at rest). Idle $0.

Control-plane register. API key shown once; stored as sha256 under FORGE_DATA_DIR (/data). Send x-temsor-pbx-key to scope GET /v1/pbx/promises to this pbx_id. No STT while idle.

Parameters

pbx_id string Pilot PBX id; auto-minted if omitted.
label string Human label, e.g. hotel or MSP site.
ari_webhook_secret string ARI webhook signing secret (stored as hint only).
name string Pilot contact name (waitlist / register stub).
email string Pilot contact email.
POST/v1/pbx/register
Request
{
  "pbx_id": "pbx_otel_msp_demo",
  "label": "Demo Otel + MSP"
}
no request sent yet
Response
Press Run to try free — no key needed.
/v1/pbx/synthetic/run PBX Synthetic Caller Run 1 credit

Evre-3 stub: fake call utterances → ingest extractor → stats (calls, promises_open). Idle $0, no LLM/PSTN.

POST /v1/pbx/synthetic/run {scenario:ivr_menu|promise_heavy, count:10..500}. Generates deterministic fake utterances, runs heuristic ingest/transcript extract, returns calls + promises_open. No Telnyx/DID/LLM.

Parameters

scenario "ivr_menu" | "promise_heavy" ivr_menu = DTMF/menu stress; promise_heavy = dense commitment lexicon. default "promise_heavy"
count integer Fake call count, capped 10..500. default 50
pbx_id string Optional PBX scope; falls back to x-temsor-pbx-key or demo PBX.
POST/v1/pbx/synthetic/run
Request
{
  "scenario": "promise_heavy",
  "count": 50
}
no request sent yet
Response
Press Run to try free — no key needed.
/v1/pbx/whisper/suggest PBX Live Whisper Suggest 1 credit

Stub: ≤3 context cards (open promises / facts) for agent UI in mock <400ms — no live STT/LLM.

POST /v1/pbx/whisper/suggest {call_id, partial_text}. Returns open promises and facts as whisper cards. Mock latency always under 400ms. No Telnyx/DID, no live provider — CTA API only.

Parameters

call_id* string Active call id for agent UI context.
partial_text string Partial transcript / utterance stub (no live STT). default ""
POST/v1/pbx/whisper/suggest
Request
{
  "call_id": "call_msp_001",
  "partial_text": "klima yarın"
}
no request sent yet
Response
Press Run to try free — no key needed.

Pricingone key covers every endpoint

Free try on this page → when you need a key, Proceed to pay · API access.

Credits are consumed per call and cache hits are free. Requests without a key run on a narrow per-IP demo quota so you can evaluate before signing up.

The API key is e-mailed the moment payment clears. Upgrades keep the same key, so your integration is never broken.

Want to finish the integration before paying?

Use it from an AI assistantthe same catalogue, exposed as MCP tools

Every endpoint is also published over the Model Context Protocol, so Claude, ChatGPT or your own agent can call it directly — no glue code, no wrapper functions. The assistant sees the same input schemas and the same metering.

Currently 50 tools. New endpoints appear automatically; nothing to update on your side.

claude_desktop_config.json

{
  "mcpServers": {
    "temsor": {
      "url": "https://api.temsor.com/mcp",
      "headers": { "x-api-key": "fk_live_…" }
    }
  }
}

Quickstart

Official client: npm install temsor-api · npmjs.com/package/temsor-api

Node.js

import Client from "temsor-api";

const api = new Client({ apiKey: KEY });
const r = await api.${(() => {
  const first = apis[0];
  return first.slug.split(/[/-]/).map((p, i) => (i === 0 ? p : p[0].toUpperCase() + p.slice(1))).join('');
})()}(${esc(JSON.stringify(apis[0].examples[0]?.input ?? {}))});
console.log(r, r.$meta);

cURL

curl -s https://api.temsor.com/v1/pbx/audio/chunk \
  -H "content-type: application/json" \
  -H "x-api-key: fk_live_…" \
  -d '{"call_id":"call_msp_001","pbx_id":"pbx_otel_msp_demo","uri":"https://customer.example/rec/call_msp_001.wav","t_ms":12000}'

JavaScript

const res = await fetch("https://api.temsor.com/v1/pbx/audio/chunk", {
  method: "POST",
  headers: { "content-type": "application/json", "x-api-key": KEY },
  body: JSON.stringify({"call_id":"call_msp_001","pbx_id":"pbx_otel_msp_demo","uri":"https://customer.example/rec/call_msp_001.wav","t_ms":12000})
});
const { data } = await res.json();

Python

import httpx
r = httpx.post("https://api.temsor.com/v1/pbx/audio/chunk",
    headers={"x-api-key": KEY},
    json={"call_id":"call_msp_001","pbx_id":"pbx_otel_msp_demo","uri":"https://customer.example/rec/call_msp_001.wav","t_ms":12000})
data = r.json()["data"]
temsor API

Small, precise APIs behind one key and one response envelope. New endpoints ship on the same key.

References OpenAPI 3.1MCP manifestService health
Response contract

{ ok, data, meta }

{ ok:false, error }

Tell us what broke

Wrong answer, missing field, an endpoint you wish existed — it reaches a person, not a queue.