サードパーティ統合

1. フォーム設定に移動

ダッシュボードでフォームを選択し、「設定」タブをクリックします。

2. Webhook URLを入力

「統合」セクションで、Webhook URLフィールドにエンドポイントURLを入力します。

https://your-app.com/api/webhooks/leadduo

3. Webhook Secret を設定（推奨）

セキュリティのため、Webhook Secretを設定することを強くお勧めします。これにより、リクエストが本当にLeadDuoから送信されたことを確認できます。

署名の検証

署名は、リクエストボディのHMAC SHA256ハッシュです。以下は検証方法の例です：

const crypto = require('crypto');

function verifyWebhook(body, signature, secret) {
  const hmac = crypto.createHmac('sha256', secret);
  hmac.update(JSON.stringify(body));
  const expectedSignature = hmac.digest('hex');
  
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expectedSignature)
  );
}

// Usage
const signature = req.headers['x-leadduo-signature'];
const isValid = verifyWebhook(req.body, signature, 'your-secret');

if (isValid) {
  console.log('Webhook verified!');
  // Process the webhook
} else {
  console.log('Invalid signature');
}

設定手順

1. Zapierで新しいZapを作成
2. トリガーとして「Webhooks by Zapier」を選択
3. 「Catch Hook」を選択
4. ZapierからWebhook URLをコピー
5. LeadDuoのフォーム設定 → Webhook URLに貼り付け
6. フォームをテスト送信してZapierでデータを確認
7. Zapierで任意のアクションを追加（Gmail、Slack、Google Sheetsなど）

人気の統合例

✨ 主な機能

✨ 主な機能

✨ 主な機能

Q: Webhookはどのくらい速く配信されますか？

A: フォーム送信後、通常1〜2秒以内にWebhookが配信されます。最大タイムアウトは10秒です。

Q: Webhookが失敗した場合はどうなりますか？

A: Webhook配信が失敗してもフォーム送信は保存されます。ダッシュボードでいつでもデータを確認できます。現在、自動リトライは実装していませんが、ロードマップに含まれています。

Q: 複数のWebhook URLを設定できますか？

A: 現在、フォームごとに1つのWebhook URLをサポートしています。複数のシステムに送信する必要がある場合は、Zapierを使用して1つのWebhookから複数のアクションを実行できます。

Q: Webhook Secretは必須ですか？

A: いいえ、オプションですが、セキュリティのために強く推奨します。Secretを設定すると、リクエストが本当にLeadDuoから送信されたことを確認できます。

Q: ローカル開発環境でWebhookをテストできますか？

A: ローカルホストは公開されていないため、直接テストできません。ngrokやlocaltunnelなどのツールを使用してローカルサーバーを公開するか、RequestBinやWebhook.siteなどのサービスを使用してペイロードを確認できます。

Q: NotionとAirtableの統合は無料プランで利用できますか？

A: いいえ、NotionとAirtableの統合はGrowthプラン以上で利用可能です。これらの統合により、フォーム送信をNotionデータベースやAirtableベースに自動的に送信できます。

Q: 複数のNotion/Airtable統合を設定できますか？

A: 現在、各フォームで1つのNotion統合と1つのAirtable統合を設定できます。複数のデータベースやベースに送信する必要がある場合は、Zapierを使用し1つのWebhookから複数の宛先に配信できます。

Q: NotionやAirtableの統合でフィールドマッピングはどのように機能しますか？

A: フォームフィールドをNotionプロパティまたはAirtableフィールドに手動でマッピングします。統合設定時に、各フォームフィールドをどのデータベースプロパティに送信するかを選択できます。フィールドタイプ（テキスト、メール、電話など）が一致していることを確認してください。

Q: Slack通知をカスタマイズできますか？

A: はい！LeadDuoはSlack Incoming Webhookを使用して、リード情報を含む書式設定されたメッセージを送信します。メッセージには、フォーム名、リードデータ、LeadQualifyスコア（有効な場合）が含まれます。さらにカスタマイズする必要がある場合は、Zapierを使用してカスタムメッセージフォーマットを作成できます。

Q: 複数のNotion/Airtable統合を設定できますか？

A: 現在、各フォームで1つのNotion統合と1つのAirtable統合を設定できます。複数のデータベースやベースに送信する必要がある場合は、Zapierを使用し1つのWebhookから複数の宛先に配信できます。

Q: NotionやAirtableの統合でフィールドマッピングはどのように機能しますか？

A: フォームフィールドをNotionプロパティまたはAirtableフィールドに手動でマッピングします。統合設定時に、各フォームフィールドをどのデータベースプロパティに送信するかを選択できます。フィールドタイプ（テキスト、メール、電話など）が一致していることを確認してください。

Q: 分析データとは何ですか？どのような情報が含まれますか？

A: LeadDuoは、各フォーム送信時に自動的にアトリビューションとコンテキストデータを収集します。これには、UTMパラメータ（utm_source、utm_medium、utm_campaignなど）、リファラーURL、ページURL、ユーザーエージェント、画面サイズ、言語、タイムゾーン、送信までの時間が含まれます。このデータは、リードがどこから来たのか、どのマーケティングキャンペーンが効果的かを理解するのに役立ちます。

Q: 統合で分析データを無効にできますか？

A: はい！各統合（メール、Slack、Webhook）には、分析データを含めるかどうかを制御するトグルがあります。デフォルトでは、SlackとWebhookで有効、メールで無効になっています。統合設定でいつでも変更できます。

Q: 分析データはどのように統合に表示されますか？

A: 表示方法は統合によって異なります。Webhookでは、analyticsオブジェクトとしてJSONペイロードに含まれます。Slackでは、メイン送信データの下にコンテキスト行として表示されます。メールでは、メッセージの下部にフッターセクションとして表示されます。