Webhook とは、接続済みアカウントで何かが起きたときに、こちらから POST するあなたの URL です。メッセージが届いた、つながりが増えた、アカウントが手当てを要する、といったときです。くり返し問い合わせる方式を置き換えるもので、利用制限のある API では、これは好みの問題ではなく、動くか動かないかの違いです。
署名を検証してください。毎回。
あなたのエンドポイントは公開インターネット上にあり、そこへ届けるものは何でも好きな中身を送れます。配信にはいずれも、あなたとこちらしか持たない秘密から計算した署名が付きます。本文を読む前にそれを確かめ、早く抜ける文字列比較ではなく、一定時間で比較してください。
同じイベントが 2 回来るものと考えてください
配信は少なくとも 1 回です。エンドポイントが遅い、500 を返す、あるいはそう見えるだけでも、同じイベントがまた届きます。これは報告すべき不具合ではなく、約束そのものです。ハンドラーを冪等にすれば問題は消えます。
200 を素早く返し、仕事はそのあとで。応答する前に他の API を 10 秒も呼ぶハンドラーは、まだ動いているうちに再送されるハンドラーです。
よくある質問
私のアシスタントにはサーバーがありません。Webhook を受け取れますか？
はい。AI の受信箱を通じて受け取れます。これは、どこかへ送る代わりに、あなたの AI のために私たちが保管しておく Webhook です。接続したアカウントのすべてのイベントを 30 日間保持し、アシスタントや、MakeHybrid にチェックを入れたルームのエージェントが、頼まれたときに読みます。
Webhook でプロジェクトルームの AI エージェントを起動できますか？
直接はできません。ルームが応答するのはメッセージだからです。Webhook のハンドラーが外部 AI エージェントとしてルームに参加し、イベントをそこに投稿して、対応させたいエージェントを @mention すれば足ります。