Breadcrumbs

Update to PortalTalk V2.5


To perform the update to PortalTalk V2.5, these administrative roles are required:

  • Global Admin in Microsoft 365, to do the PortalTalk App Consent

  • MS Teams Admin, to update the PortalTalk MS Teams app

  • PortalTalk Admin in PortalTalk, to make changes to the PortalTalk configuration (optional)


Steps to perform:

  1. Update PortalTalk’s permissions within your Microsoft 365 tenant. This is also referred as ‘the consent’.

  2. Updating the Portaltalk MS Teams V2.5 app

If the above actions are not executed, certain new functions of PortalTalk V2.5 will not work. Although, the old MS Team app will work correctly.

These are the new permissions we request you to consent.

  • Read all channel settings

  • Read all Apps in Catalog

  • Files Read All

  • Channel Members Read All

  • Team Members Read All

These new permissions are needed to build the data for the new analytic services to get the activity statuses of SharePoint and MS Teams workspaces/channels.

Execution

  1. Make sure you're signed in to Microsoft 365 as a Global Admin

  2. Navigate to the PortalTalk web UI via PortalTalk

  3. At the top of the screen a notification shows the consent needs to be updated ('Because of a new software version, the consent has to be updated.')

    image-20230627-124303.png

  4. In the yellow update bar, click the ‘Start Consent’ button

  5. You will be prompted to log on again. NOTE: this must be done by a Global Admin account

  6. The screen below is displayed. Click on 'Accept' and the additional consent will be added.

    PT 2.4 consent (qsdemo).jpg

  7. The required consent is hereby granted and ready for PortalTalk Release 2.5

Update you current PortalTalk MS Teams app V.2.5

  1. Start downloading the new MS Teams PortalTalk V2.5 app. You can find it on this page ‘Downloads for PortalTalk’

  2. Open the Microsoft Teams admin center

  3. At the main left menu choose: Teams Apps → Manage Apps

    image-20220913-133227.png

  4. At the search-box, search for ‘PortalTalk'. There should be only one app listed.

  5. In this example it is version 2.1, but can be any version lower then 2.5 in your case

  6. Click on the app name and it will be opened

    image-20220913-133243.png

  7. Click on ‘Upload file’

    image-20220913-133305.png

  8. A dialog to upload a file is selected. Select your downloaded PortalTalk MS Teams V2.5.zip file and click ‘OK’

  9. The app will be uploaded and updated now

  10. As soon as completed, the app should show version 2.5

    image-20230627-132637.png

  11. And your done. It could take up to 24 hours before the app update is visible to the end users. All the new functions of the 2.5 release can be used as soon as the update is active.

  12. You can speed up this process by log-off/login your MS Teams app. The update should be available in a short moment. This is only working for one user and one MS Teams app at the time.