データ連携

Webhookを使えば フォームデータと参加結果をサードパーティシステムへ即座に連携

FeversocialのフォームシステムはWebhook通知機能を標準搭載しています。管理画面で送信先のWebhook URLを登録しておくだけで、ユーザーがフォームを送信した瞬間にシステムが自動で検知。登録されたURLへリアルタイムで通知を行うとともに、入力されたデータを即座に外部システムへ転送します。

Webhookとは

ウェブサイトでメールアドレスを登録しておき、最新情報が届くニュースレターをイメージしてみてください。Webhookもこれとよく似た「システム同士の定期購読メカニズム」です。大きな違いは、通知を受け取る宛先がメールアドレスではなく「URL(Webアドレス)」である点です。このデータの受け取り先に指定するURLのことを「Webhook URL」と呼びます。

簡単に言えば、Webhookは「システムの自動通知メカニズム」です。2つのシステムが指定したWebアドレスを通じて、リアルタイムにデータをやり取りします。

FeverSocialのフォームおよびキャンペーンシステムには、便利な自動通知機能が備わっています。使い方はとても簡単です。管理画面であらかじめ「Webhook URL」を登録しておくだけ。ユーザーがフォームに入力したり、キャンペーンへの参加を完了したりするたびに、FeverSocialのシステムが登録されたURLへ即座にお知らせを送ります。その際、入力された内容や参加データも一緒にその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