アンケート回答受信
アンケート回答受信
アンケートに回答があった際にイベントを通知します。
署名の検証
受信したwebhookイベントがPosterから送信された正当なものである事を確認するため、必ず署名の検証を行って下さい。
- 発行された「webhook_key」を秘密鍵として、HMAC-SHA256アルゴリズムを使用してリクエストボディのダイジェスト値を取得します。
- ダイジェスト値をBase64エンコードした値と、リクエストヘッダーのX-Poster-Signatureに含まれる署名が一致することを確認します。
| 検証用の署名 | リクエストヘッダー「X-Poster-Signature」でbase64エンコードされた署名情報が送信されます |
|---|---|
| 署名検証用のキー（webhook_key） | Posterから発行された40文字の文字列 （Poster管理画面から確認して下さい。） |
イベントオブジェクト
Webhookで送信されるイベントはJSON形式の文字列をリクエストBodyとして指定されたURLにPOST送信されます。
※右にスクロールできます。
| プロパティ名 | 型 | 説明 | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| event | 文字列 | survey_answer | ||||||||
| user | オブジェクト | |||||||||
|
||||||||||
| survey | オブジェクト | |||||||||
|
||||||||||
| answer_id | 数字 | 回答ID | ||||||||
| answered_at | 文字列 | 回答日時(YYYY-MM-DD HH:ii:ss) | ||||||||
| answers | オブジェクト | 設問IDをキーとして 回答内容を文字列の配列で値に持つオブジェクト |
||||||||
Requestデータサンプル
{
"event": "survey_answer",
"user": {
"poster_user_id": 9999999999,
"line_user_id": "Udeadbeefdeadbeefdeadbeefdeadbeef",
"member_code": "20-99999-999999"
},
"survey": {
"id": 8888888888,
"name": "商品購入者アンケート"
},
"answer_id": 7777777777,
"answered_at": "2021-10-01 10:00:00",
"answers": {
"abcde111111111.22222222": [
"ウェブ広告","その他"
],
"abcde123456789.01234567": [
"検索サイト"
]
}
}
