LogoLogo
LogoLogo
  • Welcome
  • Details
  • Editions
  • UNIFIED CONTACTS DEPLOYMENT
    • Getting Started
      • Unified Contacts Pro
      • Unified Contacts CE
      • Unified Contacts Free
    • Deinstallation
      • Unified Contacts Pro
      • Unified Contacts Free
    • Deployment
  • Advanced Configuration
    • Backend Permissions
    • Custom Domain
    • License Key
    • Logs & Telemetry
    • SBC Number Lookup
    • SharePoint Online Lists
    • UC Database
      • Sync Data with Azure Data Factory
      • CRUD operations with REST API
      • Updating to Unified Contacts Pro 1.5.0
    • Update Strategy
      • Updating from older versions (<=1.5.1)
      • Release Channels
  • OTHERS
    • FAQ
    • Changelog
    • Feedback
    • Important Links
  • Legal
    • Licensing
      • Azure Marketplace
    • Privacy
    • Support
    • Terms of Use
  • Unified Contacts Website
Powered by GitBook
On this page
  • Azure Deployment
  • Checklist: Prerequisites
  • Overview Azure Resource
  • Configuration Steps
  • Step 1: Deploy Unified Contacts Pro Base Services
  • Step 2: Custom Domain
  • Step 3: Perform Post-Deployment Steps (Permission Assignments)
  • Step 4: Configure Access to the Unified Contacts Backend
  • Step 5: Add Unified Contacts Pro to your Organization's App Store
  • Step 6: Import Contacts from 3rd Party Sources and CRM Systems

Was this helpful?

  1. UNIFIED CONTACTS DEPLOYMENT
  2. Getting Started

Unified Contacts Pro

Last updated 5 months ago

Was this helpful?

This step-by-step guide will explain all the necessary steps to deploy Unified Contacts Pro for an enterprise-grade environment in your Azure tenant.

Azure Deployment

Let's start with the requirements and a resource overview. Keep in mind that you need to plan a useful Azure resource design.

Checklist: Prerequisites

Overview Azure Resource

All these resources are recommended for a production environment.

Type
Description

App Service

A virtual Azure environment to run the Unified Contacts application backend, providing a UI to configure different application specific settings like CNAME, SSL certificate and App Settings.

App Service Plan

A virtual set of compute resources and configurations for the "App Service".

Here you can configure the pricing tier and resource scaling.

Key Vault

Resource to securely store secrets and certificates. Unified Contacts leverages Key Vault to store API client secrets.

Storage account

Storage platform that stores the binaries of the Unified Contacts backend application.

SQL database

Relational database used by Unified Contacts to store persistent information such as custom settings and pinned favorites.

SQL server

A virtual set of compute resources and configurations for the "SQL database".

Configuration Steps

Step 1: Deploy Unified Contacts Pro Base Services

This is a mandatory step.

To start with the deployment, follow our setup instructions:

Step 2: Custom Domain

This is an optional step.

To configure a custom domain for the Unified Contacts backend, follow this guide:

Step 3: Perform Post-Deployment Steps (Permission Assignments)

This is a mandatory step.

To properly link all components of Unified Contacts Pro, several permissions need to be assigned. Please follow these steps to establish the relevant connections:

  1. Navigate to the Unified Contacts backend website. For that, navigate to the Unified Contacts App Service, select Overview and click Browse.

  2. Copy the content of the black box to your clipboard and paste it into a text editor.

  3. Now you need to replace the AppServiceAzureUrl with the correct URL from your Unified Contacts App Service. Therefore

    1. Navigate to the Unified Contacts App Service Overview blade.

    2. Copy the URL from your browser and replace the AppServiceAzureUrl argument value in the text editor with this URL.

  4. Copy all commands from the text editor, open the Azure Cloud Shell (Power Shell) on Azure Portal and paste the commands.

  5. During the script execution, you will be prompted for the SQL server administration account. Please provide the credentials you specified during the deployment in the ARM template.

  6. If you have previously configured a Custom domain on the Unified Contacts App Service, the script will prompt you for the correct App Service URL. Please select the custom domain.

  7. Towards the end of the script, you will be asked to grant the permissions (read-only) required for the Unified Contacts front- and backend to function properly. Please consent to those permissions by

    1. Either copying both links to your browser and acknowledging the grants manually with a suitable admin account,

  8. Once the script has completed successfully, restart the Unified Contacts App Service.

  9. To verify the successful deployment, navigate to the Unified Contacts App Service, select Overview and click Browse. The health indicators on the left side should all indicate Healthy.

It may initially take up to 10 minutes until the Unified Contacts backend portal is loaded.

Step 4: Configure Access to the Unified Contacts Backend

This is an optional step.

By default, any account from the tenant can access the Unified Contacts Backend. To configure access for certain accounts only, please refer to below article.

Step 5: Add Unified Contacts Pro to your Organization's App Store

This is a mandatory step.

  1. Open the Unified Contacts backend website. Therefore, navigate to the Unified Contacts App Service, select Overview and click Browse.

  2. In case you have never deployed Unified Contacts Pro before, the website will inform you that you first need to upload the Unified Contacts Manifest. This will make the Unified Contacts Pro Teams App available in your organization's AppStore.

  3. Acknowledge the dialogue, navigate to the Teams Manifest tab, adapt the manifest to your preferences, click Save and then Upload. If you have configured a custom domain, remeber to override the Api Domain in the manifest. Uploading the manifest might take a few moments. Please note: You can even change the display name of the app that will appear under the icon in the end-users' Teams client.

Step 6: Import Contacts from 3rd Party Sources and CRM Systems

This is an optional step.

You may import contacts from 3rd party contact sources or CRM systems by leveraging the UC Database

or SharePoint Online Lists:

Or by selecting to the Automatic Permission Grant. In this case, please complete the Device Login by opening the website , pasting the one-time code displayed in the Azure Cloud Shell, and following all steps.

The Unified Contacts Pro Teams app is now available in and you may distribute it as per your requirements.

App Service Managed Certificate
contact us
Deployment
Custom Domain
https://microsoft.com/devicelogin
Backend Permissions
Teams Admin Center
UC Database
SharePoint Online Lists