← All Topics

How to Install YakChat for Microsoft Teams

It’s quick and easy to install YakChat for Microsoft Teams. Our handy step-by-step guide shows you how.

Installation Instructions

Important: The .zip file must be uploaded into Microsoft Teams intact. Do not extract any files contained in the .zip file or the installation process will fail, even if the files are re-compressed into a new .zip file. Safari browsers are often set to automatically extract .zip files. This setting must be disabled. You can find Instructions on how to do that here.  

Step 1

Firstly, download YakChat App for Microsoft Teams into your default download folder, using the download button.  

As has been noted, you must ensure the .zip file is not unpacked. The whole .zip file must be uploaded into Microsoft Teams. 

Step 2

Now open Microsoft Teams. 

Then click on the Apps icon from the toolbar on the left.

Step 3

Click on Upload a Custom App. You can find it at the bottom of the Store menu in Microsoft Teams.*

Now continue to Step 5

*If, however, this option is not displayed, go to Step 4.

Step 4

If the Upload a custom app menu option is unavailable, then you’ll need to contact your Microsoft Teams administrator.

In order to turn on the Upload custom apps feature, visit the Teams apps/Setup policies menu in the Microsoft Teams admin center.

Step 5

Select YakChat for Teams .zip file in your browser’s default download folder. 

Then click Open.

Step 6

The Microsoft Teams Manifest window will be displayed.

Now click the Add button to add the YakChat app into Microsoft Teams.

Step 7

Microsoft Teams will provide a notification window requesting additional permissions. 

Click Continue.

Step 8

Microsoft’s authentication window will now be displayed. 

Simply sign-in with your Microsoft Teams email and password. You will also use these to login to YakChat.

Step 7

Microsoft’s permission window will be displayed  requesting your consent to access the YakChat App.

Click Accept to continue.

Step 8

If you are not the Microsoft Teams or Azure administrator, you will now be presented with a similar Microsoft permission request window but without the Consent on behalf of your organization option.

Click on the Accept button for a link that your administrator can use to provide admin approval.

Step 9

To connect your Microsoft 365 tenant with YakChat requires permission from your Microsoft Teams or Azure administrator.

If you are an administrator then you can approve  yourself by clicking on the Accept button.

To approve for another user tick the option: Consent on behalf of your organization. Then skip to step 10.

Step 10

If you are the Microsoft administrator and registered with YakChat the YakChat app will now be displayed.

If you are not the Microsoft administrator you will need to refresh the app and click Sign in

You may need to logout and back into Teams if this fails. 

Step 11

Just a few more steps to enable YakChat to provide you with new message notifications.

Click on the Chat tab, then click on the Type your questions here text box and type “Signin” or use the What I can do? menu.

Step 12

Another Microsoft’s authentication window will be displayed. 

Sign-in with your Microsoft Teams Account email and password. 

Step 13

The ‘bot’ sign in adaptive cards expire after about 10 minutes. which will result in the message The sign in code was was not found or expired message box.

If this message is displayed, type “signout” into the Type your questions here text box or select from the What I can do? menu and repea step 11.

You're in!

The “You have successfully signed in” message will be displayed so that you will now receive notifications in Teams when a new text message is received.

Click on the YakChat Tab and send your first message.

Next Step

Click on the Next button below to learn how to send your first message. 

YakChat SMS-enables Microsoft Teams for fast, compelling conversations. Connect instantly with your clients and co-workers anywhere in the world. You can add YakChat to your MS Teams or Skype for Business platform in minutes, so you’ll be up, running and texting in no time. What’s more, your contacts won’t have to download an app to get your texts. They can simply receive and reply to your messages in the same quick-and-easy way they do with family and friends. And whenever you need to keep your conversations going on the move, simply switch to our handy YakChat mobile app.
Tags: