Changes in the Microsoft bot framework resulted in some customers experiencing issues with the YakBot version 1.0.3. It’s easy to upgrade to YakChat version 2.0 that combines they same YakChat messaging app (1.0.3) with a new YakBot using the instructions provided below.
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.
Step 1: Download YakChat
Download YakBot 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.
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.
Step 3: Add YakChat to your Microsoft Teams Channel
Once the YakChat app has been installed, click on Apps and search for YakBot and click on the YakBot 2.0 app.
The Microsoft Teams installation window will be displayed. Click the Down Arrow on the right hand side of the Add button and then click on “Add to a team”
Enter the team or channel name to search for the required Teams channel, select the required Teams channel and click on the Set up button.
Step 4: Connect your Teams Channel your YakChat Shared Inbox
The YakBot installer window will be displayed. Click on the ‘Sign in’ button, and sign in using your Microsoft 365 Account ID and password to connect your Teams Channel to your YakChat Shared Inbox.
If you have not installed YakBot 2.0 before, a Microsoft notification window will be displayed requesting additional permissions. If you have previously provided YakBot 2.0 permission the skip to Step 6.
Step 5: Provide Microsoft Admin Consent
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.
If you are not the Microsoft Teams or Azure administrator, you will now be presented with a link to enable your Microsoft Azure Administrator to sign in and provide consent.
Step 6: Select Shared Inbox
The options provided differ depending on the following:
- Whether you have just one YakChat Shared inbox [a] or mutliple inboxes [b]
- or if you are moving a Shared inbox that is already associated with another Teams channel [c]
Refer to the appropriate section below:
a) Adding a single inbox for the first time
If you just have one YakChat Shared inbox that has not been previously linked to another channel then simply click on the ‘Confirm’ button to continue.
b) Adding one of multiple Shared inboxes
Select the YakChat Shared Inbox that you wish to associate with your Teams channel and click on the ‘Save’ button.
c) Moving a previously linked Shared inbox
Confirm that you wish to unlink the YakChat Shared inbox from the previously linked Teams channel and add to this channel. If you wish to cancel this process, simply close the window using the ‘x’ or click on the ‘Back’ button to select a different YakChat Shared inbox (if you have multiple inboxes).
Step 7: Save to add YakBot to the Teams Channel
Click on the ‘Save’ button and YakChat will be added as a new ‘YakChat’ tab into your Teams channel.
Step 8: Sign into the YakBot
Finally, to enable YakBot to notify your Team when a new text is received, you now need to sign in to YakBot. Once signed in, all your team will receive notifications.
To sign in to YakBot type “@yakbot” (in the same way as you would mention another team member) and click on the YakBot 2.0 listed. Then type “Sign in” or select Signin from the menu that is displayed.
A Sign In adaptive card will be displayed by YakBot. Click on the Sign In button and enter your Microsoft credentials (this is the last time you will need to signin).
Note: 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 8.
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.
Type “@yakbot” to see the menu of what you can do !
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.