Setup Microsoft configuration

Create the Microsoft Application

1. Go to https://apps.dev.microsoft.com and login using your Microsoft account credentials
   
   
   
   
   
2. Click on Add an app 
   
   
   
   
3. Choose an Application Name and click on Create
   
   
   
   
4. Click on Generate New Password 
   
   
   
   
5. Store the new generated password and the Application id somewhere safe because you will need later.
   
   
6. Scroll down to the end of the page and click on Save.
   If the save was successful, you can close the browser's window; otherwise restart the process.

Create and deploy the Skype for Business Bot

Add new Azure resource

1. Go to https://portal.azure.com and login using your Microsoft account credentials
   
   
   
   
2. Click on Create a resource
3. Type bot in the search box and click on the suggestion Bot Channels Registration
   
   
   
   
4. Click on Create
   
   
   
   
5. If you don't already have an active Azure subscription, signup for a free one by clicking on Start free
   
   
   
   
6. Click on Start free
   
   
   
   
7. Fill all the required fields in order to activate your new subscription
   
   
   
   
8. Enter all the required information (Note: you may have to repeat steps 2 to 4 if you are redirected to the Azure Dashboard)
9. Click on Auto create App ID and password
10. Click on Create New
11. Enter the Microsoft App Id and Password of the Microsoft Application you created previously and click on OK
12. Click on Create
    
    
    
    
13. Wait until that the deployment has succeeded and click on Go to resource

Set the Skype For Business Channel

1. Click on Channels
   
   
   
   
2. Click on Skype for Business
   
   
   
   
3. Agree to the Terms of Service and click on Done
   

Register the Skype for Business Bot

Requirements

1. 64-bit computer running one of the following operating systems

   • Windows 10

   • Windows 8.1

   • Windows 8
   • Windows Server 2012 R2
   • Windows Server 2012
   • Windows Server 2008
   • Windows 7

2. Windows PowerShell 3.0 

   https://docs.microsoft.com/en-US/SkypeForBusiness/set-up-your-computer-for-windows-powershell/download-and-install-windows-powershell-3-0

Full Microsoft documentation: https://docs.microsoft.com/en-US/SkypeForBusiness/set-up-your-computer-for-windows-powershell/set-up-your-computer-for-windows-powershell

Register the bot to your domain

1. Download and install the Skype for Business Online Connector module
   https://www.microsoft.com/en-us/download/details.aspx?id=39366
   

2. Run Windows PowerShell as Administrator and type the following commands

   Import module

   Set-ExecutionPolicy unrestricted
   Import-Module SkypeOnlineConnector

   Login as a tenant administrator

   Import-PSSession (New-CsOnlineSession -Credential (Get-Credential))

   Add a new endpoint

   New-CsOnlineApplicationEndpoint -ApplicationId <YOUR_MICROSOFT_APPLICATION_ID> -Name <NAME_OF_THE_BOT> -Uri <URI>

   <YOUR_MICROSOFT_APPLICATION_ID>: the same Application ID used when you created the resource on Azure

   <NAME_OF_THE_BOT>: is the display name that will be shown in the Skype For Business client

   <URI>:  must be an unused SIP address in your domain and should contains only lowercase 

   
   

   

3. If everything went well you should see the registration recap.
   Note that it may take up to 60 seconds for the last command to execute and up to 8 hours for the endpoint to propagate.

Common errors: https://docs.microsoft.com/en-us/skype-sdk/skype-for-business-bot-framework/docs/bot-common-errors

Setup Motion configuration

Setup the Open Channel Account

Create a new Open Channel Account in your XCALLY Motion server in the Openchannel Section (click on ), configure the URL (depending on where the SkypeForBusiness service is running) and select a List where to search or store the Contacts:

Complete the Open Channel account configuration (Disposition, Action, etc).

Upload and install AppZone plugin

• Download and install the SkypeForBusiness Plugin you find in the App Zone Page (it will be inserted in the Plugins section)
  
  
• Configure the SkypeForBusiness Plugin according to Microsoft configuration
  
  
  
  In details:
  

  • Microsoft Application ID and Password

    They are the same used to register the bot resource on Azure

  • Webhook: by default is https://{HOSTNAME}/api/plugins/webhook?port={PORT}&encoding=binary&path=/api/messages

    
    

    Change {HOSTNAME} and {PORT} properties according to your configuration

  • Open Channel Account
  • Admin credentials
  • Port 
    
    
• Restart SkypeForBusiness Plugin from AppZone section