はじめに

前回、こんな記事を書いた。

やりたいこと・やらなきゃいけないことをゲーム感覚でこなす仕組みを考えてみたよ。

Asanaを使って日常のタスク管理をするというものである。
これによって確かにタスクはわかりやすくなった。やるべきことは明確になったし、期限もわかるようになった。ただし、タスクを完了しても完了したという事実だけがあり、それに対して誰も何のリアクションもくれない... (あたりまえ)

そこでタスクの完了をトリガーに、自動で褒めてくれる仕組みを考えている。(褒めるのセルフサービス)

AsanaにはWebhookが用意されているので、その一歩としてWebhookを登録してみる！

Webhook

webhook ってなんだっけ？

SlackとかGithubとかそのようなWebサービスにはAPIの他にWebhookと呼ばれるものが存在している。
簡単に言ってしまえば、それらのサービスで何らかの「イベント」が発生したときに、「イベント」が発生したことをあらかじめ登録してあるエンドポイントへのPOSTリクエストによって通知してくれるものである。

「SlackのWebhook使おうぜ！」
と言われたら
「ユーザーが投稿などをした際に、Slackが指定したURLにPOSTリクエストしてくれるから、それ使おうぜ！」
と言っているものだと思えば良いと思います。
Webhookとは？

これを使うことによりイベントが発生するのを検出するためにWebAPIのリクエストを頻繁に送るようなことをしなくて済む。

AsanaへWebhookを登録する

AsanaのWebhook

詳しくはAsanaのWebhook
のドキュメントを読んでいただきたいが、Asanaのタスクやプロジェクトなどが追加・更新・削除されたことなどを知ることができるものである。

AsanaのWebhook handshake

AsanaのWebhookを利用するには、WebhookURLなどの情報を持たせたPOSTリクエストを送り、WebhookURLで指定したエンドポイントにAsana側からリクエストが飛ぶのでそのリクエストを受け取り再度、Asana側に送ってあげるということをする必要がある。(handshake)

このとき、Asana側から送られるリクエストのヘッダーに含まれるX-Hook-Secretという値をWebhookURLのエンドポイントからのレスポンスのヘッダーに含める必要がある。
これにより、確かにWebhookURLが生きていること、Asanaからの情報を受け取れることを証明する。

WebhookURLの準備

先述したようにWebhookのエンドポイントには、Asana側からリクエスト時に付与されるX-Hook-Secretなる値を読み取ることが要求される。ただのPOSTリクエストを受け取るエンドポイントであれば、GASでPOSTリクエストを受け付けられるようにしておけばいいのだが、どうやら現状のGASではリクエストヘッダーの値を確認することができないようだ。

GAS の Web App ではリクエストヘッダーにアクセスすることができません。
Google Apps Script (GAS) で Slack 連携を実装する前に知っておくとよい 5 つのこと

なお、doPost()のパラメータオブジェクトにHeader情報を直接取得できるプロパティはないと思います。
（少なくともリファレンスではそのような記述を見つけることはできませんでした）
別途調べたところ、ChatWorkでは類似の問題（doPostでのヘッダー情報取得）への対応をしたばかりです。
HTTPリクエストのヘッダに含まれる値取得し、その値をヘッダに含めてレスポンスを返したい

そのため、今回はWebhookのエンドポイントにAWSのAPI Gatewayを使うことにした。

/AsanaTaskWebhookReceiver に POSTリクエストしたら、X-Hook-Secret付きのレスポンスを返すLambdaをキックするようにする。

なお、API Gatewayへのエンドポイントの作成は、Lambda側から行ったのち、POST統合リクエストのページからLambda関数を再度指定して更新している。

上記のLambda関数を再度選んで右側にあるチェックするとAPIを作成した時の同様のポップアップが出てくるので「OK」します。権限が付与されたのでもう一度テストしてみると成功しました。
[小ネタ]Lambda統合を使用したAPI Gatewayのエクスポート→インポートの注意点

以下のようにPythonでリクエストを受け取り、レスポンスを返す簡単なコードをLambdaで実装している。

1import json
2import requests
3
4def lambda_handler(event, context):
5    secret = event['headers']['X-Hook-Secret']
6    return {
7        "statusCode":"200",
8        "headers": {
9            'Content-Type': 'application/json',
10            'Accept': 'application/json',
11            'X-Hook-Secret': secret
12        }
13    }
14    
15

Webhookの登録

curl でリクエストした際にはどうにもあんまりうまくいかなかったので、AsanaのPythonライブラリを用いてローカルからPythonでWebhookを登録した。(おそらくfiltersの部分のJSON表記がうまく書けてなかったのだと思う)

1import asana
2token = '<AsanaAccessToken>'
3client = asana.Client.access_token(token)
4client.headers['Asana-Enable'] = '1234567'
5req = {
6    'resource':'<RESOURCE_ID>',
7    'target':'<apiGateWayで実装したWebhookエンドポイント /default/AsanaTaskWebhookReceiver >',
8    "filters": [{"action":"changed","fields": ["completed"],"resource_type": "task"}],
9}
10
11res = client.webhooks.create(req)
12print(res)
13

以下のように登録内容が含まれたレスポンスが得られればWebhookの登録には成功している。

1{'gid': '<webhook-gid>', 'resource_type': 'webhook', 
2'resource': {'gid': '<resouce-gid>', 'resource_type': 'project', 'name': 'マイホームワーク'}, 
3'target': '<API GateWayで実装したWebhookエンドポイント /default/AsanaTaskWebhookReceiver >', 'active': True, 'filters': [{'resource_type': 'task', 'resource_subtype': None, 'action': 'changed', 'fields': ['completed']}], 'created_at': '2022-03-31T16:13:51.843Z', 'last_failure_at': None, 'last_failure_content': '', 'last_success_at': '2022-03-31T16:13:53.125Z'}
4

といってもこのほとんどHow to use Asana Webhooks with AWS Lambda (Python)の通りである。

API Gatewayの設定で、{internal server error} が返されて困っていたので以下の記事も参考にして解消している。
API Gateway {“message”:”Missing Authentication Token”} が返ってきた時

ちなみにこのエンドポイントに直接リンクでアクセスした際に internal server error が出るのは、X-Hook-Secretを与えてないから当然である。

またAPIのログを記録するために、IAMロールを作成し追加している。

API ゲートウェイ REST API または WebSocket API のトラブルシューティングのために CloudWatch Logs を有効にするにはどうすればよいですか?

その他にもこの記事を見たりして理解を深めた。
AWS APIGatewayからLambdaへリクエストヘッダー情報を受け渡す

まとめ

タスク完了時に通知をするため、AsanaのWebhookを使いたかった。
リクエストヘッダーの値を取得できないGASではAsanaのWebhookエンドポイントを作ることができないことがわかった。
そこでAWSのAPI Gatewayでエンドポイントを作成し、Lambdaをキックすることでエンドポイントを実装できた。
ローカル環境からこのエンドポイントを叩くことでAsanaへWebhookが登録されるのを確認した。