チャットボットでWebex連携を設定する方法

はじめに

Webex連携は無償で設定することが可能ですが、標準では非表示となっているため、あらかじめ担当営業へご連絡いただく必要があります。
Webex連携が使えるようになっているか、ご確認ください。

※Webex連携は、amieのバージョンがv2.8以上になっている必要があります。
※Bot作成者と同じ組織に所属するユーザーのみ使用できます。

  1. チャットボットを作成し、「設定」→「基本設定」をクリックします。
  2. 「SNS連携」にて、「Webex」が表示されていることを確認します。

Webex からチャット画面操作時の制約事項

通常のWebブラウザによるチャット画面とは異なり、Webex から表示するチャット画面では、以下の機能がご利用いただけません。

  • 回答表示時のサムネイル表示
  • レコメンドタグの表示
  • キーワード変換候補の表示
  • 有人チャット
  • 絞り込み補助機能の表示

※「分類タグ」と「よくある質問機能」の表示は、初回チャット質問時には表示されません。チャットで質問後、「分類絞り込み」より選択する運用となります。

Webex 連携の設定

Webex連携を行うには、Webex上にBotを作成します。

  1. Webex for Developers に接続します。
    https://developer.webex.com/docs/bots
  2. 「Create a Bot」をクリックします。
  3. 「Bot name」「Bot username」「Icon」「Description」の項目を入力し、「Add Bot」をクリックします。
  4. 「Congratulations!」画面が表示されるので、「Bot access token」と 「Bot username」の値をコピーして控えておきます。

amie 管理画面の設定

  1. 該当チャットボットを開き、「チャットボット設定」→ [基本設定」をクリックします。
  2.  「SNS連携」の「Webex」のトグルをオンにします。
  3. 各項目に、以下のように入力し、「追加」をクリックします。
    • Bot username
      「Webex 連携の設定」ー手順4 で控えた値を貼り付けます。
    • Bot access token
      「Webex 連携の設定」ー手順4 で控えた値を貼り付けます。
    • secret
      任意の文字列を入力します。次の「Webhookの作成」ー手順2で使用するので、入力した値を控えておきます。
    • Webhook URL
      次の「Webhookの作成」ー手順2で使用するので、入力した値を控えておきます。
  4. 画面下部の「更新」をクリックします。

Webhookの作成

  1. Webhookの作成ページに接続します。
    https://developer.webex.com/docs/api/v1/webhooks/create-a-webhook
  2. 「Create a Webhook」画面にて、「メッセージ送信用Webhook」と「ボタンアクション用Webhook」を作成します。


メッセージ送信用Webhookの作成

各項目を以下のように入力し、画面下部の「Run」をクリックします。

  • Authorization
    「Use personal access token」のトグルをオフにし、Bearer欄に「Webex 連携の設定」ー手順4 で控えた Bot access tokenを入力します。
  • name
    Webhook名を任意に入力します。
  • targetUrl
    「amie 管理画面の設定」ー手順3 で控えたWebhook URLを入力します。
  • resource
    messages と入力します。
  • event
    created と入力します。
  • filter
    roomType=direct と入力します。
  • secret
    「amie 管理画面の設定」ー手順3 で控えたsecretの値を入力します。
  • ownedBy
    未入力 ※入力するとエラーになります。

「Run」をクリックしても画面の遷移はありませんが、上記の設定でメッセージ送信用のWebhookが作成されます。
続いて同じ入力欄に以下の内容を入力します。

ボタンアクション用Webhookの作成

各項目を以下のように入力し、画面下部の「Run」をクリックします。

  • Authorization
    「Use personal access token」のトグルをオフにし、Bearer欄に「Webex 連携の設定」ー手順4 で控えた Bot access tokenを入力します。
  • name
    Webhook名を任意に入力します。
  • targetUrl
    「amie 管理画面の設定」ー手順3 で控えたWebhook URLを入力します。
  • resource
    attachmentActions と入力します。
  • event
    created と入力します。
  • filter
    未入力
  • secret
    「amie 管理画面の設定」ー手順3 で控えたsecretの値を入力します。
  • ownedBy
    未入力 ※入力するとエラーになります。

注意点

「run」をクリックすると、下記に「Response」が出てきます。
「200/成功」以外の文言が出た場合は設定が失敗しているため、webhookの作成ができていません。

Webex画面に Bot を追加し、チャットを利用する

  1. アプリをダウンロードしてください。
  2. Webexアプリを起動したら、左側の任意のスペースをクリックし、右側に表示された「ユーザー」タブで、
    「ユーザーを追加」をクリックします。

    ※スペースを作成する際はWebexアプリのダウンロードを行わないと作成できませんのでご注意ください。
    スペースを作成の際は以下の手順をお試しください。
    a.左側のバーにある「メッセージ」をクリックします。
    b.「+」をクリックします。
    c.「スペースを作成」をクリックします。

    d.「スペースに名前を付ける(必須)」に任意のスペース名を入力します。
    e.「名前またはメールアドレスでユーザーを追加」手順4で控えたBot usernameを入力し表示された選択肢から該当のBotをクリックします。
  3. 「Webex 連携の設定」ー手順4 で控えた Bot usernameを入力し表示された選択肢から該当のBotをクリックします。
  4. 「追加」をクリックし、Botを追加します。
  5. 追加されたBotを右クリックし、「メッセージを送信」をクリックします。

botを追加して、チャットボットに話しかけた画面例

TOP
picture
minimize