Help Center

Check out our Help Center to get the most from YakChat®

How to Install YakBot 2.0 into Microsoft Teams

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.

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. 

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.

Screenshot installing YakChat

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.

Screenshot installing YakChat

Click on Manage your apps at the bottom of the Store menu in Microsoft Teams and then click on Upload a customised app.

Screenshot of Teams Customized app upload

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 file in your browser’s default download folder.

Then click Open.

Screenshot of adding YakBot into Teams

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.  

Screenshot of adding YakBot into Teams

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”

Screenshot of adding YakBot into Teams

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.

Screenshot of adding YakBot into Teams

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.

Signing into YakChat within a Teams Channel !

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

Click Continue.

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.  

Screenshot of Microsoft Admin 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. 

Signing into YakChat within a Teams Channel

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.  

Signing into YakChat within a Teams Channel 2

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).    

Signing into YakChat within a Teams Channel 3

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.

Signing into YakChat within a Teams Channel 4

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.

Signing into YakChat within a Teams Channel 5
Signing into YakChat within a Teams Channel 6

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.

Screenshot of signing into YakBot in Teams

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.

Type “@yakbot” to see the menu of what you can do !

Screenshot of YakChat bot 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.

Was this helpful?