やりたいこと
Blue Prismのプロセスから会議設定をしたい。
設定したあとにほしいものは、設定した会議のURLとパスコード。
手でやるときはこの画面でやります。
どうやるのか
公式のこのページ「Zoom APIの使用」の図が一発でわかるので転載します。
- BPプロセスからZoom認証サーバへ、認証のリクエストを投げる
- アクセストークンが返ってくる
- そのトークンを使って、Zoom APIに、会議作成のリクエストを投げる
- 会議が作成されて、会議の情報が返ってくる
まずアプリを作成する
Zoom App Marketplace に行って、Server-to-Server-OAuth のアプリを用意します。
Zoomのアカウントは無料のやつでも会社のでもとりあえずオッケー。そのアカウントで会議を作成します。
サインインしたら右上のメニューから、Develop→Build Server-to-Server Appを選択。
そんなにいろいろ設定するところはないのですぐできます。公開はしないでアクティベートだけしたらいいです。
アプリを作成したら、認証情報（アカウントID、クライアントID、クライアントシークレット）をメモっておきます。
Blue Prismで認証情報を作成する
クライアントID、クライアントシークレットを、OAuthクライアント認証で作成します。
認証情報取得アクションを作成する
認証情報を取得するのはいつものアレ。
この認証情報を投げてトークンを取得するのですが、投げる前にBase64エンコードする必要があります。
エンコードのVBOはDXにあります。 Utility - Encode Decode
アクションの中身はこうです。
変換するテキストの中身はこんな感じです。これをエンコードのステージの入力にします。
出力引数は、「クライアントID:クライアントシークレット」をBase64エンコードしたテキストです。
トークン生成アクションを作成する
中身はこうです。
入力引数は
- アカウントID：アプリを作成したときにメモったやつ
- 認証情報取得アクションの出力引数であるテキスト（クライアントID:クライアントシークレット）
出力引数は生成したトークンが入っているコレクションです。
生JSONだと扱いにくいので、コレクションに変換してから返します。Utility - JSONは標準VBOです。
Utility - HTTPも標準VBO。これのPostアクションを使います。中身はこう。
投げるヘッダがBasicなので、Use Bearer TokenはFalseにしておきます。
URLは「https://zoom.us/oauth/token?grant_type=account_credentials&account_id={アカウントID}」
HeadersはAuthorizationの1行だけ。設定する値は「Basic Base64エンコードしたテキスト」です。
会議を作成する
材料は揃ったので、会議を作成します。
先述の認証情報取得やトークン生成のアクションは公開せず、このアクションだけ公開にしておきます。
入力引数は
- アカウントID
- 認証情報名
- 会議タイトル：テキスト
- 開始日時：日時
- 所要時間（分）：数値
アクションの中身はこんな感じ。
認証情報取得→トークン生成→開始日時をテキストに変換→リクエストを投げる
開始日時をテキストに変換するときの形は「yyyy-MM-ddTHH: mm:ss」。日と時の間に「T」が入ります。
Post JSONステージの中身はこう。
Bearer Tokenに、トークン生成アクションの出力で受け取ったトークンを設定し、Use Bearer TokenをTrueにします。
Bodyの中身。各値を入力引数の値にReplaceします。
{
"topic": "<会議タイトル>",
"start_time": "<開始日時>",
"duration": <所要時間>,
"timezone": "Asia/Tokyo"
}
返ってきたJSONをコレクションに変換して、会議URLとパスコードを返します。
コレクションの項目で使いそうなのは以下。
- start_url：ホストとして参加するときのURL
- join_url：普通の参加者にお知らせするURLはこっち
- password：パスコード。これは半角英数で、「H323_password」「pstn_password」のほうは数字です。H323とかpstnって何やねんというかたは、私も知識が薄くて上手に説明できないので、VoIPの説明とかをググってください。
これらを使って会議設定のプロセスを作成し、会議設定したあとに参加者にメールを送信するとかの処理を追加したらいいと思います。
終わりです
今回はタイトルと時間だけで設定しましたが、手で設定するときの項目はだいたい全部設定できます。
BodyのJSONに書くときの項目など、詳しくは公式資料を参照してください。→ Zoom API の概要