Twilio SMS/MMS通知

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形式である必要があります。例：[phone]）

• メッセージ: 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

• twilio_auth_token - あなたのTwilio Auth Token

• sender_number - あなたのTwilio電話番号（E.164形式である必要があります）

クールダウン

このブロックは cooldown_seconds （デフォルト値は 5 秒）で、通知の連続発生を防ぎます。次を設定してください 0 クールダウンなしにするには。

クールダウン中は、 throttling_status 出力は次のように設定されます True メッセージは送信されません。

クールダウンの制限

クールダウンは動画処理に限定されます。このブロックをHTTPサービスのワークフロー（Roboflow Hosted API、Dedicated Deployment）で使用しても、HTTPリクエストにはクールダウン効果はありません。

非同期実行

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形式、例：[phone]）。	✅
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形式、例：[phone]）。	✅
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）：メッセージを受信する電話番号（E.164形式、例：[phone]）。

  • message_parameters (*) : メッセージ内で使用するデータ。

  • media_url (Union[list_of_values, image, string]）：MMS用の任意のメディアURL。公開アクセス可能な画像URLまたはワークフローブロックの画像出力を指定してください。

  • twilio_account_sid (Union[secret, string]）：Twilio ConsoleのTwilio Account SID。

  • twilio_auth_token (Union[secret, string]）：Twilio ConsoleのTwilio Auth Token。

  • sender_number (string）：送信元電話番号（E.164形式、例：[phone]）。

  • fire_and_forget (boolean) : ブロックを非同期（True）で実行してワークフローを高速化するか、同期（False）で実行してデバッグとエラー処理を行うかを示すブールフラグ。

  • disable_sink (boolean) : ブロックの実行を無効にするブールフラグ。

  • cooldown_seconds (整数）：フォローアップ通知を送信できるまでの秒数。

• 出力

  • error_status (boolean) : ブールフラグ。

  • throttling_status (boolean) : ブールフラグ。

  • message (string) : 文字列値。

JSON 定義の例

{
	    "name": "<your_step_name_here>",
	    "type": "roboflow_core/twilio_sms_notification@v2",
	    "sms_provider": "Roboflow管理APIキー",
	    "receiver_number": "[phone]",
	    "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": "[phone]",
	    "fire_and_forget": "$inputs.fire_and_forget",
	    "disable_sink": false,
	    "cooldown_seconds": "$inputs.cooldown_seconds"
	}