> For the complete documentation index, see [llms.txt](https://help.sesami.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.sesami.co/ja/zi-dong-hua/sesami-flows-and-klaviyo/klaviyo-transactional-sms.md).

# Klaviyo トランザクショナル SMS

この設定により、Sesamiは確認、リマインダー、キャンセル、再予約などの予約関連イベントについて、Klaviyoを通じてトランザクションSMS通知を送信できます。

{% hint style="info" %}
**重要:** この設定は **SMSマーケティングではなく、トランザクションSMS用です**.
{% endhint %}

### 前提条件

設定を開始する前に、Klaviyoアカウントに以下があることを確認してください:

* **有料のKlaviyo SMSプラン** — トランザクションSMSに必要です。
* **SMSが有効化されていること** （Klaviyo内）。
* **有効なSMS送信番号** 顧客の地域をサポートしているもの。
* 以下の **プライベートAPIキー** 必要な権限を持つもの。

{% hint style="info" %}
Klaviyoでは、SMSを有効にし、顧客の地域に適した送信番号を設定する必要があります。
{% endhint %}

***

### 1. Sesamiアプリ → フロー

以下の [Klaviyoプリセットが有効になると](https://help.sesami.co/ja/zi-dong-hua/sesami-flows-and-klaviyo.md#step-2-choose-a-klaviyo-preset)、Sesamiのフローボディには **顧客の電話番号を含める必要があります** 次の `phone_number` フィールドを使用します。

フローボディに以下を追加します:

```
"profile": {
  "data": {
    "type": "profile",
    "attributes": {
      "email": "{{CustomerEmail}}",
      "phone_number": "{{CustomerPhone}}"
    }
  }
}
```

### 2. Klaviyo → フロー

希望するメトリクスをトリガーとして使用してフローを作成します。次の手順に従ってください [この手順](https://help.sesami.co/ja/zi-dong-hua/sesami-flows-and-klaviyo.md#step-1-create-a-flow-in-klaviyo)&#x20;

例: \
**フロー構成:** `Sesami Appointment Created → Transactional SMS Consent → 5分待機 → SMSメッセージ`

### 3. トランザクションSMSの同意

1\. 次を追加します: **Webhook** を最初のアクションとして。

<figure><img src="https://1805722424-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FK7d2OYgrdyEy81NmyNAW%2FScreenshot%202026-10-28%20at%2012.04.08.png?alt=media&amp;token=148df9e9-af71-4feb-8617-d3b94c5dd86a" alt=""><figcaption></figcaption></figure>

2\. 次の **Webhookの詳細** を以下の設定で構成します。

<figure><img src="https://1805722424-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FclCTHD8fZAwXs24fU6ud%2FScreenshot%202026-10-28%20at%2012.06.18.png?alt=media&amp;token=acba24ca-f1da-4fdd-a61e-e5f8378cdfbd" alt=""><figcaption></figcaption></figure>

* **Webhook名:** Webhookの名前を入力します。例: `Sesami - Transactional SMS`&#x20;

* **設定:**
  * **宛先URL: 以下をコピーしてください:**

`https://a.klaviyo.com/api/profile-subscription-bulk-create-jobs`

* **ヘッダー**

**以下の「キー」と「値」を作成します**

```
Content-Type application/json
revision 2026-07-15
Authorization Klaviyo-API-Key YOUR_PRIVATE_API_KEY
```

<figure><img src="https://1805722424-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FaMIfqgjLlugG9b487td2%2FScreenshot%202026-10-28%20at%2012.15.23.png?alt=media&amp;token=f20c0e05-35c7-453e-b682-bea1fd839509" alt=""><figcaption></figcaption></figure>

**JSON本文**\
以下をコピーしてください:

```
{
  "data": {
    "type": "profile-subscription-bulk-create-job",
    "attributes": {
      "profiles": {
        "data": [
          {
            "type": "profile",
            "attributes": {
              "email": "{{ person.email }}",
              "phone_number": "{{ person.phone_number }}",
              "subscriptions": {
                "sms": {
                  "transactional": {
                    "consent": "SUBSCRIBED"
                  }
                }
              }
            }
          }
        ]
      }
    }
  }
}
```

<figure><img src="https://1805722424-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FVyDh22hfdQxWoEyPFaNU%2FScreenshot%202026-10-28%20at%2012.18.18.png?alt=media&amp;token=de7ac4fe-67cc-43d8-872f-5ff2469b681e" alt=""><figcaption></figcaption></figure>

### 4. SMSメッセージ

同意Webhookの後:

1. 以下を追加します: **5分の遅延**.
2. SMSアクションを追加します。
3. 予約通知を設定します。
4. SMSを次のように設定します: **トランザクションステータス**.&#x20;
5. フローをライブに設定します。

<div><figure><img src="https://1805722424-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FgVT6xv8dSen0Rg0JzgEd%2FScreenshot%202026-10-28%20at%2012.19.54.png?alt=media&amp;token=6598bdf7-d27a-443b-ba9f-e6c033f171da" alt=""><figcaption></figcaption></figure> <figure><img src="https://1805722424-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FmYlOGy0AgC2QnRw7TZ8R%2FScreenshot%202026-10-28%20at%2012.20.28.png?alt=media&amp;token=d0d530f7-24b1-44a7-8c77-458d7b5f3939" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
トランザクションの同意とトランザクションステータスは別のものです:

* **トランザクションの同意** = 顧客がトランザクションSMSを受信するための許可。
* **トランザクションステータス** = SMSメッセージをトランザクションとして分類すること。

トランザクションの同意のみを持つプロフィールはトランザクションSMSを受信できますが、マーケティングSMSは受信できません。
{% endhint %}

### 5. テスト

**Sesamiで新しい予約を作成し、以下を確認します:**

* トランザクションの同意Webhookが完了する
* プロフィール → トランザクションSMS: **購読済み**
* 5分の遅延後にフローが継続する
* SMSが受信される

KlaviyoのサブスクリプションAPIは非同期であるため、サブスクリプション結果が表示されるまでしばらく時間を置いてください。

<div><figure><img src="https://1805722424-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FYBJh3teX9nGdtObpWCDn%2F1%20webhook%20.png?alt=media&amp;token=917ee541-2e35-4a1a-8160-1e8250fd1714" alt=""><figcaption></figcaption></figure> <figure><img src="https://1805722424-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FAQy7tJdnr5jmYIIZwKRS%2F2%20subscribed.png?alt=media&amp;token=d4d84723-1ade-4285-8ec8-0369727e0302" alt=""><figcaption></figcaption></figure> <figure><img src="https://1805722424-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FjzLj0OEVJKK4WGw9g3hS%2F3%20delay%20.png?alt=media&amp;token=0c778095-b752-4d7c-b84d-92dc95fbd8bd" alt=""><figcaption></figcaption></figure> <figure><img src="https://1805722424-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2F8G5SlULFgjuofWHFi4xO%2F4%20Message%20Appointment%20Confirmation-.png?alt=media&amp;token=670ac409-edb2-40c5-ac8a-164eb565cf04" alt=""><figcaption></figcaption></figure></div>

***

### トラブルシューティング

#### HTTP 400 — 電話番号の地域

Klaviyoで電話番号がアカウントでサポートされていないと報告された場合は、以下を確認してください: **Klaviyo → 設定 → テキストメッセージ**

その顧客の国・地域に対してアクティブな送信番号がアカウントにあることを確認してください。

#### フローがトリガーされない

まず以下を確認してください: **フロートリガーとトリガーフィルター**.

* トリガーは次である必要があります: [**Sesamiメトリクス**](https://help.sesami.co/ja/zi-dong-hua/sesami-flows-and-klaviyo.md)
* イベントプロパティを参照しているフィルターをすべて削除します

#### トランザクションSMSが利用できない

マーチャントが以下を持っていることを確認してください: **有料のKlaviyo SMSプラン**.

無料プランでは、SMSメッセージにトランザクションステータスを適用できません。

***

### 最終チェックリスト

**Klaviyoアカウント**

* 有料SMSプラン
* SMSが有効化されていること
* 送信番号が設定済み
* 送信番号が顧客の地域をサポートしている
* 必要な権限を持つプライベートAPIキー

**Sesami**

* Events API Webhookが設定済み
* 電話番号が含まれている

**Klaviyoフロー**

* トリガー = `Sesami Appointment Created`
* 無効なトリガーフィルターがない
* トランザクションSMS同意Webhook
* `{{ person.phone_number }}`
* `SUBSCRIBED` トランザクションの同意
* 5分の遅延
* SMSにトランザクションステータスが設定されている
* フローがライブである


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.sesami.co/ja/zi-dong-hua/sesami-flows-and-klaviyo/klaviyo-transactional-sms.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
