Troubleshoot bot configuration issues
The first step in troubleshooting a bot is to test it in Web Chat. This will allow you to determine if the problem is specific to your bot (bot doesn't work in any channel) or to a particular channel (bot works in some channels but not others).
Test in Web Chat
- Open your bot resource in the Azure Portal.
- Open the Test in Web Chat pane.
- Send your bot a message.
Bot does not work in Web Chat
There could be a number of reasons why a bot doesn't work. Most likely, the bot application is down and cannot receive messages, or the bot receives the messages but fails to respond.
To see if the bot is running:
- Open the Overview pane.
- Copy the Messaging endpoint and paste it into your browser.
If the endpoint returns an error "This site can't be reached" or "can't reach this page", that means that your bot is down and you need to redeploy it.
Bot works in Web Chat but not in other channels
If the bot works as expected in Web Chat but fails in some other channel, possible reasons are:
Channel configuration issues
It's possible that channel configuration parameters have been set incorrectly or have changed externally. For example, a bot has configured the Facebook channel for a particular page and the page was later deleted. The simplest solution is remove the channel and redo the channel configuration anew.
The links below provide instructions for configuring channels supported by the Bot Framework:
- Microsoft Teams
- Skype for Business
Implementation of some features can differ by channel. For example, not all channels support Adaptive Cards. Most channels support Buttons, but they are rendered in a channel-specific way. If you see differences in how some message types work in different channels, consult the channel reference.
Below are some additional links that can help with individual channels:
- Add bots to Microsoft Teams apps
- Facebook: Introduction to the Messenger Platform
- Principles of Cortana Skills design
- Skype for Developers
- Slack: Enabling interactions with bots
Occasionally, some channels might have an interruption of service. Usually, such outages don't last long. However, if you suspect an outage, consult a channel web site or social media.
Another way to determine if a channel has an outage is to create a test bot (such as a simple Echo Bot) and add a channel. If the test bot works with some channels but not others, that would indicate that the problem is not in your production bot.
See how-to debug a bot and the other debugging articles in that section.