Realtime Conversation

const ws = new WebSocket(
  // the credential goes in the query string: a WebSocket cannot set headers
  `wss://app.peachdeskai.com/api/voice/ws/converse?api_key=${API_KEY}`,
);

ws.binaryType = "arraybuffer";

ws.onopen = () => {
  // 1. Init frame
  ws.send(JSON.stringify({
    profile_id: "prof_8f2a...",
    engine: "vaani",
    stt_model: "lipi",
    llm_model: "BRAHMA-30B-FP8",
    language: "en",
  }));
};

ws.onmessage = (evt) => {
  if (typeof evt.data === "string") {
    const msg = JSON.parse(evt.data);
    switch (msg.type) {
      case "ready":           console.log("Agent ready:", msg.name); break;
      case "user_transcript": console.log("You:", msg.text); break;
      case "agent_transcript":console.log("Agent:", msg.text); break;
      case "turn_end":        console.log("(turn complete)"); break;
      case "error":           console.error(msg.message); break;
    }
  } else {
    // Binary WAV chunk — queue it for playback
    playWavChunk(evt.data);
  }
};

// 2. Send a recorded utterance as a binary frame
ws.send(recordedUtteranceArrayBuffer);

// Or send typed input
ws.send(JSON.stringify({ type: "text", text: "What's on my schedule today?" }));

{
  "profile_id": "prof_8f2a...",
  "engine": "vaani",
  "stt_model": "lipi",
  "llm_model": "BRAHMA-30B-FP8",
  "language": "en",
  "beam_size": 1
}

curl -X POST "https://app.peachdeskai.com/api/voice/speak" \
  -H "X-API-Key: $PEACHDESK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Your meeting starts in five minutes.",
    "profile": "Front Desk",
    "language": "en"
  }'

{
  "id": "gen_3c91...",
  "profile_id": "prof_8f2a...",
  "text": "Your meeting starts in five minutes.",
  "language": "en",
  "engine": "vaani",
  "status": "generating",
  "audio_path": null,
  "duration": null,
  "is_favorited": false,
  "source": "rest",
  "created_at": "2026-06-23T10:14:05Z"
}

const stream = new EventSource(
  "https://app.peachdeskai.com/api/voice/events/speak"
);

stream.addEventListener("speak-start", (e) => {
  const { profile_name, generation_id } = JSON.parse(e.data);
  console.log(`${profile_name} is speaking (${generation_id})`);
});

stream.addEventListener("speak-end", () => {
  console.log("Done speaking.");
});

curl -N "https://app.peachdeskai.com/api/voice/events/speak" \
  -H "X-API-Key: $PEACHDESK_API_KEY"