EasyUC
4.8.7

EasyUC für Microsoft Teams

Operator Connect über Teams-Weiterleitung

Eine Operator-Connect-Nummer über ein Teams-Dienstkonto und eine Pilotnummer in ein EasyUC-Script führen.

EasyUC · Version 4.8.7

In EasyUC: Script-Formular → Über MS Teams erreichbar → Anrufeingang → Operator Connect über Teams-Weiterleitung

Wozu dient das

Bei Operator Connect bleibt die öffentliche Rufnummer beim Anbieter und wird von ihm direkt in Microsoft Teams zugestellt, nicht an den EasyUC-SBC. Damit ein Anruf auf eine solche Nummer trotzdem ein EasyUC-Script erreicht, bietet EasyUC den Eingang Operator Connect über Teams-Weiterleitung.

Der Weg: Der Anrufer wählt die Operator-Connect-Nummer. Sie ist einem Teams-Dienstkonto zugewiesen, das jeden Anruf sofort auf eine Direct-Routing-Pilotnummer weiterleitet. Die Pilotnummer steht in der Voice Route von EasyUC, der Anruf kommt also über den Trunk am SBC an. Der SBC liest aus der History-Info des Anrufs, welche Nummer ursprünglich gewählt wurde, und ordnet den Anruf dem richtigen Script zu.

Das Script kann ein ACD-Script oder die Warteschlange eines Vermittlungsplatzes sein. Ein Microsoft Teams Auto Attendant ist nicht beteiligt. EasyUC kann die nötigen Einstellungen am Dienstkonto prüfen und über Teams PowerShell selbst setzen.

Voraussetzungen

  • Lizenzmodul teams. Ohne dieses Modul erscheint der Workspace EasyUC Teams nicht.
  • Rolle EasyUC Teams mit den Unterrechten SCRIPTS (ROLE_APP_TEAMS_SCRIPTS) und SCRIPTS bearbeiten (ROLE_APP_TEAMS_SCRIPTS_EDIT).
  • Direct Routing mit dem EasyUC-SBC läuft für diesen Tenant, und mindestens ein Script ist aus Teams erreichbar.
  • EasyUC ist an Teams PowerShell angemeldet oder eine App-Registrierung ist hinterlegt.
  • Eine Operator-Connect-Nummer, die einem Benutzer zugewiesen werden kann. Eine Dienstnummer für Ressourcenkonten eignet sich nicht.
  • Je Operator-Connect-Nummer ein eigenes Teams-Dienstkonto mit Teams-Phone-Lizenz und Enterprise Voice, dem die Nummer zugewiesen ist.
  • Die Anrufrichtlinie des Dienstkontos erlaubt die Weiterleitung an Telefonnummern. EasyUC prüft diesen Punkt nicht; kontrollieren Sie ihn in Teams.
  • Eine freie Direct-Routing-Nummer als Pilotnummer. Sie ist keinem Benutzer und keiner Ressource zugewiesen und fällt unter keine Regel für nicht zugewiesene Nummern.
  • Die globale Voice-Routing-Richtlinie des Tenants enthält die PSTN-Nutzung von EasyUC nicht.

Schritt für Schritt: Script mit Operator-Connect-Nummern einrichten

  1. Öffnen Sie das Script im Script-Formular oder legen Sie es mit IVR anlegen an.
  2. Setzen Sie den Haken Über MS Teams erreichbar und wählen Sie den Teams-Tenant.
  3. Wählen Sie unter Anrufeingang die Karte Operator Connect über Teams-Weiterleitung. Sie trägt den Hinweis von Microsoft nicht dokumentiert.
  4. Wählen Sie unter Operator-Connect-Nummern eine Nummer aus der Liste Nummer aus dem Inventar hinzufügen und klicken Sie das Plus-Symbol. Fehlt sie im Inventar, klicken Sie Nummer von Hand hinzufügen und tragen die OC-Nummer ein.
  5. Prüfen Sie je Nummer das Feld Teams-Dienstkonto (UPN). EasyUC übernimmt das Konto aus dem Inventar; Sie können es von Hand ändern.
  6. Wiederholen Sie das für weitere Nummern. Erlaubt sind höchstens 10 Nummern je Script.
  7. Tragen Sie unter Pilotnummer (Direct Routing) die Pilotnummer ein oder klicken Sie einen der Vorschläge an. Vorschläge tragen die Etiketten frei, gemeinsam oder bisher in diesem Script.
  8. Klicken Sie Speichern. EasyUC nimmt die Pilotnummer in die Voice Route auf, die Operator-Connect-Nummern nie.

Schritt für Schritt: Weiterleitung prüfen und einrichten

  1. Öffnen Sie die Tenant-Seite und prüfen Sie, dass Routen in Teams Aktuell zeigt. Andernfalls klicken Sie Routen aktualisieren. Erst danach steht die Pilotnummer im Muster der Voice Route.
  2. Öffnen Sie wieder das Script und klicken Sie Jetzt prüfen. EasyUC liest über den PowerShell-Dienst, ob Benutzer, Nummer, Richtlinie, Weiterleitung und Pilot passen. Dabei wird nichts geändert.
  3. Lesen Sie die Prüfpunkte unter Pilotnummer und Trunk und je Nummer über das Symbol Prüfpunkte. Der Status je Nummer lautet in Ordnung, Hinweis, Fehler oder nicht geprüft.
  4. Klicken Sie in der Zeile einer Nummer auf Weiterleitung einrichten.
  5. Lassen Sie Richtlinie zuweisen (EasyUC-Voice-Routing-Richtlinie) und Weiterleitung setzen (sofort auf die Pilotnummer) angehakt.
  6. Erscheint Bestehende Weiterleitung ersetzen, leitet das Konto bereits anders weiter. Setzen Sie den Haken nur, wenn diese Weiterleitung überschrieben werden darf.
  7. Klicken Sie Vorschau und lesen Sie Geplante Schritte. Ist ein Schritt als blockiert markiert, wird nichts ausgeführt.
  8. Klicken Sie Ausführen und bestätigen Sie die Rückfrage „EasyUC ändert jetzt in Microsoft Teams die Einstellungen von … Fortfahren?“.
  9. Warten Sie auf „Die Einrichtung ist abgeschlossen.“ Notieren Sie den Kasten Stand vorher mit der früheren Weiterleitung und Richtlinie für einen späteren Rückbau.
  10. Klicken Sie erneut Jetzt prüfen. Alle Prüfpunkte sollten in Ordnung zeigen.
  11. Rufen Sie die Operator-Connect-Nummer aus dem Mobilfunknetz an. Im Anrufverlauf steht unter Von Ihre Mobilnummer und unter Bis die Operator-Connect-Nummer mit dem Zusatz „über Pilot …“.

Schritt für Schritt: Weiterleitung von Hand einrichten oder zurückbauen

  1. Klicken Sie im Script Anleitung für die manuelle Einrichtung. EasyUC zeigt die sieben Schritte mit den Werten dieses Scripts.
  2. Weisen Sie dem Dienstkonto im Teams Admin Center eine Voice-Routing-Richtlinie mit der EasyUC-Nutzung zu. Ändern Sie nie die Richtlinie Global.
  3. Richten Sie im Teams-Client des Dienstkontos oder im Teams Admin Center die sofortige Weiterleitung auf die Pilotnummer ein.
  4. Kontrollieren Sie mit Jetzt prüfen.
  5. Für den Rückbau setzen Sie die Weiterleitung des Dienstkontos auf den Stand aus Stand vorher zurück und weisen die frühere Richtlinie wieder zu.
  6. Stellen Sie das Script auf einen anderen Anrufeingang um oder löschen Sie es. Bei einer gemeinsamen Pilotnummer genügt Abschalten nicht.
  7. Klicken Sie auf der Tenant-Seite Routen aktualisieren, damit eine nicht mehr genutzte Pilotnummer aus der Voice Route verschwindet.

Felder und Optionen

Felder und Optionen
Feld / AktionBedeutung und Verwendung
OC-NummerOperator-Connect-Nummer im internationalen Format mit führendem +, höchstens 40 Zeichen. Je Script höchstens 10, keine doppelt.
Teams-Dienstkonto (UPN)Konto, dem die Nummer in Teams zugewiesen ist und das weiterleitet. Höchstens 190 Zeichen. Weicht es vom Inventar ab, meldet EasyUC „Laut Inventar ist die Nummer … zugewiesen.“
Pilotnummer (Direct Routing)Direct-Routing-Nummer, auf die das Dienstkonto weiterleitet. Sie darf keiner Operator-Connect-Nummer des Scripts gleichen. Nicht zugewiesene Direct-Routing-Nummern erscheinen oft nicht im Inventar; die Nummer kann frei eingetragen werden.
Gemeinsame PilotnummerMehrere Scripts eines Tenants dürfen dieselbe Pilotnummer nutzen. Sie werden dann nur über die History-Info unterschieden, und ein direkter Anruf auf die Pilotnummer wird abgewiesen.
Jetzt prüfenLesende Prüfung über Teams PowerShell. Bei vielen Nummern kann sie unvollständig bleiben; Weitere Nummern erneut prüfen holt den Rest nach.
Prüfpunkte Pilot und TrunkPilot steht in der EasyUC-Voice-Route, Pilot ist keinem Objekt zugewiesen, Gateway sendet History-Info (ForwardCallHistory), Global-Richtlinie ohne EasyUC-Usage, SBC nimmt den Piloten an.
Prüfpunkte je NummerTeams-Benutzer vorhanden, OC-Nummer ist dem Benutzer zugewiesen, Enterprise Voice aktiv, Teams-Phone-Lizenz vorhanden, Voice-Routing-Richtlinie enthält die EasyUC-Usage, Weiterleitung aktiv (sofort), Weiterleitungsziel ist die Pilotnummer, Kein Teams-Gerät eines Vermittlungsplatzes.
Weiterleitung einrichtenÄndert über den PowerShell-Dienst nur diesen einen Benutzer. Die Richtlinie Global bleibt unverändert. Bedienbar erst nach dem Speichern des Scripts.
Operator Connect über öffentliche ZielnummerDritte Karte unter Anrufeingang, als Übergangsweg gekennzeichnet. EasyUC speichert nur die Operator-Connect-Nummer und eine öffentliche EasyUC-Zielnummer und richtet keinen eigenen Laufzeitweg ein. Die Weiterleitung muss beim Anbieter eingerichtet werden.

Ergebnis prüfen und Fehler eingrenzen

  • Erfolg: Jetzt prüfen zeigt alle Prüfpunkte in Ordnung, und der Testanruf auf die Operator-Connect-Nummer erreicht das Script. Im Anrufverlauf steht unter Bis die Operator-Connect-Nummer mit „über Pilot …“.
  • „Bitte das Script zuerst speichern. Geprüft und eingerichtet wird der gespeicherte Stand.“ Speichern Sie das Script, bevor Sie prüfen.
  • „Das EasyUC-Gateway in Teams sendet keine History-Info (ForwardCallHistory ist aus). Ohne sie kann der SBC eine weitergeleitete Operator-Connect-Nummer nicht zuordnen.“ Klicken Sie auf der Tenant-Seite Routen aktualisieren oder schalten Sie ForwardCallHistory am PSTN-Gateway in Teams ein.
  • „Die Nummer … ist Teams-Gerät eines Vermittlungsplatzes. Eine Übergabe dorthin liefe über die Weiterleitung zurück in EasyUC (Rufschleife). Bitte ein eigenes Dienstkonto verwenden.“ Verwenden Sie ein anderes Konto.
  • „Operator-Connect-Nummer und Pilotnummer dürfen nicht identisch sein, damit keine Rufschleife entsteht.“ Wählen Sie eine andere Pilotnummer.
  • „Die Nummer … ist in diesem Tenant bereits vergeben (Script „…“).“ Die Nummer gehört einem anderen Script.
  • „Mindestens ein Schritt ist blockiert. Es wird nichts ausgeführt.“ Lesen Sie den Grund am Schritt, meist eine fremde Richtlinie oder eine bestehende Weiterleitung.
  • „Der PowerShell-Dienst für Microsoft Teams ist nicht erreichbar.“ Prüfen Sie Dienst und Anmeldung auf der Tenant-Seite.
  • Prüfpunkt Global-Richtlinie ohne EasyUC-Usage als Hinweis: Die PSTN-Nutzung von EasyUC hängt an der Richtlinie Global. Für diesen Weg wird das nicht empfohlen.
  • Der Benutzer oder ein Administrator kann die Weiterleitung jederzeit ändern. Wiederholen Sie Jetzt prüfen regelmäßig. Die Checkliste des Vermittlungsplatzes stuft eine Prüfung, die älter als 7 Tage ist, als Hinweis ein.
  • Grenzen: Jede Operator-Connect-Nummer braucht ein lizenziertes Dienstkonto. Wie viele Anrufe gleichzeitig über eine Benutzernummer laufen, ist nicht geprüft.

Weiterlesen