Webhook バージョン１

kintoneでの設定

kintone にはあらかじめ、クローバと連携するアプリを作成しておく必要があります。

フォームの編集で、以下のようにフィールドにフィールドコードを設定してください。

フィールドコード	説明
name	応募者の氏名が入ります。
created_at	エントリー日時が入ります。
url	エントリー詳細ページのURLが入ります。
email	応募者のメールアドレスが入ります（メールアドレスを要求する場合のみ）。
event	イベント名称が入ります（予定イベントのフォームのみ）。
event_datetime	イベント開始日時が入ります（予定イベントのフォームのみ）。
event_quantity	申し込み人数が入ります（予定イベントのフォームのみ）。
amount_paid	支払い金額の合計が入ります（予定イベントのフォームのみ）。
payment_status	支払いステータスが入ります（予定イベントのフォームのみ）。
field_1, field_2...	各フィールドの値が入ります。「フォーム設定」で設定した順に１からの値を指定します。

既存のアプリでフィールドコードを変更せずに連携する方法は こちらをご覧ください。

各フィールドのフィールドタイプは以下のようになります。

フィールド	フィールドタイプ
name	文字列（１行）
created_at	日時
url	文字列（１行）もしくはリンク
email	文字列（１行）もしくはリンク
event	文字列（１行）
event_datetime	文字列（１行）もしくは日付時刻
event_quantity	数値
amount_paid	数値
payment_status	文字列（１行）
テキストフィールド	文字列（１行）
複数行テキストフィールド	文字列（複数行）
リストフィールド	文字列（１行）もしくはドロップダウン
ラジオボタンフィールド	文字列（１行）もしくはラジオボタン
チェックボックスフィールド	チェックボックス
日付フィールド	文字列（１行）もしくは日付
添付ファイルフィールド	文字列（１行）

注意事項

添付ファイルはファイル名のみ登録されます。ラジオボタン、ドロップダウン、チェックボックスの候補がkintoneに登録されていない場合はエラーとなります。

クローバでの設定

kintone と連携を行うには、以下のようにWebフックの設定を行います。

サービス

「kintone」を選択します。

URL

kintone のURLをホスト名まで指定します（例：https://yourdomain.cybozu.com）。

BASIC認証ユーザー・パスワード

ベーシック認証を設定している場合は、ユーザー名とパスワードを設定します。

アプリID

データを登録するアプリのアプリIDを指定します。アプリIDはkintone の該当アプリを開いたときにURLの「/k/」の後にある数字になります。

APIトークン

kintone のAPIトークンを設定します。

APIトークンの取得方法については、 kintone のヘルプを参照してください。

kintone はサイボウズ株式会社の商標または登録商標です。

それ以外のサービス向けのWebフックを追加する

サービス

「その他」を選択します。

URL

APIのエンドポイントを指定します。

BASIC認証ユーザー・パスワード

必要に応じて、ベーシック認証のユーザー名とパスワードを設定します。

カスタムヘッダー

必要に応じて、カスタムヘッダーをJSON形式で設定します。

カスタムデータ

必要に応じて、カスタムデータをJSON形式で設定します。

カスタムデータには、プレイスホルダーを利用できます。フィールド名の前後に"%"をつけたものがプレイスホルダーになります。

プレイスホルダーの例	置換される値
%name%	応募者の氏名
%created_at%	エントリー日時
%url%	エントリー詳細ページのURL
%email%	応募者のメールアドレス（メールアドレスを要求する場合のみ）
%event%	イベント名称（予定イベントのフォームのみ）
%field_1%, %field_2%...	各フィールドの値（「フォーム設定」で設定した順に１からの値を指定します）

カスタムデータの例

Webフック共通の注意事項

Webフックの実行に3回失敗した場合、そのWebフックは無効となります。再び有効にするには、手動で有効のチェックをオンにしてください。