> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/workflows/ja/burokku/blocks/notifications/twilio-sms-notification.md).
# Twilio SMS通知
Twilio SMS サービスを介して SMS テキストメッセージ通知を送信します。動的なワークフローデータパラメータを含むカスタマイズ可能なメッセージ内容、自動メッセージ切り詰めによる SMS 文字数制限への対応、キャッシュベースのセッショントラッキングを使ったクールダウン抑制、さらにモバイルアラート、緊急通知、リアルタイム通信ワークフロー向けのオプションの非同期バックグラウンド実行を備えています。
## このブロックの仕組み
このブロックは、Twilio SMS API を使用して電話番号に SMS テキストメッセージを送信し、ワークフローの実行結果をメッセージ内容に組み込みます。このブロックは:
1. が無効かどうかを確認します `disable_sink` フラグ（無効なら、送信せずに即時終了します）
2. Twilio の認証情報（Account SID と Auth Token）のハッシュを使用して、クールダウン追跡用のキャッシュキーを生成し、 `cooldown_session_key` （ワークフローステップごとに一意）
3. キャッシュで最後の通知タイムスタンプを確認してクールダウン期間を検証し（有効な場合、次の期間内の通知を抑制し `cooldown_seconds` 最後に送信された SMS からの期間内で通知を抑制し、スロットリング状態を返します）
4. 提供された認証情報から Twilio Client インスタンスを作成または取得します（効率化のため、クライアントを認証情報のハッシュでキャッシュします）
5. 動的パラメータを処理してメッセージを整形します（次のようなプレースホルダーを置換します `{{ $parameters.parameter_name }}` を使用して実際のワークフローデータに置換します `message_parameters`)
6. UQL 操作を任意で適用し、挿入前にパラメーター値を変換します（例: 検出からクラス名を抽出、指標を計算、データをフィルタリング） `message_parameters_operations`
7. メッセージが次を超える場合は切り詰めます `length_limit` 文字（切り詰めマーカーを付加し `[...]` 切り詰めを示します）
8. Twilio の送信元番号から受信先の電話番号へ SMS メッセージを送信します `messages.create` API
9. 現在の通知タイムスタンプでキャッシュを更新します（15 分後に期限切れ）
10. 次に基づいて同期または非同期で実行します `fire_and_forget` 設定:
* **同期モード** (`fire_and_forget=False`）：Twilio API 呼び出しの完了を待ち、デバッグ用に実際のエラー状態を返します
* **非同期モード** (`fire_and_forget=True`）：バックグラウンドタスクで SMS を送信し、ワークフローは即座に継続、エラー状態は常に False です
11. 成功、抑制、またはエラーを示すステータス出力を返します（利用可能な場合は Twilio API のエラー詳細を含みます）
このブロックは、ワークフロー データで実行時に置き換えられるパラメータ プレースホルダーを介して動的なメッセージ内容をサポートします。メッセージ パラメータは、ワークフローの生の出力をそのまま使うことも、UQL 操作（例: プロパティの抽出、件数の計算、値のフィルタリング）で変換することもできます。SMS メッセージは、文字数制限を超えると自動的に切り詰められ、SMS 標準に準拠してメッセージ配信の問題を防ぎます。クールダウンは、キャッシュベースのトラッキングとセッションキーを使用して送信間の最小時間を強制することで SMS スパムを防止し、分散環境または複数インスタンス環境でステップごとの抑制を可能にします。
## 要件
**Twilio アカウント設定**：SMS 機能を備えた Twilio アカウントが必要です：
* `twilio_account_sid`：Twilio Account SID（ [Twilio Console](https://twilio.com/console))
* `twilio_auth_token`：Twilio Auth Token（Twilio Console で確認でき、セキュリティのため非公開としてマークされています）
* 認証情報は、ワークフロー定義に保存するのではなく、SECRET\_KIND セレクターを使用してワークフロー入力から提供することを推奨します
* 表示 [Twilio SMS チュートリアル](https://www.twilio.com/docs/messaging/tutorials/how-to-send-sms-messages/python) のセットアップ手順
**電話番号設定**：有効な E.164 形式の電話番号が必要です（例: `+1234567890`):
* `sender_number`：送信元の Twilio 電話番号（アカウントで購入済みの番号または検証済みの番号である必要があります）
* `receiver_number`：SMS を受信する宛先の電話番号
**クールダウン用セッションキー**: `cooldown_session_key` は、適切なステップごとのクールダウン追跡を有効にするために、ワークフロー内の各 Twilio SMS 通知ステップで一意である必要があります。クールダウン機構は、15 分の有効期限を持つキャッシュベースのストレージを使用し、クールダウン秒数は 0 から 900（15 分）の間でなければなりません。
**メッセージ長の上限**：SMS メッセージのデフォルト文字数上限は 160 文字です。メッセージが `length_limit` を超えると、自動的に切り詰められ、切り詰めマーカー（`[...]`）。調整してください `length_limit` 必要に応じて調整してください。ただし、SMS 標準では通常、単一パートのメッセージは 160 文字、複数パートのメッセージはセグメントごとに 153 文字をサポートすることに注意してください。
## 一般的な使用例
* **緊急アラート通知**：重要な条件が検出されたときにモバイル端末へ SMS アラートを送信します（例：不審物が検出されたら警備担当者に通知する、システム異常が発生したらオペレーターに通知する、検出数が重大なしきい値を超えたらアラートを送る）。これにより、時間に敏感なインシデントについて即時のモバイル通知が可能になります
* **モバイル ワークフロー更新**：ワークフロー実行のステータスや重要な結果について SMS 通知を送信します（例：バッチ処理完了時にオペレーターへ通知する、重大な失敗アラートを送る、システム健全性の問題を知らせる）。これにより、自動化プロセスの状況をモバイルで把握できます
* **検出サマリー**：検出結果と主要統計を SMS で送信します（例：検出されたオブジェクト数を共有する、分類結果の要約を送る、重大な検出アラートを含める）。これにより、関係者は重要なワークフロー出力をモバイル端末で受け取れます
* **緊急通知**：緊急事態や重要イベントに対して緊急 SMS アラートを送信します（例：緊急対応担当者に通知する、保守チームに重大な問題を知らせる、システム障害の即時通知を送る）。これにより、緊急対応のための迅速なモバイル通信が可能になります
* **リアルタイム モバイル監視**：リアルタイム監視とステータス通知のために継続的な SMS 更新を送信します（例：システム健全性の問題を通知する、定期的なパフォーマンスアラートを送る、処理マイルストーンを知らせる）。これにより、運用監視のためのモバイル可視化が可能になります
* **オンコールアラート**：当番担当者に対して、営業時間外または重大な問題について SMS 通知を送信します（例：当番エンジニアにシステム問題を知らせる、当番のセキュリティ担当に検出された脅威を通知する、営業時間外のインシデント通知を送る）。これにより、オンコールスタッフ向けのモバイル通信が可能になります
## 他のブロックへの接続
このブロックはワークフローステップからデータを受け取り、SMS 通知を送信します:
* **検出または解析ブロックの後** （例: オブジェクト検出、インスタンスセグメンテーション、分類）オブジェクトが検出されたり、分類が行われたり、しきい値を超えたりした際に、緊急のモバイルアラートや要約を送信します。これにより、重要イベントについてリアルタイムのモバイル通知が可能になります
* **データ処理ブロックの後** （例: 式、プロパティ定義、検出フィルター）計算された指標、変換されたデータ、またはフィルタリングされた結果を SMS 通知に含めます。これにより、処理済みデータを用いたカスタムのモバイルレポートが可能になります
* **条件分岐ワークフローでは** （例: 条件を満たす場合に続行）特定の条件が満たされた場合にのみ SMS 通知を送信します。これにより、イベント駆動型のモバイルアラートと緊急通知が可能になります
* **集計ブロックの後** （例: データアグリゲーター）定期的な分析サマリーや統計レポートを SMS で送信します。これにより、スケジュールされたモバイル更新とトレンド分析が可能になります
* **監視ワークフローでは** モバイル端末にステータス更新、エラー通知、またはヘルスチェックレポートを送信し、SMS による自動システム監視とインシデント管理を可能にします
* **緊急ワークフロー向け** 即時のモバイル通知が重要な場合（例：セキュリティアラート、システム障害、重大な検出）、時間に敏感な状況で迅速なモバイル通信を可能にします
### 型識別子
ステップで次の識別子を使用してください `"type"` フィールド： `roboflow_core/twilio_sms_notification@v1` ワークフローにこのブロックをステップとして追加するには。
### プロパティ
| **名前** | **型** | **説明** | 参照 |
| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -- |
| `name` | `str` | このステップの一意の識別子を入力してください。 | ❌ |
| `twilio_account_sid` | `str` | Twilio API で認証するための Twilio Account SID。次の場所にあります [Twilio Console](https://twilio.com/console) アカウント情報の下にあります。このフィールドはセキュリティのため非公開としてマークされています。ワークフロー定義に保存するのではなく、SECRET\_KIND セレクターを使用してワークフロー入力から提供することを推奨します。Twilio SMS メッセージを送信するための Twilio API リクエストの認証には twilio\_auth\_token と併用されます。 | ✅ |
| `twilio_auth_token` | `str` | Twilio API で認証するための Twilio Auth Token。次の場所にあります [Twilio Console](https://twilio.com/console) アカウント情報の下にあります（表示するには「show」をクリックしてください）。このフィールドはセキュリティのため非公開としてマークされています。ワークフロー定義に保存するのではなく、SECRET\_KIND セレクターを使用してワークフロー入力から提供することを推奨します。Twilio SMS メッセージを送信するための Twilio API リクエストの認証には twilio\_account\_sid と併用されます。 | ✅ |
| `sender_number` | `str` | Twilio 電話番号から SMS メッセージを送信します。E.164 形式（例: '+1234567890'）である必要があり、Twilio で購入した電話番号または Twilio アカウント内で検証済みの番号でなければなりません。この番号は、受信者が受け取る SMS メッセージの送信者として表示されます。Twilio Console で番号を購入するか、テスト用に試用番号を使用できます。 | ✅ |
| `receiver_number` | `str` | SMS メッセージを受信する宛先の電話番号。E.164 形式（例: '+1234567890'）である必要があります。Twilio の試用アカウントでは、受信先番号は Twilio アカウント内で検証済みである必要があります。有料アカウントでは、有効な電話番号であればどこへでも送信できます。これは通知を受け取るモバイル番号です。 | ✅ |
| `message` | `str` | SMS メッセージの内容（プレーンテキスト）。プレースホルダー構文による動的パラメータをサポートします: `{{ $parameters.parameter_name }}`。プレースホルダーは実行時に message\_parameters の値で置き換えられます。メッセージは複数行テキストにできますが、送信されるのは 1 件の SMS としてです。length\_limit を超えるメッセージは、自動的に切り詰めマーカー付きで切り詰められます。例: 'Detected `{{ $parameters.num_objects }}` オブジェクト。アラート: `{{ $parameters.classes }}`.'. | ❌ |
| `message_parameters` | `Dict[str, Union[bool, float, int, str]]` | メッセージ内のプレースホルダーで使用されるパラメーター名をワークフローデータソースに対応付ける辞書。キーはメッセージ内で `{{ $parameters.key }}`として参照されるパラメーター名で、値はワークフローステップ出力または直接値へのセレクターです。これらの値は実行時にメッセージプレースホルダーに置換されます。必要に応じて message\_parameters\_operations を使用して、置換前にパラメーター値を変換できます。 | ✅ |
| `message_parameters_operations` | `Dict[str, List[Union[ClassificationPropertyExtract, ConvertDictionaryToJSON, ConvertImageToBase64, ConvertImageToJPEG, DetectionsFilter, DetectionsOffset, DetectionsPropertyExtract, DetectionsRename, DetectionsSelection, DetectionsShift, DetectionsToDictionary, Divide, ExtractDetectionProperty, ExtractFrameMetadata, ExtractImageProperty, LookupTable, Multiply, NumberRound, NumericSequenceAggregate, PickDetectionsByParentClass, RandomNumber, SequenceAggregate, SequenceApply, SequenceElementsCount, SequenceLength, SequenceMap, SortDetections, StringMatches, StringSubSequence, StringToLowerCase, StringToUpperCase, TimestampToISOFormat, ToBoolean, ToNumber, ToString]]]` | message\_parameters からのパラメーター名を、メッセージに挿入する前にパラメーター値を変換する UQL 操作チェーンへ対応付ける任意の辞書。操作は順番に適用されます（例: 検出からクラス名を抽出、件数を計算、値をフィルタリング）。キーは message\_parameters 内のパラメーター名と一致している必要があります。変換が不要なパラメーターは空のままにするか、省略してください。 | ❌ |
| `fire_and_forget` | `bool` | 実行モード: True は非同期のバックグラウンド送信（ワークフローは即座に継続し、error\_status は常に False、実行速度が速い）、False は同期送信（Twilio API 呼び出しの完了を待ち、デバッグ用に実際のエラー状態を返す）です。開発およびデバッグ中は Twilio API エラーを捕捉するために False に設定してください。SMS 配信のタイミングが重要でない本番環境では、ワークフロー実行を高速化するために True に設定してください。 | ✅ |
| `disable_sink` | `bool` | 実行時に SMS 通知送信を無効化するフラグ。True の場合、このブロックは SMS の送信をスキップし、無効化メッセージを返します。ワークフロー入力による条件付き通知制御に便利です（例: テスト用に通知を無効化できるようにする、設定に応じて有効/無効を切り替える）。実行時制御のためにワークフロー入力で設定します。 | ✅ |
| `cooldown_seconds` | `整数` | 連続する SMS 通知の間隔を最小化して SMS スパムを防ぐための秒数。デフォルトは 5 秒です。0 に設定するとクールダウンを無効化できます（スロットリングなし）。0 から 900（15 分）の間でなければなりません。クールダウン期間中、このブロックは throttling\_status=True を返して送信をスキップします。クールダウンは cooldown\_session\_key を使用し、キャッシュベースのストレージ（15 分の有効期限）でステップごとに追跡されます。ワークフロー内の各 Twilio SMS 通知ステップには、適切なステップごとの追跡のために一意の cooldown\_session\_key を設定する必要があります。 | ✅ |
| `cooldown_session_key` | `str` | この Twilio SMS Notification ステップのクールダウントラッキングセッションの一意の識別子。適切なステップごとのクールダウン分離を有効にするため、ワークフロー内の各 Twilio SMS Notification ステップで一意でなければなりません。Twilio 認証情報のハッシュと組み合わせて、最後の通知タイムスタンプを追跡するキャッシュキーを作成するために使用されます。分散環境や複数インスタンス環境では、これによりステップごとにクールダウンが正しく機能します。通常は自動生成されるか、ワークフロー入力として提供されます。 | ❌ |
| `length_limit` | `整数` | トランケーション前に SMS メッセージで許可される最大文字数。デフォルトは 160 文字（標準の単一パート SMS の長さ）です。この上限を超えるメッセージは自動的に切り詰められ、末尾の文字は切り詰めマーカー（'\[...]'）に置き換えられます。0 より大きい値でなければなりません。注: SMS 標準では、単一パートメッセージは 160 文字、複数パートメッセージはセグメントごとに 153 文字をサポートします。必要に応じて調整してください。ただし、長いメッセージでは Twilio に追加料金が発生する場合があります。 | ✅ |
この **参照** 列は、で利用可能な動的値を使ってプロパティをパラメータ化できる可能性を示します `ワークフロー` 実行時。参照 *バインディング* 詳細は。
### ランタイム互換性
`requires_internet` - エアギャップ／オフライン環境: このブロックは、完全にオフライン／エアギャップ環境から到達できないサービスに依存しています。
`soft` - ランタイム `hosted_serverless`, `dedicated_deployment`；実行 `リモート` : クールダウン／レート制限タイマーはプロセスメモリに保存されます。ステートレスまたは複数レプリカのHTTPランタイムでリモートステップ実行を行う場合、各リクエストごとに新しいワーカーが割り当てられるため、クールダウンはスロットリングしません。クールダウンが文書どおりに機能するのは、永続的なWebRTCセッションでのローカルステップ実行のみです。
### 入力と出力のバインディング
利用可能な接続は、そのバインディング種別によって異なります。どのバインディング種別が `Twilio SMS通知` のバージョン `v1` あるか確認してください。
入力と出力のバインディング
* 入力
* `twilio_account_sid` (*Union\[*[*`secret`*](/workflows/ja/gaido/developer-guide/kinds/secret.md)*,* [*`string`*](/workflows/ja/gaido/developer-guide/kinds/string.md)*]*）：Twilio API で認証するための Twilio Account SID。 [Twilio Console](https://twilio.com/console) アカウント情報の下にあります。このフィールドはセキュリティのため非公開としてマークされています。ワークフロー定義に保存するのではなく、SECRET\_KIND セレクターを使用してワークフロー入力から提供することを推奨します。Twilio SMS メッセージを送信するための Twilio API リクエストの認証には twilio\_auth\_token と併用されます。
* `twilio_auth_token` (*Union\[*[*`secret`*](/workflows/ja/gaido/developer-guide/kinds/secret.md)*,* [*`string`*](/workflows/ja/gaido/developer-guide/kinds/string.md)*]*）：Twilio API で認証するための Twilio Auth Token。 [Twilio Console](https://twilio.com/console) アカウント情報の下にあります（表示するには「show」をクリックしてください）。このフィールドはセキュリティのため非公開としてマークされています。ワークフロー定義に保存するのではなく、SECRET\_KIND セレクターを使用してワークフロー入力から提供することを推奨します。Twilio SMS メッセージを送信するための Twilio API リクエストの認証には twilio\_account\_sid と併用されます。
* `sender_number` ([*`string`*](/workflows/ja/gaido/developer-guide/kinds/string.md)）：Twilio 電話番号から SMS メッセージを送信します。E.164 形式（例: '+1234567890'）である必要があり、Twilio で購入した電話番号または Twilio アカウント内で検証済みの番号でなければなりません。この番号は、受信者が受け取る SMS メッセージの送信者として表示されます。Twilio Console で番号を購入するか、テスト用に試用番号を使用できます。
* `receiver_number` ([*`string`*](/workflows/ja/gaido/developer-guide/kinds/string.md)）：SMS メッセージを受信する宛先の電話番号。E.164 形式（例: '+1234567890'）である必要があります。Twilio の試用アカウントでは、受信先番号は Twilio アカウント内で検証済みである必要があります。有料アカウントでは、有効な電話番号であればどこへでも送信できます。これは通知を受け取るモバイル番号です。
* `message_parameters` ([*`*`*](/workflows/ja/gaido/developer-guide/kinds/wildcard.md)) : メッセージ内のプレースホルダーで使用されるパラメーター名をワークフローデータソースに対応付ける辞書。キーはメッセージ内で `{{ $parameters.key }}`として参照されるパラメーター名で、値はワークフローステップ出力または直接値へのセレクターです。これらの値は実行時にメッセージプレースホルダーに置換されます。必要に応じて message\_parameters\_operations を使用して、置換前にパラメーター値を変換できます。
* `fire_and_forget` ([*`boolean`*](/workflows/ja/gaido/developer-guide/kinds/boolean.md)）：実行モード: True は非同期のバックグラウンド送信（ワークフローは即座に継続し、error\_status は常に False、実行速度が速い）、False は同期送信（Twilio API 呼び出しの完了を待ち、デバッグ用に実際のエラー状態を返す）です。開発およびデバッグ中は Twilio API エラーを捕捉するために False に設定してください。SMS 配信のタイミングが重要でない本番環境では、ワークフロー実行を高速化するために True に設定してください。
* `disable_sink` ([*`boolean`*](/workflows/ja/gaido/developer-guide/kinds/boolean.md)）：実行時に SMS 通知送信を無効化するフラグ。True の場合、このブロックは SMS の送信をスキップし、無効化メッセージを返します。ワークフロー入力による条件付き通知制御に便利です（例: テスト用に通知を無効化できるようにする、設定に応じて有効/無効を切り替える）。実行時制御のためにワークフロー入力で設定します。
* `cooldown_seconds` ([*`整数`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)）：連続する SMS 通知の間隔を最小化して SMS スパムを防ぐための秒数。デフォルトは 5 秒です。0 に設定するとクールダウンを無効化できます（スロットリングなし）。0 から 900（15 分）の間でなければなりません。クールダウン期間中、このブロックは throttling\_status=True を返して送信をスキップします。クールダウンは cooldown\_session\_key を使用し、キャッシュベースのストレージ（15 分の有効期限）でステップごとに追跡されます。ワークフロー内の各 Twilio SMS 通知ステップには、適切なステップごとの追跡のために一意の cooldown\_session\_key を設定する必要があります。
* `length_limit` ([*`整数`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)）：トランケーション前に SMS メッセージで許可される最大文字数。デフォルトは 160 文字（標準の単一パート SMS の長さ）です。この上限を超えるメッセージは自動的に切り詰められ、末尾の文字は切り詰めマーカー（'\[...]'）に置き換えられます。0 より大きい値でなければなりません。注: SMS 標準では、単一パートメッセージは 160 文字、複数パートメッセージはセグメントごとに 153 文字をサポートします。必要に応じて調整してください。ただし、長いメッセージでは Twilio に追加料金が発生する場合があります。
* 出力
* `error_status` ([`boolean`](/workflows/ja/gaido/developer-guide/kinds/boolean.md)) : ブールフラグ。
* `throttling_status` ([`boolean`](/workflows/ja/gaido/developer-guide/kinds/boolean.md)) : ブールフラグ。
* `message` ([`string`](/workflows/ja/gaido/developer-guide/kinds/string.md)) : 文字列値。
JSON 定義の例
```json
{
"name": "",
"type": "roboflow_core/twilio_sms_notification@v1",
"twilio_account_sid": "$inputs.twilio_account_sid",
"twilio_auth_token": "$inputs.twilio_auth_token",
"sender_number": "+1234567890",
"receiver_number": "+1234567890",
"message": "直近5分間で {{ $parameters.num_instances }} 件のインスタンスを検出しました",
"message_parameters": {
"predictions": "$steps.model.predictions",
"reference": "$inputs.reference_class_names"
},
"message_parameters_operations": {
"predictions": [
{
"property_name": "class_name",
"type": "DetectionsPropertyExtract"
}
]
},
"fire_and_forget": "$inputs.fire_and_forget",
"disable_sink": false,
"cooldown_seconds": "$inputs.cooldown_seconds",
"cooldown_session_key": "session-1v73kdhfse",
"length_limit": "$inputs.sms_length_limit"
}
```