URL-Referenz
Click-to-Call-Raum-URLs
Erstellen Sie einen Link zu room.html, der einem Meeting beitritt, eine Telefonnummer vorbefüllt, einen bestimmten ausgehenden SIP-Trunk fixiert, den Anzeigenamen setzt oder mit ausgeschalteter Kamera startet — ganz ohne Code. Fügen Sie ihn in eine E-Mail, einen Intranet-Button, einen CRM-Datensatz, eine E-Mail-Signatur oder einen QR-Code ein.
Alle Parameter im Überblick
| Parameter | Typ | Beispiel | Was er bewirkt |
|---|---|---|---|
| room | String | stefan-test | Meeting-Raumname / Slug. Jeder Besucher mit demselben room=-Wert landet im selben Meeting. Erratbarer Slug für offene Meetings; nicht erratbarer Zufalls-Slug (z. B. r-7a3f9c2e) für private Einzelgespräche, bei denen die URL das Zugangs-Token ist. |
| name | String | Stefan | Anzeigename, den andere Teilnehmer sehen. Ohne diesen Parameter fragt die Seite beim Beitritt nach einem Namen. |
| dial | E.164 / Nebenstelle | %2B4915157610183 | Telefonnummer oder PBX-Nebenstelle, die die Bridge wählt, sobald der erste Browser-Teilnehmer eintrifft. Das führende + URL-kodiert als %2B. Interne Nebenstellen wie 610 funktionieren ebenfalls. |
| trunk | Trunk-Id | tr_4194b9eab3de | Optional. Fixiert den ausgehenden Anruf auf einen bestimmten SIP-Trunk. Ohne diesen Parameter wählt die Bridge den niedrigsten Priority-Trunk, der den Anruf tragen kann. Nützlich, wenn ein Trunk die richtige Anrufer-ID, den richtigen Tarif oder eine regulatorische Bindung für das Ziel hat. |
| cam | off | off | Mit deaktivierter Kamera starten. Audio-only-Erlebnis. Äquivalent: nocam=1. |
| nocam | 1 | 1 | Synonym für cam=off. |
Die Seite liegt immer unter /room.html. Eine URL auf den Host-Root (/?room=…) wird von der Marketing-Startseite ausgeliefert und die Parameter werden stillschweigend ignoriert — immer /room.html in den Pfad aufnehmen.
Häufige Muster
1) Zwei Personen in einem Meeting-Raum
Beide besuchen dieselbe URL, kein Wählen.
2) Click-to-Call einer Nummer
Sie treten dem Raum bei, die Bridge ruft die Nummer an, das Telefon nimmt am Meeting teil, sobald es abnimmt.
3) Click-to-Call über bestimmten Trunk
Wie oben, aber den Anruf auf einen ausgehenden Trunk per Id fixieren.
4) Audio-only, Name vorbelegt
Nützlich für telefonähnliche Buttons in CRMs und mobilen Signaturen.
5) Interne PBX-Nebenstelle
Die Bridge wählt einen registrierten SIP-Benutzer statt einer PSTN-Nummer.
6) Vollständiger One-Shot-Link
Zufallsraum (URL ist das Zugangs-Token), Audio-only, Name vorbelegt, Anruf über fixierten Trunk.
Kodierungshinweise
URL-Parameter folgen den Standard-application/x-www-form-urlencoded-Regeln. Zwei Zeichen sind in Click-to-Call-URLs besonders zu beachten:
| Literal | Kodiert | Warum |
|---|---|---|
| + | %2B | In Query-Strings bedeutet + „Leerzeichen“. Das führende + der Rufnummer muss %2B sein. |
| Leerzeichen | %20 oder + | Falls name ein Leerzeichen enthält (z. B. „John Doe“), verwenden Sie John%20Doe oder John+Doe. |
Wie der Anruf fließt
Wenn die Seite mit einem dial=-Parameter geladen wird, tritt der Browser per WebSocket dem Raum bei und sendet eine einzige {type:"dial", number:…, trunk:…}-Nachricht an den Server. Der Server prüft den Anruf gegen die FraudGuard-Schicht (Allowlist, Blocklist, Tageslimits, Limits pro IP), übergibt ihn per HMAC-signiertem lokalem POST an die SIP-Bridge, und die Bridge platziert den SIP-Anruf an Ihren konfigurierten Trunk. Das Telefon hebt ab, tritt dem Raum als regulärer Audio-only-Teilnehmer bei, und der Audiomixer schaltet Sie zusammen.
Der Anruf wird einmal pro Browser-Ladevorgang ausgelöst. Ein Neuladen oder ein zweiter Besucher, der demselben Raum beitritt, löst ihn nicht erneut aus. Wenn Sie zurückrufen müssen, schließen Sie den Tab und klicken Sie den Link erneut.
Verwandte Seiten
Weiterführend: API-Übersicht · signal.ashx REST · REST-API-Referenz · Virtuelle Nummern.