担当者のTeamsへ通知する

Microsoft Teamsのコネクタ(Webhook)の廃止について

Teamsのコネクタ(Webhook)廃止に伴い、新たにWebhookURLの発行とラクネコへの再設定が必要です。
Teamsコネクタの廃止に関する情報はこちらのお知らせをご参照ください。

新しいWebhookの設定手順は以下、「新しい設定手順(新WebhookURL設定)」のタブより設定手順をご確認頂き、再設定をお願いします。

また、廃止されるWebhookURLとの見分け方はURLから確認が可能です。以下のようにURL内に「workflows」があれば今後利用可能なWebhookURLです。
【今後利用可能なWebhookURL】 https://(ドメイン)/workflows/************
【廃止されるWebhookURL】 https://(ドメイン)/webhookやwebhookb2/***********


  • 新しい設定手順(新WebhookURL設定)
  • 従来の設定手順(2024年12月31日廃止予定)

目次

WebhookURL取得手順(初めてWebhookURLを取得する場合)

  • 1.Microsoft Teamsで通知用のチームを作成します

    既にチームを作成済みの場合は、手順2からご確認ください。

  • 2.通知したいチャンネルのワークフロー画面を表示します

    既存又は作成したチームのチャンネルの右側「・・・」をクリックし「ワークフロー」をクリックします。

  • 3.設定するワークフローを選択します

    ワークフロー作成のダイアログが表示されたら「Webhook要求を受信するとチャンネルに投稿する」を選択します。

  • 4.ワークフローの名前の設定します

    ワークフローの名前を設定し「次へ」をクリックします。

    Point
    WebhookURLはチャンネル毎に発行する必要があります。
    複数のチャンネルで受け付け通知をご利用する場合はチャンネル毎に分かりやすい名称で設定を推奨します。
    【例】「(チャンネル名)_ラクネコ通知用」など

  • 5.ワークフローを追加するを押します

    利用するチーム名、チャンネル名が選択されている事を確認し「ワークフローを追加する」をクリックします。

    Check
    通信状況によって表示に時間がかかる場合があります。
    チーム名、チャンネル名が表示されるまでお待ちください。

  • 6.表示されたWebhookURLをコピーします

    作成したワークフローのWehookURLが表示されます。
    コピーボタンをクリックし完了ボタンもクリックします。

  • 7.WebhookURLをラクネコに連携します

    ラクネコの管理画面を開き、アカウント設定画面のMicrosoft Teamsの通知設定に先ほどコピーしたWebhookURLを貼り付けます。
    その後、「未連携」を「連携中」に変更します。

  • 8. (任意設定)メンション設定をします

    受付通知を受け取る際にメンションをつける場合、Microsoft Teamsにログインしているご自身のメールアドレスを「アカウントID」項目に設定します。

  • 9. 「通知テスト」をクリックし連携確認をします

    「通知テスト」をクリックしTeamsにテスト来客通知が届いたら連携操作が完了です。

  • 10. 受付を実施し通知確認をします

    受付アプリ操作し、担当者宛に通知が届くか確認をします。
    通知が届かない場合、連携設定に誤りがないか改めてご確認をお願い致します。

チームにゲスト参加している場合

ゲストとしてチームに参加している場合、メンションに設定するユーザーIDは手順3の設定と異なります。
通常のユーザーIDではメンション通知が飛ばない為、以下のようにIDを加工してラクネコに設定する必要がございます。

  • 【例】
    rakuneko@pdc.proto-g.co.jp → rakuneko_pdc.proto-g.co.jp#EXT#@rakuneko-support.onmicrosoft.com

    以下の手順で編集が可能です。参考としてご確認ください。
    ①『〇〇〇@×××.co.jp』の場合「@」を「_」へ変更します。
    ②①で変更した内容の後ろに「#EXT#@△△△.onmicrosoft.com」を入力します。
     ※『△△△」はM365テナントドメインが入ります。ゲストのユーザーは確認が出来ない情報の為、
      Teamsの管理者へご確認をお願い致します。
    ③『〇〇〇_×××.co.jp#EXT#@△△△.onmicrosoft.com』をアカウントID項目に入力し完了です。

WebhookURL取得手順(WebhookURLを再取得する場合)

  • 1.ワークフローの編集画面を開きます

    Teams左側メニューボタンの「・・・」又はその他のアプリより「Workflows」をクリックします。

  • 2.ワークフローを選択します

    WebhookURLの確認したいワークフローの右端にカーソルを合わせ「︙」より「編集」をクリックします。

    Check
    ワークフロー一覧への表示は共同所有者に設定されているユーザー又はグループとして共有されている必要がございます。

  • 3.WebhookURLを取得します

    「When a Teams webhook request is received」をクリックします。
    HTTP POSTのURL欄に表示されたWebhookURLをコピーします。

  • 4.WebhookURLをラクネコに連携します

    ラクネコの管理画面を開き、アカウント設定画面のMicrosoft Teamsの通知設定に先ほどコピーしたWebhookURLを貼り付けます。
    その後、「未連携」を「連携中」に変更します。

  • 5. 「通知テスト」をクリックし連携の確認をします

    「通知テスト」をクリックしTeamsにテスト来客通知が届いたら連携操作が完了でございます。

※こちらの手順は8月15日以降操作が出来ない手順です。ご注意ください。

WebhookURL取得手順(初めてWebhookURLを取得する場合)

  • 1.Microsoft Teamsで通知用のチームを作成します

    既にチームを作成済みの場合手順2からご確認お願い致します。

  • 2.チャンネル管理画面よりコネクタの画面を表示します

    既存又は作成したチームのチャンネルの右側「・・・」をクリックし「チャンネルを管理」をクリックします。
    コネクタの「編集画面」をクリックしコネクタの一覧画面を表示させます。

  • 3.コネクタにWebhookを追加します

    検索画面に「Incoming Webhook」と検索します。
    検索結果に表示された「Incoming Webhook」の「追加」ボタンをクリックします。
    Incoming Webhookの詳細画面が表示されたら再度「追加」ボタンをクリックします。

  • 4. Webhookの名前を設定し作成します

    通知に使用するWebhookの名前を設定します。
    (例:ラクネコ通知用など)
    名前を入力しましたら、「作成」ボタンをクリックします。

  • 5. WebhookURLをラクネコへ連携します

    コネクタの画面をスクロールしURLをコピーします。
    コピーしたURLをラクネコ管理画面開き、
    アカウント設定画面からMicrosoftTeamsのWebhookURLに貼り付け「未連携」から「連携中」にします。
    アカウントIDはTeamsにログインしているメールアドレスを入力します。

  • 6. (メンションを設定したい場合)ユーザーIDを設定

    Microsoft Teamsへログインしているメールアドレスを「ユーザーID」項目へ設定し、メンション通知設定の完了です。

    ※通知時にメンションとして表示される名称は、ラクネコのユーザー名を表示する仕様となっております。
    ※Microsoft Teamsの仕様上、ユーザーに対するメンションのみ利用する事が可能となっております。チームメンション等はご利用頂けない事ご了承ください。

  • 7. 「通知テスト」をクリックし連携の確認をします

    手順5又は手順6完了後、「通知テスト」をクリックしTeamsにテスト来客通知が届いたら連携操作が完了でございます。

チームにゲスト参加している場合

ゲストとしてチームに参加している場合、メンションに設定するユーザーIDは手順3の設定と異なります。
通常のユーザーIDではメンション通知が飛ばない為、以下のようにIDを加工してラクネコに設定する必要がございます。

  • 【例】
    rakuneko@pdc.proto-g.co.jp → rakuneko_pdc.proto-g.co.jp#EXT#@rakuneko-support.onmicrosoft.com

    以下の手順で編集が可能です。参考としてご確認ください。
    ①『〇〇〇@×××.co.jp』の場合「@」を「_」へ変更します。
    ②①で変更した内容の後ろに「#EXT#@△△△.onmicrosoft.com」を入力します。
     ※『△△△」はM365テナントドメインが入ります。ゲストのユーザーは確認が出来ない情報の為、
      Teamsの管理者へご確認をお願い致します。
    ③『〇〇〇_×××.co.jp#EXT#@△△△.onmicrosoft.com』をアカウントID項目に入力し完了です。

WebhookURL取得手順(WebhookURLを再取得する場合)

  • 1. Teamsのコネクタ画面を表示

    チームの右側の「・・・」をクリックしを「チャンネルを管理」をクリックします。
    チャンネルの設定画面上にありますコネクタの「編集」をクリックします。

  • 2. 「Incoming Webhook」の構成情報を確認します

    コネクタ画面が開きましたら、左側メニュー画面上の「構成済み」をクリックします。
    「Incoming Webhook」が表示されることを確認し、「1構成済み」をクリック後「管理」をクリックします。

    ※「Incoming Webhook」が表示されていない場合、もともと設定されていない状態の為、
     本マニュアルの「初めてWebhookURLを取得する場合」に沿って操作をお願いします。

  • 3. Webhook URLをコピーします

    「Incoming Webhook」の画面が表示されましたら画面をスクロールし「クリックボードにコピー」ボタンを利用しWebhook URLをコピーします。

  • 4. WebhookURLをラクネコへ連携します

    ラクネコ管理画面の「アカウント設定」画面を開き、Microsoft Teamsの通知設定項目を表示します。
    先程取得したWebhookを貼り付け、「未連携」を「連携中」に変更し設定が完了です。

  • 5. 「通知テスト」をクリックし連携の確認をします

    「通知テスト」をクリックしTeamsにテスト来客通知が届いたら連携操作が完了でございます。