​

Note de langue

​

Configurer le softphone navigateur (WebRTC)

1. Le softphone intégré au dashboard — Orbit livre un softphone prêt à l’emploi dans le dashboard. C’est le chemin sans code et le bon point de départ pour la plupart des équipes.
2. Un softphone embarqué basé sur LiveKit (Softphone dans @devotel-orbit/web) — vous montez le softphone dans votre propre espace agent (CRM, mur de centre de contact, outil interne) avec votre propre UI.
3. Un softphone SIP-over-WSS embarqué (le chemin d’enregistrement SIP) — un client SIP classique (par ex. JsSIP) qui s’enregistre directement auprès de la passerelle WebRTC-vers-SIP d’Orbit.

​

2. Émettre les identifiants du softphone

​

Softphone dashboard intégré / LiveKit embarqué

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

​

Softphone SIP/WSS embarqué

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" }'

• Les identifiants vivent 60 minutes — ré-enregistrez avant expiresAt sinon la session tombe.
• callerIdNumber doit être un numéro que votre organisation possède (sinon 403) — c’est ainsi que le spoofing de CLI sortant est bloqué.
• Le nom d’utilisateur est lié à votre organisation : un nom volé ne peut pas être rejoué contre un autre tenant.
• L’émission de jetons est limitée à owner/admin/developer — pas d’endpoint public anonyme.

​

4. Extrait JS complet — micro, push VoIP + repli navigateur

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. Vérification & dépannage

1. Émettez un identifiant (section 2), connectez le client (section 4) et guettez l’événement connect ou SIP registered.
2. Passez un appel sortant vers votre propre mobile — vous devriez entendre la sonnerie puis un audio bidirectionnel.
3. Faites router un appel entrant vers votre numéro et confirmez que le softphone sonne et répond.

​

Où aller ensuite

• SDK demo test-call page — passez un vrai appel sortant de test depuis le dashboard (Developer → SDK Live Demo).
• SIP trunk setup — si vous voulez apporter votre propre carrier/trunk à côté du softphone navigateur.
• Voice queues — les files ACD par lesquelles passent les appels entrants avant qu’un softphone réponde.
• Web SDK — la carte complète des événements de Softphone et des autres surfaces SDK.