Script über Microsoft Teams erreichbar machen

Wozu dient das

Der Trunk allein führt noch nirgendwohin. Erst ein Script legt fest, welche Nummer aus Teams angerufen werden kann und was mit dem Anruf geschieht: Ansage, Menü, Warteschlange, Agenten oder Vermittlungsplatz. Dafür schalten Sie im Script Über MS Teams erreichbar ein, wählen den Tenant und tragen die Nummer ein.

Je Tenant führt eine Nummer zu genau einem Script. Der SBC nimmt aus Teams nur Anrufe auf diese Script-Nummern an und weist jede andere Nummer ab. Beim Speichern setzt EasyUC die Voice Route für die Nummer in Teams selbst.

Ein Script kann zusätzlich eine CUCM-Nummer haben oder ausschließlich über Teams erreichbar sein. Ohne CUCM-Modul ist jedes Script ein reines Teams-Script.

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). Mit ACD-Modul gelten die Rechte des ACD-Bereichs für Scripts.
Ein Teams-Tenant ist angelegt und aktiv.
Für den selbsttätigen Abgleich der Route: App-Registrierung am Tenant oder ein angemeldeter Teams-Administrator.
Eine Nummer im internationalen Format, die in Teams gewählt werden soll. Sie darf im Tenant keinem anderen Script gehören.

Schritt für Schritt: Neues Script mit Teams-Nummer anlegen

Öffnen Sie die Script-Liste. Mit ACD-Modul über den Workspace Calling Features, ohne ACD-Modul über EasyUC Teams → Teams → IVR-Scripts.
Klicken Sie IVR anlegen.
Tragen Sie unter Name einen Namen ein, zum Beispiel Zentrale.
Wenn das CUCM-Modul aktiv ist, wählen Sie unter Erreichbar über entweder CUCM-Nummer oder Nur Microsoft Teams. Bei Nur Microsoft Teams bekommt das Script keine CUCM-Nummer und keinen CTI-RoutePoint.
Setzen Sie den Haken Über MS Teams erreichbar. Bei einem reinen Teams-Script ist er immer gesetzt.
Wählen Sie unter Teams-Tenant den Tenant. In der Auswahl steht der SBC-Hostname in Klammern.
Wählen Sie unter Anrufeingang die Karte Direct Routing.
Tragen Sie unter In Teams gewählte Nummer die Nummer ein, zum Beispiel +49 40 1234567.
Füllen Sie die übrigen Angaben des Scripts aus (Sprache, Stimme, Begrüßung) wie im Kapitel „Ein ACD-/IVR-Skript einrichten“.
Lassen Sie IVR aktiv angehakt und klicken Sie Speichern.
Warten Sie auf „Script gespeichert.“ und auf die Zeile „Route in Teams gesetzt“ mit Ihrer Nummer. Bis Teams die Änderung übernimmt, können einige Minuten vergehen.

Schritt für Schritt: Bestehendes CUCM-Script zusätzlich über Teams erreichbar machen

Öffnen Sie das Script aus der Script-Liste.
Lassen Sie Erreichbar über auf CUCM-Nummer.
Setzen Sie den Haken Über MS Teams erreichbar.
Wählen Sie Teams-Tenant und die Karte Direct Routing.
Tragen Sie die In Teams gewählte Nummer ein.
Klicken Sie Speichern. Das Script ist danach über die CUCM-Nummer und über die Teams-Nummer erreichbar.

Schritt für Schritt: Erreichbarkeit prüfen

Öffnen Sie EasyUC Teams → Teams → Teams-Tenants und klicken Sie auf den Tenant.
Prüfen Sie unter Scripts über diesen Trunk, dass das Script mit seiner Nummer und dem Status Erreichbar aufgeführt ist.
Prüfen Sie im Kasten Rufregeln für die Script-Nummern, dass Routen in Teams Aktuell zeigt. Andernfalls klicken Sie Jetzt abgleichen.
Rufen Sie die Nummer aus einem Teams-Client an, dessen Benutzer die EasyUC-Richtlinie hat.

Felder und Optionen

Felder und Optionen
Feld / Aktion	Bedeutung und Verwendung
Erreichbar über	Nur mit CUCM- und Teams-Modul: CUCM-Nummer oder Nur Microsoft Teams. Der Wechsel auf Nur Microsoft Teams entfernt beim Speichern den CTI-RoutePoint im CUCM; der Wechsel zurück legt ihn wieder an.
Über MS Teams erreichbar	Schaltet den Anrufeingang über Teams für dieses Script ein.
Teams-Tenant	Tenant, über dessen Trunk die Anrufe kommen. Pflichtfeld bei eingeschaltetem Teams-Eingang.
Anrufeingang	Direct Routing: EasyUC verwaltet die Voice Route zu seinem SBC. Operator Connect über Teams-Weiterleitung: siehe eigenes Kapitel. Operator Connect über öffentliche Zielnummer: Übergangsweg ohne EasyUC-Laufzeitweg; EasyUC speichert nur die Zuordnung.
In Teams gewählte Nummer	Internationales Format mit führendem +, insgesamt 7 bis 16 Ziffern, höchstens 40 Zeichen. Leerzeichen, Bindestriche und Klammern werden entfernt.
Call Control Group	Nur bei Scripts mit CUCM-Nummer: Gruppe der CTI-Ports, auf denen Anrufer gehalten werden.
Gesprächsaufzeichnung	Jeden Anruf dieses Skripts aufzeichnen mit Aufnahmen aufbewahren (Tage) von 1 bis 3650 und Bestätigung des rechtlichen Hinweises.
IVR aktiv	Ohne Haken ist das Script abgeschaltet. Auf der Tenant-Seite steht dann Script abgeschaltet, und die Nummer wird nicht angenommen.

Ergebnis prüfen und Fehler eingrenzen

Erfolg: Im Script-Formular steht „Route in Teams gesetzt: …“, auf der Tenant-Seite steht das Script als Erreichbar, und ein Anruf aus Teams erreicht die Begrüßung des Scripts.
„Es ist noch kein Teams-Tenant angebunden. Bitte zuerst unter „Session Border Controller“ einen anlegen.“ Legen Sie zuerst den Tenant an.
„Dieser Tenant ist abgeschaltet. Anrufe kommen erst an, wenn er wieder aktiv ist.“ Setzen Sie am Tenant den Haken Trunk aktiv.
„Erwartet: + gefolgt von Landesvorwahl und Rufnummer, insgesamt 7 bis 16 Ziffern.“ Korrigieren Sie das Format der Nummer.
„Für diesen Tenant ist keine App-Registrierung hinterlegt. Die Route wird dann nur gesetzt, solange auf der Tenant-Seite ein Teams-Admin angemeldet ist.“ Melden Sie sich an oder hinterlegen Sie eine App-Registrierung.
„Die Route in Teams wurde nicht aktualisiert“ oder „Die Route in Teams konnte nicht aktualisiert werden“ Klicken Sie Zur Tenant-Seite, prüfen Sie die Anmeldung und klicken Sie dort Jetzt abgleichen.
Status Nummer schon von einem anderen Script belegt auf der Tenant-Seite: Zwei Scripts teilen sich die Nummer. Ändern Sie eine davon.
„Ein reines Teams-Script ist nur über Microsoft Teams erreichbar: bitte „Über MS Teams erreichbar“ einschalten, den Teams-Tenant und einen vollständigen Eingangsweg wählen.“ Ergänzen Sie Tenant und Nummer.
„Bitte die CUCM-Nummer angeben, unter der das Script in CUCM erreichbar ist.“ Sie haben CUCM-Nummer gewählt, aber keine Nummer eingetragen.