Jaa


Connect a bot to channels

APPLIES TO: SDK v3

A channel is a connection between communication applications and a bot. A bot, registered with Azure, uses channels to facilitate the communication with users.

You can configure a bot to connect to any of the standard channels such as Alexa, Cortana, Facebook Messenger, and Slack. For more information, see Bot channels registration.

In addition to the provided channels, you can also connect a bot to your communication application using Direct Line as the channel.

The Bot Framework allows you to develop a bot in a channel-agnostic way by normalizing messages that the bot sends to a channel. This involves the following:

  • Convert the messages from the Bot Framework schema into the channel's schema.
  • If the channel does not support all aspects of the Bot Framework schema, the Bot Connector service tries to convert the message to a format that the channel does support. For example, if the bot sends a message that contains a card with action buttons to the email channel, the connector may send the card as an image and include the actions as links in the message's text.
  • For most channels, you must provide channel configuration information to run a bot on the channel. Most channels require that a bot have an account on the channel. Others, like Facebook Messenger, require a bot to have an application registered with the channel also.

To configure a bot to connect to a channel, complete the following steps:

  1. Sign in to the Azure Portal.

  2. Select the bot that you want to configure.

  3. In the Bot Service blade, click Channels under Bot Management.

  4. Click the icon of the channel you want to add to your bot.

    Connect to channels

After you've configured the channel, users on that channel can start using your bot.

Connect a bot to a channel

The connection steps are different for each channel. See the related article in the table below more information.

Channel Description
Cortana Send and receive voice messages in addition to textual conversation.
Direct Line Integrate a bot into a mobile app, web page, or other applications.
Office 365 email Enable a bot to communicate with users via Office 365 email.
Facebook Connect a bot to both Facebook Messenger and Facebook Workplace, so that it can communicate with users on both platforms.
Kik Configure a bot to communicate with users through the Kik messaging app.
LINE Configure a bot to communicate with users through the LINE app.
Microsoft Teams Configure a bot to communicate with users through Microsoft Teams.
Skype Configure a bot to communicate with users through Skype.
Skype for Business Configure a bot to communicate with users through Skype for Busines.
Slack Configure a bot to communicate with users through Slack.
Telegram Configure a bot to communicate with users through Telegram.
Web Chat Automatically configured for you when you create a bot with the Bot Framework Service.

Publish a bot

The publishing process is different for each channel.

Cortana

Bots are published to Cortana from the dashboard and are used to power Cortana skills. Publishing a bot submits it for review. Cortana skills can be deployed for your own use, deployed to a small group, or published to the world.

Skype

Note

As of October 31, 2019 the Skype channel no longer accepts new Bot publishing requests. This means that you can continue to develop bots using the Skype channel, but your bot will be limited to 100 users. You will not be able to publish your bot to a larger audience. Current Skype bots will continue to run uninterrupted. Read more about why some features are not available in Skype anymore.

Bots are published to Skype from the configuration page. Publishing a bot submits it for review. Before review, the bot is limited to 100 contacts. Approved bots do not have limited contacts and you may opt to have the bot included in the Skype bot directory.

Skype for Business

Important

Skype for Business Online will retire on July 31, 2021. Skype for Business Online customers should see no change to the service before the retirement date. Read Skype for Business Online to Be Retired for more details.

Skype for Business bots are registered with a Skype for Business Online tenant by a Tenant Administrator.

To view the status of a review, open the bot in the Bot Framework Portal and click Channels. If the bot is not approved, the result will link to the reason why. After making the required changes, resubmit the bot for review.

Additional resources

The SDK includes samples that you can use to build bots. Visit the Samples repo on GitHub to see a list of samples.