データ連携

Webhookを使えば フォームデータと参加結果を第三者システムへリアルタイム連携

Feversocialのフォームシステムは、Webhook通知機能に対応しています。管理画面でWebhook URLを登録しておけば、フォームに新しい回答が届くたびに、FeversocialのシステムがそのURLへ通知を送信し、回答データも同時に届きます。

Webhookとは

あるサービスにメールアドレスを登録しておくと、最新情報が届いたときに通知が届く——そんな経験はありませんか。Webhookも、これによく似た「購読の仕組み」です。2つのシステムの間でやり取りするための、通知の仕組みといえます。違いは、システム間の送信先がURLアドレスになっている点です。このURLのことをWebhook URLと呼びます。

簡単に言うと、Webhookはインターネット上の通知技術、またはひとつのアドレスのようなものだとイメージしてください。異なる2つのシステムは、あらかじめ決めておいたこのアドレスを通じて、データをやり取りできます。

Feversocialのフォーム・キャンペーンシステムにも、この通知機能が備わっています。管理画面でWebhook URLを登録しておけば、フォームに新しい回答があったとき、あるいはキャンペーンへの参加が完了するたびに、FeversocialのシステムがそのWebhook URLへ通知を送信し、回答またはキャンペーンのデータを同時に届けます(データ形式は以下のとおりです)。

Googleスプレッドシート、CRM(顧客関係管理)/CDP(顧客データプラットフォーム)/チャットボット、メール配信サービス、あるいはZapierやMakeのようなデータ連携プラットフォームなど、世の中の多くのシステムがWebhookデータを受け取れるようになっています。

社内のIT担当者に依頼して、フォームデータを自社のデータベースシステムへリアルタイムで記録することも可能です。

Webhookデータ送信の仕組み図

Feversocialフォーム Webhook形式

以下は、あるフォームの形式例です
{
    "webhook_id": “f2f7a357-971f-459d-97b6-636f09d913bd”,
    "event_type": "formSubmit",
    "version": "1",
    "payload": {
        "form_id": 104,
        "title": "form example",
        “serial_number”: 190,
        “uid”: "temp_8fd49340-950b-11ea-b0fb-79250516b2b6",
        “login_id”:  "12345",
        "submitted_at": 1585129540,
        "fields": [
            {
                "id": 1,
                "name": "full name",
                "value": "John Doe",
                "ref": "your name"
            },
            {
                "id": 2,
                "name": "email",
                "value": "[email protected]",
                "ref": ""
            },
            {
                "id": 3,
                "name": "what's your favorite pets",
                "value": "dogs,cats,rabbits",
                "ref": ""
            },
            {
                "id": 4,
                "name": "what's your gender",
                "value": "male",
                "ref": ""
            },
            {
                "id": 5,
                "name": "county/city",
                "value": "Taipei City",
                "ref": "address1"
            },
            {
                "id": 6,
                "name": "district",
                "value": "Zhongshan District",
                "ref": "address2"
            },
            {
                "id": 7,
                "name": "term of use",
                "value": true,
                "ref": ""
            },
            {
                "id": 8,
                "name": "rf",
                "value": "some hidden value",
                "ref": ""
            }
        ],
       "tracking": {            
                "ga_client_id": "1855437272.1588751465",            
                "utm_source": "",            
                "utm_campaign": "",            
                "utm_medium": "",            
                "utm_term": "",            
                "utm_content": ""        
         }
    }
}

外側フィールド(Header)

Header/Keyデータ型説明
X-Fever-SignaturestringFeversocialが発行するデジタル署名。HMAC-SHA256で生成されます
webhook_idstringWebhookの一意なID
event_typestringWebhookのイベントタイプ
versionstringWebhook APIのバージョン番号
payloadobjectメインのデータ

Payload形式の説明

Keyデータ型説明
form_idnumberフォームの一意なID
titlestringフォームタイトル
serial_numbernumberキャンペーン参加者のシリアルコード
uidstringFeversocial内部の一意な識別番号
login_idstringログインユーザーのID(Facebook、LINE、または会員ID)
submitted_atnumberUNIXタイムスタンプ
fieldsarrayフォームデータのフィールド
fields[].idnumberフィールドの一意なID
fields[].namestringフィールドの表示名
fields[].valuestring, bool参加者が入力した値
fields[].refstringフィールドの別名
fields[].is_multiple_choicebool複数選択かどうか
trackingobjectトラッキングコード|フォームのURLにUTMパラメータが含まれている場合、システムが自動的に保存します
tracking.ga_client_idstring
tracking.utm_campaignstring
tracking.utm_sourcestring
tracking.utm_mediumstring
tracking.utm_termstring
tracking.utm_contentstring
icon_BackToTop