ボットにMicrosoft Teamsチャネルを追加するには、Microsoft Bot Frameworkアカウントにボットを作成して、Microsoft TeamsとKore.ai間の接続を構成する必要があります。ボットにMicrosoft Teamsチャネルを追加するには、以下のステップに従います。

  • ボットの登録―すべてのボットの詳細を追加し、アプリIDとパスワードを作成して、Microsoft Bot Frameworkにボットを作成する必要があります。自分のボットを登録するには、Microsoft Bot Framework 開発者ポータルで無料アカウントを作成して登録しておく必要があります。
  • チャネルの有効化―ボットを登録した後、チャネルを有効にします。
  • チャネルの公開―チャネルを有効にしてすべての構成を確認したら、必要に応じてボットを公開して開発者が利用できるようにすることができます。

Register the Bot with Microsoft Teams channel

To set up Microsoft Teams as a channel, you must register a Bot Channel service in Azure and enable a webhook for the platform to receive messages.
You need an active subscription to Azure services with admin access to subscribe for a new Azure service.

Register a Bot Channel

  1. Log in to the Microsoft Bot Framework portal.
  2. On the portal menu, click + New.
  3. Search and select Bot Channels Registration from the search window.
  4. Click Create and proceed to the next screen to enter the details.
  5. Enter all the required details to register the bot channel.
  6. From the Bot Builder platform, copy the Webhook URL from the Configurations tab of the Channel page for Microsoft Teams and provide it in the Messaging Endpoint field.

App Association

The Bot Channel Regsitration must be associated with a Microsoft App ID and Password. You can choose to go with the default option of Auto-create App Id and password if you want your bot to be available for multiple tenants or users outside of your Azure domain.

Note: You need to select multi tenant option for the Type of App while configuring an Azure bot. Configuration fails if single tenant is selected.

You can also choose to create your own App ID and password and define who is eligible to access your bot. Follow the instructions available here for more details.

  1. Click Create to complete the registration.
  2. After successful creation, you are redirected to the Dashboard of your Azure account.

Configure App Id and Password

From your Azure Dashboard, select the resource that you have created in the previous steps. You are redirected to the details page of the new resource that you have created.

  1. On the left pane, click Settings > Manage next to the Microsoft App ID field.
  2. Click Generate New Password to create a new password for your app.
  3. Make a note of the password displayed on the pop-up screen and enter it in the Configurations tab of the MS Team channel enablement page on the bots platform.
  4. Click Ok to go back to the previous screen.
  5. Make a note of the App ID and enter in the ‘Configuration’ tab of the MS Team channel enablement page on the bots platform.
  6. Click the Save option at the end of the page to save your changes.

Enable Microsoft Teams Channel

  1. On the menu, go to the Channels and select the MS Teams channel.
  2. You are redirected to the channel information page. Review the information and click Save to complete the channel setup.

Microsoft Teamsチャネルを有効にするには、以下のステップに従います。

  1. ボットビルダーのボットセクションで、Microsoft Teamsチャネルを追加したいボットをクリックします。
  2. チャネルタブで、Microsoft Teamsアイコンをクリックします。Microsoft Teamsのチャネルページが表示されます。
  3. Microsoft Teamsチャネルページの構成タブに移動して、アプリの構成を更新またはレビューし、チャネルを有効にします。
メモ:ボットフレームワークの“Webチャット”オプションはサポートされていません。

Microsoft Teamsチャネルの編集

Microsoft Teamsチャネルを編集するには、以下のステップに従います。

  1. チャネルにカーソルを合わせ、クリックして変更します。チャネル構成に必要な更新を行い、それらを保存します。
  2. 設定アイコンをクリックして、チャネル情報を無効にしたり削除したりすることもできます。 チャネルを変更するには、次のコマンドのいずれかを選択します:
  • 無効化/有効化無効化をクリックして、ボットの“Microsoft Teams”チャネルの使用を一時的に無効にします。“Microsoft Teams”チャネルの使用を有効にするには、有効化をクリックします。
  • 削除削除をクリックします。削除の確認ダイアログボックスで、OKをクリックして、ボットチャネル構成を完全に削除します。
警告:この操作は永久的で、元に戻すことはできません。

On-premise Installation Best Practices

If your on-premise version of the Kore.ai Platform is set up on AWS or a physical server and if you are using Microsoft Teams on Azure, you should ensure communication is established between the Azure server and Kore.ai Platform server.

Following are the best practices for on-premise installation:

  • Do not expose the Kore platform directly to the public internet and have a load balancer that is integrated with a Web Application Firewall (WAF).
  • Expose only the Elastic Load Balancing (ELB) to public internet traffic or through a reverse proxy (Nginx/Apache) deployed in the Demilitarized Zone (DMZ).
  • The URL pattern /hooks/msbotframework/ specific to Microsoft Teams, needs to be whitelisted by enabling rules in WAF/reverse proxy.

봇에 Microsoft Teams 채널을 추가하려면, Microsoft Teams와 Kore.ai 간 연결을 설정하기 위한 Microsoft Bot Framework에 봇을 생성해야 합니다. Microsoft Teams 채널을 봇에 추가하려면 다음 단계를 따르세요.

  • Register the Bot – 모든 봇 세부 정보를 추가하고 앱 ID 및 암호를 추가하여 Microsoft 봇 프레임워크에 봇을 생성해야 합니다 봇을 등록하려면, Microsoft Bot Framework 개발자 포털에서 무료 계정을 생성하고 등록해야 합니다.
  • Enable Channel– 봇을 등록한 후, 채널을 활성화합니다.
  • Publish Channel – 채널이 활성화되고 모든 설정이 검증된 후, 봇을 선택적으로 게시하여 개발자가 사용할 수 있도록 합니다.

Register the Bot with Microsoft Teams channel

To set up Microsoft Teams as a channel, you must register a Bot Channel service in Azure and enable a webhook for the platform to receive messages.
You need an active subscription to Azure services with admin access to subscribe for a new Azure service.

Register a Bot Channel

  1. Log in to the Microsoft Bot Framework portal.
  2. On the portal menu, click + New.
  3. Search and select Bot Channels Registration from the search window.
  4. Click Create and proceed to the next screen to enter the details.
  5. Enter all the required details to register the bot channel.
  6. From the Bot Builder platform, copy the Webhook URL from the Configurations tab of the Channel page for Microsoft Teams and provide it in the Messaging Endpoint field.

App Association

The Bot Channel Regsitration must be associated with a Microsoft App ID and Password. You can choose to go with the default option of Auto-create App Id and password if you want your bot to be available for multiple tenants or users outside of your Azure domain.

Note: You need to select multi tenant option for the Type of App while configuring an Azure bot. Configuration fails if single tenant is selected.

You can also choose to create your own App ID and password and define who is eligible to access your bot. Follow the instructions available here for more details.

  1. Click Create to complete the registration.
  2. After successful creation, you are redirected to the Dashboard of your Azure account.

Configure App Id and Password

From your Azure Dashboard, select the resource that you have created in the previous steps. You are redirected to the details page of the new resource that you have created.

  1. On the left pane, click Settings > Manage next to the Microsoft App ID field.
  2. Click Generate New Password to create a new password for your app.
  3. Make a note of the password displayed on the pop-up screen and enter it in the Configurations tab of the MS Team channel enablement page on the bots platform.
  4. Click Ok to go back to the previous screen.
  5. Make a note of the App ID and enter in the ‘Configuration’ tab of the MS Team channel enablement page on the bots platform.
  6. Click the Save option at the end of the page to save your changes.

Enable Microsoft Teams Channel

  1. On the menu, go to the Channels and select the MS Teams channel.
  2. You are redirected to the channel information page. Review the information and click Save to complete the channel setup.

Microsoft Teams 채널을 활성화하려면 다음 단계를 따르세요.

  1. 봇 빌더의 Bots 섹션에서, Microsoft Teams 채널을 추가하려는 봇을 클릭하세요.
  2. Channels tab,에서, Microsoft Teams 아이콘을 클릭하세요. Microsoft Teams channel 페이지가 표시됩니다.
  3. Microsoft Teams 채널 페이지의 Configuration 탭으로 이동하여 앱 구성을 업데이트하거나 검토하고 채널을 활성화합니다.
참고: 봇 프레임워크의 Web Chat 옵션은 지원되지 않습니다.

Microsoft Teams 채널 편집

Microsoft Teams 채널을 편집하려면 다음 단계를 따르세요.

  1. 채널 위로 마우스를 이동하고 클릭하여 수정합니다. 채널 구성에서 필요한 업데이트를 하고 저장합니다.
  2. 또한 Settings 아이콘을 클릭하여 채널 정보를 사용하지 않거나 삭제할 수도 있습니다. 채널을 수정하려면 다음과 같은 명령 중 하나를 선택하세요.
  • Disable/EnableDisable을 클릭하여 봇의 Microsoft Teams 채널 사용을 일시적으로 비활성화하세요. Microsoft Teams 채널 사용을 활성화하려면, Enable을 클릭하세요.
  • DeleteDelete를 클릭하세요. Delete Confirmation 대화 상자에서, OK을 클릭하여 봇 채널 설정을 영구적으로 삭제합니다.
Warning: 이 작업은 영구적이므로 취소할 수 없습니다.

On-premise Installation

In a scenario where your platform is on-premise and you want to integrate Microsoft Teams as a bot channel, if your MS teams (SaaS) is on Azure and Kore.ai platform is set up on a different cloud network like Amazon Web Services (AWS) or a physical server on-premise, you need to ensure that a communication is established between the Azure server and Kore.ai platform server. To know more guidelines, go to Using MS Teams cloud service from an on-premise installation.

To add Microsoft Teams channel to your bot, you must create a bot in the Microsoft Bot Framework account to configure the connection between Microsoft Teams and Kore.ai. To add the Microsoft Teams channel to your bot, follow the below steps:

  • Register the Bot – You must create a bot in the Microsoft Bot Framework by adding all the bot details and creating the App ID and Password. To register the bot, you must have created and registered for a free account in the Microsoft Bot Framework developer portal.
  • Enable Channel – After registering the bot, enable the channel.
  • Publish Channel – After the channel is enabled and all configurations are verified, you can optionally publish the bot to make it available for developers.

Register the Bot with Microsoft Teams channel

To set up Microsoft Teams as a channel, you must register a Bot Channel service in Azure and enable a webhook for the platform to receive messages.
You need an active subscription to Azure services with admin access to subscribe for a new Azure service.

Register a Bot Channel

  1. Log in to the Microsoft Bot Framework portal.
  2. On the portal menu, click + New.
  3. Search and select Bot Channels Registration from the search window.
  4. Click Create and proceed to the next screen to enter the details.
  5. Enter all the required details to register the bot channel.
  6. From the Bot Builder platform, copy the Webhook URL from the Configurations tab of the Channel page for Microsoft Teams and provide it in the Messaging Endpoint field.

App Association

The Bot Channel Regsitration must be associated with a Microsoft App ID and Password. You can choose to go with the default option of Auto-create App Id and password if you want your bot to be available for multiple tenants or users outside of your Azure domain.

Note: You need to select multi tenant option for the Type of App while configuring an Azure bot. Configuration fails if single tenant is selected.

You can also choose to create your own App ID and password and define who is eligible to access your bot. Follow the instructions available here for more details.

  1. Click Create to complete the registration.
  2. After successful creation, you are redirected to the Dashboard of your Azure account.

Configure App Id and Password

From your Azure Dashboard, select the resource that you have created in the previous steps. You are redirected to the details page of the new resource that you have created.

  1. On the left pane, click Settings > Manage next to the Microsoft App ID field.
  2. Click Generate New Password to create a new password for your app.
  3. Make a note of the password displayed on the pop-up screen and enter it in the Configurations tab of the MS Team channel enablement page on the bots platform.
  4. Click Ok to go back to the previous screen.
  5. Make a note of the App ID and enter in the ‘Configuration’ tab of the MS Team channel enablement page on the bots platform.
  6. Click the Save option at the end of the page to save your changes.

Enable Microsoft Teams Channel

  1. On the menu, go to the Channels and select the MS Teams channel.
  2. You are redirected to the channel information page. Review the information and click Save to complete the channel setup.

To enable Microsoft Teams channel, follow the below steps:

  1. In the Bots section of the Bot Builder, click the bot you want to add the Microsoft Teams channel to.
  2. On the Channels tab, click the Microsoft Teams icon. The Microsoft Teams channel page is displayed.
  3. Go to the Configuration tab of the Microsoft Teams channel page to update or review the app configurations and enable the channel.
Note: Web Chat option of Bot Framework is not supported.

Edit Microsoft Teams Channel

To edit the Microsoft teams channel, follow the below steps:

  1. Hover over the channel and click to modify. Make necessary updates to your channel configurations and save them.
  2. You can also disable or delete the channel information by clicking the Settings icon.

    Select one of the following commands to modify the channel:
  • Disable/Enable – Click Disable to temporarily disable the use of the Microsoft Teams channel for your bot. To enable the use of the Microsoft Teams channel, Click Enable.
  • Delete – Click Delete. On the Delete Confirmation dialog box, click OK to permanently delete the bot channel configuration.
Warning: This operation is permanent and cannot be undone.

On-premise Installation Best Practices

If your on-premise version of the Kore.ai Platform is set up on AWS or a physical server and if you are using Microsoft Teams on Azure, you should ensure communication is established between the Azure server and Kore.ai Platform server.

Following are the best practices for on-premise installation:

  • Do not expose the Kore platform directly to the public internet and have a load balancer that is integrated with a Web Application Firewall (WAF).
  • Expose only the Elastic Load Balancing (ELB) to public internet traffic or through a reverse proxy (Nginx/Apache) deployed in the Demilitarized Zone (DMZ).
  • The URL pattern /hooks/msbotframework/ specific to Microsoft Teams, needs to be whitelisted by enabling rules in WAF/reverse proxy.