> 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-omnisend.md).

# Sesami FlowsとOmnisend

SesamiとOmnisendを連携して、予約ビジネス向けの高度なメールおよびSMSマーケティングを実現します。

## Omnisendとは？

Omnisendは、Eコマース事業向けのメールおよびSMSマーケティングに特化したマーケティングオートメーションプラットフォームです。Eコマース事業者が顧客と関わり、売上を伸ばし、マーケティング全体の効率を向上させるためのツールと機能を提供します。

## なぜSesamiをOmnisendと連携するのか？

SesamiのイベントデータをOmnisendに送信し、すべてのコミュニケーション（メールまたはSMS）をOmnisend経由でトリガーすることで、顧客向けのやり取りを一元化できます。すでにOmnisendを使って注文確認、SMSマーケティングメッセージ、その他の連絡を送っている多くの企業では、予約確認やアポイントのリマインダーもOmnisend経由で送ることで、統一された顧客体験を実現できます。

### 一般的なユースケース

**メールとSMSのワークフロー：**

* 予約確認フロー
* 予約変更フロー
* 予約キャンセルフロー
* 予約リマインダーフロー（24時間前、または任意のタイミング）
* 予約完了フロー

## 仕組み

Sesamiは **Sesami Flows** を使用して、予約イベントをリアルタイムでOmnisendに送信します。予約が作成、再予約、チェックイン、開始、キャンセル、またはノーショーとして記録されると、Sesamiはそのイベントデータを、作成済みのカスタムイベントにWebhook経由でOmnisendへ送信します。その後、Omnisendでこれらのカスタムイベントに基づいてメールまたはSMSメッセージをトリガーするワークフローを作成します。

### データの流れ

1. 顧客がSesamiで予約を行う
2. Sesami Flowがトリガーされ、Webhook経由でイベントデータをOmnisendに送信する
3. Omnisendがイベントをカスタムイベント（例：「Appointment Created」）として受け取る
4. そのイベントに基づいてOmnisendのワークフローがトリガーされる
5. 顧客が予約詳細を記載したメールまたはSMSを受け取る

## 設定手順

### パート1：Omnisendを設定する

#### ステップ1：Omnisendをインストールして接続する

1. をインストールします **Omnisendアプリ** Shopifyアプリストアから
2. アプリの設定手順に従ってストアを接続します
3. Omnisendのオンボーディングを完了します

#### ステップ2：APIキー（KPIキー）を作成する

1. Omnisendで、 **プロフィールタブ**
2. に移動し、 **ストア設定**
3. をクリックし、 **APIキー** タブを開きます
4. 「 **プライベートAPIキーを作成**
5. 」をクリックします
6. 権限を設定します。以下を選択してください：
   * **キャンペーン** - レポート、受信者リストのダウンロードを許可
   * **連絡先** - 購読者の作成、編集、ダウンロード、削除を許可
   * **注文** - 注文の作成、編集、ダウンロード、削除を許可
   * **商品** - 商品の作成、編集、ダウンロード、削除を許可
   * **カート** - カートの作成、編集、ダウンロード、削除を許可
   * **イベント** - カスタムイベントの取得とトリガーを許可（**必須**)
7. 生成されたAPIキーをコピーし、安全に保管します

{% hint style="warning" %}
**重要**：各一意のイベントタイプ（予約作成、再予約、キャンセルなど）ごとに別々のAPIキーが必要です。
{% endhint %}

詳細については、 [Omnisend APIドキュメント](https://api-docs.omnisend.com/).

#### ステップ3：Omnisendでカスタムイベントを作成する

追跡したい各予約イベントタイプごとに、カスタムイベントを作成します：

1. Omnisendで、 **ストア設定 > カスタムイベント**
2. 「 **カスタムイベントを作成**
3. イベントを設定します：
   * **イベント名**：わかりやすい名前を付けます（例：「Appointment Created」「Appointment Rescheduled」）
   * **システム名**：イベント名に基づいて自動生成されます
   * **イベントのカスタムフィールド**：メール／SMSで使用する予約プロパティを定義します：
     * `CustomerName` - 顧客名
     * `ServiceName` - 予約されたサービス名
     * `DateTimeInCustomerTimezone` - 予約日時
     * `CustomerManagementLink` - 顧客が予約を管理するためのリンク
     * `AppointmentID` - 一意の予約ID
     * `TeamMember` - 担当スタッフ名
     * 必要に応じて他のフィールドを追加します
4. 顧客を追加 **メール** と **電話** のフィールド（メッセージ送信に必要）
5. カスタムイベントを保存します
6. **イベントIDをコピー** - Sesami FlowのWebhook URLで必要になります

{% hint style="info" %}
追跡したい各イベントタイプ（作成、再予約、キャンセル、完了、リマインダー）について、この手順を繰り返します。
{% endhint %}

詳細な手順については、 [Omnisendのカスタムイベントのドキュメント](https://support.omnisend.com/en/articles/6791819-custom-events).

### パート2：Sesami Flowsを設定する

#### ステップ1：SesamiでFlowを作成する

1. を開きます [Sesami管理ポータル](https://help.sesami.co/admin/sesami-admin-portal)
2. に移動し、 **Flows**
3. 「 **Flowを作成**

#### ステップ2：Flowのトリガーを設定する

1. トリガーイベントを選択します：
   * 予約作成
   * 予約再設定
   * 顧客チェックイン
   * 予約開始
   * 予約キャンセル
   * ノーショー
2. 設定 **いつ** を **すぐに**に設定するか、イベントの前後の任意の時点に設定します（例：リマインダーなら予約の24時間前）
3. 必要に応じて追加条件を設定します

#### ステップ3：Webhookアクションを追加する

1. 設定 **アクション** タイプを **Webhook**
2. に設定します
   * **ターゲットURL**: `https://api.omnisend.com/v3/events/[EVENT_ID]`
     * 置き換えます `[EVENT_ID]` を、OmnisendからコピーしたイベントIDに
   * **いつ**："Immediately" に設定します（またはリマインダー用にタイミングを設定します）

#### ステップ4：Webhookヘッダーを設定する

WebhookのHeadersセクションに、以下を追加します：

```json
{
  "Content-Type": "application/json",
  "X-API-KEY": "YOUR_OMNISEND_API_KEY"
}
```

置き換えます `YOUR_OMNISEND_API_KEY` を、Omnisendで作成した実際のAPIキーに置き換えます。

#### ステップ5：Webhook本文を設定する

WebhookのBodyセクションで、Sesamiの予約データをOmnisendのカスタムフィールドにマッピングします：

```json
{
  "fields": {
    "CustomerName": "{{CustomerName}}",
    "ServiceName": "{{ServiceName}}",
    "DateTimeInCustomerTimezone": "{{DateTimeInCustomerTimezone}}",
    "CustomerManagementLink": "{{CustomerManagementLink}}",
    "AppointmentID": "{{AppointmentID}}",
    "TeamMember": "{{TeamMember}}"
  },
  "email": "{{CustomerEmail}}",
  "phone": "{{CustomerPhone}}"
}
```

{% hint style="info" %}
"fields"内のフィールド名は、Omnisendのカスタムイベントで定義したカスタムフィールドと完全に一致している必要があります。 `"fields"` は、Omnisendのカスタムイベントで定義したカスタムフィールドと完全に一致していなければなりません。
{% endhint %}

#### ステップ6：Flowを保存して有効化する

1. Flowにわかりやすい名前を付けます（例：「Omnisend - Appointment Created」）
2. **保存** Flowを
3. 有効化

Omnisendに送信したい各イベントタイプについて、手順1〜6を繰り返します。

### パート3：Omnisendでワークフローを作成する

#### ステップ1：カスタムワークフローを作成する

1. にログインします **Omnisend**
2. に移動し、 **Automation > Workflows**
3. 「 **新しいワークフロー**
4. を選択 **カスタムワークフローを作成**

#### ステップ2：トリガーを設定する

1. トリガーには、カスタムイベント（例：「Appointment Created」）を選択します
2. Sesamiがこのイベントにデータを送信するたびに、ワークフローがトリガーされます

#### ステップ3：EmailまたはSMSアクションを追加する

1. 「 **アクションを追加** をワークフロー内に
2. 選択 **メール** または **SMS**
3. メッセージテンプレートをデザインします

#### ステップ4：テンプレートでカスタムフィールドを使用する

メールまたはSMSの内容を編集するとき、カスタムフィールドの構文を使って予約プロパティにアクセスできます：

* `[[custom_event.CustomerName]]` - 顧客名
* `[[custom_event.ServiceName]]` - サービス名
* `[[custom_event.DateTimeInCustomerTimezone]]` - 予約日時
* `[[custom_event.CustomerManagementLink]]` - 予約管理リンク
* `[[custom_event.TeamMember]]` - 担当チームメンバー

#### ステップ5：追加のワークフロー設定を構成する

1. 設定 **頻度** ルール（例：「この自動化にすでに入っている連絡先に対しては、ワークフローを再トリガーしない」）
2. 追加 **終了条件** が必要な場合
3. 必要に応じて時間遅延や条件分岐を設定します

#### ステップ6：ワークフローを有効化する

ワークフローを作成してテストしたら、 **有効化** をクリックして公開します。

## 連携のテスト

本番公開前に、連携をテストします：

1. Sesamiでテスト予約を作成する
2. イベントがOmnisendの **ストア設定 > カスタムイベント** に表示されることを確認する（イベントアクティビティを表示）
3. すべての予約プロパティが正しく入力されていることを確認する
4. Omnisendのワークフローをテストし、メール／SMSが正しく送信されることを確認する
5. 内容を確認し、すべてのカスタムフィールドが正しく表示されることを確認する

{% hint style="success" %}
**ワンポイント**：テスト用の顧客メールアドレスと電話番号を用意し、ライブ顧客向けにワークフローを有効化する前にテスト予約を行って、顧客体験全体を確認しましょう。
{% endhint %}

## FAQ

<details>

<summary>イベントタイプごとに別々のAPIキーが必要ですか？</summary>

はい。Omnisendでは、作成する各カスタムイベントごとに一意のAPIキーが必要です。つまり、予約作成、再予約、キャンセルのイベントを追跡する場合は、3つの別々のAPIキーが必要になります。

</details>

<details>

<summary>OmnisendはメールだけでなくSMSにも使えますか？</summary>

はい！ OmnisendはメールとSMSの両方をサポートしています。次の点を確認してください：

* を含める `電話` フィールドをWebhook本文に
* OmnisendアカウントでSMSが有効になっていること
* 適切な同意を得て顧客の電話番号を収集していること
* OmnisendワークフローでSMSアクションを設定すること

詳細については、 [OmnisendのSMSドキュメント](https://support.omnisend.com/en/articles/1061873-sms-in-campaigns).

</details>

<details>

<summary>複数のリマインダーワークフローが必要な場合は？</summary>

異なるタイミングで複数のリマインダーFlowをSesamiで作成できます：

* 予約の7日前
* 予約の24時間前
* 予約の2時間前

それぞれを同じOmnisendのカスタムイベントに送信することもできますし、異なるリマインダータイミングごとに別々のカスタムイベントを作成することもできます。

</details>

<details>

<summary>イベントがOmnisendに表示されません。何を確認すればよいですか？</summary>

* OmnisendのAPIキーが正しく、「Events」権限が有効になっていることを確認してください
* Webhook URL内のEvent IDがカスタムイベントと一致していることを確認してください
* SesamiでFlowが有効になっていることを確認してください
* Flowを設定した後にテスト予約を作成していることを確認してください
* Sesami Flowのログを確認し、Webhookが正常に送信されたかを確認してください
* Omnisendのカスタムイベントアクティビティ（ストア設定 > カスタムイベント）を確認してください
* 必要なすべてのフィールド（メールまたは電話）がWebhook本文に含まれていることを確認してください

</details>

<details>

<summary>異なる言語用に翻訳を使えますか？</summary>

はい！ Omnisendはキャンペーンと自動メールの翻訳をサポートしています。顧客の言語設定に応じて、ワークフローのローカライズ版を作成できます。詳しくは [Omnisendの翻訳ドキュメント](https://support.omnisend.com/en/articles/1061898-translations-for-campaigns-and-automated-emails).

</details>

## 関連

* [Sesami Flows](https://help.sesami.co/ja/zi-dong-hua/sesami-flows.md) - Sesamiの自動化システムの概要
* [メールとWebhookアクション](https://help.sesami.co/ja/zi-dong-hua/email-and-webhook-as-action-types.md) - アクションタイプの理解
* [Sesami FlowsとKlaviyo](https://help.sesami.co/ja/zi-dong-hua/sesami-flows-and-klaviyo.md) - 代替ESP連携
* [通知メール](https://help.sesami.co/ja/tong-zhi/notification-emails.md) - デフォルトのSesami通知システム


---

# 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-omnisend.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.
