Teamsからkintoneに勤怠登録しよう

はじめに

今回は Teams から kintone に勤怠登録をしてみようと思います。
具体的には、Teams から送ったメッセージを分解して、 kintone の任意のフィールドに登録するという処理を Microsoft Power Automate を使って実現していきます。

準備するもの

準備するものは以下の通りです。

• kintone のアプリ
  • 「レコード追加」権限のある API トークン（詳しくは kintone ヘルプのAPI トークンを生成するを参照）
• Microsoft Teams
• Microsoft Power Automate

kintone の設定

まず、kintone にアプリを作ります。
今回は勤怠登録をイメージしてアプリを作成しました。
用意したフィールドは以下の通りです。

通信には、API トークンを使用します。
API トークンの詳しい設定方法は、kintone ヘルプのAPI トークンを生成するを参照してください。
API トークンのアクセス権は「レコード追加」にチェックを入れてください。

Microsoft Power Automate の設定

Microsoft Power Automate を設定していきます。全体の流れは以下の通りです。

Microsoft Teams からメッセージを送信する

まず、Microsoft Teams からメッセージを受け取ったときの設定をします。
今回はテスト用に、「連携動作確認用」チームに「レコード登録」チャネルを作成しました。

以下のような形でメッセージを送信することを想定して、実装していきます。

コマンド名 {フィールド名}：{String}

実際に送信するメッセージは以下の通りです。

HTML をテキストに変換する

Microsoft Power Automate では、Microsoft Teams からのメッセージを HTML 形式で受け取ります。
そのままでは、文字列として処理できないため、「Html to Text」で文字列に変換します。
設定方法は以下のように、Content に「メッセージ 本文 コンテンツ」を追加するだけです。

変数を初期化する(command)

文字列に変換した後は、文字列を「コマンド（command）」と「HTTP リクエスト送信用のボディ(requestBody)」に分解していきます。
はじめにコマンド部分を切り出してみましょう。「変数を初期化する」で文字列を分解していきます。

「値」の部分は以下のように設定します。

画像だとわかりづらいですが、split の第二引数には半角スペースを渡しています。

split(body('Html_to_text'),'{ }')

受け取った文字列の半角スペースより前の部分を切り出すという式です。
切り出した文字列は配列に格納されます。
上記の式だと、配列の１番目にコマンド、２番目にそれ以降の文字列が格納されます。

変数を初期化する(requestBody)

続いて、内容の部分を切り出していきましょう。
「変数を初期化する」の部分は先ほどと同じように設定します。

先ほど、配列の 2 番目に格納したテキストは以下のような形になっています。

"勤務場所:自宅"

フィールド名と値が「：（カンマ）」で区切られている状態なので、こちらも先ほどと同様に
「：（カンマ）」の前後で文字列を切り離して、それぞれ配列に格納します。

条件分岐（コマンドの判定）

次は、コマンドの判定です。
送信されたメッセージのコマンドが「勤務開始」であれば kintone にレコード登録を行う、というように分岐させたいと思います。
「はいの場合」は HTTP リクエストを送信、「いいえの場合」は Microsoft Teams のメッセージにエラーメッセージを返信する、という条件で設定していきましょう。

条件は以下のように設定します。

条件分岐の式は、変数の初期化（command）で作成した配列の１番目のコマンドを比較するように設定します。

はいの場合

「はいの場合」には、HTTP リクエストを送信します。
詳しい kintone API の POST メソッドの仕様については、こちらの記事を参考にしてください。

リクエストの「本文」にはリクエストボディを記載します。

{
  "app": {"アプリID"},
  "record": {
    "日時": {
      "value": {"メッセージ CreateDateTime"}
    },
    "氏名": {
      "value": {"メッセージ from ユーザー displayName"}
    },
   variables('requestBody')[0]: {
      "value": {variables('requestBody')[１]}
    }
  }
}

「日時」、および「氏名」フィールドには、「動的なコンテンツを追加」から「メッセージ CreateDateTime」と「メッセージ from ユーザー displayName」をそれぞれ設定します。
「勤務場所」には、「動的なコンテンツを追加」から「式」を追加し、先ほど変作成した配列の値を代入します。

いいえの場合

コマンドが「勤務開始」以外だった際には、Microsoft Teams のメッセージに返信する形でエラーメッセージを送信します。
「メッセージへの返信の投稿（V2）」を使用して、「動的なコンテンツ」から「メッセージ ID」を指定します。
そして、「返信」には、返信したいメッセージの内容を追加します。

動作確認

実際に動作確認をしてみます。
Power Automate の右上にある、「テスト」から「トリガーアクションを実行する」を選択します。

実際に下記のメッセージを送信してみると、kintone に内容が登録されています。

勤務開始 勤務場所:自宅

エラーの確認も行います。
先ほどのコマンドの前に「/」を入れてみます。

/勤務開始 勤務場所:自宅

すると、メッセージにエラーメッセージが返信されました。

最後に

今回は、「Microsoft Teams から kintone に勤怠登録する」というしシナリオを想定して、Microsoft Power Automate を使った連携方法を検証してみました。
実際に運用するには、足りない点も多くあると思いますが、簡単な内容であれば Microsoft Teams から手軽にレコード登録を実装できると思います。