# 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 App Storeから
2. アプリのセットアップ手順に従ってストアを接続します
3. Omnisendのオンボーディングプロセスを完了します

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

1. Omnisendで、 **プロフィールタブ**
2. 移動先 **ストア設定**
3. をクリックし、 **API Keys** タブ
4. をクリック **プライベート API キーを作成**
5. 「Sesami Integration」（または同様の名前）と名付けます
6. 権限を設定します。以下を選択してください：
   * **Campaigns** - レポート、受信者リストのダウンロードを許可
   * **Contacts** - サブスクライバーの作成、編集、ダウンロード、削除を許可
   * **注文** - 注文の作成、編集、ダウンロード、削除を許可
   * **商品** - 商品の作成、編集、ダウンロード、削除を許可
   * **Carts** - カートの作成、編集、ダウンロード、削除を許可
   * **イベント** - カスタムイベントの取得およびトリガーを許可（**必須**)
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` - 一意の予約識別子
     * `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** をShopify管理画面で
2. 移動先 **設定 > Flows**
3. をクリック **Flow を作成**

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

1. トリガーイベントを選択します：
   * 予約作成
   * 予約再スケジュール
   * 予約キャンセル
   * 予約完了
   * 時間ベースのリマインダー（例：予約の24時間前）
2. 必要に応じて追加条件を設定します

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

1. 設定 **アクション** のタイプを **Webhook**
2. Webhookを設定します：
   * **送信先URL**: `https://api.omnisend.com/v3/events/[EVENT_ID]`
     * 次の値を置き換えます `[EVENT_ID]` OmnisendからコピーしたEvent 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のカスタムイベントで定義したカスタムフィールドと完全に一致している必要があります。
{% endhint %}

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

1. Flowに説明的な名前を付けます（例：「Omnisend - Appointment Created」）
2. **保存** Flow
3. Flowを有効化します

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

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

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

1. にログインします **Omnisend**
2. 移動先 **Automation > Workflows**
3. をクリック **New workflow**
4. 選択します **Create custom workflow**

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

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

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

1. をクリック **Add action** をワークフロー内で
2. 選択 **メール** または **SMS**
3. メッセージテンプレートをデザインする

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

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

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

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

1. 設定 **Frequency** ルール（例：「この自動化にすでに入っている連絡先に対してワークフローを再トリガーしない」）
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>メールだけでなくSMSでもOmnisendを使えますか？</summary>

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

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

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

</details>

<details>

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

Sesamiで複数のリマインダーFlowを作成でき、それぞれ異なるタイミングに設定できます：

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

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

</details>

<details>

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

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

</details>

<details>

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

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

</details>

## 関連項目

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


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.sesami.co/ja/zi-dong-hua/sesami-flows-and-omnisend.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.