2026.11.17導入・活用の解説

Web-to-リードをSandboxで試して本番のフォームへ移す手順

Web-to-リードのフォームをSandboxで試してから本番へ出すときの手順です。Sandboxで生成したHTMLには、Sandboxの組織IDが入っています。本番で生成し直す順番と、試すときに使うデバッグの行をまとめます。

01どういうときに使うのか

リードのカスタム項目やレコードタイプ、割り当てルール、リードを受けて動くフローをSandboxで作り、フォームからの送信も試してから本番へ出したい場面があります。フォームを自社のサイトへ載せる作業は、Web制作会社に頼む場合もあります。

このとき、Sandboxで生成したHTMLを先に渡しておき、本番へ出す日に「Salesforceにかかわる部分だけ差し替えてもらう」段取りにするなら、どこを差し替えるのかを先に決めておく必要があります。Web-to-リードのHTMLは、生成した組織に結びついた値を含むためです。

02本番へ移すときに見直す箇所

公式ヘルプの記載から、次の2つを見直します。

箇所中身公式ヘルプの記載
組織IDHTMLに書き込まれた、生成した組織の組織IDSandboxと本番は別々の組織IDを持つ。Web-to-リードのように組織IDを書き込んで使うものは、本番へ出すときに本番の組織IDへ更新する
カスタム項目の指定カスタム項目へ値を渡す入力欄の name と idカスタム項目は、項目IDを name と id に入れて指定する(隠し項目で値を渡す方法の説明)

カスタム項目の項目IDは、画面に出ている項目名とは別のものです。HTMLを読んでも、どの入力欄がどの項目なのかを見分けにくいところです。本番で生成したHTMLの値を使えば、Sandboxの項目IDと本番の項目IDを1つずつ突き合わせる作業がいりません。

Sandboxの組織IDは、Sandboxを更新するたびに変わります。Sandboxを更新したあとは、Sandboxで試すためのフォームもSandboxで生成し直してください。

03Sandboxで試すときはデバッグの行を使う

生成されたHTMLには、テスト用の行がコメントの形で入っています。公式ヘルプでは、行の前後の <!-- と --> を外し、debugEmail の値に自分のメールアドレスを入れると、送信したときにデバッグの情報がメールで届くと説明しています。

<input type="hidden" name="debug" value="1">

フォームを試すときだけ有効にする行です。サイトへ公開する前に必ず消します。

debug の行を有効にすると、送信したときにデバッグ用のページが表示されます。公式ヘルプは、Web-to-リードのページを公開する前にこの行を消すよう書いています。

Sandboxで確かめるのは、次のようなところです。

  • 選んだ項目に値が入ったリードができるか
  • 割り当てルールやフローが、Web-to-リードで作られたリードでも動くか
  • 完了後に移動するページ(生成時に入力するURL)へ移るか

04本番へ移す順番

  1. 項目とルールを本番へ移す

    リードのカスタム項目、レコードタイプ、割り当てルール、フローなど、フォームが前提にしているものを先に本番へ移します。

  2. 本番のWeb-to-リードの設定を開く

    設定の「Web-to-リード」で、本番の組織で有効になっているか、デフォルトのリード作成者、reCAPTCHAの設定を見ます。Sandboxで決めた内容と合わせます。

  3. 本番でHTMLを生成し直す

    本番の組織で「Web-to-リードフォームの作成」を開き、Sandboxと同じ項目を選んで生成します。完了後に移動するURLも本番のサイトのものを入れます。

  4. 見た目の調整だけを本番のHTMLへ移す

    Sandboxのフォームで直したラベルやレイアウトは、本番で生成したHTMLへ移します。組織IDと項目の指定は、本番で生成したHTMLの値をそのまま使います。

  5. デバッグの行を消して渡す

    debug と debugEmail の行が有効になっていないことを確かめてから、Web制作会社へ渡します。

  6. 公開後に1件送る

    サイトに載ったフォームから1件送り、本番の組織にリードができること、項目に値が入っていることを確かめます。

Web制作会社には、Sandboxで生成したHTMLを「見た目の確認用」、本番で生成したHTMLを「公開用」として、役割を分けて渡すと取り違えが起きにくくなります。

05リードが作られなかったとき

送信してもリードが作られないとき、Salesforceはデフォルトのリード作成者へ「Salesforce could not create this lead」というメールを送ります。公式のナレッジ記事は、原因として次のものを挙げています。

原因見るところ
重複ルールで作成が止められたリードの重複ルールの動作
州・国の選択リストを使っていて、国を選ばずに州を送ったフォームの国と州の入力欄
組織でWeb-to-リードが無効になっている設定の「Web-to-リード」
一意の設定をしたカスタム項目に、既にある値が送られた一意の設定をした項目
リードを自動で取引開始するApexトリガがあるリードのトリガ

入力規則で止まったときは、理由を書かずに「入力規則のため作成できなかった」という趣旨の文面になることがあります。Sandboxで動いたのに本番で作られないときは、本番にだけある入力規則や重複ルールも疑ってください。

隠し項目で標準項目へ値を渡す行を自分で足すときは、name と id の項目名を小文字で書きます。公式のナレッジ記事は、Salesforce上のAPI名が大文字を含んでいても小文字で書くよう説明しています。カスタム項目のときは、項目IDを入れます。

06確認した環境

  • 2026年11月 / Salesforce Winter '27(API バージョン 68.0)時点の公式ドキュメントで確認しています
  • 内容は、Salesforce ヘルプの「Servers and IDs」「Generate Leads from Your Website with Web-to-Lead」と、Web-to-リードに関するナレッジ記事(いずれも英語版)の記載に合わせています

07まとめ

  • Web-to-リードのHTMLは、生成した組織の組織IDを含み、カスタム項目は項目IDで指定します
  • Sandboxと本番は組織IDが違い、Sandboxの組織IDは更新のたびに変わります
  • Sandboxでは debug・debugEmail の行を有効にして試し、公開前に消します
  • 本番へ出すときは、項目とルールを移してから本番でHTMLを生成し直し、見た目の調整だけを移します
  • リードが作られないときは、デフォルトのリード作成者に届くメールと、本番の重複ルール・入力規則を確かめます

08参考

SalesforceとAIの導入・運用についてご相談ください

導入前の検討から、お使いの環境の改修・運用、AIの導入・活用まで承ります。状況を伺ったうえで、進め方をご提案します。