■＊＊＊を使って "Microsoft Teams" に投稿してみた件

■はじめに

・会社で"Microsoft Teams"を導入されたのをきっかけに、他サービスからの投稿方法をいくつか調べたのでここに備忘録として残します

■■ここで出来るようになること

・”Microsoft Teams” の ”Incoming Webhook” の設定方法

・”cUrl” を使って ”Microsoft Teams” に投稿してみる
・”Power Shell” を使って ”Microsoft Teams” に投稿してみる
・”python” を使って ”Microsoft Teams” に投稿してみる

※下記からの事例では”Microsoft Automate”（旧Flow）を利用したものになります

・”Microsoft Forms” を使って ”Microsoft Teams” に投稿してみる

注）事例によってはO365以外のアカウントが必要なものもあります。その際には個別に入手するようお願いします

▲初投稿：2019-12-24

■やってみよう！

■■”Microsoft Teams に Incoming Webhook を設定しよう

・外部サービスからHTTPリクエストでTeamsにメッセージを送るために、Teamsの接続用コネクタ”Incoming Webhook”を新規作成します

・投稿先のTeamsのチャネルの”...”をクリックしてメニューを出し”コネクタ”をクリックします

・コネクタの一覧の中から” Incoming Webhook”を探し出して”追加”ボタンをクリックします

・確認画面が出てくるので、また”追加”ボタンをクリックします

・接続用の名前を入力します。必要であればアイコンをも変更する事ができます（タイムラインに表示されるアイコンが変わります）。入力が完了したら”作成”ボタンをクリックします

・他サービスからの接続先になるURLが表示されるので、コピーして取っておきます。コピーしたら”完了”ボタンをクリックします

・既に設定が作られていた場合、”構成済み”メニューをクリックします。追加で別の設定を作りたい場合、”構成”ボタンをクリックします。既存の設定を変更もしくわURLを再確認した場合、**”構成済み”リンクをクリックします

・”構成済み”リンクをクリックすると構成済みの設定の一覧が表示されるので、該当のところの”管理”ボタンをクリックします

・既存の情報が表示されるので確認もしくわ変更します。

・変更した場合、”保存”ボタンを削除した場合、”削除”ボタンをクリックします

※接続先のURLは外部サービスからの呼び出しによく使うのでメモを残して置くとよいでしょう！

■■”cURL”を使って Microsoft Teams に投稿してみる

・実現するための手順としては下記の様になります
　Mac等:cURLコマンド→Teams:Incoming Webhook→Teams:Channel

・Mac等のcURLコマンドが使用可能なパソコンから、本文（"Hello World"）をTeamsに投稿してみる

echo '{"text": "Hello World"}' | curl -H 'Content-type: application/json' -d @- <Teams:Incoming Webhook URL>

■■”PowerShell”を使って Microsoft Teams に投稿してみる

・実現するための手順としては下記の様になります
　Windows10:PowerShell→Teams:Incoming Webhook→Teams:Channel

・Windows10のPoweShellが使用可能なパソコンから、本文（"Hello World"）をTeamsに投稿してみる

$URI = '<Teams:Incoming Webhook URL>'
$body = ConvertTo-JSON @{
  text  = 'Hello World'
}
Invoke-RestMethod -uri $URI -Method Post -body $body -ContentType 'application/json'

■■”Python”を使って Microsoft Teams に投稿してみる

・実現するための手順としては下記の様になります
　Python(Shell: sendteams.py)→Teams:Incoming Webhook→Teams:Channel

・"Python" から "Micrsoft Teams" にメッセージを送信するには "pymsteams" というライブラリを使うのが簡単です。以未インストールの場合は以下の手順で"pymsteams"をインストールします。

yum -y install gcc python-devel
curl -L https://bootstrap.pypa.io/get-pip.py | python
pip install pymsteams

・下記の”Python”の実行Shellファイル(sendteams.py)を作成します

・"Python"が使用可能なパソコンからsendteams.pyを実行し、本文（"Hello World"）をTeamsに投稿してみる

sendteams.py

import pymsteams
myTeamsMessage = pymsteams.connectorcard("h<Teams:Incoming Webhook URL>")
myTeamsMessage.text("Message Body")
myTeamsMessage.send()

■■”Microsoft Forms”を使って Microsoft Teams に投稿してみる

・実現するための手順としては下記の様になります
　Forms(投稿用WEB画面)→Power Automate（旧Flow）→Teams:Channel

・"Forms" から "Micrsoft Teams" にメッセージを送信するには "Forms" に投稿用WEB画面、"Power Automate（旧Flow）" にFormsとTeamsを連携させるフローを用意する必要があります
注）本事例はO365アカウントが必要になります

・Forms WEB画面作成

・"Forms" を起動して ”新しいフォーム”をクリックします

・編集モードの画面から”＋新規追加”をクリックします

・今回は "Teams" にメッセージを投稿したいので ”テキスト” をクリックします

・本フォームのタイトルを入力します

・メッセージ入力欄のコメントを入力します

・フォーム自体の作成はこれで完了なので、動作確認をしてみます。画面右上の”プレビュー”をクリックします

・フォームの実行画面に切り替わるので、コメントを入力します。入力出来たら”送信”ボタンを押します

・下記の様な送信完了画面が出てきたら成功です。左上にある”戻る”クリックを押すと元の編集画面に戻ります

・”回答”タブをクリックします

・先ほど入力した内容が表示されていれば確認完了です

・念のため編集画面以外から呼び出し出来る様に”共有”から接続先のURLをコピーしておきます。Formsで行うことは以上です

・"Power Automate（旧Flow）" フロー作成

・"Power Automate（旧Flow）" を使ってFormsとTeamsの間を連携させるフローを作成します。ですが、ここではテンプレートにちょうどやりたい事のフローがあるのでそれを使いたいと思います

・"Power Automate（旧Flow）" を立ち上げます。立ち上がったら、画面左側のメニューから”テンプレート”をクリックします。画面上部にある検索用のテキストボックスに”Forms Teams”を入力し検索します。検索の結果出てくる”新しい回答が送信されたときにチームに通知する”を探し出してクリックします

・アカウント、ライセンスがが正常に登録されていれば、必要なサービスに自動的にログインされます。アカウント横の”...”をクリックすると接続先のアカウントを変更する事も可能です

・接続先に問題がなければ、”続行”ボタンをクリックします

・テンプレート内に設定されているフローが表示されます。今回、先ほど作ったFormsの画面に投稿されたコメントをTeamsの特定のChanelに投稿したいだけなので、このフローの設定だけを変えればOKです

・先ほど作ったFormsを ”When a new response is submitted: フォームID” のドロップダウンリスト内から見つけて選択します

・”Apply to each: Get response details: フォームID” も先ほど作ったFormsをドロップダウンリスト内から見つけて選択します

・”Apply to each: Post message” は連携先のTeamsの情報を下記の様に入力します
　①チーム：投稿先のTeamsのチーム名をドロップダウンリストから選択します
　②チャネル：稿先のTeamsのチャンネル名をドロップダウンリストから選択します
　③先ほど作ったFormsのテキストをTeamsに投稿する本文にしたいので”動的コンテンツの追加”をクリックします
　④別窓にFormsのテキスト入力時のタイトル名”コメントを入力してください”が表示されるので、それをクリックします
　⑤メッセージ：”コメントを入力してください”が追加されるので、あとは他にも必要なコメントや文字装飾を施します
　⑥問題なければ”保存”を押します

・不具合が無いか確認します。画面右上にある”フローチェッカー”をクリックします。すると下記の様な画面が現れ、エラーがあればその内容を表示します。（↓の場合は何もエラーが無い状況を示しています）

・画面左上にあるフロー名をクリックするとフローの詳細画面に戻ります

・一連の動作確認を行ってみる

・Formsの入力画面を呼び出しコメントを入力します。入力出来たら”送信”ボタンをクリックします

・該当のTeamsのチャネルにFormsに投稿した内容が登録できていたら完成です

・"Power Automate（旧Flow）" のフロー詳細画面を見ると先ほどの実行履歴が残っているので状況が”成功”になっているか確認します

■参考

・Microsoft Teams documentation　・・・　こちら
・Microsoft Teams のテクニカル ドキュメンテーション　・・・　こちら
・Use Markdown formatting in Teams　・・・　こちら

・Microsoft Teamsにメッセージを飛ばす　・・・　こちら
・Microsoft Teams に PowerShell で投稿してみる　・・・　こちら
・Python から Microsoft Teams へ投稿する　・・・　こちら

・Qiita(KSxRDevelop)　・・・　その他の情報はこちら