通知ワークフロー ヘルプ
概要
通知ワークフローは、予約に紐づく自動通知（ゲスト向け・オーナー向け）を施設側で管理できる機能です。「予約開始の24時間前にリマインダー」「承認待ちの予約が入ったらオーナーに通知」のような設定を、アンカーイベント（いつ起きるか）＋オフセット（何分/時間ずらすか）＋チャネル（どの手段で送るか） の組み合わせで表現します。
サイドバーの「🔔 通知ワークフロー」から /notifications を開きます。
4つのタブ
| タブ名 | 説明 |
|---|---|
| ワークフロー | 通知の一覧・ON/OFF切り替え・編集・カスタム通知の追加 |
| メッセージ | 各通知の本文（件名・メール本文・SMS文面・音声スクリプト）を日英で編集 |
| 履歴 | 過去7日〜未来1日の送信状況（待機/送信中/送信/失敗/キャンセル）と月次課金額 |
| チャネル | LINE / Email / SMS / Voice / スピーカーの接続状況カードと設定画面へのリンク |
ワークフロータブ
標準（canonical）ワークフロー
全施設に 無効（enabled=false） の状態で最初から用意されています。有効化はオーナーが個別に行います。標準ワークフローは削除できませんが、アンカー・オフセット・チャネルは編集できます（ワークフローキー自体は変更不可）。
ゲスト向け（4種類）
| ワークフロー | いつ | 用途 |
|---|---|---|
| 予約前日リマインダー | 予約開始の24時間前 | 予約を忘れないように案内 |
| チェックイン案内 | 予約開始の10分前 | チェックイン方法を案内 |
| お片付け依頼 | 予約終了の5分前 | 退出前のお願い |
| ご利用ありがとうメッセージ | 予約終了時 | お礼メッセージ |
施設管理者（オーナー）向け（6種類、詳細は次章）
- 新規予約が入った
- 承認待ちの予約が入った
- 承認待ちが12時間放置されている（リマインダー）
- 決済が完了した
- 予約がキャンセルされた
- 予約が延長された
受信者（オーナー通知の設定方法）
編集モーダルの 「受信者」 ドロップダウンで「施設管理者」を選ぶと、その通知は予約者（ゲスト）ではなく施設のオーナーに届きます。一覧では対象の通知に「施設管理者」バッジが表示されます。
標準ワークフローは受信者を変更できません（ドロップダウンが無効化されています）。標準の施設管理者向け6種類は最初から「施設管理者」に固定されています。受信者を選べるのは新規カスタムワークフローを作成するときだけです。
誰に届くか（宛先解決）
「施設管理者」宛の通知は、以下の順で解決した宛先全員に送られます。
- その施設の Facility Owner（施設オーナー） 全員
- Facility Owner が1人もいない場合は、所属組織の Organization Owner（組織オーナー） 全員
- どちらもいない場合は配信失敗として記録されます（履歴タブで確認できます）
旧来の「施設管理者」担当者設定（facility_manager_id）は使われません。ログイン権限で使われているのと同じロールモデルで宛先が決まります。
チャネル（オーナー通知は現状Email固定）
編集モーダルでチャネルを「自動選択」のままにしていても、施設管理者向け通知は現状すべてEmail（Resendによる HTMLメール）で届きます。ゲスト向け通知の「自動選択」はLINE連携済みのゲストならLINEに流れますが、オーナー宛の宛先解決はLINEアカウントを見に行かない設計のため、オーナー個人がLINE連携していてもLINEには届きません（今後のアップデートで対応予定）。
アンカーイベント
ゲスト向け通知は「予約開始/終了の◯分前」のような時刻を起点にしますが、施設管理者向け通知は予約に起きた出来事そのものを起点にします。
| アンカー | 発火するタイミング |
|---|---|
| 新規予約 | 予約が作成されたとき |
| 承認待ち | 承認制の予約が承認待ちの状態になったとき |
| 決済完了 | ゲストが決済して予約が確定したとき（下記の注意を参照） |
| キャンセル | 予約がキャンセルされたとき |
| 延長 | 予約の利用終了時刻が後ろ倒しされたとき |
「決済完了」は実際に決済された予約でのみ届きます。 手動確定・無料プラン・会員プランなど、決済を伴わずに予約が確定したケースでは送られません。また、チェックイン時精算（後払い）の予約は、確定した時点ではまだ未決済のため、この通知の対象にはなりません。
承認リマインダーの自動キャンセル
「承認待ちが12時間放置されている」通知は、承認待ちになってから12時間後に届く設定です。その前にオーナー自身が承認または却下すると、このリマインダーは自動的にキャンセルされます。無駄な催促メールが届くことはありません。
カスタムワークフロー
標準以外に、施設独自の通知を追加できます。ワークフローキー（英数字・アンダースコアのみ）、アンカーイベント、オフセット、チャネル、受信者を自由に設定可能です。作成後は一覧から削除もできます。
メッセージタブ
各通知の本文を、チャネル別（件名/メール本文/SMS文面/音声スクリプト）・言語別（日本語/英語）に編集できます。プレビューでサンプル変数が展開された表示を確認できます。
使用できる変数
| 変数 | 内容 |
|---|---|
{{guest_name}} |
予約者名 |
{{start_time}} |
予約開始時刻（施設のタイムゾーンで整形） |
{{end_time}} |
予約終了時刻（施設のタイムゾーンで整形） |
{{facility_name}} |
施設名 |
{{room_name}} |
部屋名 |
{{approval_url}} |
承認画面へのリンク（承認系のオーナー通知でのみ使用） |
{{approval_url}} は「承認待ちの予約が入った」「承認待ちリマインダー」の2つの標準通知にのみ含まれています。ゲスト向け通知やその他のオーナー通知には含める必要はありません。
履歴タブ
過去7日〜未来1日分の送信状況を一覧表示します。状態（待機／送信中／送信／失敗／キャンセル）・発火時刻・ワークフロー名・チャネル・試行回数・課金額を確認できます。失敗した行にはエラーコードとヒントが表示されます。上部には当月の従量課金合計（SMS送信数・スピーカー再生回数など）がサマリ表示されます。
チャネルタブ
チャネルがカード形式で並びます。各カードから該当チャネルの設定画面に移動できます。
| チャネル | 設定画面 | 課金 |
|---|---|---|
| LINE | LINE連携設定 | 無料 |
| 基本設定（送信元アドレス確認） | 無料 | |
| SMS | Twilio連携設定 | ¥25/セグメント（BYO契約なら顧客直課金） |
| Voice | Twilio連携設定 | ¥60/分（BYO契約可） |
| スピーカー | スピーカー通知チャネル | ¥3/回 |
| Webhook | Webhook通知チャネル | 無料 |
Webhookカードは施設が所属する組織で
notification_webhook_channelフィーチャーフラグが有効な場合のみ表示されます。 LINE・Email・SMS・Voice・スピーカーと異なり、Webhookは「人に通知する」チャネルではなく外部システムへイベントを連携するチャネルです。詳しくはWebhook通知チャネルを参照してください。
よくある質問
Q: LINE連携設定にある「管理者通知設定」と、この「施設管理者」向け通知は同じものですか？
A: 別の機能です。 LINE連携設定の「管理者通知設定」は、チェックイン/チェックアウト/決済失敗をLINEで管理者に知らせる従来からの機能です。一方、通知ワークフローの「施設管理者」向け通知は、新規予約・承認待ち・決済完了・キャンセル・延長といった予約イベントを対象にした新しい仕組みで、現状はEmailのみで届きます。両方を有効にしても通知が重複することはありません（対象イベントが異なります）。
Q: 標準の施設管理者向け通知の受信者を「ゲスト」に変更できますか？
A: できません。標準（canonical）ワークフローは受信者・アンカーイベントの組み合わせが定義の一部になっているため固定です。ゲスト向けに似た通知を作りたい場合は、カスタムワークフローとして新規作成してください。
Q: 施設にオーナーが誰もいない場合、通知はどうなりますか？
A: Facility OwnerもOrganization Ownerもいない施設では配信に失敗し、履歴タブに失敗として記録されます。まずはサポートにご連絡のうえ、施設オーナーまたは組織オーナーを設定してください。
Q: 承認待ちリマインダーを止めたいのですが、無効化以外に方法はありますか？
A: 承認または却下すれば自動的にキャンセルされます。手動で止める必要はありません。今後届く通知自体を止めたい場合は、ワークフロー一覧でON/OFFを切り替えてください。
Q: Webhookチャネルはどこで設定しますか？
A: 配送先（送信先URL・署名鍵）の登録はチャネルタブのWebhookカードから、どのイベントで送信するかはワークフロータブの編集画面でチャネルに「Webhook」を選んで設定します。詳しくはWebhook通知チャネルを参照してください。