メインコンテンツへスキップ

​
ローカル開発

Webhook はインターネット経由であなたのサーバーに到達する必要があるため、ローカルの開発サーバーを公開する必要があります。

​
Cloudflare Tunnels の利用

Cloudflare Tunnels は、ファイアウォールのポートを開放することなくローカルサーバーを公開できる無料の手段です。 
cloudflared tunnel --url localhost:3000
https://abc123.trycloudflare.com のような公開 URL が発行されます。この URL を Webhook の設定で使用してください： 
{
  "url": "https://abc123.trycloudflare.com/webhook"
}

​
トラブルシューティング

​
Webhook が届かない

  • エンドポイントにアクセスできない - サーバーがインターネットから到達可能であり、ファイアウォールが受信接続を許可していることを確認してください
  • HTTP を使用している - Webhook の URL は HTTPS を使用する必要があります
  • イベントが間違っている - Webhook 設定の events フィルターを確認してください

​
署名検証が失敗する

最もよくある原因は、生のリクエストボディではなく、パース済みの JSON ボディを使用していることです。 
// ❌ 誤り - 解析後のボディを使用している
const signature = crypto
  .createHmac('sha256', secret)
  .update(JSON.stringify(req.body))
  .digest('hex');

// ✅ 正解 - 生のボディを使用する
app.use('/webhook', express.raw({ type: 'application/json' }));
app.post('/webhook', (req, res) => {
  const signature = crypto
    .createHmac('sha256', secret)
    .update(req.body) // 生のバッファ
    .digest('hex');
});

​
その他の問題

  • シークレットが誤っている - アカウント設定 から取得した正しいシークレットを使用していることを確認してください
  • タイムアウトエラー - エンドポイントが 10 秒以内に応答するようにしてください