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. https://www.youtube.com/watch?v=fZ2han_Er0w
Step 1: Download YakChat
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: Go to the Apps Menu in Microsoft Teams
Now open Microsoft Teams. Then click on the Apps icon from the toolbar on the left.
Click on Manage your apps at the bottom of the Store menu in Microsoft Teams and then click on Upload a customised app.
Click on Manage your apps. You can find it at the bottom of the Store menu in Microsoft Teams.
Click on Publish an app that is located at the top.
Then click on Upload a customised app in the pop-up window.
If the Upload a customised app option is not displayed, then click on Submit and app to your org and after adding the app, contact your Microsoft Teams administrator to approve the app using the Teams Administration Portal. Once approved, you will need to sign out and back in to Teams and go to Step 3.
Select YakChat.zip file in your browser’s default download folder.
Then click Open.
The Microsoft Teams Manifest window will be displayed.
Now click the Add button to add the YakChat app into Microsoft Teams.
Step 3: Sign in using Microsoft Credentials
Microsoft Teams will provide a notification window requesting additional permissions.
Click Continue.
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 4: Provide Microsoft Admin Consent
Microsoft’s permission window will be displayed requesting your consent to access the YakChat App.
Click Accept to continue.
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 6.
Step 5: Provide Microsoft Admin Consent
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 6: Sign into the YakChat Messaging App
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 7: Sign in for Teams Notifications
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.
Another Microsoft’s authentication window will be displayed.
Sign-in with your Microsoft Teams Account email and password.
Step 8: Sign in Expired
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 repeat step 7.
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
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.
