> 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-smsmms-notification.md).
# Twilio SMS/MMS通知
この **Twilio SMS/MMS通知** このブロックを使用すると、ユーザーはワークフローの一部としてテキストおよびマルチメディアメッセージを送信できます。
### SMSプロバイダーのオプション
このブロックは、ドロップダウン選択で2つのSMS配信方法をサポートします：
1. **Roboflow 管理 API キー（デフォルト）** - Twilioの設定は不要です。メッセージはRoboflowのプロキシサービス経由で送信されます：
* **簡単なセットアップ** - メッセージ、宛先、必要に応じてメディアを指定するだけです
* **安全** - 認証にはワークフローの API キーが使用されます
* **Twilioアカウントは不要です**
* **料金：** 米国/カナダ：1クレジットで30件のメッセージ。国際：1クレジットで10件のメッセージ。（SMSとMMSは同一料金）
2. **カスタムTwilio** - ご自身のTwilioアカウントを使用します：
* メッセージ配信を完全に制御できます
* Twilioの認証情報（Account SID、Auth Token、電話番号）が必要です
* メッセージ料金はTwilioに直接お支払いください
### メッセージ内容
* **受信者番号：** メッセージを受信する電話番号（E.164形式である必要があります。例：+15551234567）
* **メッセージ:** SMS/MMSの本文です。 **メッセージは、ワークフロー実行中に生成されたデータでパラメータ化できます。以下を参照してください *****動的パラメーター***** セクション。**
* **メディアURL（任意）：** MMSメッセージでは、画像URLまたは可視化ブロックの画像出力を指定してください
### 動的パラメーター
メッセージ内容はワークフロー実行結果でパラメータ化できます。例：
```
message = "警告！ {{ $parameters.num_detections }} 個のオブジェクトを検出しました"
```
メッセージパラメータは次のように設定します `message_parameters`:
```
message_parameters = {
"num_detections": "$steps.model.predictions"
}
```
次を使用してデータを変換します `message_parameters_operations`:
```
message_parameters_operations = {
"predictions": [
{"type": "DetectionsPropertyExtract", "property_name": "class_name"}
]
}
```
### MMSサポート
次を指定してメッセージとともに画像を送信します `media_url`:
* **画像URL**：公開アクセス可能な画像URLを文字列またはリストで指定します
* **ワークフロー画像**：可視化ブロックの画像出力を参照します
* **Base64画像**：画像は送信用に自動変換されます
例:
```
media_url = "$steps.bounding_box_visualization.image"
```
または複数の画像：
```
media_url = ["https://example.com/image1.jpg", "https://example.com/image2.jpg"]
```
**注意:** MMSは主に米国/カナダでサポートされています。国際MMSの利用可否は通信事業者によって異なります。
### カスタムTwilioの使用
ご自身のTwilioアカウントを使用するには、「Custom Twilio」を選択して次を設定します：
* `twilio_account_sid` - Twilio ConsoleのあなたのTwilio Account SID [Twilio Console](https://twilio.com/console)
* `twilio_auth_token` - あなたのTwilio Auth Token
* `sender_number` - あなたのTwilio電話番号（E.164形式である必要があります）
### クールダウン
このブロックは `cooldown_seconds` （デフォルト値は `5` 秒）で、通知の連続発生を防ぎます。次を設定してください `0` クールダウンなしにするには。
クールダウン中は、 `throttling_status` 出力は次のように設定されます `True` メッセージは送信されません。
{% hint style="warning" %}
**クールダウンの制限**
クールダウンは動画処理に限定されます。このブロックをHTTPサービスのワークフロー（Roboflow Hosted API、Dedicated Deployment）で使用しても、HTTPリクエストにはクールダウン効果はありません。
{% endhint %}
### 非同期実行
Set `fire_and_forget=True` メッセージをバックグラウンドで送信し、ワークフローを続行できるようにします。\n非同期モードでは、 `error_status` は常に `False`. **Set `fire_and_forget=False` デバッグ用です。**
### 通知の無効化
Set `disable_sink` フラグを使用して、ワークフロー入力から通知ブロックを手動で無効にします。
### 型識別子
ステップで次の識別子を使用してください `"type"` フィールド： `roboflow_core/twilio_sms_notification@v2` ワークフローにこのブロックをステップとして追加するには。
### プロパティ
| **名前** | **型** | **説明** | 参照 |
| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- | -- |
| `name` | `str` | このステップの一意の識別子を入力してください。 | ❌ |
| `sms_provider` | `str` | SMS配信方法を選択します。Roboflowの管理サービスを使用するか、ご自身のTwilioアカウントを設定してください。 | ❌ |
| `receiver_number` | `str` | メッセージを受信する電話番号（E.164形式、例：+15551234567）。 | ✅ |
| `message` | `str` | 送信するメッセージの内容。 | ❌ |
| `message_parameters` | `Dict[str, Union[bool, float, int, str]]` | メッセージ内で使用するデータ。 | ✅ |
| `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]]]` | メッセージパラメーターに対して実行される前処理操作。 | ❌ |
| `media_url` | `Optional[List[str], str]` | MMS用の任意のメディアURL。公開アクセス可能な画像URLまたはワークフローブロックの画像出力を指定してください。 | ✅ |
| `twilio_account_sid` | `str` | Twilio ConsoleのTwilio Account SID。 | ✅ |
| `twilio_auth_token` | `str` | Twilio ConsoleのTwilio Auth Token。 | ✅ |
| `sender_number` | `str` | 送信元電話番号（E.164形式、例：+15551234567）。 | ✅ |
| `fire_and_forget` | `bool` | ブロックを非同期（True）で実行してワークフローを高速化するか、同期（False）で実行してデバッグとエラー処理を行うかを示すブールフラグ。 | ✅ |
| `disable_sink` | `bool` | ブロックの実行を無効にするブールフラグ。 | ✅ |
| `cooldown_seconds` | `整数` | フォローアップ通知を送信できるまでの秒数。 | ✅ |
この **参照** 列は、で利用可能な動的値を使ってプロパティをパラメータ化できる可能性を示します `ワークフロー` 実行時。参照 *バインディング* 詳細は。
### ランタイム互換性
`requires_internet` - エアギャップ／オフライン環境: このブロックは、完全にオフライン／エアギャップ環境から到達できないサービスに依存しています。
`soft` - ランタイム `hosted_serverless`, `dedicated_deployment`；実行 `リモート` : クールダウン／レート制限タイマーはプロセスメモリに保存されます。ステートレスまたは複数レプリカのHTTPランタイムでリモートステップ実行を行う場合、各リクエストごとに新しいワーカーが割り当てられるため、クールダウンはスロットリングしません。クールダウンが文書どおりに機能するのは、永続的なWebRTCセッションでのローカルステップ実行のみです。
### 入力と出力のバインディング
利用可能な接続は、そのバインディング種別によって異なります。どのバインディング種別が `Twilio SMS/MMS通知` のバージョン `v2` あるか確認してください。
入力と出力のバインディング
* 入力
* `receiver_number` ([*`string`*](/workflows/ja/gaido/developer-guide/kinds/string.md)）：メッセージを受信する電話番号（E.164形式、例：+15551234567）。
* `message_parameters` ([*`*`*](/workflows/ja/gaido/developer-guide/kinds/wildcard.md)) : メッセージ内で使用するデータ。
* `media_url` (*Union\[*[*`list_of_values`*](/workflows/ja/gaido/developer-guide/kinds/list-of-values.md)*,* [*`image`*](/workflows/ja/gaido/developer-guide/kinds/image.md)*,* [*`string`*](/workflows/ja/gaido/developer-guide/kinds/string.md)*]*）：MMS用の任意のメディアURL。公開アクセス可能な画像URLまたはワークフローブロックの画像出力を指定してください。
* `twilio_account_sid` (*Union\[*[*`secret`*](/workflows/ja/gaido/developer-guide/kinds/secret.md)*,* [*`string`*](/workflows/ja/gaido/developer-guide/kinds/string.md)*]*）：Twilio ConsoleのTwilio Account SID。
* `twilio_auth_token` (*Union\[*[*`secret`*](/workflows/ja/gaido/developer-guide/kinds/secret.md)*,* [*`string`*](/workflows/ja/gaido/developer-guide/kinds/string.md)*]*）：Twilio ConsoleのTwilio Auth Token。
* `sender_number` ([*`string`*](/workflows/ja/gaido/developer-guide/kinds/string.md)）：送信元電話番号（E.164形式、例：+15551234567）。
* `fire_and_forget` ([*`boolean`*](/workflows/ja/gaido/developer-guide/kinds/boolean.md)) : ブロックを非同期（True）で実行してワークフローを高速化するか、同期（False）で実行してデバッグとエラー処理を行うかを示すブールフラグ。
* `disable_sink` ([*`boolean`*](/workflows/ja/gaido/developer-guide/kinds/boolean.md)) : ブロックの実行を無効にするブールフラグ。
* `cooldown_seconds` ([*`整数`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)）：フォローアップ通知を送信できるまでの秒数。
* 出力
* `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@v2",
"sms_provider": "Roboflow管理APIキー",
"receiver_number": "+15551234567",
"message": "警告！ {{ $parameters.num_detections }} 個のオブジェクトを検出しました",
"message_parameters": {
"num_detections": "$steps.model.predictions",
"reference": "$inputs.reference_class_names"
},
"message_parameters_operations": {
"predictions": [
{
"property_name": "class_name",
"type": "DetectionsPropertyExtract"
}
]
},
"media_url": "$steps.visualization.image",
"twilio_account_sid": "$inputs.twilio_account_sid",
"twilio_auth_token": "$inputs.twilio_auth_token",
"sender_number": "+15551234567",
"fire_and_forget": "$inputs.fire_and_forget",
"disable_sink": false,
"cooldown_seconds": "$inputs.cooldown_seconds"
}
```