This site is obsolete and should be used for reference only. The information in this documentation is not guaranteed to work for Bot Framework SDK versions past 4.9.1.

Known issues

HTTP 401 Error when invoking a Skill

If you experience a HTTP 401 (authentication) error when invoking a Skill with an exception message as shown: Exception Message: Error invoking the skill id: "SKILL_ID" at "" (status is 401)

Validate your parent Bot (e.g. Virtual Assistant) appSettings.json file has a correctly populated botFrameworkSkills section. For example you should see a complete fragment like the one shown below with the appId of each configured Skill. This should be populated automatically by the botskills CLI.

"botFrameworkSkills" : [
        "id": "calendarSkill",
        "name": "calendarSkill",
        "description": "The Calendar skill provides calendaring related capabilities and supports Office and Google calendars.",
        "appId": "SkillAppId",
        "skillEndpoint": "",

    "skillHostEndpoint": ""

HTTP 500 Error when invoking a Skill

If you experience a HTTP 500 (server error) error when invoking a Skill with an exception message as shown: Exception Message: Error invoking the skill id: "SKILL_ID" at "" (status is 500)

Validate your parent Bot (e.g. Virtual Assistant) appSettings.json file has a valid skillHostEndpoint which should be pointing at the URL of your Parent Bot (e.g. Virtual Assistant) with a suffix of /api/skills as per the example below. Skills connect back to the caller through this endpoint.

"botFrameworkSkills" : [
    { }],
    "skillHostEndpoint": ""

If you are debugging a parent bot locally and invoking a Skill remotely you will need to configure tunneling software (e.g. ngrok) to ensure this connection can be made back to the calling bot from the Skill. If you are using ngrok, follow these instructions:

  1. Start a debugging session for your Virtual Assistant and make a note of the port it’s hosted on (e.g. 3978)
  2. Assuming port 3978 run this command:L ngrok.exe http 3978 -host-header="localhost:3978"
  3. Retrieve the https forwarding URL (e.g. https:{name} and update skillHostEndpoint with this URL suffixed with /api/skills
  4. Now, when a remote skill is invoked it will route all responses back to https:{name} which will then tunnel responses back to your Virtual Assistant

My Microsoft App Registration could not be automatically provisioned

Some users might experience the following error when running deployment Could not provision Microsoft App Registration automatically. Please provide the -appId and -appPassword arguments for an existing app and try again. In this situation, create and register an Azure AD application manually.

Once created, retrieve the Application (ClientId) and create a new client secret on the Certificates & secrets pane

Run the above deployment script again but provide two new arguments appId and appPassword passing the values you’ve just retrieved.

NOTE: Take special care when providing the appSecret step above as special characters (e.g. @) can cause parse issues. Ensure you wrap these parameters in single quotes.

The message contains mention from the Teams channel

When a bot is called via mention(@) in Teams, the message will contain <at>YOUR_BOT_NAME<\at> and it will confuse LUIS sometimes. If you don’t need the mention part, you could modify your bot’s DefaultActivityHandler like below. The RemoveRecipientMention() function will remove mentions from turnContext.Activity.Text.

        public override async Task OnTurnAsync(ITurnContext turnContext, CancellationToken cancellationToken = default)
+            if (turnContext.Activity.ChannelId == Channels.Msteams)
+            {
+                turnContext.Activity.RemoveRecipientMention();
+            }

QnA Maker can’t be entirely deployed in a region other than westus.

QnAMaker has a central Cognitive Service resource that must be deployed in westus, the dependent Web App, Azure Search and AppInsights resources can be installed in a broader range of regions. We have therefore fixed this QnAMaker resource to be westus in the ARM template (template.json) which can be found in the deployment/resources folder of your Virtual Assistant. When deploying in a region such as westeurope all dependent resources will be created in the requested region. This script will be updated as new regions are available.

The introduction card isn’t displayed when a locale is missing

There is a known issue in the Virtual Assistant when the bot doesn’t pass a Locale setting at the beginning of the conversation, the Intro Card won’t show up. This is due to a limitation in the current channel protocol. The StartConversation call doesn’t accept Locale as a parameter.

When you’re testing in Bot Emulator, you can get around this issue by setting the Locale in Emulator Settings. Emulator will pass the locale setting to the bot as the first ConversationUpdate call.

When you’re testing in other environments, if it’s something that you own the code, make sure you send an additional activity to the bot between the StartConversation call, and the user sends the first message:

      from   : { id: userID, name: "User", role: "user"},
      name   : 'startConversation',
      type   : 'event',
      locale : this.props.locale,
      value  : ''
    .subscribe(function (id) {
      console.log('trigger "conversationUpdate" sent');

When you’re testing in an environment you don’t own the code for, chances are you won’t be able to see the Intro Card. Because of the current channel protocol behavior, we made this tradeoff so that we don’t show an Intro Card with a default culture that doesn’t match your actual locale. Once the StartConversation supports passing in metadata such as Locale, we will make the change immediately to support properly localized Intro Card.

If a resource has a firewall configured, the resource might not be reached by the bot

There is a known issue in the Azure resources with a firewall configured when the bot is trying to reach to the resource: {"code":"Forbidden","message":"Request originated from client IP <IP>. This is blocked by your <RESOURCE> firewall settings"}

You can check your network configuration in the Azure Portal as follows:

  1. Select your desired resource
  2. Select Firewall and virtual networks configuration
  3. Check the configuration of the Allow access from to enable all or selected networks
  4. If you have selected networks, check the configured networks

If you are using a C# bot and Bot Framework Emulator, you will see a trace when these kind of exceptions are caught by the onTurnError handler in order to identify the error.

Otherwise, if you are using a TypeScript bot, you should remove the showTypingMiddleware and add the onTurnError handler in the defaultAdapter:


    this.onTurnError = async (context: TurnContext, error: Error): Promise<void> => {
        await context.sendActivity({
            type: ActivityTypes.Trace,
            text: error.message || JSON.stringify(error)
        await context.sendActivity({
            type: ActivityTypes.Trace,
            text: error.stack
        telemetryClient.trackException({ exception: error });

For more information, check the following issues:

  • botbuilder-js#1599 - [BotBuilder-Core] Handle Uncaught Exceptions
  • #2766 - OnTurnError is not getting called in VA
  • botbuilder-js#726 - ShowTypingMiddleware suppresses errors and does not allow adapter.onTurnError to handle them
  • botbuilder-js#1170 - ShowTypingMiddleware provoke silent error behaviour

LUISGen error on Mac OSX during deployment

When deploying your Virtual Assistant or Skill on a Mac you may experience the following LuisGen error:

Luisgen : The term 'luisgen' is not recognized as the name of a cmdlet, function, script file, or operable program.
Check the spelling of the name, or if a path was included, verify that the path is correct and try again.
At /Users/BotPath/Deployment/Scripts/add_remote_skill.ps1:170 char:2
+     luisgen $dispatchJsonPath -cs "DispatchLuis" -o $lgOutFolder 2>>  ...
+     ~~~~~~~
+ CategoryInfo          : ObjectNotFound: (luisgen:String) [], CommandNotFoundException
+ FullyQualifiedErrorId : CommandNotFoundException

The root cause is discussed here whereby powershell isn’t expanding the ~ in the path. If you run $env:PATH within Powershell on your Mac you’ll see ~/.dotnet/toolsin the path which is where luisgen will have been installed. In fact if you run ~/.dotnet/tools/luisgen within powershell you should be able to execute it correctly.

The workaround at this time is to run this ahead of any of the Virtual Assistant deployment scripts.

$env:PATH += ":/users/YOUR_USER_NAME/.dotnet/tools"

Dispatch refresh failed with Exit Code 1 Error using ErrorActionPreference = Stop in PowerShell

There is a known issue in the dispatch refresh executed in the update_cognitive_models.ps1 of the C#/TypeScript bots, that if the user has configured $ErrorActionPreference = Stop in PowerShell, it will stop the execution raising the Exit Code 1 Error.

As a workaround the $ErrorActionPreference should be changed to Continue

$ErrorActionPreference = 'Continue'

See the following related documents: