이메일 알림
이메일로 알림을 보냅니다.
v2
이 이메일 알림 이 블록을 사용하면 워크플로의 일부로 이메일 알림을 보낼 수 있습니다.
이 블록의 작동 방식
이메일 제공업체 옵션
이 블록은 드롭다운 선택기를 통해 두 가지 이메일 전송 방법을 지원합니다:
Roboflow 관리형 API 키(기본값) - SMTP 구성이 필요하지 않습니다. 이메일은 Roboflow의 프록시 서비스를 통해 전송됩니다:
간편한 설정 - 제목, 메시지, 수신자만 제공하면 됩니다
안전함 - 인증에는 워크플로 API 키가 사용됩니다
SMTP 서버가 필요하지 않습니다
사용자 지정 SMTP - 자체 SMTP 서버를 사용하세요:
이메일 전송을 완전히 제어 가능
SMTP 서버 구성 필요(호스트, 포트, 자격 증명)
CC 및 BCC 수신자 지원
사용자 지정 가능한 이메일 내용
제목: 제목 필드를 설정하여 이메일 제목 줄을 정의합니다.
메시지: 메시지 필드를 사용해 이메일 본문을 작성합니다. 메시지는 워크플로 실행 중 생성된 데이터로 매개변수화할 수 있습니다. 참고 동적 매개변수 섹션.
수신자(To, CC, BCC): 이메일 수신 대상을 다음 항목으로 정의합니다:
receiver_email,cc_receiver_email, 그리고bcc_receiver_email속성. 단일 이메일 또는 목록을 입력할 수 있습니다.
동적 매개변수
메시지 내용은 워크플로 실행 결과로 매개변수화할 수 있습니다. 동적 매개변수를 사용하는 예시 메시지를 확인하세요:
메시지 매개변수는 워크플로 실행 엔진이 다음 항목의 적절한 데이터 선택기를 설정하여 전달합니다: message_parameters 필드입니다. 예:
데이터를 선택하는 것만이 유일한 옵션은 아닙니다. 데이터는 블록 내에서 처리될 수도 있습니다. 아래 예시에서는 예측된 클래스의 이름을 추출하고자 합니다. 다음 변환을 적용할 수 있습니다 각 매개변수에 대해 다음을 설정하여 message_parameters_operations:
그 결과, 전송될 이메일에서는 다음과 같이 표시됩니다:
사용자 지정 SMTP 서버 사용
자체 SMTP 서버를 사용하려면 다음에서 "사용자 지정 SMTP"를 선택하세요: email_provider 드롭다운에서 다음 매개변수를 구성하세요:
smtp_server- 사용할 SMTP 서버의 호스트 이름sender_email- 발신자로 사용할 이메일 계정sender_email_password- 발신자 이메일 계정의 비밀번호smtp_port- SMTP 서비스 포트 - 기본값:465
블록 강제합니다 SMTP에서 SSL 사용.
사용자 지정 SMTP 서버의 일반적인 사용 시나리오는 Google SMTP 서버를 통해 이메일을 보내는 것입니다. 다음을 참고하세요: Google 튜토리얼 블록을 올바르게 구성하려면.
2단계 인증이 켜져 있으면 GMAIL 비밀번호는 작동하지 않습니다
이메일 서비스 제공업체로 사용자 지정 SMTP 서버를 선택하는 GMAIL 사용자는 다음을 구성해야 합니다 애플리케이션 비밀번호 2단계 인증으로 보호된 계정에서 문제를 피하기 위해. 다음 점에 유의하세요: 애플리케이션 비밀번호는 보호된 상태로 유지해야 합니다 - 비밀번호는 Workflow 입력으로 보내고 호출자가 매번 제공하도록 하며, Workflow 정의에 저장하지 않는 것을 권장합니다.
쿨다운
이 블록은 다음을 허용합니다 cooldown_seconds (이는 기본값은 5 초) 원치 않는 알림 폭주를 방지합니다. 필요에 따라 조정하고, 0 쿨다운 없음으로 설정하세요.
쿨다운 기간 동안, 해당 단계가 연속으로 실행되면 throttling_status 출력이 설정됩니다 True 그리고 알림은 전송되지 않습니다.
쿨다운 제한 사항
현재 쿨다운 구현은 비디오 처리에만 제한됩니다. HTTP 서비스 뒤에서 실행되는 워크플로(Roboflow Hosted API, Dedicated Deployment 또는 자체 호스팅 inference 서버)에서 이 블록을 사용해도 HTTP 요청 처리에는 영향을 주지 않습니다.
첨부 파일
이메일과 함께 보낼 첨부 파일을 지정할 수 있습니다. 첨부 파일은 전용 블록이나 이미지 출력에서 런타임에 생성할 수 있습니다.
지원되는 첨부 파일 형식:
CSV/텍스트 파일: 다음과 같은 블록에서 CSV 포맷터
이미지: 시각화 블록의 모든 이미지 출력(자동으로 JPEG로 변환됨)
이진 데이터: 호환되는 블록의 모든 바이트 출력
첨부 파일을 포함하려면 첨부 파일 이름을 키로 제공하고 블록 출력을 참조하세요:
참고: 이미지 첨부 파일은 자동으로 JPEG 형식으로 변환됩니다. 파일 이름에 .jpg 또는 .jpeg 확장자가 없으면 자동으로 추가됩니다.
비동기 실행
다음을 fire_and_forget 속성. 이메일이 백그라운드에서 전송되도록 하려면 True로 설정하세요. 그러면 이메일 전송을 기다리지 않고 워크플로가 계속 진행됩니다. 이 경우 다음에 의존할 수 없습니다 error_status 출력이며, 항상 다음으로 설정됩니다 False, 따라서 우리는 다음 설정을 권장합니다 fire_and_forget=False 디버깅 목적으로.
런타임 매개변수를 기반으로 알림 비활성화
때로는 이메일 알림 블록을 수동으로 비활성화하는 것이 편리할 수 있습니다. 다음 설정으로 가능합니다 disable_sink 플래그를 Workflow 입력에 대한 참조로 두는 것입니다. 이렇게 설정하면 호출자가 필요할 때 합의된 입력 매개변수를 보내 싱크를 비활성화할 수 있습니다.
일반적인 사용 사례
이 블록을 사용하여 [블록 유형에 따른 목적]
다른 블록에 연결하기
이 블록의 출력은 워크플로의 다른 블록에 연결할 수 있습니다.
유형 식별자
단계에서 다음 식별자를 사용하세요 "type" 필드: roboflow_core/email_notification@v2 워크플로우에 이 블록을 단계로 추가하려면.
속성
이름
유형
설명
참조
name
str
이 단계에 대한 고유 식별자를 입력하세요..
❌
email_provider
str
이메일 전송 방법을 선택하세요: Roboflow의 관리형 서비스를 사용하거나 자체 SMTP 서버를 구성하세요..
❌
subject
str
메시지의 제목..
❌
receiver_email
Union[List[str], str]
수신자 이메일 주소..
✅
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]]]
메시지 매개변수에 수행할 전처리 작업..
❌
sender_email
str
메시지를 보내는 데 사용할 이메일..
✅
smtp_server
str
사용할 사용자 지정 SMTP 서버..
✅
sender_email_password
str
SMTP 서버 인증 시 사용할 발신자 이메일 비밀번호..
✅
cc_receiver_email
Optional[List[str], str]
CC 이메일 주소..
✅
bcc_receiver_email
Optional[List[str], str]
BCC 이메일 주소..
✅
smtp_port
정수
SMTP 서버 포트..
❌
fire_and_forget
bool
더 빠른 워크플로를 위해 블록을 비동기(True)로 실행할지, 디버깅 및 오류 처리를 위해 동기(False)로 실행할지 나타내는 불리언 플래그..
✅
disable_sink
bool
블록 실행을 비활성화하는 불리언 플래그..
✅
cooldown_seconds
정수
후속 알림을 보낼 수 있을 때까지의 초 수. .
✅
이 참조 열은 워크플로우 런타임에서 사용 가능한 동적 값으로 속성을 매개변수화할 수 있는 가능성을 나타냅니다 워크플로우 런타임입니다. 자세한 내용은 바인딩 을 참조하세요.
런타임 호환성
소프트 - 런타임 호스팅 서버리스, 전용 배포; 실행 원격 : 쿨다운/속도 제한 타이머는 프로세스 메모리에 저장됩니다. 상태 비저장 또는 다중 복제본 HTTP 런타임에서 원격 단계 실행을 사용하면 각 요청이 새 작업자를 받으므로 쿨다운이 속도를 제한하지 않습니다. 쿨다운은 지속적인 WebRTC 세션에서 로컬 단계 실행을 사용할 때만 문서화된 대로 작동합니다.
입력 및 출력 바인딩
사용 가능한 연결은 바인딩 유형에 따라 달라집니다. 어떤 바인딩 유형인지 확인하세요 이메일 알림 버전 v2 을 가지고 있는지.
입력 및 출력 바인딩
입력
receiver_email(Union[list_of_values,string]): 수신자 이메일 주소..message_parameters(*): 메시지에 사용할 데이터..sender_email(string): 메시지를 보내는 데 사용할 이메일..smtp_server(string): 사용할 사용자 지정 SMTP 서버..cc_receiver_email(Union[list_of_values,string]): CC 이메일 주소..bcc_receiver_email(Union[list_of_values,string]): BCC 이메일 주소..fire_and_forget(boolean): 더 빠른 워크플로를 위해 블록을 비동기(True)로 실행할지, 디버깅 및 오류 처리를 위해 동기(False)로 실행할지 나타내는 불리언 플래그..disable_sink(boolean): 블록 실행을 비활성화하는 불리언 플래그..cooldown_seconds(정수): 후속 알림을 보낼 수 있을 때까지의 초 수. .
v1
SMTP 서버를 통해 이메일 알림을 보내며, 사용자 지정 가능한 제목, 동적 워크플로 데이터 매개변수가 포함된 메시지 내용, 수신자 목록(To, CC, BCC), 파일 첨부, 쿨다운 제한, 그리고 알림·보고·커뮤니케이션 워크플로를 위한 선택적 비동기 백그라운드 실행을 지원합니다.
이 블록의 작동 방식
이 블록은 SMTP 서버를 통해 이메일 알림을 보내고, 워크플로 실행 결과를 이메일 내용에 통합합니다. 이 블록은 다음을 수행합니다:
다음을 통해 싱크 비활성화 여부를 확인합니다
disable_sink플래그(비활성화되어 있으면 전송하지 않고 즉시 반환)쿨다운 기간을 검증합니다(활성화되어 있으면 다음 시간 내 알림을 제한합니다
cooldown_seconds마지막으로 보낸 이메일 기준으로, 제한 상태를 반환합니다)동적 매개변수를 처리하여 이메일 메시지를 형식화합니다(다음과 같은 플레이스홀더를 바꿉니다
{{ $parameters.parameter_name }}실제 워크플로 데이터로message_parameters)삽입 전에 매개변수 값을 변환하기 위해 선택적 UQL 작업을 적용합니다(예: 탐지에서 클래스 이름 추출, 지표 계산, 데이터 필터링) 다음을 사용하여
message_parameters_operations다음 항목에서 이메일 수신자 목록을 구성합니다
receiver_email(필수),cc_receiver_email, 그리고bcc_receiver_email(단일 이메일 주소 또는 목록 지원)참조된 워크플로 단계 출력에서 내용을 가져와 이메일 첨부 파일로 인코딩하여 첨부 파일을 처리합니다
구성된 서버에 SSL로 보호된 SMTP 연결을 설정합니다(발신자 이메일과 비밀번호로 인증)
다음에 따라 이메일을 동기 또는 비동기로 전송합니다
fire_and_forget설정:동기 모드 (
fire_and_forget=False): 이메일 전송 완료를 기다리고, 디버깅을 위해 실제 오류 상태를 반환합니다비동기 모드 (
fire_and_forget=True): 백그라운드 작업으로 이메일을 전송하고, 워크플로는 즉시 계속 진행되며, 오류 상태는 항상 False입니다
성공, 제한, 오류를 나타내는 상태 출력을 반환합니다
이 블록은 런타임에 워크플로 데이터로 대체되는 매개변수 플레이스홀더를 통해 동적 메시지 내용을 지원합니다. 메시지 매개변수는 원시 워크플로 출력이거나 UQL 작업으로 변환된 값일 수 있습니다(예: 속성 추출, 개수 계산, 값 필터링). 첨부 파일은 문자열 또는 이진 콘텐츠를 생성하는 다른 워크플로 블록에서 가져오며(예: 보고서용 CSV Formatter, 스크린샷용 이미지 출력), 쿨다운은 전송 사이의 최소 시간을 강제하여 알림 스팸을 방지합니다. 다만 이는 비디오 처리 워크플로에만 적용되며 HTTP 요청 컨텍스트에는 적용되지 않습니다.
요구 사항
SMTP 서버 구성: 다음 구성을 가진 SMTP 서버에 대한 액세스가 필요합니다:
smtp_server: SMTP 서버의 호스트 이름(예:smtp.gmail.comGoogle의 경우)sender_email: 발신자로 사용할 이메일 주소sender_email_password: 발신자 이메일 계정의 비밀번호(또는 2FA가 있는 Gmail의 경우 애플리케이션 전용 비밀번호)smtp_port: SMTP 포트(기본값:465SSL의 경우)
2FA를 사용하는 Gmail 사용자: Gmail에서 2단계 인증을 사용 중이라면 다음을 사용해야 합니다 애플리케이션 전용 비밀번호 일반 Gmail 비밀번호 대신 사용하세요. 애플리케이션 비밀번호는 안전하게 보관해야 하며, 워크플로 정의에 저장하기보다 워크플로 입력을 통해 제공해야 합니다.
쿨다운 제한 사항: 쿨다운 메커니즘(cooldown_seconds)은 비디오 처리 워크플로에만 적용됩니다. HTTP 요청 컨텍스트(Roboflow Hosted API, Dedicated Deployment 또는 자체 호스팅 서버)에서는 각 요청이 독립적이므로 쿨다운이 적용되지 않습니다.
일반적인 사용 사례
경고 알림: 특정 조건이 감지되면 이메일 경고를 보내세요(예: 승인되지 않은 객체가 감지되면 보안팀에 알리고, 이상이 감지되면 운영자에게 알리며, 감지 수가 임계값을 넘으면 경고 전송) 이를 통해 실시간 모니터링 및 사고 대응을 지원합니다
워크플로 실행 보고서: 워크플로 결과가 포함된 주기적 또는 이벤트 기반 보고서를 생성해 이메일로 전송합니다(예: 감지 통계가 포함된 일일 요약 보고서, 배치 처리 완료 알림, 성능 지표 요약) 이를 통해 자동 보고 및 문서화를 지원합니다
감지 요약: 집계된 통계가 포함된 감지 결과 요약을 이메일로 전송합니다(예: 감지된 객체 목록, 개수 및 분류 전송, 감지 신뢰도 요약 포함) 이를 통해 이해관계자가 워크플로 출력에 대해 계속 알 수 있습니다
오류 및 상태 알림: 워크플로 실행 상태와 오류를 관리자에게 알립니다(예: 워크플로 실패 시 경고 전송, 처리 완료 알림, 시스템 상태 문제 보고) 이를 통해 프로덕션 배포의 모니터링 및 디버깅을 지원합니다
데이터 내보내기 알림: 생성된 데이터 내보내기와 보고서를 이메일로 전송합니다(예: CSV Formatter의 CSV 보고서 첨부, 내보낸 감지 데이터 전송, 서식이 적용된 분석 요약 포함) 이를 통해 자동 데이터 배포 및 보관을 지원합니다
다중 수신자 업데이트: CC/BCC를 사용해 여러 이해관계자에게 동시에 알림을 보냅니다(예: 감지 사항을 팀원에게 알림, 여러 부서에 업데이트 전송, 가시성을 위해 CC로 보고서 배포) 이를 통해 효율적인 다자간 커뮤니케이션을 지원합니다
다른 블록에 연결하기
이 블록은 워크플로 단계에서 데이터를 받아 이메일 알림을 전송합니다:
탐지 또는 분석 블록 뒤에서 (예: 객체 감지, 인스턴스 분할, 분류) 객체가 감지되거나 분류가 수행되거나 임계값을 초과할 때 경고나 요약을 보내 실시간 알림 워크플로를 지원합니다
데이터 처리 블록 다음 (예: Expression, Property Definition, Detections Filter) 계산된 지표, 변환된 데이터 또는 필터링된 결과를 이메일 알림에 포함하여 처리된 데이터로 맞춤형 보고를 지원합니다
포맷터 블록 다음 (예: CSV Formatter) 서식이 지정된 보고서와 내보내기를 이메일에 첨부하여 구조화된 데이터와 분석을 자동 배포합니다
조건부 워크플로에서 (예: Continue If) 특정 조건이 충족될 때만 알림을 보내 이벤트 기반 경고 및 보고를 지원합니다
집계 블록 다음 (예: Data Aggregator) 주기적인 분석 요약과 통계 보고서를 이메일로 보내 예약 보고 및 추세 분석을 지원합니다
모니터링 워크플로에서 상태 업데이트, 오류 알림 또는 상태 점검 보고서를 보내 자동 시스템 모니터링 및 사고 관리를 지원합니다
유형 식별자
단계에서 다음 식별자를 사용하세요 "type" 필드: roboflow_core/email_notification@v1 워크플로우에 이 블록을 단계로 추가하려면.
속성
이름
유형
설명
참조
name
str
이 단계에 대한 고유 식별자를 입력하세요..
❌
subject
str
알림의 이메일 제목 줄입니다. 이는 이메일 헤더와 수신자의 받은편지함 제목 필드에 표시되는 텍스트입니다. 알림 목적을 설명하는 정적 텍스트를 포함할 수 있습니다(예: '워크플로 알림', '감지 요약', '일일 보고서')..
❌
sender_email
str
알림의 발신자로 사용할 이메일 주소입니다. 이 이메일 계정은 구성된 SMTP 서버에 접근할 수 있어야 하며 sender_email_password에 제공된 비밀번호를 사용합니다. 2FA가 활성화된 Gmail의 경우 애플리케이션 전용 비밀번호가 설정된 Gmail 주소여야 합니다..
✅
receiver_email
Union[List[str], str]
알림의 기본 수신자 이메일 주소입니다. 필수 필드이며 최소 하나의 수신자를 지정해야 합니다. 단일 이메일 주소 문자열일 수도 있고 여러 수신자를 위한 이메일 주소 목록일 수도 있습니다. 수신자는 받은 이메일의 'To' 필드에서 자신의 이메일 주소를 보게 됩니다..
✅
message
str
이메일 본문 내용(일반 텍스트)입니다. 다음 플레이스홀더 구문을 사용한 동적 매개변수를 지원합니다: {{ $parameters.parameter_name }}. 플레이스홀더는 런타임에 message_parameters의 값으로 대체됩니다. 메시지는 여러 줄 텍스트일 수 있습니다. 예: '감지됨 {{ $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]]]
메시지에 삽입하기 전에 매개변수 값을 변환하는 UQL 작업 체인에 message_parameters의 매개변수 이름을 매핑하는 선택적 사전입니다. 작업은 순서대로 적용됩니다(예: 감지에서 클래스 이름 추출, 개수 계산, 값 필터링). 키는 message_parameters의 매개변수 이름과 일치해야 합니다. 변환이 필요 없는 매개변수는 비워 두거나 생략하세요..
❌
cc_receiver_email
Optional[List[str], str]
선택적 CC(Carbon Copy) 수신자 이메일 주소입니다. 단일 이메일 주소 문자열일 수도 있고 이메일 주소 목록일 수도 있습니다. CC 수신자는 이메일 사본을 받으며 서로의 주소를 볼 수 있습니다. 정보를 받아야 하지만 조치는 필요하지 않은 수신자에게 사용하세요..
✅
bcc_receiver_email
Optional[List[str], str]
선택적 BCC(Blind Carbon Copy) 수신자 이메일 주소입니다. 단일 이메일 주소 문자열일 수도 있고 이메일 주소 목록일 수도 있습니다. BCC 수신자는 이메일 사본을 받지만 주소는 다른 수신자에게 숨겨집니다. 알림을 비공개로 받아야 하는 수신자에게 사용하세요..
✅
smtp_server
str
이메일 전송에 사용할 SMTP 서버 호스트 이름입니다. 일반적인 예: Gmail의 'smtp.gmail.com', Outlook의 'smtp.outlook.com', 또는 조직의 SMTP 서버 호스트 이름입니다. 이 블록은 SMTP 연결에 SSL/TLS 암호화를 강제합니다. 서버가 지정된 포트에서 SSL을 지원하는지 확인하세요..
✅
sender_email_password
str
SMTP 서버 인증에 사용할 발신자 이메일 계정의 비밀번호입니다. 2단계 인증이 활성화된 Gmail의 경우 일반 Gmail 비밀번호 대신 애플리케이션 전용 비밀번호를 사용하세요. 이 필드는 보안을 위해 비공개로 표시됩니다. 워크플로 정의에 저장하기보다 워크플로 입력을 통해 제공하는 것이 권장됩니다. Roboflow 호스팅 서비스의 경우 안전한 자격 증명 관리를 위해 SECRET_KIND 선택기를 사용할 수 있습니다..
✅
smtp_port
정수
SMTP 서버 포트 번호입니다. 기본값은 465(SMTP용 표준 SSL 포트)입니다. 일반적인 대안은 587(TLS용, 지원되지 않음 - 이 블록은 SSL을 강제함), 25(암호화되지 않음, 권장하지 않음)입니다. 이 블록이 요구하는 대로 포트가 SSL 암호화를 지원하는지 확인하세요..
❌
fire_and_forget
bool
실행 모드: 비동기 백그라운드 전송은 True(워크플로가 즉시 계속 진행, error_status는 항상 False, 더 빠른 실행), 동기 전송은 False(이메일 완료를 기다림, 디버깅을 위해 실제 오류 상태 반환)입니다. 개발 및 디버깅 중에는 이메일 전송 오류를 잡기 위해 False로 설정하세요. 이메일 전송 시점이 중요하지 않을 때는 더 빠른 워크플로 실행을 위해 프로덕션에서 True로 설정하세요..
✅
disable_sink
bool
런타임에 이메일 전송을 비활성화하는 플래그입니다. True이면 블록은 이메일 전송을 건너뛰고 비활성화 메시지를 반환합니다. 워크플로 입력을 통한 조건부 알림 제어에 유용합니다(예: 호출자가 테스트를 위해 알림을 비활성화하도록 하거나, 구성에 따라 활성화/비활성화). 런타임 제어를 위해 워크플로 입력으로 설정하세요..
✅
cooldown_seconds
정수
알림 스팸을 방지하기 위해 연속 이메일 알림 사이의 최소 초 수입니다. 기본값은 5초입니다. 0으로 설정하면 쿨다운을 비활성화할 수 있습니다(제한 없음). 쿨다운 기간 동안 블록은 throttling_status=True를 반환하고 전송을 건너뜁니다. 참고: 쿨다운은 비디오 처리 워크플로에만 적용되며, HTTP 요청 컨텍스트(Roboflow Hosted API, Dedicated Deployment 또는 각 요청이 독립적인 자체 호스팅 서버)에는 적용되지 않습니다..
✅
이 참조 열은 워크플로우 런타임에서 사용 가능한 동적 값으로 속성을 매개변수화할 수 있는 가능성을 나타냅니다 워크플로우 런타임입니다. 자세한 내용은 바인딩 을 참조하세요.
런타임 호환성
소프트 - 런타임 호스팅 서버리스, 전용 배포; 실행 원격 : 쿨다운/속도 제한 타이머는 프로세스 메모리에 저장됩니다. 상태 비저장 또는 다중 복제본 HTTP 런타임에서 원격 단계 실행을 사용하면 각 요청이 새 작업자를 받으므로 쿨다운이 속도를 제한하지 않습니다. 쿨다운은 지속적인 WebRTC 세션에서 로컬 단계 실행을 사용할 때만 문서화된 대로 작동합니다.
입력 및 출력 바인딩
사용 가능한 연결은 바인딩 유형에 따라 달라집니다. 어떤 바인딩 유형인지 확인하세요 이메일 알림 버전 v1 을 가지고 있는지.
입력 및 출력 바인딩
입력
sender_email(string): 알림의 발신자로 사용할 이메일 주소입니다. 이 이메일 계정은 구성된 SMTP 서버에 접근할 수 있어야 하며 sender_email_password에 제공된 비밀번호를 사용해야 합니다. 2FA가 활성화된 Gmail의 경우 애플리케이션 전용 비밀번호가 설정된 Gmail 주소여야 합니다..receiver_email(Union[list_of_values,string]): 알림의 기본 수신자 이메일 주소입니다. 필수 필드이며 최소 하나의 수신자를 지정해야 합니다. 단일 이메일 주소 문자열일 수도 있고 여러 수신자를 위한 이메일 주소 목록일 수도 있습니다. 수신자는 받은 이메일의 'To' 필드에서 자신의 이메일 주소를 보게 됩니다..message_parameters(*): 메시지 플레이스홀더에 사용되는 매개변수 이름을 워크플로 데이터 소스에 매핑하는 사전입니다. 키는 메시지에서 다음과 같이 참조되는 매개변수 이름입니다{{ $parameters.key }}, 값은 워크플로 단계 출력 또는 직접 값에 대한 선택기입니다. 이러한 값은 런타임에 메시지 플레이스홀더로 대체됩니다. 필요에 따라 message_parameters_operations를 사용해 대체 전에 매개변수 값을 변환할 수 있습니다..cc_receiver_email(Union[list_of_values,string]): 선택적 CC(Carbon Copy) 수신자 이메일 주소입니다. 단일 이메일 주소 문자열일 수도 있고 이메일 주소 목록일 수도 있습니다. CC 수신자는 이메일 사본을 받으며 서로의 주소를 볼 수 있습니다. 정보를 받아야 하지만 조치는 필요하지 않은 수신자에게 사용하세요..bcc_receiver_email(Union[list_of_values,string]): 선택적 BCC(Blind Carbon Copy) 수신자 이메일 주소입니다. 단일 이메일 주소 문자열일 수도 있고 이메일 주소 목록일 수도 있습니다. BCC 수신자는 이메일 사본을 받지만 주소는 다른 수신자에게 숨겨집니다. 알림을 비공개로 받아야 하는 수신자에게 사용하세요..smtp_server(string): 이메일 전송에 사용할 SMTP 서버 호스트 이름입니다. 일반적인 예: Gmail의 'smtp.gmail.com', Outlook의 'smtp.outlook.com', 또는 조직의 SMTP 서버 호스트 이름입니다. 이 블록은 SMTP 연결에 SSL/TLS 암호화를 강제합니다. 서버가 지정된 포트에서 SSL을 지원하는지 확인하세요..fire_and_forget(boolean): 실행 모드: 비동기 백그라운드 전송은 True(워크플로가 즉시 계속 진행, error_status는 항상 False, 더 빠른 실행), 동기 전송은 False(이메일 완료를 기다림, 디버깅을 위해 실제 오류 상태 반환)입니다. 개발 및 디버깅 중에는 이메일 전송 오류를 잡기 위해 False로 설정하세요. 이메일 전송 시점이 중요하지 않을 때는 더 빠른 워크플로 실행을 위해 프로덕션에서 True로 설정하세요..disable_sink(boolean): 런타임에 이메일 전송을 비활성화하는 플래그입니다. True이면 블록은 이메일 전송을 건너뛰고 비활성화 메시지를 반환합니다. 워크플로 입력을 통한 조건부 알림 제어에 유용합니다(예: 호출자가 테스트를 위해 알림을 비활성화하도록 하거나, 구성에 따라 활성화/비활성화). 런타임 제어를 위해 워크플로 입력으로 설정하세요..cooldown_seconds(정수): 알림 스팸을 방지하기 위해 연속 이메일 알림 사이의 최소 초 수입니다. 기본값은 5초입니다. 0으로 설정하면 쿨다운을 비활성화할 수 있습니다(제한 없음). 쿨다운 기간 동안 블록은 throttling_status=True를 반환하고 전송을 건너뜁니다. 참고: 쿨다운은 비디오 처리 워크플로에만 적용되며, HTTP 요청 컨텍스트(Roboflow Hosted API, Dedicated Deployment 또는 각 요청이 독립적인 자체 호스팅 서버)에는 적용되지 않습니다..
마지막 업데이트
도움이 되었나요?