# Installation Guide (for Admins)

**Getting Easy Calling up and running is easier than you think.** This guide walks you through the complete installation process, step by step.

## Before You Begin

### Who Should Do This Installation?

This guide is for **IT Administrators** or **Teams Administrators** who are responsible for setting up applications in your Microsoft 365 tenant.

### What You'll Need

* **Global Administrator** access to your Microsoft 365 tenant
* **Teams Administrator** rights (to configure call queues)
* **15-20 minutes** of uninterrupted time
* **The Easy Calling app package** (download below)

### What You'll Accomplish

By the end of this guide, you'll have:

* Easy Calling installed in your Teams environment
* Permissions configured correctly
* Your first call queue set up and ready to use
* Your team ready to start handling calls

{% hint style="info" %}
**Important:** You'll need to grant administrative consent for Easy Calling to access call information and integrate with Teams. This is a one-time setup.
{% endhint %}

***

## Step 1: Download the Easy Calling App Package

Download the latest version of Easy Calling to your computer. You'll upload this to Teams in the next step.

{% file src="/files/tSD4YHJXd9AtC3zkGbbq" %}

**Pro Tip:** Save this file somewhere easy to find, like your Desktop or Downloads folder.

***

## Step 2: Upload Easy Calling to Teams Admin Center

Now we'll add Easy Calling to your organization's Teams apps.

**1. Open the Teams Admin Center**

Go to [admin.teams.microsoft.com](https://admin.teams.microsoft.com/) and sign in with your **Global Administrator** account.

**2. Navigate to "Manage Apps"**

In the left sidebar, click **Teams apps** → **Manage apps**

<figure><img src="/files/6DMURjd4JlHeulOSPcwD" alt=""><figcaption></figcaption></figure>

**3. Upload the Easy Calling Package**

* Click the **"Upload"** button (or **"Upload new app"**)
* Click **"Upload"** again in the dialog that appears
* Select the **EasyCalling-1.1.7.zip** file you downloaded earlier
* Click **"Open"**

<figure><img src="/files/nEsK03QzmkR8b9sAtb69" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/JQIjpeCcAHQuUDFkpUUC" alt="Upload dialog"><figcaption><p>Select the Easy Calling ZIP file</p></figcaption></figure>

<figure><img src="/files/JamTNerWpP1uNKTQV4OQ" alt="App uploaded successfully"><figcaption><p>Easy Calling is now uploaded to your tenant</p></figcaption></figure>

**4. Verify the Upload**

Search for "Easy Calling" in the Manage Apps list to confirm it's been added successfully.

{% hint style="success" %}
**Great job!** Easy Calling is now available in your Teams environment. Next, we'll configure the permissions.
{% endhint %}

***

## Step 3: Run the Easy Calling Setup Wizard

After purchasing your Easy Calling license, you'll receive an email with an installation link. This wizard automates most of the permission setup.

### Why Do We Need Permissions?

Easy Calling needs specific permissions to:

* **Read call information** from Microsoft Teams (to show you who's calling)
* **Control calls** (answer, transfer, send to voicemail)
* **Send notifications** to your team about incoming calls
* **Create resource accounts** for call queues

These permissions are granted once and apply to your entire organization.

### Starting the Wizard

**1. Open the Installation Link**

Click the installation link in your purchase confirmation email. You'll see the Easy Calling setup wizard.

**2. Sign In with Your Admin Account**

When prompted, sign in with your **Global Administrator** account.

**3. Click "Get Started"**

<figure><img src="/files/kuiQ835qJIDUfsk2ps8Y" alt=""><figcaption></figcaption></figure>

4. **The system will now check whether the required endpoints are accessible and are not blocked by a firewall, for example. If everything is accessible, you can click "Next."**

<figure><img src="/files/uX6iHblPiU12x1fvSxMA" alt=""><figcaption></figcaption></figure>

5. **If you skipped Step 2, you can choose here to have the manifest installed automatically or to install it manually. Once the installation is complete, you can click "Next"**

<figure><img src="/files/B1xdGuWNnLK0Glrh8zXQ" alt=""><figcaption></figcaption></figure>

**Automatically:**

<figure><img src="/files/CyELLAqFXXIuP6l8wbzT" alt=""><figcaption></figcaption></figure>

**Manual:**

<figure><img src="/files/TwZlUyJIsP1mKrc1v7L0" alt=""><figcaption></figcaption></figure>

***

## Step 4: Grant Permissions (This is Important!)

The wizard will guide you through granting several permissions. Don't worry–we'll explain what each one does.

### Permission 1: User Settings (My Easy Platform)

**What it does:** Allows Easy Platform to read your users' profiles so it can show agent names and availability.

**What to do:**

1. Click the **"Grant Consent"** button
2. A Microsoft permission dialog will appear
3. Sign in with your **Global Administrator** account
4. Review the permissions (they're all read-only)
5. Click **"Accept"**

<figure><img src="/files/hvyQtaDSaRudPwh5XPlk" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/9H5HNFSQPN8auJZmtbWM" alt=""><figcaption></figcaption></figure>

If validation succeeds, click **"Next"** If validation fails, try granting consent again

<figure><img src="/files/suJ0MY0BM6V6h9pW9I2b" alt=""><figcaption></figcaption></figure>

***

### Permission 2: Easy Platform (Application Access)

**What it does:** Allows the Easy Platform backend to create and manage call queues on your behalf.

**What to do:**

1. Click the **"Grant Consent"** button
2. Sign in with your **Global Administrator** account (if prompted)
3. Review the permissions
4. Click **"Accept"**

<figure><img src="/files/ea6p4QxHvwFLYdQxZbTH" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/9lfQfdOanjFwT9ebvrLd" alt=""><figcaption></figcaption></figure>

If validation succeeds, click **"Next"** If validation fails, try granting consent again

<figure><img src="/files/cJItgUey50Znk29xpxj8" alt=""><figcaption></figcaption></figure>

***

### Permission 3: Easy Calling Configuration (Call Management)

**What it does:** Allows Easy Calling to send and receive call information in real-time.

**What to do:**

1. Click the **"Grant Consent"** button
2. Sign in with your **Global Administrator** account (if prompted)
3. Review the permissions (these include call management capabilities)
4. Click **"Accept"**

<figure><img src="/files/Cz4UGIM7sRh23fyuFqqE" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/ScCr10gPHkFDXvGg48R3" alt=""><figcaption></figcaption></figure>

If validation succeeds, click **"Next"** If validation fails, try granting consent again

<figure><img src="/files/ABhhIzFIIKBucm9uee9x" alt=""><figcaption></figcaption></figure>

***

### Permission 4: Teams Policy (Call Transfers)

**What it does:** Allows Easy Calling to transfer calls and remove participants (required for transferring callers to different agents or queues).

**What to do:**

1. Click the **"Activate Teams Policy"** button
2. This will automatically configure the necessary Teams policy

<figure><img src="/files/1MawqcAKCGPyHXs49HTF" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/HkHiT89AgUXlYNgPjlkC" alt="Teams policy activation"><figcaption><p>The policy is being activated</p></figcaption></figure>

If validation succeeds, click **"Next"** If validation fails, try granting consent again

<figure><img src="/files/XHA2c1Z3rD7qsPXQY3X6" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**What's a Teams Policy?** It's a set of rules that controls what apps can do in your Teams environment. This policy specifically allows Easy Calling to transfer calls between users.
{% endhint %}

***

## Step 5: Configure Initial Settings (Optional)

Now you can enable some global features. **Don't worry–you can change these later.**

### Available Features

<figure><img src="/files/b7uhpeCJhbCITfwFiMBl" alt=""><figcaption></figcaption></figure>

**Feature options:**

* **Enable Microsoft Planner** – Create tasks from calls in shared Planner boards
* **Enable Personal Tasks** – Create tasks in Microsoft To-Do
* **Enable Personal Contact Creation** – Save callers as personal contacts
* **Enable Send Mail** – Send follow-up emails directly from Easy Calling
* **Enable Entra ID Lookup** – Automatically identify callers from your directory
* **Enable Search.ch Integration** (Switzerland only) – Look up unknown Swiss phone numbers

**Our recommendation:** Enable all features initially. You can always turn off features later if your team doesn't use them.

<figure><img src="/files/8qWJeJrP2GT1pZ7wkuCA" alt=""><figcaption></figcaption></figure>

**Click "Next"** to continue

***

## Step 6: Set Access Permissions

Control who can access the Easy Platform configuration portal.

<figure><img src="/files/HwmQZP3wjnFkcIYa1Zs8" alt=""><figcaption></figcaption></figure>

### Options:

**Option 1: All Users (Default)** Any user in your organization can log in to the Easy Platform portal with their Microsoft account.

**Option 2: Specific Users/Groups** Restrict access to only designated administrators or team leads.

**Our recommendation:** Start with "All Users" so anyone can explore the portal. Once you've set up your call queues, restrict access to administrators and voice app managers only.

**Click "Next"** to continue

***

## Step 7: Installation Complete!

You've successfully installed Easy Calling. The final screen shows important links and resources.

<figure><img src="/files/8lQbybQ4cSjCjYfuIOfu" alt=""><figcaption></figcaption></figure>

**Save these links:**

* **Easy Platform Configuration Portal** – Where you'll create call queues
* **Easy Calling Documentation** – This guide and others
* **Support Contact** – If you need help

{% hint style="success" %}
**Congratulations!** You've successfully installed Easy Calling. Now it's time to create your first call queue.
{% endhint %}

***

## What's Next?

### Immediate Next Steps (Do These Now)

1. [**Configure Best Practices – Call Life Cycle Queue**](/getting-started/easy-calling-configuration.md) – Set up a call queue so calls can be routed to your team
2. [**Configure Teams Call Flow**](https://github.com/easy-platform/easycalling/blob/main/docs/end-user/getting-started/microsoft-teams-call-flow.md) – Connect your phone numbers to Easy Calling
3. **Add Your Team** – Assign agents to your call queue

### After Best Practices – Call Life Cycle Queue is Working

4. [**Train Your Team**](/getting-started/best-practices-call-life-cycle.md) – Share the Quick Start Guide with your agents
5. [**Set Up Voicemail**](https://github.com/easy-platform/easycalling/blob/main/docs/end-user/guides/how-to/setup-voicemail.md) – Configure voicemail greetings and routing
6. [**Customize Caller ID**](/getting-started/easy-calling-configuration.md#enable-entra-id-lookup-name-resolution) – Connect external databases for better caller identification

***

## Troubleshooting Installation Issues

### "Grant Consent" Button Doesn't Work

**Possible causes:**

* You're not signed in as a Global Administrator
* Your organization has additional security policies that block consent

**Solution:**

1. Confirm you're using a Global Administrator account
2. Contact your security team to temporarily allow admin consent
3. Try again in a private/incognito browser window

***

### "Validate Consent" Fails

**Possible causes:**

* The consent wasn't fully processed yet (Microsoft sometimes takes a minute)
* There was a network interruption

**Solution:**

1. Wait 60 seconds and click "Validate Consent" again
2. If it still fails, go back and grant consent again
3. Check the Azure Active Directory admin center to confirm the app permissions are listed

***

### Can't Upload the App Package

**Possible causes:**

* You don't have permissions to upload custom apps
* Custom app uploads are disabled in your tenant

**Solution:**

1. Verify you have Teams Administrator or Global Administrator rights
2. In Teams Admin Center, go to **Teams apps** → **Manage apps** → **Org-wide app settings**
3. Ensure "Upload custom apps" is turned ON
4. Try uploading again

***

### Installation Wizard Link Doesn't Work

**Possible causes:**

* The link expired
* You're opening it in an unsupported browser

**Solution:**

1. Contact TwinCap First support to request a new installation link
2. Try opening the link in Microsoft Edge or Google Chrome
3. Clear your browser cache and try again

***

## Need Help?

If you encounter any issues during installation:

* **Email:** <support@twincapfirst.ch>
* **Phone (Switzerland):** +41 44 666 50 50
* **Phone (Germany):** +49 7431 893 99 60

**Before contacting support, have this information ready:**

* Which step you're stuck on
* Any error messages you're seeing
* Screenshots (if applicable)
* Your organization's domain name

***

## Installation Checklist

Use this checklist to track your progress:

* [ ] Downloaded Easy Calling app package
* [ ] Uploaded app to Teams Admin Center
* [ ] Verified app appears in Manage Apps
* [ ] Received installation wizard link via email
* [ ] Opened wizard and signed in as Global Administrator
* [ ] Granted consent for User Settings
* [ ] Granted consent for Easy Platform
* [ ] Granted consent for Call Management
* [ ] Activated Teams Policy
* [ ] Configured global feature settings
* [ ] Set access permissions
* [ ] Saved configuration portal link
* [ ] **Next:** [Configure first call queue](/getting-started/easy-calling-configuration.md)

***

**Ready to create your first call queue?** Head to the [Configuration Guide](/getting-started/easy-calling-configuration.md) to get started!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.easycalling.easyplatform.app/getting-started/installation-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.