How to Install YakBot into a Teams Channel #

It’s quick and easy to install YakBot into a Teams Channel (for YakChat Shared plans only). Our handy step-by-step guide shows you how.

The YakChat Bot is used in combination with the
YakChat App which should be installed first.

Instructions: Install YakBot for Microsoft Teams #

Important: Make sure that you upload the .zip file into Microsoft Teams intact. It is most important that you do not extract any files contained in the .zip file, otherwise the installation process will fail, even if you re-compress the files into a new .zip file.

Because Safari browsers are often set to automatically extract .zip files, you must disable this setting. You can find Instructions on how to do that here.  

Step 1 #

In order to download YakBot for Microsoft Teams, click the Download button below. 

As has been noted, it is particularly important that the zip file is not unpacked. The whole zip file must be uploaded into Microsoft Teams.

Screenshot of How to install YakBot for 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: 

YakBot for Microsoft Teams

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

Then click Open.

Screenshot of Installing YakChat Teams App

Step 6 #

The Microsoft Teams Manifest window will be displayed.

Now click the Down Arrow on the right hand side of the Add button and then click on “Add to a team”

Teams Channel YakBot Sign in

Step 7 #

Enter the team or channel name to search for the required Teams channel.

Now select the required Teams channel and click on the Set up button..

Teams Channel YakBot Installation

Step 8 #

If the Microsoft’s authentication window displayed, simply sign-in with your Microsoft Teams email and password. You will also use these to login to YakChat.

Screenshot of Installing YakChat Teams Bot

Step 9 #

To connect your Microsoft 365 tenant with YakChat requires permission from your Microsoft Teams or Azure administrator.  This is only required once to enable any user in the organization to use YakBot.

If YakBot has not been installed elsewhere in your organization and you are an administrator, you can approve yourself by clicking on the Accept button,

To approve your whole organization, you can also tick the option: Consent on behalf of your organization. Then skip to step 11.

If you are not an administrator go to to Step 10.

Screenshot of Installing YakChat Teams Bot

Step 10 #

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.

Screenshot of Installing YakChat Teams App

Step 11 #

If Skip to step 14 if you have already installed and registered, using the YakChat App.

If this the first time you’ve used YakChat, and you’ve not pre-purchased the service, you will now be asked to complete YakChat’s Free Trial Registration page. 

On the first page, simply enter:

1) Your name

2) Your MicrosoftTeams login email address

3) Your contact number

Then click Next.

Screenshot of Installing YakChat Teams App

step 12 #

Complete the Company details page, and confirm to which country your texts will be sent. 

Then click Next.

Screenshot of Installing YakChat Teams App

Step 13 #

Finally, confirm you have read the Terms and Conditions and are happy to receive updates and marketing information from YakChat.

Then click Finish.

Screenshot of Installing YakChat Teams App

Step 14 #

YakChat Bot will now be displayed in Microsoft Teams.

If the Sign-In button is displayed, click on it and log-in using your Microsoft 365 account again.

YakBot may ask you to type a message in the Type your questions here box but this can be ignored when installing into a Teams channel.

Teams Channel YakBot Installation

Step 15 #

After authentication type “@yakbot” in the Start a new conversation here box, click on the @YakBot contact suggestion and then click Send (or press Return)

Teams Channel YakBot Installation

Step 16 #

The bot will display the email address and number of the Shared numbers in your subscription.  Select the radio button beside the required Shared number to link the bot to the Teams channel and click the Add button.

Teams Channel YakBot Installation

Step 17 #

To check the bot is working, simply type “@yakbot” again in the Start a new conversation here box, click on the @YakBot contact suggestion and then click Send (or press Return).

This time YakBot should respond with the adaptive card requested the number send the text to which means you are now signed in correctly.

Teams Channel YakBot Installation

Last Step #

Click Next to learn how to send your first text 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.

What are your feelings