Introduction

This guide walks you through configuring the jtel ACD Client Tab as a custom application within Microsoft Teams, providing seamless integration with the jtel Carrier Portal. By adding this app to your Teams environment, users can access the jtel ACD Client directly within Teams.

The setup process involves creating a Teams app package, uploading it to your Teams admin portal, and configuring it for global use within your organization. This document provides step-by-step instructions on the prerequisites, installation, and setup, along with guidance for updating the app as needed.

Guide Overview

1. Prerequisites: Setting up the required files for the Teams app.
2. App Creation: Configuring and zipping the necessary files for upload.
3. Installation and Setup: Uploading the app to Teams and configuring it within your organization's policies.
4. Updating the App: Procedures to update the app version and troubleshoot if necessary.

Prerequisites

To begin, create a Teams application by preparing three files:

1. Icon-color.png and Icon-outline.png - the application's icons.
2. manifest.json - the application's configuration file.

Configuring manifest.json

The manifest.json file defines key application properties and configurations, such as app identifiers, permissions, and URLs.

{
  "$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.16/MicrosoftTeams.schema.json",
  "manifestVersion": "1.16",
  "id": "$application_id",
  "version": "1.0.0",
  "packageName": "de.jtel.acd.teams",
  "developer": {
    "name": "jtel GmbH",
    "websiteUrl": "https://jtel.de/",
    "privacyUrl": "https://jtel.de/privacy-statement-eu/",
    "termsOfUseUrl": "https://jtel.de/en/legal",
    "mpnId": ""
  },
  "name": {
    "short": "jtel ACD",
    "full": "jtel ACD Client Tab"
  },
  "description": {
    "short": "jtel ACD Teams Client",
    "full": "The jtel ACD Client for Microsoft Teams provides seamless integration with jtel's Carrier Portal, enabling users to manage carrier operations directly within Teams. Access dashboards, monitor performance metrics, and collaborate with your team efficiently."
  },
  "icons": {
    "outline": "Icon-outline.png",
    "color": "Icon-color.png"
  },
  "accentColor": "#333333",
  "configurableTabs": [],
  "staticTabs": [
    {
      "entityId": "jtelACD",
      "name": "jtel ACD",
      "contentUrl": "$acd_portal_url",
      "websiteUrl": "$acd_portal_url",
      "scopes": [ "team", "personal" ]
    }
  ],
  "bots": [],
  "connectors": [],
  "composeExtensions": [],
  "permissions": [
    "identity",
    "messageTeamMembers"
  ],
  "validDomains": [
    "$acd_domain",
    "jtel.de"
  ],
  "webApplicationInfo": {
    "id": "$app_registration_id",
    "resource": "https://$acd_domain"
  }
}
  

Replace the following placeholders:

• $application_id: The unique ID for your application. Generate one using a Free Online GUID Generator.
• $acd_portal_url: The URL for the jtel Carrier Portal (e.g., https://myacdsystem.mydomain.de/CarrierPortal/login/myResellersUID/myClientsUID).
• $acd_domain: Your portal's domain, such as myacdsystem.mydomain.de.
• $app_registration_id: The "Application (client) ID" from Microsoft Azure’s App registrations.

Once configured, compress the three files into a .zip file for upload.

Example in the attachment:

jtelACDTeamsTab.zip

Teams App Upload and Configuration

To create Teams Apps for your organization, you must be a Global Admin: Login to Microsoft 365 admin center with your admin credential and make sure of the role.

1. Login to Dashboard - Microsoft Teams admin center

2. Go to Teams apps → Manage apps and click on Upload new app.

3. Follow the steps to upload the zip file created in the previous steps.
   
   

   
   
   

4. By successful upload, you should see the following popup:
   
   
   
   

5. You should be able to see the new app in All apps table by typing the filter jtel ACD
   
   
   
   

6. Go to Teams apps → Setup policies and click on Global (Org-wide default)

7. Under Installed apps click on Add apps and search for the added application by the name “jtel ACD“. Next click on Add.

8. Under Pinned apps, click on Add apps and add the new application.

9. Finally click on save button and you should see the following popup:
   
   
   
   

10. Restart the Teams application and go to Apps and search for jtel ACD.
    
    
    
    

11. Select the new application and click on Add button. The portal will be opened then.

Updating an Existing App

1. Update the app folder (manifest.json and icons if necessary).
2. In manifest.json, the id should be the same and the version should be incremented (e.g., from 1.0.0 to 1.0.1 for example).
3. Zip the folder.
4. Login to Dashboard - Microsoft Teams admin center.
5. Go to Teams apps → Manage apps and search for the jtel app.
6. Open the app and click on New version Upload file on the top of the screen.
7. Upload the new zip.

With these steps, your organization can seamlessly integrate and manage the jtel ACD Client within Microsoft Teams.