Webhooksで候補者をSlackとHubSpotに同期する

ウェブホークとは

Webhooks は、あるシステム（ClarityHire）が別のシステム（Slack、HubSpot、Zapier）にリアルタイムイベント（「候補者は面接に合格した」など）を送信するAPI接続です。

ユースケース

ユースケース1：Slack通知

候補者が面接に合格したとき、#hiring チャネルに Slack メッセージが送信されます。

@channel 🎉 Alice Johnson passed the technical interview!
Score: 4.5/5
Interviewer: John Smith
Next: Schedule on-site

セットアップ：

1. ClarityHire でウェブホック URL を設定（Slack Incoming Webhook URL）
2. イベント「Interview Passed」を選択
3. Slack メッセージテンプレートを構成

ユースケース2：HubSpot同期

候補者パフォーマンスと結果が、HubSpot CRM で連絡先にタグ付けされます。

Contact: Alice Johnson
Tags: ["Technical Screened", "Passed", "Ready for Onsite"]
Custom field: Interview Score = 4.5

セットアップ：

1. ClarityHire でウェブホック URL を設定（HubSpot Webhook）
2. イベント「Interview Completed」を選択
3. HubSpot マッピングを構成（スコア > カスタムフィールド）

ウェブホック通常

1. イベント発火：ClarityHire で面接が完了
2. ペイロードを送信：候補者データ + スコア + 結果を JSON で送信
3. エンドポイント実行：Slack または HubSpot がメッセージを受信して処理

セットアップのベストプラクティス

1. テストまず：ウェブホックを有効化する前に、ペイロードをテストします
2. セキュア：HubSpot API キーを保護（環境変数）
3. 再試行ロジック：ネットワーク障害時に再試行する
4. ログ記録：トラブルシューティング用のウェブホック呼び出しをログに記録