ウェブフック

お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

Webhook - 使用ケース

フォームのレスポンスを自動的にCRMツールに送信。
リードが取得されたときに、メーリングリストソフトウェアに新規エントリーを生成。
フォームの提出をプロジェクト管理ツールと統合してタスクを作成。
新規のフォーム提出についてチーム内のチャットアプリケーションで通知し、チーム共同作業を促進。
フォーム提出に基づいて自動化されたメールレスポンスをトリガー。
分析と報告のためにフォームデータでデータベースソフトウェアを更新。
フォームの提出を顧客サポートシステムと統合してチケットを作成。
データの保管のために、フォームの提出をスプレッドシートやドキュメントに追加。
重要なフォームの提出に対して指定された受信者にSMS通知を送信。
スケジュールのためにフォームデータをカレンダーアプリケーションと同期。

Webhookの設定

ランディングページのワークスペース内で、右上隅にある設定アイコンをクリックします。
Integrationsを設定から選択し、左側のメニューから利用可能な設定を選択し、次に一覧からWebhookを見つけます。
作成 Webhookオプションをクリックします。
新しく作成されたWebhookの名前と説明を提供します。
ランディングページのフォームからカスタムアプリケーションに情報を転送するために使用する方法を決定します。Zoho LandingPageはWebhookで取得する、POST、PUT方法をサポートしています。Webhookのタイプは以下のセクションで説明されています。
データを送信したいURLを入力します。
Webhookに対して好ましい認証方法を選択します。

いいえ Authentication	ヘッダー認証	クエリパラメータ認証
いいえ認証メカニズム、セキュリティが低い	一般的には、それほかの方法よりも安全で、URLやリクエスト本文に機密情報が表示されないと考えられています	認証情報がURLに含まれていることから、ログに記録されたり公開されたりする可能性があり、セキュリティが低い場合があります
なし (いいえ認証)	ヘッダーの解析と検証が必要	認証情報が直接URLに含まれているため、実装がシンプル
セキュリティが問題とならないシナリオに合っています	APIエンドポイントやWebhookのセキュリティ強化によく使用されます	セキュリティ要件がそれほど厳しくない、よりシンプルな統合に適しています

Webhookのタイプ

Webhookを取得

GETリクエストはサーバーからデータを取得するために使用されます。この種類のWebhookは通常、情報をフェッチするかデータを問い合わせるために使用されます。GETリクエストによりアプリケーションは、データを変更せずにサーバーに保存されたデータにアクセスできます。これはサーバーデータを変更せずに情報を取得することが主な目標となるシナリオ、例えばユーザーの権限を取得するかデータベースのデータを問い合わせる場合に最適です。

POST Webhook

POSTリクエストはリソースの作成または変更のためにサーバーにデータを送信するために利用されます。この種類のWebhookは通常、サーバー上のデータを追加したり更新したりするために使用されます。POSTリクエストは、新規のデータをサーバーに追加したり、既存のデータを変更する必要がある場合に通常使用されます。データはリクエスト本文に含まれるためURLで見えないので、機密情報を送信するのに他の方式より安全とされています。

PUT Webhook

PUTリクエストは特に、サーバー上の既存リソースの変更または置き換えのために設計されています。この種類のWebhookは、クライアントが既存リソースを新たに更新する必要があるときに使われます。PUTリクエストではクライアントが変更点だけでなく全ての更新リソースをサーバーに送信することが必要となります。このリクエストは冪等性を持つとされており、複数の同一リクエストが同じ結果をもたらすことを意味しています。この特性は、ユーザーの権限を更新したりデータベースのエントリを変更する等、データの一貫性と精度が重要なシチュエーションに適しています。