開発者向け

Webhookで回答を自分のサーバーに送る

すべての回答を署名付きのJSONペイロードで受け取り、StrawPollから送られたものか確認します。

最終更新

Webhookは、各回答を自分のサーバー上のアドレスに、JSON本文付きのPOSTリクエストとして送信します。

設定する

  1. ダッシュボードで連携を開き、連携を追加をクリックしてWebhooksを選びます。
  2. エンドポイントのURLを入力します。https://で始まり、インターネットからアクセスできる必要があります。
  3. 任意: エンドポイントが必要とするヘッダー(例: Authorizationヘッダー)を追加します。
  4. 投票を選び、新しい回答、変更された回答、またはその両方を送るかを選んで保存します。
  5. 連携のページから署名シークレットをコピーし、テストを送信をクリックします。

ペイロード

json
{
	"id": "0193f1c2-…",
	"event": "response.created",
	"createdAt": "2026-11-08T14:05:12.000Z",
	"form": {
		"id": "…",
		"slug": "team-lunch",
		"name": "Team lunch",
		"title": "Where should we eat on Friday?",
		"url": "https://strawpoll.com/…"
	},
	"response": {
		"id": "…",
		"createdAt": "2026-11-08T14:05:11.000Z",
		"updatedAt": null,
		"deletedAt": null,
		"respondent": { "name": "Sam", "email": "sam@example.com", "phone": null },
		"answers": [
			{
				"fieldId": "…",
				"question": "Q1 · Where should we eat?",
				"value": "…",
				"text": "Pizza"
			}
		],
		"comment": null
	}
}
  • eventはresponse.created、response.updated、response.deletedのいずれかで、テストを送信の場合はpingです。
  • response.deletedでは、deletedAtに回答者が回答を削除した日時が、answersに送信されていた内容が入ります。自分の記録からも削除してください。
  • idは送信ごとに一意です。すでに処理した送信を無視するために使えます。
  • answersには、すべての質問が順番に並びます。textは結果に表示されるとおりの回答で、valueは生の値です。valueの形式は質問タイプによって異なります。

ヘッダー

ヘッダー内容
X-StrawPoll-Eventイベント(例: response.created)
X-StrawPoll-Delivery送信のid
X-StrawPoll-Timestamp送信日時(Unix秒)
X-StrawPoll-Signaturesha256=と署名

署名を検証する

署名は、送信ID、タイムスタンプ、生のリクエスト本文をドットでつないだものに対して、署名シークレットで作成したHMAC-SHA256です。自分で計算して比較します。

js
import { createHmac, timingSafeEqual } from 'node:crypto';

function isFromStrawPoll(request, rawBody, secret) {
	const id = request.headers['x-strawpoll-delivery'];
	const timestamp = request.headers['x-strawpoll-timestamp'];
	const signature = request.headers['x-strawpoll-signature'] ?? '';

	const expected =
		'sha256=' + createHmac('sha256', secret).update(`${id}.${timestamp}.${rawBody}`).digest('hex');
	const fresh = Math.abs(Date.now() / 1000 - Number(timestamp)) < 300;

	return (
		fresh &&
		signature.length === expected.length &&
		timingSafeEqual(Buffer.from(signature), Buffer.from(expected))
	);
}

本文はパースする前の、受け取ったままの状態で署名を計算してください。古いタイムスタンプを拒否すれば、傍受したリクエストを第三者が再送する攻撃を防げます。

シークレットが漏れた可能性がある場合は、連携のページで再生成をクリックします。古いシークレットはすぐに使えなくなるので、エンドポイントを更新してください。

時間内に応答する

10秒以内に、2xxのいずれかのステータスで応答してください。時間のかかる処理は、応答したあとに行います。

送信に失敗すると、StrawPollはその後30秒の間に、同じidで3回再送します。429以外の4xxの応答は再送せず、リダイレクトには一切従いません。すべての試行は、サーバーの応答内容とともに最近の送信に表示されます。