Softphone-Einrichtung

MicroSIP an CodeB anbinden

MicroSIP ist ein kostenloses Windows-Softphone. Sobald es in Ihrem CodeB-Tenant registriert ist, verhält es sich wie jede andere Nebenstelle — es klingelt, wenn jemand Ihren Benutzernamen wählt, Ihr Name erscheint im CodeB Webphone, und Sie können über dieselben Trunks ausgehende Anrufe tätigen, die auch der Browser nutzt.

Schritt 1

MicroSIP installieren

Laden Sie das aktuelle MicroSIP Lite von www.microsip.org/downloads herunter und starten Sie den Installer. Die Standard-Variante reicht — die Pro-Edition wird nicht benötigt.

MicroSIP läuft auf Windows 7 und neuer. Das Projekt selbst veröffentlicht keine portable Variante, aber der Installer legt alles unter %ProgramFiles%\MicroSIP ab und blendet beim Start ein Tray-Icon ein.

Schritt 2

SIP-Anmeldedaten beschaffen

Fragen Sie Ihren CodeB-Administrator nach:

Benutzername — eine kurze Kennung (z. B. test, stefan).
Passwort — das Klartext-Passwort, das in MicroSIP eingetragen wird.
Tenant-Domäne — der Hostname Ihrer CodeB-Instanz, z. B. phone.codeb.io. Das ist gleichzeitig Ihr SIP-Realm.

Tipp: Wenn Sie selbst Administrator sind, legen Sie Benutzer auf der Seite register.html (Admin-Bereich) an oder setzen Passwörter dort zurück. Passwörter werden bereits im Browser gehasht, bevor sie den Server erreichen.

Schritt 3

Konto in MicroSIP anlegen

Rechtsklick in das MicroSIP-Fenster → Account — oder Add Account… aus dem Menü — und füllen Sie den Dialog mit den unten stehenden Werten. Das Beispiel verwendet den Tenant phone.codeb.io und den Benutzernamen test; tragen Sie Ihre eigenen Werte ein.

Account Name	Beliebig — dieses Label ist nur in MicroSIP sichtbar. `CodeB` oder `microsip` funktionieren gut.
SIP Server	Hostname Ihres CodeB-Tenants, z. B. `phone.codeb.io`. Gleicher Wert wie die Domäne.
SIP Proxy	Adresse der Bridge mit SIP-Port, z. B. `phone.codeb.io:6070`. Im selben LAN wie der Server können Sie alternativ die lokale IP nutzen, z. B. `192.168.0.20:6070` — spart einen DNS-Hop.
Username *	Der Benutzername, den Ihr Administrator angelegt hat — z. B. `test`.
Domain *	Gleicher Wert wie SIP Server, z. B. `phone.codeb.io`. CodeB verwendet die Request-Domäne als Tenant-Schlüssel; deshalb muss dieser Wert exakt mit Ihrem Tenant übereinstimmen.
Login	Gleicher Wert wie Username. (MicroSIP erlaubt für andere TK-Anlagen abweichende Werte; CodeB nicht.)
Password	Das Klartext-Passwort, das Sie von Ihrem Administrator erhalten haben.
Display Name	Wie Sie für andere sichtbar sein möchten — z. B. Ihr Vorname. Wird als Caller-ID bei ausgehenden Anrufen angezeigt.

Alle weiteren Felder (Verschlüsselung, NAT, Codecs etc.) können auf den MicroSIP-Standardwerten bleiben. Auth Name bleibt leer — MicroSIP verwendet automatisch den Login.

Funktionierendes Beispiel

Account Name: microsip
SIP Server: phone.codeb.io
SIP Proxy: phone.codeb.io:6070
Username *: test
Domain *: phone.codeb.io
Login: test
Password: ••••
Display Name: stefan

Klicken Sie auf Save. MicroSIP versucht sofort, sich zu registrieren.

Schritt 4

Registrierung überprüfen

Schauen Sie auf die Statuszeile oben im MicroSIP-Fenster — die Anzeige neben dem Kontonamen sollte innerhalb von ein bis zwei Sekunden auf grün wechseln, und der Status-Text liest sich als Online. Bleibt er gelb oder rot, springen Sie zur Fehlerbehebung weiter unten.

Zur Bestätigung von der Server-Seite öffnen Sie https://<ihr-tenant>/registrar.html im Browser. Ihr Benutzername sollte mit einem aktuellen lastRefreshUtc-Zeitstempel in der Liste auftauchen. Die Contact-URI wurde bereits auf Ihren öffentlichen Endpunkt umgeschrieben — das ist normal und ermöglicht es der Bridge, Sie durch NAT zurückzuerreichen.

Schritt 5

Testanruf

Aus dem MicroSIP-Tastenfeld:

Wählen Sie Ihren eigenen CodeB-Webphone-Benutzernamen — wenn jemand das CodeB Webphone im selben Tenant geöffnet hat, klingelt sein Tab.
Wählen Sie einen Raumnamen wie r_demo — Sie treten dem Konferenzraum als Audio-Teilnehmer bei. Wichtig: Räume, die per SIP-Softphone erreichbar sein sollen, müssen mit r_ beginnen. Die Bridge erkennt das Ziel an diesem Präfix als Raum (und nicht als Benutzer); jeder Name ohne dieses Präfix wird als Benutzer bzw. Nebenstelle behandelt und nicht in einen Konferenzraum geroutet.
Wählen Sie eine vollständige E.164-Nummer wie +4980012345 — die Bridge routet den Anruf über die konfigurierten Outbound-Trunks gemäß den Regeln auf outbound-routing.html.

Eingehende Anrufe funktionieren genauso: Alles, was über inbound-routing.html auf Ihren Benutzernamen geroutet wird — egal ob vom Browser, von einem anderen Softphone oder von einem PSTN-Trunk — klingelt in MicroSIP.

Hinweis für Räume: Wenn Sie einen Raum anlegen, in den auch SIP-Anrufer hineinwählen sollen, vergeben Sie einen Namen mit r_-Präfix (z. B. r_sales, r_standup, r_demo). Ein Raum, der nur sales heißt, ist vom Softphone aus nicht erreichbar — nur Browser-Teilnehmer können beitreten.

Fehlerbehebung

Status bleibt gelb mit „Stopped" oder „Forbidden"

Meist sind Benutzername oder Passwort falsch oder der Realm passt nicht. Prüfen Sie Schritt 3 nach, vor allem das Feld Domain — es muss exakt mit Ihrem Tenant-Hostnamen übereinstimmen, z. B. phone.codeb.io ohne Pfad, ohne Schema, ohne Port.

Mit Admin-Zugang setzen Sie das Passwort auf register.html neu und tragen es direkt in MicroSIP ein.

Status bleibt gelb mit „Request Timeout" oder ohne Antwort

Der SIP-Proxy ist nicht erreichbar. Prüfen Sie den Port unter SIP Proxy — er muss der öffentliche SIP-Port der Bridge sein, üblicherweise 6070. Führen Sie auf demselben Rechner in der PowerShell Test-NetConnection phone.codeb.io -Port 6070 aus. Schlägt das fehl, blockiert Ihre Firewall oder Ihr Provider UDP auf diesem Port.

Wenn Sie im selben LAN wie der Server sind, versuchen Sie die lokale IP-Form (z. B. 192.168.0.20:6070). NAT-Traversal zwischen zwei privaten Netzen ist für SIP UDP nicht konfiguriert.

Registrierung läuft, aber eingehende Anrufe läuten nicht in MicroSIP

Zwei häufige Ursachen. Erstens: Ihr Benutzername steht in keiner Inbound-Route — bitten Sie Ihren Administrator, auf inbound-routing.html einen Eintrag anzulegen, der die DID (oder ein Anrufer-Muster) auf Ihren Benutzernamen abbildet. Zweitens: NAT kann den Contact-Pfad nach etwa 30 Sekunden Stille verwerfen; MicroSIP registriert sich standardmäßig alle 60 Sekunden neu, was das Pinhole offen hält. Sehen Sie weiterhin Aussetzer, senken Sie „Re-register every" in den MicroSIP-Konteneinstellungen auf 30 Sekunden.

Verbindung kommt zustande, aber kein Ton

Fast immer RTP, das von einem Router blockiert wird. CodeB streamt G.711 (PCMA / PCMU) über dieselbe öffentliche IP wie das SIP-Signaling auf dynamischen UDP-Ports. Stellen Sie sicher, dass die SIP-ALG-Funktion Ihres Routers deaktiviert ist — Verbraucher-Implementierungen von SIP-ALG sind dafür bekannt, SDP zu zerlegen. Auf der FRITZ!Box ist nichts Spezielles nötig; stellen Sie nur sicher, dass nichts anderes den von MicroSIP angekündigten Port-Bereich belegt.

Registriert sich alle paar Sekunden neu

Das Standard-Re-Register-Intervall von MicroSIP liegt bei 60 Sekunden — feuert es häufiger, weist der Server die Registrierung zurück und MicroSIP versucht es immer wieder. Öffnen Sie dial-log.html auf dem Server, um den Ablehnungsgrund zu sehen (meist: falsches Passwort oder unbekannter Benutzer).

Kommen Sie nicht weiter? Schicken Sie Ihrem Administrator den Inhalt von Hilfe → Logs aus MicroSIP für die letzte Minute samt dem genauen Zeitstempel Ihres Versuchs — gepaart mit dem passenden Zeitfenster in dial-log.html lässt sich nahezu jedes Registrierungs- oder Anrufproblem in weniger als einer Minute eingrenzen.