ClearTone for Developers

The Local Connection

A simple web connection at http://127.0.0.1:47820/cleartone on each computer running ClearTone. It speaks JSON and works from any web app, so there is nothing to install alongside it.

A Short Example

// Is ClearTone running on this computer?
const base = "http://127.0.0.1:47820/cleartone";
const status = await fetch(base + "/status").then(r => r.json());
if (status.running) console.log("ClearTone is on. Mic cleaning:", status.mic_on);

// Follow the live transcript
let last = 0;
setInterval(async () => {
  const t = await fetch(base + "/transcript?since=" + last).then(r => r.json());
  if (!t.on) return;
  t.segments.forEach(s => console.log(s.side, s.text));   // "me" or "them"
  last = t.last;
}, 500);

// Tell ClearTone who the call is with
await fetch(base + "/context", { method: "POST", headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ name: "Sarah Lee", company: "Acme Dental",
                         records: { hubspot: { module: "contacts", id: "1234" } } }) });