Mailgun(미리 보기)

Mailgun은 전자 메일을 보내고, 받고, 추적하고, 저장할 수 있는 강력한 API를 제공합니다. 이 커넥터를 사용하여 코드를 작성하지 않고 전자 메일 배달 및 통신 워크플로를 자동화할 수 있습니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 Class 지역
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)
파워 오토메이트 Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
연락처
이름 지원 채널
URL https://help.mailgun.com/hc/en-us
전자 메일 support@mailgun.com
커넥터 메타데이터
게시자 신치 스웨덴 AB
웹 사이트 https://www.mailgun.com
개인 정보 보호 정책 https://www.mailgun.com/legal/privacy-policy/
카테고리 마케팅; 판매 및 CRM

커넥터 이름

Mailgun

커넥터 요약

Mailgun 커넥터를 사용하면 Power Automate 사용자가 메일을 보내고, Mailgun 도메인 정보를 검색하고, 개별 전자 메일 주소의 유효성을 검사하고, 대량 전자 메일 유효성 검사 작업을 제출하고, Mailgun 계정을 사용하여 대량 유효성 검사 결과를 검색할 수 있습니다.

연락처

연락처 URL: https://help.mailgun.com/hc/en-us

지원/연락처 전자 메일: support@mailgun.com

등록 URL: https://signup.mailgun.com/

요구 사항

  • Mailgun 계정입니다. 없는 경우 .에 https://signup.mailgun.com/등록합니다.
  • Mailgun API 키 또는 도메인 전송 키입니다.
  • 계정에 대한 올바른 Mailgun API 지역(미국 또는 EU)입니다.
  • 전자 메일 보내기의 경우 Mailgun 송신 도메인입니다. 프로덕션 전송에는 확인된 도메인이 필요합니다.
  • 유효성 검사 작업의 경우 Mailgun 유효성 검사에 액세스합니다.

샌드박스 도메인은 초기 테스트에 사용할 수 있지만 권한 있는 받는 사람으로 제한됩니다.

자격 증명을 가져오는 방법

이 커넥터는 Mailgun API 키 인증을 사용합니다. Mailgun 제어판 로그인하고 API 보안에서 API 키를 만들거나 보내는 도메인 설정에서 도메인별 송신 API 키를 만듭니다.

커넥터는 사용자 이름으로 기본 인증 api 을 사용하고 Mailgun API 키를 암호로 사용합니다. 연결 설정 중에 계정과 일치하는 Mailgun API 지역을 선택합니다.

지원되는 작업

이 커넥터는 다음 작업을 지원합니다.

  • Send Email: Mailgun 보내기 도메인을 사용하여 전자 메일을 보냅니다.
  • Get Domain Information: Mailgun 도메인 정보를 검색합니다.
  • Validate Email Address: 개별 전자 메일 주소의 유효성을 검사합니다.
  • Submit Bulk Validation Job: 대량 전자 메일 유효성 검사 작업을 제출합니다.
  • Get Bulk Validation Results: 대량 전자 메일 유효성 검사 결과를 검색합니다.

연결을 만드는 중

커넥터는 다음과 같은 인증 유형을 지원합니다.
기본값 연결을 만들기 위한 매개 변수입니다. 모든 지역 공유 불가

기본값

적용 가능 지역: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유할 수 없는 연결입니다. Power App이 다른 사용자와 공유되는 경우, 다른 사용자에게는 명시적으로 새로운 연결을 생성하라는 메시지가 표시됩니다.

이름 유형 묘사 필수
API 키 시큐어스트링 (보안 문자열) Mailgun 프라이빗 API 키 True
Mailgun 지역 문자열 Mailgun US 또는 Mailgun EU 선택 True

actions

대량 유효성 검사 결과 가져오기

이전에 제출된 작업에 대한 대량 유효성 검사 작업 상태 및 요약 결과를 검색합니다.
대량 전자 메일 유효성 검사

메일 헤더 열이 있는 CSV를 업로드하고 Mailgun의 V4 API를 사용하여 대량 유효성 검사 작업을 시작합니다.
도메인 가져오기

도메인 목록을 가져옵니다. 주 또는 권한으로 필터링할 수 있습니다. 목록은 페이지가 매겨지고 페이지당 1000개 항목으로 제한됩니다.
도메인 세부 정보 가져오기

도메인의 상태 및 설정에 대한 세부 정보를 포함하는 도메인의 JSON 표현을 가져옵니다.
전자 메일 보내기

Mailgun의 메시지 API와 호환되는 다중 파트 양식 필드를 통해 Mailgun 계정을 사용하여 전자 메일을 보냅니다.
전자 메일 유효성 검사

Mailgun의 유효성 검사 서비스를 사용하여 전자 메일 주소의 유효성을 검사하고 배달 가능성 결과를 반환합니다.

대량 유효성 검사 결과 가져오기

작업 ID:
Get_Bulk_Validation_Results

이전에 제출된 작업에 대한 대량 유효성 검사 작업 상태 및 요약 결과를 검색합니다.

매개 변수

속성 키 필수 형식 Description
직무 ID
 list_id True string

대량 유효성 검사 요청에서 반환된 작업 식별자입니다.

반품

속성 경로 형식 Description
직무 ID
 id string

작업 식별자
직무 ID
 list_id string

작업 목록 이름
작업 상태
 status string

현재 작업 상태
생성 일시
 created_at integer

작업이 만들어진 경우(Unix 타임스탬프)
CSV 다운로드 URL
 download_url.csv string

모든 결과를 CSV 파일로 다운로드하는 URL
큐레이팅된 CSV 다운로드 URL
 download_url.curated_csv string

큐레이팅된 결과를 CSV 파일로 다운로드하는 URL
JSON 다운로드 URL
 download_url.json string

모든 결과를 JSON 파일로 다운로드하는 URL
큐레이팅된 JSON 다운로드 URL
 download_url.curated_json string

큐레이팅된 결과를 JSON 파일로 다운로드하는 URL
총 수량
 quantity integer

작업의 총 레코드 수
처리된 레코드
 records_processed integer

지금까지 처리된 레코드 수
결과물 수
 summary.result.deliverable integer

결과물 주소 수
배달할 수 없는 개수
 summary.result.undeliverable integer

배달할 수 없는 주소 수
모든 개수 catch
 summary.result.catch_all integer

catch-all 주소 수
송신 안 함 수
 summary.result.do_not_send integer

보내지 않음으로 플래그가 지정된 주소 수
모든 개수 적용
 summary.result.accept_all integer

모든 허용 주소 수
알 수 없는 개수
 summary.result.unknown integer

알 수 없는 배달 가능성이 있는 주소 수
높은 위험 수
 summary.risk.high integer

위험 수준이 높은 주소 수
중간 위험 수
 summary.risk.medium integer

중간 위험 주소 수
낮은 위험 수
 summary.risk.low integer

위험 수준이 낮은 주소 수
알 수 없는 위험 수
 summary.risk.unknown integer

알 수 없는 위험이 있는 주소 수
참여도가 높은 수
 summary.engagement.highly_engaged integer

참여도가 높은 주소 수
참여 횟수
 summary.engagement.engaged integer

참여 주소 수
분리된 개수
 summary.engagement.disengaged integer

해제된 주소 수
봇 수
 summary.engagement.bot integer

봇 주소 수
불만 제기자 수
 summary.engagement.complainer integer

불만 제기자 주소 수
데이터 수 없음
 summary.engagement.no_data integer

계약 데이터가 없는 주소 수

대량 전자 메일 유효성 검사

작업 ID:
Bulk_Validate_Email

메일 헤더 열이 있는 CSV를 업로드하고 Mailgun의 V4 API를 사용하여 대량 유효성 검사 작업을 시작합니다.

매개 변수

속성 키 필수 형식 Description
작업 목록 이름
 list_id True string

대량 유효성 검사 작업을 식별하는 경로 매개 변수입니다.
CSV 파일
 file True file

업로드할 CSV 파일입니다. 파일에는 이메일이라는 헤더가 포함되어야 합니다.

반품

속성 경로 형식 Description
작업 ID(목록 이름)
 id string

작업 식별자(목록 이름)
서버 메시지
 message string

Mailgun의 상태 메시지

도메인 가져오기

작업 ID:
Get_Domains

도메인 목록을 가져옵니다. 주 또는 권한으로 필터링할 수 있습니다. 목록은 페이지가 매겨지고 페이지당 1000개 항목으로 제한됩니다.

매개 변수

속성 키 필수 형식 Description
Limit
 limit integer

최대 항목 수입니다. 최대: 1000. 기본값: 100
건너뛰기
 skip integer

nth 요소에서 시작하는 항목 목록을 가져옵니다. 기본값: 0
주
 state string

특정 상태의 도메인만 가져옵니다. 활성, 확인되지 않은 또는 사용하지 않도록 설정할 수 있습니다.
정렬
 sort string

유효한 정렬 옵션은 이름(asc), name:asc 또는 name:desc입니다.
권위
 authority string

특정 권한이 있는 도메인만 가져옵니다.
Search
 search string

지정된 부분 또는 전체 이름으로 도메인을 검색합니다. 와일드카드를 지원하지 않습니다.
하위 계정 포함
 include_subaccounts boolean

이 계정의 하위 계정에 속하는 모든 도메인을 검색합니다. 기본값: false입니다.

반품

속성 경로 형식 Description
total_count
 total_count integer

총 도메인 수
items
 items array of object

도메인 목록
id
 items.id string

도메인의 고유 식별자
이름
 items.name string

Mailgun에 등록된 정규화된 도메인 이름
state
 items.state string

도메인의 현재 확인 상태
형
 items.type string

도메인의 분류입니다. 가능한 값은 사용자 지정 또는 샌드박스입니다.
생성_시간
 items.created_at string

도메인이 RFC1123 형식으로 만들어진 시기를 나타내는 타임스탬프
is_disabled
 items.is_disabled boolean

도메인이 현재 비활성화되어 있는지 여부를 나타냅니다.
require_tls
 items.require_tls boolean

True Mailgun이 TLS 연결을 통해서만 메시지를 보내는 경우
skip_verification
 items.skip_verification boolean

TLS 연결을 설정할 때 true Mailgun이 인증서 및 호스트 이름을 확인하지 않는 경우
smtp_login
 items.smtp_login string

도메인에 대한 SMTP 로그인 사용자 이름
smtp_password
 items.smtp_password string

SMTP 인증에 사용되는 도메인에 대한 선택적 SMTP 암호
spam_action
 items.spam_action string

메시지가 스팸으로 플래그가 지정될 때 수행할 작업입니다. 옵션을 사용하지 않도록 설정, 태그 또는 차단
와일드카드
 items.wildcard boolean

도메인이 와일드카드 도메인이고 하위 도메인에 대한 전자 메일을 받을 수 있는지를 나타냅니다.
subaccount_id
 items.subaccount_id string

도메인이 속한 하위 계정 ID
tracking_host
 items.tracking_host string

추적에 사용되는 도메인에 대한 사용자 지정 추적 호스트가 열리고 클릭합니다.
use_automatic_sender_security
 items.use_automatic_sender_security boolean

True Mailgun이 DKIM 키 생성 및 DNS 레코드 구성을 자동으로 관리하는 경우
web_prefix
 items.web_prefix string

열기 및 클릭 추적에 사용되는 하위 도메인 접두사
web_scheme
 items.web_scheme string

추적에 사용되는 프로토콜 체계
archive_to
 items.archive_to string

배달된 각 메시지의 복사본을 게시할 URL
encrypt_incoming_message
 items.encrypt_incoming_message boolean

이 도메인에 들어오는 true 메시지가 암호화되는 경우
message_ttl
 items.message_ttl integer

들어오는 메시지와 나가는 메시지를 모두 검색하기 위한 TTL(Time to Live)을 초 단위로 지정합니다.

도메인 세부 정보 가져오기

작업 ID:
Get_Domain

도메인의 상태 및 설정에 대한 세부 정보를 포함하는 도메인의 JSON 표현을 가져옵니다.

매개 변수

속성 키 필수 형식 Description
도메인 이름
 name True string

가져올 도메인의 이름

반품

속성 경로 형식 Description
id
 domain.id string

도메인의 고유 식별자
이름
 domain.name string

Mailgun에 등록된 정규화된 도메인 이름
state
 domain.state string

도메인의 현재 확인 상태
형
 domain.type string

도메인의 분류입니다. 가능한 값은 사용자 지정 또는 샌드박스입니다.
생성_시간
 domain.created_at string

도메인이 RFC1123 형식으로 만들어진 시기를 나타내는 타임스탬프
is_disabled
 domain.is_disabled boolean

도메인이 현재 비활성화되어 있는지 여부를 나타냅니다.
require_tls
 domain.require_tls boolean

True Mailgun이 TLS 연결을 통해서만 메시지를 보내는 경우
skip_verification
 domain.skip_verification boolean

TLS 연결을 설정할 때 true Mailgun이 인증서 및 호스트 이름을 확인하지 않는 경우
smtp_login
 domain.smtp_login string

도메인에 대한 SMTP 로그인 사용자 이름
smtp_password
 domain.smtp_password string

SMTP 인증에 사용되는 도메인에 대한 선택적 SMTP 암호
spam_action
 domain.spam_action string

메시지가 스팸으로 플래그가 지정될 때 수행할 작업입니다. 옵션을 사용하지 않도록 설정, 태그 또는 차단
와일드카드
 domain.wildcard boolean

도메인이 와일드카드 도메인이고 하위 도메인에 대한 전자 메일을 받을 수 있는지를 나타냅니다.
subaccount_id
 domain.subaccount_id string

도메인이 속한 하위 계정 ID
tracking_host
 domain.tracking_host string

추적에 사용되는 도메인에 대한 사용자 지정 추적 호스트가 열리고 클릭합니다.
use_automatic_sender_security
 domain.use_automatic_sender_security boolean

True Mailgun이 DKIM 키 생성 및 DNS 레코드 구성을 자동으로 관리하는 경우
web_prefix
 domain.web_prefix string

열기 및 클릭 추적에 사용되는 하위 도메인 접두사
web_scheme
 domain.web_scheme string

추적에 사용되는 프로토콜 체계
archive_to
 domain.archive_to string

배달된 각 메시지의 복사본을 게시할 URL
encrypt_incoming_message
 domain.encrypt_incoming_message boolean

이 도메인에 들어오는 true 메시지가 암호화되는 경우
message_ttl
 domain.message_ttl integer

들어오는 메시지와 나가는 메시지를 모두 검색하기 위한 TTL(Time to Live)을 초 단위로 지정합니다.
receiving_dns_records
 receiving_dns_records array of object

전자 메일을 받는 데 필요한 DNS 레코드 목록
is_active
 receiving_dns_records.is_active boolean

DNS 레코드가 현재 활성 상태인지 여부를 나타냅니다.
캐시
 receiving_dns_records.cached array of string

DNS 레코드에 대해 캐시된 Mailgun 값 목록
이름
 receiving_dns_records.name string

해당하는 경우 DNS 레코드의 이름
우선권
 receiving_dns_records.priority string

MX DNS 레코드의 우선 순위 값
record_type
 receiving_dns_records.record_type string

MX, TXT 또는 CNAME과 같은 DNS 레코드 유형
유효함
 receiving_dns_records.valid string

DNS 레코드가 유효한지 여부를 나타냅니다.
value
 receiving_dns_records.value string

DNS 레코드의 예상 값
sending_dns_records
 sending_dns_records array of object

전자 메일을 보내는 데 필요한 DNS 레코드 목록
is_active
 sending_dns_records.is_active boolean

DNS 레코드가 현재 활성 상태인지 여부를 나타냅니다.
캐시
 sending_dns_records.cached array of string

DNS 레코드에 대해 캐시된 Mailgun 값 목록
이름
 sending_dns_records.name string

해당하는 경우 DNS 레코드의 이름
우선권
 sending_dns_records.priority string

MX DNS 레코드의 우선 순위 값
record_type
 sending_dns_records.record_type string

MX, TXT 또는 CNAME과 같은 DNS 레코드 유형
유효함
 sending_dns_records.valid string

DNS 레코드가 유효한지 여부를 나타냅니다.
value
 sending_dns_records.value string

DNS 레코드의 예상 값

전자 메일 보내기

작업 ID:
Send_Email

Mailgun의 메시지 API와 호환되는 다중 파트 양식 필드를 통해 Mailgun 계정을 사용하여 전자 메일을 보냅니다.

매개 변수

속성 키 필수 형식 Description
도메인 이름
 domain_name True string

전자 메일을 보낼 도메인
전자 메일 주소에서
 from True string

메시지를 보낼 전자 메일 주소입니다.
전자 메일 주소로
 to True string

받는 사람 전자 메일 주소입니다.
주제
 subject True string

전자 메일의 제목입니다.
전자 메일 본문(텍스트)
 text string

전자 메일의 일반 텍스트 본문입니다.
전자 메일 본문(HTML)
 html html

전자 메일의 HTML 본문입니다.
CC 전자 메일 주소
 cc string

탄소 복사 받는 사람 전자 메일 주소입니다.
BCC 전자 메일 주소
 bcc string

블라인드 카본 복사 받는 사람 전자 메일 주소입니다.
Reply-To 전자 메일 주소
 h:Reply-To string

회신을 배달해야 하는 위치입니다.
Attachment
 attachment file

메시지에 포함할 파일 첨부 파일입니다.
Tags
 o:tag array

Mailgun에서 전자 메일을 그룹화하고 필터링하는 하나 이상의 태그(메시지당 최대 10개).

반품

속성 경로 형식 Description
메시지 ID
 id string

큐에 대기된 메시지에 할당된 고유 식별자
상태 메시지
 message string

Mailgun에서 사람이 읽을 수 있는 상태(예: 큐에 대기됨) 감사합니다.)

전자 메일 유효성 검사

작업 ID:
Validate_Email

Mailgun의 유효성 검사 서비스를 사용하여 전자 메일 주소의 유효성을 검사하고 배달 가능성 결과를 반환합니다.

매개 변수

속성 키 필수 형식 Description
이메일 주소
 address True string

유효성을 검사할 전자 메일 주소입니다.

반품

속성 경로 형식 Description
이메일 주소
 address string

유효성이 검사된 전자 메일 주소
유효합니다.
 is_valid boolean

Mailgun이 주소를 유효한 것으로 간주하는지 여부
사서함 확인
 mailbox_verification string

사서함 확인 상태
삭제 가능한 주소입니다.
 is_disposable_address boolean

주소가 삭제 가능한 공급자의 주소인지 여부
역할 주소
 is_role_address boolean

주소가 역할 기반 주소인지 여부
유효성 검사 이유
 reason array of string

Mailgun에서 반환된 유효성 검사 이유(유효한 경우 비어 있음)
위험 수준
 risk string

Mailgun에서 할당한 위험 수준
결과
 result string

Mailgun 결과(예: 결과물 또는 배달할 수 없음)
루트 주소
 root_address string

정규화된 루트 주소
표시 이름
 parts.display_name string

주소의 이름 부분 표시
도메인
 parts.domain string

주소의 도메인 부분
로컬 파트
 parts.local_part string

주소의 로컬 부분