ClickFunnels での Webhook の作成

ClickFunnels Webhook は、データを受信できる Webhook URL を介して ClickFunnels から別のプラットフォームにデータを転送する方法を提供します。基本的に、ClickFunnels は、指定されたイベントが発生するたびに、指定された URL に POST リクエストを行います。この記事では、ClickFunnels で Webhook を作成および管理するプロセスについて説明します。

必要条件

• ClickFunnels プランのスケーリング、最適化、または支配

• 受信 POST 要求を処理するように適切に構成された外部 Webhook エンドポイント URL

手記：

Webhook は、技術的な経験を持つユーザーを対象とした高度な機能です。Webhook、JSON ペイロードの処理、または外部サービスとの統合に慣れていない場合は、資格のある開発者に相談して、適切なセットアップと配信処理を確保することをお勧めします。

ClickFunnels Webhook の概要

ClickFunnels Webhook は、特定のイベントが発生したときに、ClickFunnels から外部サービスにリアルタイムでデータを送信できるようにする機能です。これは、ClickFunnels を他のプラットフォームと統合し、ワークフローを自動化する場合に特に役立ちます。Webhook は、ClickFunnels の既存の直接統合に代わる優れた代替手段を提供し、ネイティブ統合を持たないプラットフォームと接続する柔軟性を提供します。これにより、ユーザーは、使用されている外部サービスに関係なく、効率的で自動化されたデータ フローを維持できます。

新しい Webhook の作成

ClickFunnels で Webhook を作成するには、次の手順に従います。

1. 左側のナビゲーションで [ワークスペース設定 ] に移動します。

2. [ Webhook] を選択します。

3. [ Add New Endpoint ] ボタンをクリックします。

   

4. Webhookの[ 名前 ]を入力します(例:「Shopifyに注文を送信」)。

5. [URL] フィールドに、データの送信先のアプリケーションまたは API のエンドポイント URL を入力します。

6. [ イベントタイプ] フィールドで、Webhook をトリガーするイベントを選択します (例: contact.created と order.completed など) を呼び出します。

   イベントタイプの完全なリストについては、API ドキュメントの Webhook イベントタイプを参照してください。

7. [ API バージョン] フィールドで、API バージョンを選択します。

   大事な：

   V1 Webhook はメンテナンスサポートのみを受け、さらに開発されていないため、使用は推奨されません。新しい Webhook は通常 V2 専用であるため、可能な限り V2 を選択することをお勧めします。

8. エンドポイントスコープの指定(オプション): [ エンドポイントスコープ ]セクションでは、Webhookを特定の ファネル と ページに制限できます。これは、ClickFunnels セットアップの特定の部分で発生するイベントによってのみ Webhook をトリガーする場合に便利です。

   

   大事な：

   エンドポイントのスコープは、特定のイベントに制限されます。このスコープ内ですべてのイベントがサポートされているわけではありません。ページと目標到達プロセスを混在させることはできますが、選択したイベントタイプが対象であることを確認してください。[エンドポイント スコープ(Endpoint Scopes)] セクションの横にある情報アイコンをクリックすると、サポートされているイベントのリストが表示されます。

9. [ エンドポイントの作成 ] ボタンをクリックして、新しい Webhook を保存します。

Webhook配信の表示

ClickFunnels で Webhook 配信を表示するには、次の手順に従います。

1. [ワークスペース設定] に移動します。

2. [ Webhook] を選択します。

3. 表示する特定の Webhook を選択します。

4. [ 配信] セクションまで下にスクロールします。「配信」テーブルには、すべての配信試行が表示されます。

5. エントリの横にある [詳細] ボタンをクリックして、詳細を表示します。これにより、配信ステータス、試行タイムスタンプ、応答コードが表示されます。

   

ClickFunnels は、イベント タイプ、連絡先 ID、関連するメタデータなどの構造化された情報を含む JSON 形式で Webhook ペイロードを送信します。この JSON を解析してアクションをトリガーしたり、データをサードパーティのツールや API に渡してさらに処理したりできます。

Webhook イベントの再試行:

配信が失敗した場合、ClickFunnels は特定の条件で Webhook を自動的に再試行します。各試行は [配信試行] セクションに記録され、試行の時刻、ステータス、および応答コードが表示されます。再試行の仕組みに関する技術的な詳細については、 Webhook API Documentationを参照してください。

既存の Webhook の変更

ClickFunnels の既存の Webhook を変更するには、次の手順に従います。

1. [ワークスペース設定] に移動します。

2. [ Webhook] を選択します。

3. 編集するWebhookの横にある 歯車(⚙️) アイコンをクリックします。

   

4. 必要に応じて、名前、URL、イベントタイプ、エンドポイントスコープを更新します。

5. [ エンドポイントの更新] をクリックして、変更を保存します。

Webhook の削除

ClickFunnels で Webhook を削除するには、次の手順に従います。

1. [ワークスペース設定] に移動します。

2. [ Webhook] を選択します。

3. 削除するWebhookの横にあるゴミ箱(🗑️)アイコンをクリックします。

   

4. 表示されるプロンプトで、[ 続行] をクリックして削除を確認します。

   警告：

   Webhook の削除は永続的であり、元に戻すことはできません。Webhookに関連付けられている既存の配信ログはすべて削除されます。注意して、正しい Webhook を削除していることを確認してください。

Webhook のトラブルシューティング

Webhook が正しく機能し、意図したデータをエラーなく送信するには、Webhook の効果的なトラブルシューティングが重要です。ClickFunnels の Webhook のトラブルシューティングに役立つ手順とベスト プラクティスをいくつか紹介します。

1. 配送の詳細を表示する:    

   • まず、ClickFunnels 内の配信の詳細を確認します。ワークスペース設定の「Webhooks」セクションに移動し、特定の Webhook を選択して、配信テーブルを確認します。エントリの横にある [詳細] ボタンをクリックすると、配信ステータス、試行タイムスタンプ、応答コードに関する詳細情報が表示されます。これは、Webhook 配信に差し迫った問題があるかどうかを特定するのに役立ちます。

2. Webhook テストサイトを使用する:

   • Webhook をさらにテストしてトラブルシューティングするには、 webhook.site などの Webhook テスト サービスを使用できます。このサービスを使用すると、ClickFunnels Webhook のテストに使用できる一時的な Webhook URL を作成できます。

   • webhook.site に移動し、一意のURLを生成します。

   • ClickFunnels Webhook 設定の URL を webhook.site URL に置き換えます。

   • Webhook をトリガーすると予想されるアクション (注文の完了、連絡先の削除など) を ClickFunnels で実行します。

   • webhook.site に戻り、テスト URL に送信されたデータを調べます。これにより、どのようなデータが送信されているかが正確にわかり、不一致や問題を特定するのに役立ちます。

3. イベントの種類とスコープを確認します。    

   • Webhook 設定で選択したイベントタイプが、テストするアクションに適切であることを確認します。エンドポイントのスコープを再確認して、Webhook が正しいファネルとページに対してトリガーされるように設定されていることを確認します。

   • 必要に応じて、Webhook テストサイトを使用して再度監視およびテストする特定のイベントに一致するように、イベントの種類とスコープを調整します。

4. API バージョンの互換性を確認します。    

   • V1 Webhook は非推奨であり、すべての機能やイベントをサポートしていない可能性があるため、正しい API バージョン (できれば V2) を使用していることを確認してください。

   • 統合する外部プラットフォームまたはサービスも、使用しているバージョンをサポートしていることを確認します。

5. 応答コードを分析します。

   • Webhook 配信の試行中に受信した応答コードに注意してください。200 (OK)、400 (不正なリクエスト)、401 (未承認)、500 (内部サーバー エラー) などの一般的な HTTP 応答コードは、潜在的な問題に関する洞察を提供します。

   • たとえば、400 エラーはデータ形式の問題を示している可能性があり、401 エラーは認証の問題を示唆しています。

6. ドキュメントとサポートを参照してください。    

   • 追加のガイダンスとトラブルシューティングのヒントについては、ClickFunnels の API ドキュメントとサポート リソースを参照してください。この API Documentation には、Webhook イベントの種類、パラメーター、ベストプラクティスに関する包括的な詳細が記載されています。

   • 問題が解決しない場合は、ClickFunnels サポートに問い合わせてサポートを受けることを検討してください。より迅速かつ正確な応答を受け取るために、できるだけ多くの情報を提供します。画像、画面録画、データ ログ、またはサポート チームが問題をより効果的に分析して理解するのに役立つその他の関連詳細を含めます。

これらの手順に従い、利用可能なツールとリソースを利用することで、ClickFunnels Webhook の問題を効果的にトラブルシューティングして解決し、外部システムとのシームレスな統合とデータ フローを確保できます。

Webhook に関するよくある質問