← All Topics

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.

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 the YakBot.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 Down Arrow on the right hand side of the Add button and then click on “Add to a team”

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

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.

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.

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.

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.

step 12

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

Then click Next.

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.

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.

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)

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.

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.

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.