​

Sprachhinweis

​

Browser-Softphone (WebRTC) einrichten

1. Das eingebaute Dashboard-Softphone — Orbit liefert ein fertiges Softphone im Dashboard. Das ist der Zero-Code-Weg und der richtige Startpunkt für die meisten Teams.
2. Ein eingebettetes LiveKit-basiertes Softphone (Softphone in @devotel-orbit/web) — Sie mounten das Softphone mit eigener UI in Ihrem eigenen Agenten-Arbeitsplatz (CRM, Contact-Centre-Wall, internes Tool).
3. Ein eingebettetes SIP-over-WSS-Softphone (der SIP-Register-Weg) — ein klassischer SIP-Client (z. B. JsSIP), der sich direkt gegen Orbits WebRTC-zu-SIP-Gateway registriert.

​

2. Softphone-Zugangsdaten ausstellen

​

Eingebautes Dashboard- / eingebettetes LiveKit-Softphone

curl -X POST https://api.orbit.devotel.io/api/v1/voice/softphone/token \
  -H "Authorization: Bearer YOUR_API_KEY"

​

Eingebettetes SIP/WSS-Softphone

curl -X POST https://api.orbit.devotel.io/api/v1/voice/softphone/register \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "callerIdNumber": "+15559876", "deviceLabel": "agent-desk-04" }'

• Credentials leben 60 Minuten — registrieren Sie vor expiresAt neu, sonst bricht die Session ab.
• callerIdNumber muss eine Nummer sein, die Ihre Organisation besitzt (anderenfalls 403) — so wird CLI-Spoofing beim ausgehenden Anruf blockiert.
• Der Username ist an Ihre Organisation gebunden, ein gestohlener Username kann nicht gegen einen anderen Tenant wiederverwendet werden.
• Die Token-Ausstellung ist auf owner/admin/developer begrenzt — kein öffentlicher, anonymer Endpoint.

​

4. Vollständiges JS-Beispiel — Mikrofon, VoIP-Push + Browser-Fallback

import { OrbitSoftphone } from "@devotel-orbit/web";

const softphone = new OrbitSoftphone({
  apiBaseUrl: "https://api.orbit.devotel.io",
  apiKey: "YOUR_API_KEY", // serve from your backend — never commit it
  onCallStateChange: (s) => console.log("softphone state:", s),
  onError: (e) => handleSoftphoneFailure(e), // ← fallback lives here
});

// 1. Mic is gated on the browser's getUserMedia. Ask for it on a user
//    gesture (a click) — not page load.
async function armMicrophone() {
  await navigator.mediaDevices.getUserMedia({ audio: true });
  await softphone.connect(); // mints token + publishes mic
}

// 2. Place an outbound call.
async function callCustomer(e164) {
  return softphone.dial(e164); // returns call_id when ringing
}

// 3. Fallback: if the browser/media path can't connect, hand the call
//    to a click-to-call bridge.
function handleSoftphoneFailure(err) {
  console.warn("WebRTC unavailable, falling back:", err.message);
  // show "call me on my device" UI → POST /voice/click-to-call instead
}

​

5. Verifikation & Fehlerbehebung

1. Credential ausstellen (Abschnitt 2), Client verbinden (Abschnitt 4) und auf das connect- bzw. SIP-registered-Ereignis achten.
2. Einen ausgehenden Anruf auf das eigene Mobiltelefon tätigen — Sie sollten Klingeln und dann Zwei-Wege-Audio hören.
3. Einen eingehenden Anruf auf Ihre Nummer routen lassen und bestätigen, dass das Softphone klingelt und annimmt.

​

Nächste Schritte

• SDK demo test-call page — einen echten ausgehenden Testanruf aus dem Dashboard tätigen (Developer → SDK Live Demo).
• SIP trunk setup — wenn Sie eigene Carrier/Trunks neben dem Browser-Softphone mitbringen wollen.
• Voice queues — die ACD-Queues, durch die eingehende Anrufe laufen, bevor ein Softphone antwortet.
• Web SDK — vollständige Event-Map für Softphone und die anderen SDK-Flächen.