プロバイダーイベントに反応する
連携は、アプリからサービスへ外向きに到達させるだけではありません。そのサービス内で何かが起きたときに、アプリが反応できるようにもします。Slack に新しいメッセージが届く、GitHub で issue が開かれる、Calendly でフォームが送信される。そしてアプリが自動的に応答します。このページでは、その考え方と設定方法を説明します。
イベントトリガーとは
イベントトリガーは、外部サービスで起きたことを、それに応答してアプリが行うことへ接続します。気にするイベントを選び、それが発火したときに何が起きるべきかを選びます。
構築できる例をいくつか挙げます。
- 新しい GitHub issue が開かれる → アプリがレコードとして保存し、チームに通知する。
- Slack チャンネルにメッセージが投稿される → アプリが live ダッシュボードに表示する。
- Calendly ミーティングが予約される → アプリが顧客記録を更新する。
変更をポーリングしたり、連携のための仕組みを自分で書く必要もありません。イベントと応答を説明すると、Kliv がイベントを待ち受け、発生時に応答を実行します。
イベントに応答できるもの
イベントが発火したとき、次の 2 つのどちらかを実行できます。
- カスタムサーバー側ロジックを実行する。 イベントはedge functionを起動できます。これは、レコードの保存、別の連携の呼び出し、メール送信など、必要なことを行う小さな裏側のロジックです。何をすべきかを説明すると、AI が書きます。
- アプリを live で更新する。 イベントはアプリへ直接ストリームされ、訪問者が見ているものをリアルタイムで更新できます。live フィード、ダッシュボード、アクティビティ表示に便利です。
カスタムロジックを実行する応答は、連携を通じて戻り方向に操作することもできます。たとえば、新しい GitHub issue に反応して Slack に概要を投稿します。これを機能させるには、使用するアクションがイベントに対して許可されている必要があります。コネクターを利用できる人の制御を参照してください。
設定する
イベントトリガーは Settings → Integrations から設定します。連携を開き、次に接続済みアカウントを開くと、待ち受けられるイベントが一覧表示されます。各トリガーで次を選びます。
- 待ち受けるイベント、
- 応答:カスタムロジックを実行するか、アプリへストリームするか。
保存すると、Kliv はイベントを監視し、発生するたびに応答を実行します。
知っておくとよいこと
- 配信は信頼できます。 Kliv は各イベントを少なくとも 1 回配信することを目指し、応答が最初に成功しない場合は再試行します。そのため一時的な問題でイベントが失われることはありません。
- イベントは利用量に数えられます。 受信イベントへの反応は、アカウントの利用量を使います。
関連
- edge functions でアプリを拡張する — カスタムサーバー側ロジックでできること。
- コネクターを利用できる人の制御 — イベントが連携のアクションを使えるようにします。
- 接続できるもの — 利用可能な連携。