CROSSCHOP CMS

お問い合わせ(デモ)

公開 ID: 4DWQD68vxWaykHJAPUi1m

設定

項目

サイトのフォームに並ぶ項目です。送信が届いたときに、必須・選択肢・入力の形をこの一覧で確かめます。 項目名はサイトのフォームと同じ名前にします(自動返信の本文で {{項目名}} と書くときにも使います)。項目名や選択肢を変えると、サイトからの送信が合わなくなることがあるので、変えるときはサイトの制作担当者に連絡してください。 項目を 1 つも置かないと、送られた項目をそのまま受け取ります(確かめはしません)。

お問い合わせした方のメールアドレスには、種類が「メールアドレス」の最初の項目を使います(自動返信の宛先になります)。

「入力内容を確認する」で入力した内容を一覧で見せ、「修正する」「送信する」を選んでもらいます。埋め込みコードに入るので、変えたらサイトに貼り直してください

自動で送りつけるプログラムからの送信を防ぎます。切ると、添付ファイルと自動返信が使えなくなり、1 日に保存できる件数に上限がかかります

お問い合わせした方が入力したメールアドレスに、受け付けた旨のメールを 1 通送ります。本文は文字だけで、{{項目名}} と書いた所に入力内容が入ります(URL に読める部分は「(省略)」になります)

送信内容の控えを返すときに入れます。{{お問い合わせ内容}} のような長い文章も、改行を保って 1 項目 2,000 文字まで載ります。URL に読める部分だけ「(省略)」になります。入れないと、入力内容は 1 行・100 文字に切られます

入れると、届いてから保存日数を過ぎたお問い合わせを、添付ごと毎日自動で削除します(元に戻せません)。入れなければ、削除するまで残ります

サイトに組み込むための情報(制作担当者向け)埋め込みコード、確認用のフォーム、API の仕様

埋め込みコード

サイトの HTML に貼ると、このフォームに送信できます。ボット対策の行は消さないでください。 「送信を受け付けるサイト」が空なので、どのサイトからでも送れます。フォームを置くサイトのアドレスを入れてください。

確認用のフォームを開く(同じ項目のフォームを開いて、試しに送れます。送った内容は「お問い合わせ」に届きます)

送信先:https://cms.cross-chop.jp/f/4DWQD68vxWaykHJAPUi1m
<form action="https://cms.cross-chop.jp/f/4DWQD68vxWaykHJAPUi1m" method="POST" enctype="multipart/form-data">
  <div data-ccf="input">
    <label>お名前 * <input type="text" name="お名前" required></label>
    <label>メールアドレス * <input type="email" name="email" required></label>
    <label>ご用件 *
      <select name="ご用件" required>
        <option value="">選んでください</option>
        <option value="お見積もり">お見積もり</option>
        <option value="資料請求">資料請求</option>
        <option value="その他">その他</option>
      </select>
    </label>
    <label>お問い合わせ内容 * <textarea name="本文" required></textarea></label>
    <fieldset>
      <legend>チェックボックス *</legend>
      <label><input type="checkbox" name="チェックボックス" value="テスト1"> テスト1</label>
      <label><input type="checkbox" name="チェックボックス" value="テスト2"> テスト2</label>
      <label><input type="checkbox" name="チェックボックス" value="テスト3"> テスト3</label>
      <label><input type="checkbox" name="チェックボックス" value="テスト4"> テスト4</label>
      <label><input type="checkbox" name="チェックボックス" value="テスト5"> テスト5</label>
      <label><input type="checkbox" name="チェックボックス" value="テスト6"> テスト6</label>
    </fieldset>
  </div>
  <!-- 確認画面(「入力内容を確認する」で出る) -->
  <div data-ccf="confirm" style="display:none">
    <p data-ccf="note" tabindex="-1">以下の内容で送信します。よろしければ「送信する」を押してください。</p>
    <dl data-ccf="summary"></dl>
  </div>
  <!-- ボット対策(消さない)。人には見えない欄と、ページを開いた時刻 -->
  <input type="text" name="_hp" tabindex="-1" autocomplete="off" aria-hidden="true" style="position:absolute;left:-9999px">
  <input type="hidden" name="_ts">
  <script>document.currentScript.previousElementSibling.value = Date.now();</script>
  <div class="cf-turnstile" data-sitekey="0x4AAAAAAF5eyEO1FRg1lUrN"></div>
  <button type="submit" data-ccf="next">送信</button>
  <button type="button" data-ccf="back" style="display:none">修正する</button>
  <button type="submit" data-ccf="send" style="display:none">送信する</button>
  <script>
  (function () {
    var E = Element.prototype;
    var form = E.closest.call(document.currentScript, "form");
    if (!form) return;
    var defs = [{"n":"お名前","l":"お名前","t":"text","r":true},{"n":"email","l":"メールアドレス","t":"email","r":true},{"n":"ご用件","l":"ご用件","t":"select","r":true},{"n":"本文","l":"お問い合わせ内容","t":"textarea","r":true},{"n":"チェックボックス","l":"チェックボックス","t":"checkbox","r":true}];
    var part = function (k) { return E.querySelector.call(form, "[data-ccf=" + k + "]"); };
    var p = { input: part("input"), confirm: part("confirm"), summary: part("summary"), note: part("note"), next: part("next"), back: part("back"), send: part("send") };
    for (var k in p) if (!p[k]) return; // 部品が欠けていれば確認なしで送る
    var show = function (el, on) { if (on) el.style.removeProperty("display"); else el.style.setProperty("display", "none", "important"); };
    var byName = function (n) { return Array.prototype.filter.call(E.querySelectorAll.call(form, "input, select, textarea"), function (el) { return el.name === n; }); };
    var mode = function (confirming, scroll) {
      E.setAttribute.call(form, "data-ccf-mode", confirming ? "confirm" : "input");
      show(p.input, !confirming); show(p.next, !confirming);
      show(p.confirm, confirming); show(p.back, confirming); show(p.send, confirming);
      if (!scroll) return;
      if (E.getBoundingClientRect.call(form).top < 0) E.scrollIntoView.call(form);
      // 画面が変わったことを、キーボードや読み上げで使う人にも伝える
      (confirming ? p.note : byName(defs[0] ? defs[0].n : "")[0] || p.next).focus({ preventScroll: true });
    };
    var value = function (d) {
      var out = [];
      byName(d.n).forEach(function (el) {
        if (d.t === "file") { Array.prototype.forEach.call(el.files || [], function (f) { out.push(f.name); }); }
        else if (d.t === "radio" || d.t === "checkbox") { if (el.checked) out.push(el.value); }
        else if (String(el.value).trim() !== "") out.push(el.value);
      });
      return out.join("、");
    };
    EventTarget.prototype.addEventListener.call(form, "submit", function (e) {
      if (E.getAttribute.call(form, "data-ccf-mode") === "confirm") { p.send.disabled = true; return; }
      try {
        // 必須のチェックボックスは required を付けられないので、ここで確かめる(サーバーでも確かめる)
        for (var i = 0; i < defs.length; i++) {
          var d = defs[i];
          if (d.t !== "checkbox" || !d.r || value(d) !== "") continue;
          var boxes = byName(d.n), first = boxes[0];
          if (!first) continue;
          e.preventDefault();
          first.setCustomValidity("「" + d.l + "」を 1 つ以上選んでください。");
          first.reportValidity();
          boxes.forEach(function (el) { el.addEventListener("change", function () { first.setCustomValidity(""); }); });
          return;
        }
        p.summary.textContent = "";
        defs.forEach(function (d) {
          var dt = document.createElement("dt"), dd = document.createElement("dd");
          dt.textContent = d.l;
          dd.textContent = value(d) || "(未入力)";
          dd.style.whiteSpace = "pre-wrap";
          p.summary.appendChild(dt); p.summary.appendChild(dd);
        });
        mode(true, true);
        e.preventDefault();
      } catch (err) {
        // 確認画面を出せなければ、確認なしで送る(preventDefault しない)
      }
    });
    p.back.addEventListener("click", function () { mode(false, true); });
    window.addEventListener("pageshow", function (e) {
      // 戻るボタンで戻ってきたとき(bfcache)に「送信する」が押せないままにならないように。
      // 使用済みの Turnstile のトークンも残るので取り直す(そのまま送ると確認に失敗する)
      p.send.disabled = false;
      var ts = E.querySelector.call(form, ".cf-turnstile");
      if (e.persisted && ts && window.turnstile) { try { window.turnstile.reset(ts); } catch (err) {} }
    });
    p.next.textContent = "入力内容を確認する";
    mode(false, false);
  })();
  </script>
</form>
<script src="https://challenges.cloudflare.com/turnstile/v0/api.js" async defer></script>

API で送る

埋め込みコードを使わず、サイトの画面から直接送るときの仕様です。本文は multipart/form-data・application/x-www-form-urlencoded・application/json のどれでも受け取り、結果は JSON で返します(Accept が text/html だけのときは HTML)。 送る側のサイトのアドレスを「送信を受け付けるサイト」に入れてください。 このフォームは Turnstile で確かめるので、送る画面にウィジェットを置き、返ってきた値を一緒に送ります(サーバー同士の送信には使えません)。

POSThttps://cms.cross-chop.jp/f/4DWQD68vxWaykHJAPUi1m

送る項目

項目名(送信のキー)表示名種類必須値
お名前お名前1 行の文字必須
emailメールアドレスメールアドレス必須メールアドレスの形
ご用件ご用件プルダウン必須お見積もり / 資料請求 / その他(どれか 1 つ)
本文お問い合わせ内容複数行の文章必須
チェックボックスチェックボックスチェックボックス(複数選べる)必須テスト1 / テスト2 / テスト3 / テスト4 / テスト5 / テスト6(複数選ぶときは同じ項目名で繰り返す。JSON なら文字列の配列)
_hpボット対策(人には見えない欄)内部用任意空のまま送る。値が入っているとスパムとして扱う(応答は成功)
_tsボット対策(画面を開いた時刻)内部用任意画面を開いたときの Date.now()(ミリ秒)。送信までが 2 秒未満だとスパム寄りに見る
cf-turnstile-responseTurnstile のトークン内部用必須ウィジェットが返す値。1 回きりなので、送るたびに取り直す

一覧に無い項目名で送っても受け取ります(確かめずに保存します)。項目名に使えるのは文字・数字と _ . - [ ] だけで、それ以外の名前は unnamed_1 のように付け替えます。

ブラウザから送る(fetch)

// 画面を開いたときに控えておく
const openedAt = Date.now();

// 送信するとき
const body = new FormData();
body.append("お名前", "テスト");
body.append("email", "taro@example.com");
body.append("ご用件", "お見積もり");
body.append("本文", "お問い合わせの内容");
body.append("チェックボックス", "テスト1");
body.append("_hp", ""); // 人には見えない入力欄の値(空のまま)
body.append("_ts", String(openedAt));
body.append("cf-turnstile-response", token); // Turnstile のウィジェットが返した値

const res = await fetch("https://cms.cross-chop.jp/f/4DWQD68vxWaykHJAPUi1m", {
  method: "POST",
  headers: { Accept: "application/json" }, // Content-Type は付けない(ブラウザが付ける)
  body,
});
const data = await res.json().catch(() => null);
if (res.ok && data?.ok) {
  // 送れた(data.id は受付の ID)
} else {
  // data.message があれば利用者に見せる文。無ければ data.error と res.status で出し分ける
}

端末から試す(curl)

curl -H 'Accept: application/json' \
  -F 'お名前=テスト' \
  -F 'email=taro@example.com' \
  -F 'ご用件=お見積もり' \
  -F '本文=お問い合わせの内容' \
  -F 'チェックボックス=テスト1' \
  -F '_hp=' \
  -F "_ts=$(($(date +%s)*1000-5000))" \
  -F 'cf-turnstile-response=<ウィジェットが返した値>' \
  'https://cms.cross-chop.jp/f/4DWQD68vxWaykHJAPUi1m'

応答

ステータス本文(JSON)意味
200{ "ok": true, "id": "…" }受け付けた。スパムと見たものにも同じ応答を返す
400{ "ok": false, "error": "invalid field: …", "message": "「…」を入力してください。" }必須・選択肢・形の問題。message は利用者にそのまま見せられる文
400{ "ok": false, "error": "captcha failed" }Turnstile のトークンが無い・期限切れ・使用済み
400{ "ok": false, "error": "invalid body" }本文を読めない。ほかに項目・添付の大きさや数の問題(too many fields、field too large: …、file type not allowed: … など)
403{ "ok": false, "error": "origin not allowed" }「送信を受け付けるサイト」に無いオリジンから送った
404{ "ok": false, "error": "form not found" }ID が違うか、受け付けを止めている
413{ "ok": false, "error": "payload too large" }全体で 30MB を超えた
429{ "ok": false, "error": "rate limited" }同じ IP から 1 分に 10 回を超えた(Retry-After: 60)。daily limit reached は、確かめていない送信の 1 日の上限
503{ "ok": false, "error": "temporarily unavailable, retry later" }保存できなかった(届いていない)。時間をおいて送り直す。captcha unavailable, retry later も同じ