この記事はシスコの有志による Cisco Systems Japan Advent Calendar 2023 の 4 日目として投稿しています。
2023 年版: https://qiita.com/advent-calendar/2023/cisco

はじめに

ここでは GAS (Google Apps Script) で Webex bot を作る手順をまとめます。下記のような感じの Bot を作ります。

GAS を使うメリット

Webex bot をラボで作成するには ngrok などのツールが必要になります。しかしこうしたツールの社内利用は禁止されていることも多く、また Web とのやりとりで遅延も発生します。GAS は Google により Web 上で提供されているため、ngrok などのツールが不要で遅延も少なく、また無料で使えるところが大きなメリットになります。

Webex bot の準備

まず下記の手順で Webex bot を作成します（既に Bot がある場合は読み飛ばしてください）。

https://developer.webex.com/ にログイン
右上アイコンをクリックし My Webex Apps をクリック
Create a New App > Create a Bot を選択
Bot name, Bot username, アイコンを選び、適当な Description を入れて作成します
作成後に表示される Bot access token をメモします

作成後に表示される Bot access token は一度しか表示されないので注意しましょう！

GAS サンプルコードのコピペ

次に GAS の準備をします。GAS は google アカウントを持っている人であれば誰でも利用することができます。
https://script.google.com/ にアクセスし Start Scripting をクリックします。

ログイン後新しいプロジェクトを作り、下記のコードをコピペします。2 行目の YOUR_BOT_TOKEN を上記 Bot access token に置き換えてください。

// Bot access token を下記にコピペ
webexToken = 'YOUR_BOT_TOKEN'

function doPost(e) {
  // webhook で最初に呼ばれるのはこの関数
  var jsonString = e.postData.getDataAsString();
  var body = JSON.parse(jsonString);

  var roomId = body.data.roomId;
  var roomType = body.data.roomType;
  var personId = body.data.personId;
  var msgId = body.data.id;

  var msg = getMsg(msgId);

  if (msg.indexOf('ありがと') > 0) {
    sendMsg(roomId, msgId, 'どういたしまして！');
  } else if(msg.indexOf('メリークリスマス') > 0){
    sendMsg(roomId, msgId, 'メリークリスマス！良いお年を！');
  } else {
    sendMsg(roomId, msgId, 'こんにちは！');
  }
}


function sendMsg(roomId, msgId, msg){
  // message を送信する関数
  var url = 'https://webexapis.com/v1/messages/';

  var headers = {
    'Authorization': 'Bearer '+ webexToken,
    'Content-Type': 'application/json'
  };

  var payload = {
    'roomId': roomId,
    'parentId': msgId,
    'markdown': msg
  };

  var options = {
    'method': 'POST',
    'headers': headers,
    'payload': JSON.stringify(payload)
  };

  UrlFetchApp.fetch(url, options);
}


function getMsg(msgId) {
  // HTTP リクエストして message の中身を取得する関数
  var url = 'https://webexapis.com/v1/messages/'+msgId;

  var headers = {
    'Authorization': 'Bearer '+ webexToken,
    'Content-Type': 'application/json'
  };

  var options = {
    'method': 'GET',
    'headers': headers
  };

  var response = UrlFetchApp.fetch(url, options);
  var resJson = JSON.parse(response.getContentText('UTF-8'));

  return resJson.text;
}