Oracle Cloud Infrastructure Documentation

Skype for Business

When you set up a Skype for Business channel, users can chat with your digital assistant (or standalone skill) through the Skype for Business user interface.

Here's the process for setting up a channel:

  1. You create a bot registration in Microsoft Azure to integrate with your digital assistant.
  2. Using the app ID and password from the bot registration, you create a channel in Digital Assistant .
  3. You copy the webhook URL that is generated when you create the channel and add it to the bot registration.
  4. Your Skype for Business tenant administrator adds the bot to the tenant.
  5. You test the digital assistant through the Chat window in the Skype user interface.

Step 1: Create a Bot Channels Registration in Azure

To make your digital assistant (or standalone skill) available in Skype for Business, you need to have it registered through Azure Bot Service.

Before you create that registration, you need to have a Microsoft account.

To create the registration:

  1. Go to https://portal.azure.com/ and log in with your Microsoft account.

  2. In the Search field, search for and select Bot Channels Registration .

  3. On the Bot Channels Registration page, fill in the Bot Name field with the name you want to appear for its entry in the Chat window in Skype for Business.

  4. Fill in the rest of the required fields.

  5. Scroll down and select Auto create App ID and password and then click the button for Auto create App ID and password in the panel that opens up.

  6. Click Create.

  7. Wait a minute or two for the bot registration to be created and deployed.

    When it completes, you will get a notification that the deployment succeeded.

  8. In the notification, click Go to resource.

    If the notification disappears before you can click on it, you can open it up again by clicking the Notifications icon at the top of the page.
    Description of azure-notification.png follows
    Description of the illustration azure-notification.png

  9. In the left navigation bar, under Bot Management, select Settings.
  10. Copy the value of the Microsoft App ID and save it in a safe place.

  11. Generate and save a client secret. You can do this by:
    1. Clicking the Manage button that is next to the app ID.

      This takes you to the Microsoft Bot Framework console.

    2. Clicking View this app in the Azure portal.

      This returns you to Azure.

    3. In the left navigation, clicking Certificates & secrets.
    4. Clicking + New Client Secret.
    5. Clicking Add.
    6. Copying the client secret and saving it to a safe place on your system.

    You'll need both the app ID and client secret to configure the channel in Digital Assistant.

  12. Now that you have the client secret copied, close the Certificates & secrets dialog.
  13. Leave the Azure Portal open in your browser.

    You'll later complete the registration with a webhook URL that you get when you create the channel in Digital Assistant.

Step 2: Create a Channel in Digital Assistant

  1. In Digital Assistant, click Channels in the left menu and then choose Users.

  2. Click + Channel to open the Create Channel dialog.

  3. Give your channel a name.

  4. Choose Skype For Business as the channel type.

  5. Fill in Microsoft Application Id with the Microsoft App ID that you obtained when you created your bot registration in Azure.

  6. Fill in Microsoft Application Password with the client secret that you obtained from your bot registration.

  7. Click Create.

  8. In the Channels page, copy the WebHook URL and paste it somewhere convenient on your system.

  9. Click icon for the Route To ... dropdown and select the digital assistant or skill that you want to associate with the channel.

  10. Switch on the Channel Enabled control.

Step 3: Configure the Webhook URL for Skype for Business

  1. In the browser tab where you have Azure Portal open, use the Search field to navigate back your bot registration.

  2. In the left navigation bar, select Settings.

  3. In the Messaging endpoint field, paste the webhook URL that you obtained when creating the channel in Digital Assistant.

  4. Within Bot Service in the left navigation bar, scroll down to the Bot Management section and click Channels.

  5. Click the icon for Skype and then click Save.

Step 4: Add the Bot to Your Skype for Business Tenant

Once you have the created the bot registration in Azure and the channel in Digital Assistant, you need to add the bot to your Skype for Business tenant. See https://docs.microsoft.com/en-us/skype-sdk/skype-for-business-bot-framework/docs/overview#add-a-bot-to-skype-for-business.

Step 5: Test Your Bot in Skype for Business

With the your bot (digital assistant or skill) added to Skype for Business you can now test it in Skype for Business.

  1. Open Skype for Business.

  2. Click Chats, click the Chat button, select New Chat.

  3. In the New Chat window, use the Search field to find your bot.

  4. In the Type a message here field, start communicating with your digital assistant.

Supported Capabilities

Skype for Business channels in Digital Assistant support the following capabilities:

  • text (both sending and receiving)
  • emojis (partial support for sending, full support for receiving)
  • links
  • carousel components (partial support)
  • list components (partial support)

Message Constraints

Skype for Business channels in Digital Assistant have the following message constraints:

  • Text Messages
    • Maximum length of text action label: 1 line (about 50 characters)
    • Types of text actions allowed: Postback, Call, URL
  • Horizontal Cards
    • Maximum length of title: 2 lines (about 80 characters)
    • Maximum length of description: 25,000 characters
    • Maximum length of card action label: 1 line (about 50 characters)
    • Maximum number of cards: 10
    • Maximum number of card actions: 6. If the number of card actions exceeds 6, the card is duplicated to render remaining card actions.
    • Minimum number of card actions: 0
    • Maximum number of card list actions: 6
    • At least one description, image or action required?: No
    • Types of card actions allowed: Postback, Call, URL
    • Types of card list actions allowed: Postback, Call,URL
  • Vertical Cards
    • Maximum length of title: 2 lines (about 80 characters)
    • Maximum length of description: 25,000 characters
    • Maximum length of card action label: 1 line (about 50 characters)
    • Maximum number of cards: 10
    • Maximum number of card actions: 3
    • Minimum number of card actions: 0
    • Maximum number of card list actions: 6
    • At least one description, image or action required?: No
    • Types of card actions allowed: Postback, Call, URL
    • Types of card list actions allowed: Postback, Call, URL
  • Attachment Messages
    • Supported?: Yes
    • Types of actions allowed: Postback, Call, URL
  • Action Buttons
    • Maximum length of global action label: 1 line (about 50 characters)
    • Maximum number of global actions: 6
    • Types of global actions allowed: Postback, Call, URL