Introduction
The following instructions explain how to install the iThink Connect Birthday app for Microsoft Graph.
The application is a Microsoft Viva Connections card that integrates with your Microsoft 365 environment. It is expected that it will becomes part of your Viva Connections experience in the Viva Connections app, Intranet Home page and Microsoft Teams Viva Connection App.
The application is made up of a Microsoft SharePoint SPFX Application Package.
Pre-requisites
You will need to accessing Microsoft 365 and SharePoint as a user who has the SharePoint Admin role within Microsoft Entra ID.
You will need to be or have access to a login or user who has been assigned the Global Administrator within Microsoft Entra ID (Formerly Azure Active Directory) role.
Installing the iThink Connect SharePoint Package
Now iThink Connect Birthday for Graph is available in the SharePoint Store, please install the application using the following instructions.
Firstly, go to your Microsoft SharePoint Homepage which has Microsoft Viva Connections Installed.
If you want to know how to configure Microsoft Viva Connections please follow these instructions, alternatively give us a call and we can setup your Intranet using our Intranet Accelerator.
Browse to your SharePoint Homepage and click on SharePoint Cog.
Click on View Dashboard to open Viva Connection Dashboard
- Click Edit
- Click the Add Card and scroll down the list and click on the add more cards.
This will open up the SharePoint Store and scroll down to find the Viva Connections cards.
Click on the Add App button.
If this is the first time that you have tried to install an application in SharePoint you might not have created a SharePoint App Catalog.
- Create a SharePoint App Catalog using the wizard that is displayed on your screen.
- Our recommendation is to call the site apps.
The Enable app screen will appear, we recommend that you choose “Only enable this app”. This gives more control over who has access to the application.
- Choose Only enable this app.
- Click Enable app.
Next you will be asked to approve access to this application. This will need a user to be present who is a Global Administrator within the tenant.
- Click Go to API access page.
The SharePoint API access page will appear.
In the list will be a pending request which will have the name iThink Connect Api.
This setup will allow the iThink Connect application to connect to the iThink Connect Api through SharePoint. This is all secure. We are asking for a minimal set of permissions including the ability to be able to access the Microsoft Graph to read people’s birthday information.
- Select the pending request.
- Choose Approve
The right-hand task pane will appear.
- choose the Approve button.
A new dialog will appear asking for consent to allow the iThink Connect Api application to have access to your tenant.
As mentioned previously this is to allow it to read your users profile information.
- Check the “Consent on behalf of your organisation”
- Click Accept
You will be taken to the iThink 365 Connect setup application.
This is where you will need to register with us and subscribe to the iThink Connect application. Without this subscription, the Birthday application will not work.
Keep the window open and follow the next steps.
Register for iThink Connect
Now you will need to register for iThink Connect.
You will see the following screen.
- Scroll down and click the “Get started – sign in” button.
- Accept the consent for iThink Connect Customer Portal” if it pops up. This allows iThink Connect to read your user information and is need to continue.
- Click “Consent on behalf of your organisation”
- Click Accept
You will be presented with the Start iThink Connect Setup page.
- Check the email address at the top of the screen.
- Click Start iThink Connect Setup button
You will be taken through a setup wizard.
- Please fill out your company size.
- Please choose the domain that you use as your primary domain.
- Please fill out your details, and company address.
- Choose Yes to accept the confirmation to setup iThink Connect for the tenant.
- Click Submit.
You will be presented with screen two of the Setup Wizard.
If you have not consented to the iThink Connect Api then you will be asked to consent the application.
- Click “Consent iThink Connect Api”
- Login with your credentials.
- Check the permissions requested and click Accept.
You will receive congratulations, consent to the iThink Connect Api was successful.
You will have automatically be assigned a trial subscription to the iThink Connect Birthday app for six months.
- Close down the dialog and follow the next set of instructions to add the card to your Microsoft Viva Connections dashboard.
Adding iThink Connect App to Viva Connections Dashboard
Browse to your Microsoft SharePoint homepage which hosts your Intranet.
The URL is the same as the SharePoint Admin site without the -admin
So, for example
- https://acme-admin.sharepoint.com would become https://acme.sharepoint.com
Next, we need to configure your Microsoft Viva Connections Dashboard. The instructions assume you have an Intranet homepage and are configured for Microsoft Viva Connections. If you have not then please follow the instructions here to get setup.
https://learn.microsoft.com/en-us/viva/connections/set-up-admin-center
or
Alternately, come and use our Microsoft 365 Intranet Accelerator ?.
- Click on the SharePoint Cog.
- Choose Add an app
Find the iThink Connect app to add to the site.
- Click Add and wait for the button to change to Added.
- Click, on the “Back to Intranet (your name maybe different)
Now you are ready to add the application to your Microsoft Viva Connections Dashboard.
- Click on the SharePoint Cog.
- Choose Manage Viva Connections
- Scroll down and choose “View Dashboard”.
With the dashboard open.
- Click Edit.
- Click “Add a card”.
- Choose Birthday card
Change the size of the card to Medium using the edit web part.
When happy with the card size.
- Click Republish.
The card will now appear in your Microsoft Viva Connections Dashboard.
