Installation guide
The technical installation is carried out by IT person with following access rights:
- Global Administrator
- Teams Administrator
System technical requirements:
- Microsoft 365 For Business -subscription
- Azure subscription
- Access to Azure OpenAI Service
Azure subscription cannot be trial version of any kind. OpenAI services require registration before they can be provisioned.
DeliwiAI technical installation is divided into three distinct sections
1: Installation
First, the managed application is installed to your Azure subscription.
2: DeliwiAI installer
Second, the software packages are deployed to Azure applications and Entra ID applications are created.
3: Final steps
Finally, Entra ID applications must be consented for the whole organization and installation is finalized in the DeliwiAi user interface.
In the final stage of technical installation, individuals from departments such as HR are invited to service, who will execute the launch of DeliwiAI to your organization's staff.
The technical installation process will take 1-2h, depending on Azure resource creation speeds. If there are any issues in the installation process, please send mail to contact@decliving.com.
Step-by-step process
1: Choose the right DeliwiAI plan
Installation steps in the marketplace are quite straightforward. Marketplace interface asks for following information:
After accepting all legal obligations, Azure resources start to deploy and after deployment, software will be installed to these resources.
There are 6 different plans (Tier). Select a plan based on the number ofpersonnel in your organization.
DeliwiAI –installer
The installer can be started from address, sent to the admin email after software packages have been pushed to Azure resources.
Before going to the installer, please accept companywide consents links from the completion email. As of 07.05.2024 these links do not forward browser properly and give errors (even though consent was given succesfully).
Upon navigating to the DeliwiAi setup page, the installer will use pop-ups to ask for a second set of Entra ID consents. Some browsers block these by default. Unblock pop-ups from the site and reload/refresh site again to get it working.
In the installation process, teamsbot application will be installed (as of 07.05.2024, teamsbot installation through installer does not work and must be installed manually, see below).
The installer will also ask which people from Entra ID will be given admin status. Ensure that you give yourself admin status to avoid getting locked out of the system.
Teamsbot installation
Currently Teams bot must be manually installed to company Teams application catalog.
This can be done from Teams admin center:https://admin.teams.microsoft.com/policies/manage-appsFrom top right corner select “Actions” and “Upload new app”. Upload Teams bot manifest.zip there and email created “App ID” to Deliwi team (see email in the beginning).
Download the manifest.zip below:
We will get back to you when the backend setup has been done.
2: Basic information
Project details:
Subscription* = Automatically from system
Resource group* = Name for the managed application. It is recommended to create a new resource group for this
Instance details:
Region* = Where DeliwiAI resources will be installed
Adminemail* = Admin’s email address to receiveinstallation completion mail
Custom domain name = The readable URL-name for deliwiai-app (CustomDomainName).deliwi.ai*
Managed Application Details:
Application name* = Name of the managed application resource. It is recommended to use “DeliwiAI”
Managed Resource Group* = The resource group name for Managed Resource Group. DeliwiAI application resources will be deployed here and DeliwiAI administrators will be given admin rights to these resources. It is recommended to leave this as default.
DeliwiAI –installer
The installer can be started from address, sent to the admin email after software packages have been pushed to Azure resources.
Before going to the installer, please accept companywide consents links from the completion email. As of 07.05.2024 these links do not forward browser properly and give errors (even though consent was given succesfully).
Upon navigating to the DeliwiAi setup page, the installer will use pop-ups to ask for a second set of Entra ID consents. Some browsers block these by default. Unblock pop-ups from the site and reload/refresh site again to get it working.
In the installation process, teamsbot application will be installed (as of 07.05.2024, teamsbot installation through installer does not work and must be installed manually, see below).
The installer will also ask which people from Entra ID will be given admin status. Ensure that you give yourself admin status to avoid getting locked out of the system.
Teamsbot installation
Currently Teams bot must be manually installed to company Teams application catalog.
This can be done from Teams admin center:https://admin.teams.microsoft.com/policies/manage-appsFrom top right corner select “Actions” and “Upload new app”. Upload Teams bot manifest.zip there and email created “App ID” to Deliwi team (see email in the beginning).
Download the manifest.zip below:
We will get back to you when the backend setup has been done.
3: Recheck information
Terms
Name: Automatically filled for default admin account
Preferred e-mail address: Automatically filled for default admin account
Preferred phone number: Can leave empty
Note: Name and email are only used for Microsoft legal purposes.
Co-admin Access Permission
You also give consent Co-Admin Access to created resource groups.
DeliwiAI –installer
The installer can be started from address, sent to the admin email after software packages have been pushed to Azure resources.
Before going to the installer, please accept companywide consents links from the completion email. As of 07.05.2024 these links do not forward browser properly and give errors (even though consent was given succesfully).
Upon navigating to the DeliwiAi setup page, the installer will use pop-ups to ask for a second set of Entra ID consents. Some browsers block these by default. Unblock pop-ups from the site and reload/refresh site again to get it working.
In the installation process, teamsbot application will be installed (as of 07.05.2024, teamsbot installation through installer does not work and must be installed manually, see below).
The installer will also ask which people from Entra ID will be given admin status. Ensure that you give yourself admin status to avoid getting locked out of the system.
Teamsbot installation
Currently Teams bot must be manually installed to company Teams application catalog.
This can be done from Teams admin center:https://admin.teams.microsoft.com/policies/manage-appsFrom top right corner select “Actions” and “Upload new app”. Upload Teams bot manifest.zip there and email created “App ID” to Deliwi team (see email in the beginning).
Download the manifest.zip below:
We will get back to you when the backend setup has been done.
4: Azure deployment begins
Managed application is created to the resource group specified in section 2. A Separate resource group for DeliwiAI is created and Azure resources are provisioned there. This usually takes 20-40 minutes. After resource provisioning is completed, software packages are deployed. Do note that currently it is not possible to see software deployment progress. Software deployment takes around 30-40 minutes.
After installation is completely done, an email with Entra ID consent links will be sent to the email provided in section 2 (admin email).
DeliwiAI –installer
The installer can be started from address, sent to the admin email after software packages have been pushed to Azure resources.
Before going to the installer, please accept companywide consents links from the completion email. As of 07.05.2024 these links do not forward browser properly and give errors (even though consent was given succesfully).
Upon navigating to the DeliwiAi setup page, the installer will use pop-ups to ask for a second set of Entra ID consents. Some browsers block these by default. Unblock pop-ups from the site and reload/refresh site again to get it working.
In the installation process, teamsbot application will be installed (as of 07.05.2024, teamsbot installation through installer does not work and must be installed manually, see below).
The installer will also ask which people from Entra ID will be given admin status. Ensure that you give yourself admin status to avoid getting locked out of the system.
Teamsbot installation
Currently Teams bot must be manually installed to company Teams application catalog.
This can be done from Teams admin center:https://admin.teams.microsoft.com/policies/manage-appsFrom top right corner select “Actions” and “Upload new app”. Upload Teams bot manifest.zip there and email created “App ID” to Deliwi team (see email in the beginning).
Download the manifest.zip below:
We will get back to you when the backend setup has been done.
5: Accepting Entra ID consents
In the completion email, there are three links. Two links are for accepting company wide consents, these are required for the DeliwiAI authentication to work properly. After accepting consents, an error page is shown. Do not worry, this is a known issue but consents are still ok (these can be checked from Entra ID Enterprise applications).
Final link is to the DeliwiAI setup page.
DeliwiAI –installer
The installer can be started from address, sent to the admin email after software packages have been pushed to Azure resources.
Before going to the installer, please accept companywide consents links from the completion email. As of 07.05.2024 these links do not forward browser properly and give errors (even though consent was given succesfully).
Upon navigating to the DeliwiAi setup page, the installer will use pop-ups to ask for a second set of Entra ID consents. Some browsers block these by default. Unblock pop-ups from the site and reload/refresh site again to get it working.
In the installation process, teamsbot application will be installed (as of 07.05.2024, teamsbot installation through installer does not work and must be installed manually, see below).
The installer will also ask which people from Entra ID will be given admin status. Ensure that you give yourself admin status to avoid getting locked out of the system.
Teamsbot installation
Currently Teams bot must be manually installed to company Teams application catalog.
This can be done from Teams admin center:https://admin.teams.microsoft.com/policies/manage-appsFrom top right corner select “Actions” and “Upload new app”. Upload Teams bot manifest.zip there and email created “App ID” to Deliwi team (see email in the beginning).
Download the manifest.zip below:
We will get back to you when the backend setup has been done.
6: Accepting pop-up consents from DeliwiAI website
Currently most browsers block pop-ups from sites by default. These popups are for additional required consents. Allow pop-ups and reload the site. Note that the site should forward to /setup -url. If it does not, please get the correct link from the completion email.
Press "Next"
Accept
DeliwiAI –installer
The installer can be started from address, sent to the admin email after software packages have been pushed to Azure resources.
Before going to the installer, please accept companywide consents links from the completion email. As of 07.05.2024 these links do not forward browser properly and give errors (even though consent was given succesfully).
Upon navigating to the DeliwiAi setup page, the installer will use pop-ups to ask for a second set of Entra ID consents. Some browsers block these by default. Unblock pop-ups from the site and reload/refresh site again to get it working.
In the installation process, teamsbot application will be installed (as of 07.05.2024, teamsbot installation through installer does not work and must be installed manually, see below).
The installer will also ask which people from Entra ID will be given admin status. Ensure that you give yourself admin status to avoid getting locked out of the system.
Teamsbot installation
Currently Teams bot must be manually installed to company Teams application catalog.
This can be done from Teams admin center:https://admin.teams.microsoft.com/policies/manage-appsFrom top right corner select “Actions” and “Upload new app”. Upload Teams bot manifest.zip there and email created “App ID” to Deliwi team (see email in the beginning).
Download the manifest.zip below:
We will get back to you when the backend setup has been done.
7: Install DeliwiAI Teams Bot
The installer will prompt Teamsbot installation. This action requires that the installer has administrator rights to the administrator rights to Teams Admin Center*
DeliwiAI –installer
The installer can be started from address, sent to the admin email after software packages have been pushed to Azure resources.
Before going to the installer, please accept companywide consents links from the completion email. As of 07.05.2024 these links do not forward browser properly and give errors (even though consent was given succesfully).
Upon navigating to the DeliwiAi setup page, the installer will use pop-ups to ask for a second set of Entra ID consents. Some browsers block these by default. Unblock pop-ups from the site and reload/refresh site again to get it working.
In the installation process, teamsbot application will be installed (as of 07.05.2024, teamsbot installation through installer does not work and must be installed manually, see below).
The installer will also ask which people from Entra ID will be given admin status. Ensure that you give yourself admin status to avoid getting locked out of the system.
Teamsbot installation
Currently Teams bot must be manually installed to company Teams application catalog.
This can be done from Teams admin center:https://admin.teams.microsoft.com/policies/manage-appsFrom top right corner select “Actions” and “Upload new app”. Upload Teams bot manifest.zip there and email created “App ID” to Deliwi team (see email in the beginning).
Download the manifest.zip below:
We will get back to you when the backend setup has been done.
8: Add Administrators
Congratulations - the technical installation of DeliwiAI is now 99% complete!
As the final step, invite the person or people responsible for launching and daily operations of the DeliwiAI service. Typically, these individuals are from HR, communications, or business operations.
Enter their email addresses in the field provided. They will automatically receive an invitation to the service and can begin using it. It is advisable to include also your own (technical admin) email address in the group of invitees.
DeliwiAI –installer
The installer can be started from address, sent to the admin email after software packages have been pushed to Azure resources.
Before going to the installer, please accept companywide consents links from the completion email. As of 07.05.2024 these links do not forward browser properly and give errors (even though consent was given succesfully).
Upon navigating to the DeliwiAi setup page, the installer will use pop-ups to ask for a second set of Entra ID consents. Some browsers block these by default. Unblock pop-ups from the site and reload/refresh site again to get it working.
In the installation process, teamsbot application will be installed (as of 07.05.2024, teamsbot installation through installer does not work and must be installed manually, see below).
The installer will also ask which people from Entra ID will be given admin status. Ensure that you give yourself admin status to avoid getting locked out of the system.
Teamsbot installation
Currently Teams bot must be manually installed to company Teams application catalog.
This can be done from Teams admin center:https://admin.teams.microsoft.com/policies/manage-appsFrom top right corner select “Actions” and “Upload new app”. Upload Teams bot manifest.zip there and email created “App ID” to Deliwi team (see email in the beginning).
Download the manifest.zip below:
We will get back to you when the backend setup has been done.
*After the installation is done, teamsbot can be found in the Admin Center by searching for “Deliwi” in Manage Apps –section.
DeliwiAI –installer
The installer can be started from address, sent to the admin email after software packages have been pushed to Azure resources.
Before going to the installer, please accept companywide consents links from the completion email. As of 07.05.2024 these links do not forward browser properly and give errors (even though consent was given succesfully).
Upon navigating to the DeliwiAi setup page, the installer will use pop-ups to ask for a second set of Entra ID consents. Some browsers block these by default. Unblock pop-ups from the site and reload/refresh site again to get it working.
In the installation process, teamsbot application will be installed (as of 07.05.2024, teamsbot installation through installer does not work and must be installed manually, see below).
The installer will also ask which people from Entra ID will be given admin status. Ensure that you give yourself admin status to avoid getting locked out of the system.
Teamsbot installation
Currently Teams bot must be manually installed to company Teams application catalog.
This can be done from Teams admin center:https://admin.teams.microsoft.com/policies/manage-appsFrom top right corner select “Actions” and “Upload new app”. Upload Teams bot manifest.zip there and email created “App ID” to Deliwi team (see email in the beginning).
Download the manifest.zip below:
We will get back to you when the backend setup has been done.