Feversocialのフォームシステムは、Webhook通知機能に対応しています。管理画面でWebhook URLを登録しておけば、フォームに新しい回答が届くたびに、FeversocialのシステムがそのURLへ通知を送信し、回答データも同時に届きます。
あるサービスにメールアドレスを登録しておくと、最新情報が届いたときに通知が届く——そんな経験はありませんか。Webhookも、これによく似た「購読の仕組み」です。2つのシステムの間でやり取りするための、通知の仕組みといえます。違いは、システム間の送信先がURLアドレスになっている点です。このURLのことをWebhook URLと呼びます。
簡単に言うと、Webhookはインターネット上の通知技術、またはひとつのアドレスのようなものだとイメージしてください。異なる2つのシステムは、あらかじめ決めておいたこのアドレスを通じて、データをやり取りできます。
Feversocialのフォーム・キャンペーンシステムにも、この通知機能が備わっています。管理画面でWebhook URLを登録しておけば、フォームに新しい回答があったとき、あるいはキャンペーンへの参加が完了するたびに、FeversocialのシステムがそのWebhook URLへ通知を送信し、回答またはキャンペーンのデータを同時に届けます(データ形式は以下のとおりです)。
Googleスプレッドシート、CRM(顧客関係管理)/CDP(顧客データプラットフォーム)/チャットボット、メール配信サービス、あるいはZapierやMakeのようなデータ連携プラットフォームなど、世の中の多くのシステムがWebhookデータを受け取れるようになっています。
社内のIT担当者に依頼して、フォームデータを自社のデータベースシステムへリアルタイムで記録することも可能です。
外側フィールド(Header)
| Header/Key | データ型 | 説明 |
|---|---|---|
| X-Fever-Signature | string | Feversocialが発行するデジタル署名。HMAC-SHA256で生成されます |
| webhook_id | string | Webhookの一意なID |
| event_type | string | Webhookのイベントタイプ |
| version | string | Webhook APIのバージョン番号 |
| payload | object | メインのデータ |
Payload形式の説明
| Key | データ型 | 説明 |
|---|---|---|
| form_id | number | フォームの一意なID |
| title | string | フォームタイトル |
| serial_number | number | キャンペーン参加者のシリアルコード |
| uid | string | Feversocial内部の一意な識別番号 |
| login_id | string | ログインユーザーのID(Facebook、LINE、または会員ID) |
| submitted_at | number | UNIXタイムスタンプ |
| fields | array | フォームデータのフィールド |
| fields[].id | number | フィールドの一意なID |
| fields[].name | string | フィールドの表示名 |
| fields[].value | string, bool | 参加者が入力した値 |
| fields[].ref | string | フィールドの別名 |
| fields[].is_multiple_choice | bool | 複数選択かどうか |
| tracking | object | トラッキングコード|フォームのURLにUTMパラメータが含まれている場合、システムが自動的に保存します |
| tracking.ga_client_id | string | |
| tracking.utm_campaign | string | |
| tracking.utm_source | string | |
| tracking.utm_medium | string | |
| tracking.utm_term | string | |
| tracking.utm_content | string |