アンケート回答受信


アンケート回答受信

アンケートに回答があった際にイベントを通知します。

署名の検証

受信した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オブジェクト
パラメータ名 説明
poster_user_id 数字Posterで管理されるユーザーID
line_user_id 文字列LINE Messaging APIで使用するuserId
member_code 文字列Posterで管理される会員番号
surveyオブジェクト
パラメータ名 説明
id 数字アンケートID
name 文字列アンケート名
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": [
            "検索サイト"
        ]
    }
} 

※ LINE 及び LINE公式アカウント はLINE株式会社の商標または登録商標です。PosterはLINE株式会社が提供する LINE Messaging API を利用しています。