Erstellen von Registerkarten für Anrufe

Artikel
02/03/2025

Hinweis

Die Erweiterbarkeit von Aufrufen ist nur für Einzelanrufe und in der öffentlichen Entwicklervorschau für Teams verfügbar.

Sie können jetzt Persönliche Apps erstellen, die sich nahtlos in PSTN-Anrufe (Public Switched Telephone Network) und Teams-to-Teams-Anrufe integrieren lassen. Mithilfe des richtigen Bereichs und Kontexts können Sie Apps erstellen, die Registerkartentyp, statischen Bereich, persönlichen Kontext und Besprechungsseitenbereiche effektiv nutzen.

Diese Integration ist einfach. Sie können eine neue persönliche Registerkarten-App erstellen oder eine vorhandene Registerkarten-App mit persönlichem Bereich und dem entsprechenden Kontext aktualisieren. Apps können auf die Anrufer-ID für bestimmte Anrufer zugreifen und relevante Informationen anzeigen, z. B. ihre aktiven Fälle oder Abrechnungsprobleme. Dies verbessert das Hilfsprogramm der App und bietet Benutzern während Anrufen eine umfangreichere Erfahrung.

Voraussetzungen

Stellen Sie sicher, dass die folgenden Anforderungen erfüllt sind, bevor Sie eine Registerkarten-App zur Unterstützung von 1:1-Aufrufen erstellen oder aktualisieren:

RSC-Berechtigungen erforderlich: Stellen Sie sicher, dass die folgenden RSC-Berechtigungen für die App erteilt werden:
- OnlineMeetingParticipant.Read.Chat
- OnlineMeeting.ReadBasic.Chat
Teams JS SDK erforderlich: TeamsJS SDK release latest version
Anrufer-ID-Informationen: Die Registerkarten-App muss anstelle getMeetingDetailsVerbose von getMeetingDetails verwenden, um die anrufbezogenen Informationen abzurufen. Die App kann Anrufer-ID-Details wie Telefonnummer und E-Mail-ID abrufen.

Weitere Informationen finden Sie unter API zum Abrufen von Besprechungsdetails.

Aktivieren persönlicher Registerkarten-Apps für Anrufe

So aktivieren Sie die persönliche Registerkarten-App für 1:1-Anrufe:

Aktualisieren des App-Manifests
Anheften Ihrer persönlichen Registerkarten-App an Anruferweiterungen

Aktualisieren des App-Manifests

Teams verwendet den Kontext des besprechungsseitigen Bereichs zum Hinzufügen von Anrufkontext im Manifestschema. Aktualisieren Sie Ihr App-Manifest mit den relevanten Bereichs- und Kontextarrays im staticTabs Abschnitt. Um Ihre persönliche Registerkarten-App für Einzelanrufe zu konfigurieren, aktualisieren Sie den staticTabs Abschnitt wie folgt:

Legen Sie als scopepersonal fest, um Ihre App in einem persönlichen Bereich verfügbar zu machen und die App in einem Anruf zu aktivieren.

Legen Sie als contextmeetingSidePanel fest, um die Unterstützung der Registerkarten-App zu aktivieren.

Hier sehen Sie ein Beispiel für das Update im staticTabs Abschnitt des App-Manifests:


"staticTabs":[
{
    "entityId": "contoso",
    "scopes": ["personal"],
    "context":[
        "meetingSidePanel",
    ],
    "name": "Contoso"
    "contentUrl": "http://contoso.com/content",
    "websiteUrl": "http://contoso.com/content"
}
],

Hier sehen Sie ein Beispiel für die App-Manifestdatei:

Wählen Sie diese Option aus, um ein Beispiel-App-Manifest anzuzeigen.

{
  "$schema": "https://raw.githubusercontent.com/OfficeDev/microsoft-teams-app-schema/preview/DevPreview/MicrosoftTeams.schema.json",
  "version": "1.1.5", 
  "manifestVersion": "devPreview",
  "id": "25407c29-8335-68a3-bfdb-4384580a1858",
  "packageName": "",
  "name": { "short": "Packing List - PersMSP", "full": "Packing List - PersonalAndMeetingSidePanel" },
  "developer": {
    "name": "Microsoft Corporation",
    "websiteUrl": "https://www.microsoft.com",
    "privacyUrl": "https://packing-list.azurewebsites.net/privacy.html",
    "termsOfUseUrl": "https://packing-list.azurewebsites.net/tou.html"
  },
  "description": {
    "short": "Packing list app",
    "full": "Test app to test static tabs flow"
  },
  "icons": { "outline": "outline.png", "color": "color.png" },
  "accentColor": "#eff9fc",
  "staticTabs": [
    {
      "entityId": "54d496e0-2b51-4210-bf7d-21d0b5821d9c",
      "name": "Packing List - PersonalAndMeetingSidePanel",
      "contentUrl": "https://packing-list.azurewebsites.net",
      "websiteUrl": "https://packing-list.azurewebsites.net",
      "scopes": ["personal"],
      "context": [
        "meetingSidePanel"
      ]
    }
  ],
  "validDomains": ["packing-list.azurewebsites.net"],
  "webApplicationInfo": { "id": "25407c29-8335-68a3-bfdb-4384580a1858" },
  "showLoadingIndicator": true,
  "authorization": {
    "permissions": {
      "orgWide": [],
      "resourceSpecific": [
        { "name": "OnlineMeeting.ReadBasic.Chat", "type": "Delegated" },
        { "name": "MeetingStage.Write.Chat", "type": "Delegated" },
        { "name": "OnlineMeetingParticipant.Read.Chat", "type": "Delegated" },
        {
          "name": "OnlineMeetingParticipant.ToggleIncomingAudio.Chat",
          "type": "Delegated"
        },
        { "name": "ChannelMeetingStage.Write.Group", "type": "Delegated" },
        { "name": "ChannelMeeting.ReadBasic.Group", "type": "Delegated" }
      ]
    }
  }
}

Anheften Ihrer persönlichen Registerkarten-App an Anruferweiterungen

Teams-Clientbenutzer können nur auf Ihre persönliche Registerkarten-App zugreifen, wenn sie vom Teams-Administrator angeheftet wurde. Administratoren können Anruferweiterungen nutzen, um persönliche Anruf-Registerkarten-Apps anzuheften. So heften Sie eine App für Anrufe an:

Wechseln Sie in der App-Setuprichtlinie zum Abschnitt angeheftete Apps.
Heften Sie Ihre App an, und weisen Sie sie Benutzern zu, die während Einzelanrufen Zugriff benötigen.

Weitere Informationen finden Sie unter Verwenden von App-Setuprichtlinien zum Anheften und Installieren von Apps für Benutzer.

Siehe auch

Erstellen einer Registerkarte

Freigeben über