musubi

サーバーから送る(webhook)

最終更新: 2026年11月18日

画面イメージ(例): 顧客を集める

フォームを受けたあとの処理を自分のサーバーで持っているときは、そのサーバーから musubi に送信の内容を送ります。鍵を付けて送るので、ほかの人は送れません。

  1. 左のメニューの「流入元」で「サーバーから送る(webhook)」を選びます。
  2. 名前とプロダクトを入れて作ると、流入元と鍵が一緒にできます。
  3. 鍵は、この画面を閉じるともう出せません。控えて、サーバーの環境変数などの、ほかの人から見えない所に置きます。
  4. 画面の「送り先の URL」に、鍵を付けて送るようにサーバーを直します。
  5. 自分のアドレスで1回送って、ここに届くか確かめます。

鍵をなくしたときは「新しい鍵を作る」で作り直します。流入元を止めると、その鍵は使えなくなります。

見たページも結ぶ

サイトの行動のタグを貼ったサイトでは、本人がそのサイトの画面でメールアドレスを入れて送った登録に、ブラウザの番号(visitorId)を添えると、その人がそれまでとそれからに見たページが顧客に結びつきます。Google などのアカウントの連携だけの登録には添えません。

  • 番号を読むのは、タグを貼ったのと同じサイト(www の有無・サブドメインも同じ)の画面です。
  • 本人が記録を止めている(「追跡しないで」の設定を含む)ときは添えません。下のコードはそれを確かめます。
  • 添えた値の形が違うときは、登録は受けますが結びつきません。送ったあと、その顧客の画面の「サイトで見たページ」に出るかで確かめます。
  • タグと鍵は、同じワークスペースのものを使います。
function musubiVisitorId() {
  try {
    if (navigator.globalPrivacyControl === true || navigator.doNotTrack === "1") return undefined;
    if (localStorage.getItem("musubi_optout") === "1") return undefined;
    const id = localStorage.getItem("musubi_vid");
    return id !== null && /^[A-Za-z0-9_-]{22}$/.test(id) ? id : undefined;
  } catch {
    return undefined;
  }
}

読んだ値を登録の送信に添えて自分のサーバーへ渡し、サーバーが musubi に送る本文に "visitorId": "<読んだ値>" を入れます。