Twilio SMS/MMS 알림

Twilio를 통해 SMS/MMS 알림을 보냅니다.

이 Twilio SMS/MMS 알림 블록을 통해 사용자는 워크플로의 일부로 텍스트 및 멀티미디어 메시지를 보낼 수 있습니다.

SMS 제공자 옵션

이 블록은 드롭다운 선택기를 통해 두 가지 SMS 전송 방식을 지원합니다:

1. Roboflow 관리형 API 키(기본값) - Twilio 설정이 필요 없습니다. 메시지는 Roboflow의 프록시 서비스를 통해 전송됩니다:

   • 간편한 설정 - 메시지, 수신자, 선택적 미디어만 제공하면 됩니다

   • 안전함 - 인증에는 워크플로 API 키가 사용됩니다

   • Twilio 계정이 필요하지 않습니다

   • 가격: 미국/캐나다: 크레딧당 30개 메시지. 국제: 크레딧당 10개 메시지. (SMS와 MMS는 동일한 요금)

2. 사용자 지정 Twilio - 자체 Twilio 계정을 사용하세요:

   • 메시지 전송을 완전히 제어

   • Twilio 자격 증명(계정 SID, 인증 토큰, 전화번호)이 필요합니다

   • 메시징 비용은 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 계정 SID를 가져오세요 Twilio 콘솔

• twilio_auth_token - Twilio 인증 토큰

• sender_number - Twilio 전화번호(E.164 형식이어야 함)

쿨다운

이 블록은 다음을 허용합니다 cooldown_seconds (기본값은 5 초) 알림이 연속으로 발생하는 것을 방지합니다. 다음으로 설정하세요 0 쿨다운을 사용하지 않으려면 비워두세요.

쿨다운 동안에는 throttling_status 출력이 다음으로 설정되고 True 메시지는 전송되지 않습니다.

쿨다운 제한 사항

쿨다운은 비디오 처리에만 적용됩니다. 이 블록을 HTTP 서비스 워크플로(Roboflow Hosted API, Dedicated Deployment)에서 사용해도 HTTP 요청에는 쿨다운 효과가 없습니다.

비동기 실행

설정 fire_and_forget=True 백그라운드에서 메시지를 전송하여 워크플로가 계속 진행되도록 합니다.\n비동기 모드에서는 error_status 항상 False. 설정 fire_and_forget=False 디버깅용입니다.

알림 비활성화

설정 disable_sink 워크플로 입력을 통해 notifier 블록을 수동으로 비활성화하는 플래그입니다.

유형 식별자

단계에서 다음 식별자를 사용하세요 "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 콘솔의 Twilio 계정 SID..	✅
twilio_auth_token	str	Twilio 콘솔의 Twilio 인증 토큰..	✅
sender_number	str	발신 전화번호(E.164 형식, 예: [phone]).	✅
fire_and_forget	bool	더 빠른 워크플로를 위해 블록을 비동기(True)로 실행할지, 디버깅 및 오류 처리를 위해 동기(False)로 실행할지 나타내는 불리언 플래그..	✅
disable_sink	bool	블록 실행을 비활성화하는 불리언 플래그..	✅
cooldown_seconds	정수	후속 알림을 보낼 수 있을 때까지의 초 수..	✅

이 참조 열은 워크플로우 런타임에서 사용 가능한 동적 값으로 속성을 매개변수화할 수 있는 가능성을 나타냅니다 워크플로우 런타임입니다. 자세한 내용은 바인딩 을 참조하세요.

런타임 호환성

인터넷 필요 - 에어갭 / 오프라인 배포 : 이 블록은 완전히 오프라인 / 에어갭된 배포에서는 접근할 수 없는 서비스에 의존합니다.

소프트 - 런타임 호스팅 서버리스, 전용 배포; 실행 원격 : 쿨다운/속도 제한 타이머는 프로세스 메모리에 저장됩니다. 상태 비저장 또는 다중 복제본 HTTP 런타임에서 원격 단계 실행을 사용하면 각 요청이 새 작업자를 받으므로 쿨다운이 속도를 제한하지 않습니다. 쿨다운은 지속적인 WebRTC 세션에서 로컬 단계 실행을 사용할 때만 문서화된 대로 작동합니다.

입력 및 출력 바인딩

사용 가능한 연결은 바인딩 유형에 따라 달라집니다. 어떤 바인딩 유형인지 확인하세요 Twilio SMS/MMS 알림 버전 v2 을 가지고 있는지.

입력 및 출력 바인딩

• 입력

  • receiver_number (string): 메시지를 수신할 전화번호(E.164 형식, 예: [phone]).

  • message_parameters (*): 메시지에 사용할 데이터..

  • media_url (Union[list_of_values, 이미지, string]): MMS용 선택적 미디어 URL(들). 공개적으로 접근 가능한 이미지 URL 또는 워크플로 블록의 이미지 출력을 제공하세요..

  • twilio_account_sid (Union[secret, string]): Twilio 콘솔의 Twilio 계정 SID..

  • twilio_auth_token (Union[secret, string]): Twilio 콘솔의 Twilio 인증 토큰..

  • 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"
	}