Zoho ZeptoMail
ZeptoMail은 Zoho에서 서비스를 보내는 트랜잭션 전자 메일입니다. 애플리케이션 또는 웹 사이트에서 이러한 자동화된 전자 메일을 직접 보낼 수 있습니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate (파워 오토메이트) | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | Zoho ZeptoMail |
| URL | https://www.zoho.com/zeptomail/contact.html |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Zoho Corporation Private Limited |
| 웹 사이트 | https://www.zoho.com/zeptomail/ |
| 개인 정보 보호 정책 | https://www.zoho.com/privacy.html |
| 카테고리 | Communication |
Zoho ZeptoMail
이 커넥터를 사용하면 ZeptoMail에서 전자 메일을 보낼 수 있습니다. 사용자 지정 전자 메일을 보내거나 ZeptoMail 계정에서 기존 전자 메일 템플릿을 사용할 수 있습니다.
필수 조건
ZeptoMail 계정 및 확인된 도메인입니다. 첫 번째 계정을 만들려면 여기를 클릭하십시오.
자격 증명을 가져오는 방법
새 연결을 만들 때
- Zoho 계정이 있는 도메인을 선택합니다.
- ZeptoMail의 자격 증명을 입력합니다.
- 전원 앱이 다른 사용자와 공유되더라도 새 연결을 만들어 사용을 시작해야 합니다.
커넥터 시작
아래 단계에 따라 ZeptoMail에 연결합니다.
- Power Automate 계정에 로그인하고 왼쪽 메뉴에서 만들기를 클릭합니다.
- 클라우드 흐름, 데스크톱 흐름 또는 비즈니스 흐름을 만들도록 선택할 수 있습니다. ZeptoMail에 연결하려면 자동화된 클라우드 흐름을 선택합니다.
- 다음 세 가지 방법으로 흐름을 만들 수 있습니다.
- 비어 있는 것부터 시작하여 사용자 지정 흐름을 만듭니다.
- 사용 가능한 템플릿 중에서 선택합니다.
- 커넥터에서 시작하도록 선택합니다.
- 처음부터 비어 있는 자동 클라우드 흐름을 클릭하여 처음부터 연결을 만듭니다.
- 원하는 값을 입력하고 필요한 매개 변수를 선택합니다.
- 저장을 클릭합니다. 흐름이 자동으로 실행됩니다.
알려진 문제 및 제한 사항
전자 메일 헤더, 본문 콘텐츠, 인라인 이미지 및 첨부 파일을 포함한 총 전자 메일 크기는 15MB를 초과하지 않아야 합니다.
ZeptoMail 계정의 해당 도메인을 선택합니다. 이렇게 하지 않으면 인증 오류가 발생합니다.
일반적인 오류 및 해결
인증 오류를 방지하려면 ZeptoMail 계정이 호스트되는 도메인을 선택합니다.
자주 묻는 질문(FAQ)
https://help.zoho.com/portal/en/kb/zeptomail/faqs
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| Zoho 계정 데이터가 있는 지역을 선택합니다. | 문자열 | 도메인을 선택합니다. | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| 메일 보내기 |
원하는 받는 사람에게 전자 메일을 보내려면 |
| 모든 메일 에이전트 가져오기 |
이 엔드포인트는 계정의 모든 메일 에이전트에 대한 세부 정보를 가져옵니다. 메일 에이전트 이름, 메일 에이전트 키, 만든 시간, 상태를 포함한 데이터를 반환합니다. \n\n데이터 필드 설명:\n- mailagent_name: 메일 에이전트의 이름입니다.\n- mailagent_key: 메일 에이전트 키입니다.\n- mailagent_alias: 메일 에이전트 별칭.\n- created_time: 메일 에이전트가 만들어진 시간입니다.\n- 상태: 메일 에이전트의 상태입니다.\n\n예제 1: ZeptoMail 계정에서 모든 메일 에이전트의 세부 정보를 검색합니다. 샘플 프롬프트 1: 계정의 모든 메일 에이전트에 대한 세부 정보를 가져옵니다. |
| 서식 파일 메일 보내기 |
템플릿을 사용하여 단일 전자 메일 보내기 |
| 처리된 전자 메일 분석 |
이 엔드포인트는 메일 에이전트 이름으로 식별된 메일 에이전트에서 보낸 전자 메일에 대한 전자 메일 분석을 가져옵니다. 기간 및 매일의 총 하드본스, 소프트본스 및 보낸 통계 수를 포함한 데이터를 반환합니다. mailagent 매개 변수는 시스템에 나열된 메일 에이전트 이름과 일치해야 합니다. |
| 처리된 전자 메일 세부 정보 가져오기 |
이 엔드포인트는 고유한 ID로 식별된 메일 에이전트에서 처리하는 전자 메일에 대한 자세한 정보를 가져옵니다. 제목, 보낸 사람 주소, 보낸 시간 및 시간 범위에 대해 전송된 전자 메일에 대한 요청 ID를 포함한 데이터를 반환합니다. mailagent_key 매개 변수는 시스템에 나열된 메일 에이전트의 메일 에이전트 키와 일치해야 합니다. |
메일 보내기
원하는 받는 사람에게 전자 메일을 보내려면
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
메일 에이전트
|
mailagent_key | True | string |
메일 에이전트를 선택하거나 메일 에이전트 키를 입력합니다. |
|
prefix
|
from-prefix | True | string |
예: 지원 접두사는 support@fromdomain.com |
|
도메인
|
from-domain | True | string |
주소 도메인에서 |
|
이름
|
name | True | string |
보낸 사람의 사용자 이름 |
|
address
|
address | True | string |
받는 사람의 전자 메일 주소입니다. |
|
이름
|
name | string |
받는 사람의 이름입니다. |
|
|
address
|
address | True | string |
받는 사람의 전자 메일 주소입니다. |
|
이름
|
name | string |
받는 사람의 이름입니다. |
|
|
address
|
address | True | string |
받는 사람의 전자 메일 주소입니다. |
|
이름
|
name | string |
받는 사람의 이름입니다. |
|
|
메일 유형
|
mailtype | string |
보낼 메일의 형식 |
|
|
주제
|
subject | True | string |
전자 메일의 제목 줄 |
|
몸
|
htmlbody | string |
전자 메일의 본문 콘텐츠입니다. |
|
|
address
|
address | string |
메일 에이전트에서 확인된 도메인을 포함하는 유효한 전자 메일 주소입니다. |
|
|
이름
|
name | string |
회신의 이름입니다. |
|
|
기본 64 콘텐츠
|
content | string |
파일의 Base64로 인코딩된 값입니다. |
|
|
콘텐츠 형식
|
mime_type | string |
첨부 파일의 콘텐츠 형식을 나타냅니다. |
|
|
파일 이름
|
name | string |
첨부 파일의 파일 이름입니다. |
반환
모든 메일 에이전트 가져오기
이 엔드포인트는 계정의 모든 메일 에이전트에 대한 세부 정보를 가져옵니다. 메일 에이전트 이름, 메일 에이전트 키, 만든 시간, 상태를 포함한 데이터를 반환합니다. \n\n데이터 필드 설명:\n- mailagent_name: 메일 에이전트의 이름입니다.\n- mailagent_key: 메일 에이전트 키입니다.\n- mailagent_alias: 메일 에이전트 별칭.\n- created_time: 메일 에이전트가 만들어진 시간입니다.\n- 상태: 메일 에이전트의 상태입니다.\n\n예제 1: ZeptoMail 계정에서 모든 메일 에이전트의 세부 정보를 검색합니다. 샘플 프롬프트 1: 계정의 모든 메일 에이전트에 대한 세부 정보를 가져옵니다.
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
데이터
|
data | array of object |
데이터 |
|
메일 에이전트 이름
|
data.mailagent_name | string |
메일 에이전트의 이름 |
|
생성 시간
|
data.created_time | string |
메일 에이전트가 만들어진 시간 |
|
도메인
|
data.domain | string |
메일 에이전트에 연결된 도메인 |
|
도메인 확인 상태
|
data.domain-verification-status | string |
연결된 메일 에이전트의 확인 상태 |
|
Description
|
data.description | string |
메일 에이전트 설명 |
|
메일 에이전트 키
|
data.mailagent_key | string |
메일 에이전트의 키 |
|
상태
|
data.status | string |
메일 에이전트의 상태 |
|
message
|
message | string |
message |
서식 파일 메일 보내기
템플릿을 사용하여 단일 전자 메일 보내기
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
메일 에이전트
|
mailagent_key | True | string |
메일 에이전트를 선택하거나 메일 에이전트 키를 입력합니다. |
|
메일 서식 파일
|
mail_template_key | True | string |
메일 서식 파일 선택 |
|
prefix
|
from-prefix | True | string |
예: 지원 접두사는 support@fromdomain.com |
|
도메인
|
from-domain | True | string |
주소 도메인에서 |
|
이름
|
name | True | string |
보낸 사람의 사용자 이름 |
|
address
|
address | True | string |
받는 사람의 전자 메일 주소입니다. |
|
이름
|
name | string |
받는 사람의 이름입니다. |
|
|
address
|
address | True | string |
받는 사람의 전자 메일 주소입니다. |
|
이름
|
name | string |
받는 사람의 이름입니다. |
|
|
address
|
address | True | string |
받는 사람의 전자 메일 주소입니다. |
|
이름
|
name | string |
받는 사람의 이름입니다. |
|
|
tag
|
key | string |
보낼 메일의 병합 태그입니다. |
|
|
value
|
value | string |
이러한 태그는 해당 태그에 대해 이 매개 변수에 제공된 값으로 바뀝니다. |
|
|
address
|
address | string |
메일 에이전트에서 확인된 도메인을 포함하는 유효한 전자 메일 주소입니다. |
|
|
이름
|
name | string |
회신의 이름입니다. |
반환
처리된 전자 메일 분석
이 엔드포인트는 메일 에이전트 이름으로 식별된 메일 에이전트에서 보낸 전자 메일에 대한 전자 메일 분석을 가져옵니다. 기간 및 매일의 총 하드본스, 소프트본스 및 보낸 통계 수를 포함한 데이터를 반환합니다. mailagent 매개 변수는 시스템에 나열된 메일 에이전트 이름과 일치해야 합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
메일 에이전트 이름
|
mailagent | True | string |
메일 에이전트 이름 선택 또는 입력 |
|
날짜부터
|
from_time | string |
날짜부터 정적을 yyyy-MM-ddTHH:mm:sszzz 형식으로 입력합니다. |
|
|
현재까지
|
to_time | string |
yyyy-MM-ddTHH:mm:sszzz 형식으로 현재까지 정적 입력 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
애널리틱스
|
hb.stats | array of object |
하드바운스 분석 |
|
날짜
|
hb.stats.date | string |
하드바운스 날짜 |
|
날짜별 개수
|
hb.stats.count | integer |
매일 하드바운스 수 |
|
총 개수
|
hb.count | integer |
총 하드바운스 수 |
|
애널리틱스
|
sb.stats | array of object |
통계 |
|
날짜
|
sb.stats.date | string |
softbounce 날짜 |
|
날짜별 개수
|
sb.stats.count | integer |
매일의 소프트바운스 수 |
|
softbounces의 총 수
|
sb.count | integer |
count |
|
애널리틱스
|
sent.stats | array of object |
보낸 전자 메일 분석 |
|
날짜
|
sent.stats.date | string |
보낸 전자 메일의 날짜 |
|
날짜별 개수
|
sent.stats.count | integer |
매일 보낸 전자 메일 수 |
|
보낸 전자 메일의 총 수
|
sent.count | integer |
count |
처리된 전자 메일 세부 정보 가져오기
이 엔드포인트는 고유한 ID로 식별된 메일 에이전트에서 처리하는 전자 메일에 대한 자세한 정보를 가져옵니다. 제목, 보낸 사람 주소, 보낸 시간 및 시간 범위에 대해 전송된 전자 메일에 대한 요청 ID를 포함한 데이터를 반환합니다. mailagent_key 매개 변수는 시스템에 나열된 메일 에이전트의 메일 에이전트 키와 일치해야 합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
메일 에이전트 키
|
mailagent_key | True | string |
메일 에이전트를 선택하거나 메일 에이전트 키를 입력합니다. |
|
주제
|
subject | string |
전자 메일 제목 입력 |
|
|
부터
|
from | string |
전자 메일의 보낸 사람 주소 입력 |
|
|
에게
|
to | string |
전자 메일의 받는 사람 주소 입력 |
|
|
날짜:
|
date_from | string |
yyyy-MM-ddTHH:mm:sszzz 형식으로 검색 날짜부터 입력 |
|
|
날짜-날짜
|
date_to | string |
yyyy-MM-ddTHH:mm:sszzz 형식으로 검색 날짜를 입력합니다. |
|
|
요청 ID
|
request_id | string |
전자 메일의 요청 ID 입력 |
|
|
하드바운스 표시
|
is_hb | boolean |
결과에 하드바운스 포함 |
|
|
softbounces 표시
|
is_sb | boolean |
결과에 softbounces 포함 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
details
|
data.details | array of object |
처리된 전자 메일 목록 |
|
SMTP인 경우
|
data.details.email_info.is_smtp_trigger | boolean |
메일이 SMTP에 의해 트리거되는 경우 |
|
주제
|
data.details.email_info.subject | string |
메일의 제목 |
|
반송 주소
|
data.details.email_info.bounce_address | string |
전자 메일의 반송 주소 |
|
Mailagent 키
|
data.details.email_info.mailagent_key | string |
전자 메일의 메일 에이전트 키 |
|
프로세스 상태
|
data.details.email_info.process_state | string |
전자 메일의 처리된 상태 |
|
Address
|
data.details.email_info.from.address | string |
보낸 사람 세부 정보의 전자 메일 주소 |
|
이름
|
data.details.email_info.from.name | string |
보낸 사람의 이름 |
|
에게
|
data.details.email_info.to | array of object |
받는 사람 전자 메일 |
|
Address
|
data.details.email_info.to.email_address.address | string |
받는 사람의 전자 메일 주소 |
|
이름
|
data.details.email_info.to.email_address.name | string |
받는 사람의 이름 |
|
보낸 시간
|
data.details.email_info.processed_time | string |
메일의 처리된 시간 |
|
배달 상태
|
data.details.email_info.status | string |
처리된 메일의 상태 |
|
요청 ID
|
data.details.request_id | string |
요청의 고유 참조 ID |
|
message
|
message | string |
message |
정의
SuccessMessage
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
데이터
|
data | array of object |
데이터 |
|
코드
|
data.code | string |
성공 응답에 해당하는 코드입니다. |
|
추가 정보
|
data.additional_info | array of |
요청에서 수행된 작업에 대한 추가 정보를 제공합니다. |
|
자세한 메시지
|
data.message | string |
이 요청에 대해 수행된 작업입니다. |
|
상태 메시지
|
message | string |
요청의 상태입니다. |
|
요청 ID
|
request_id | string |
요청의 고유 참조 ID입니다. |