다음을 통해 공유


Mensagia(미리 보기)

Mensagia는 비즈니스 자동화 통신을 위한 신뢰할 수 있는 SMS, 이메일 및 음성 메시지를 제공합니다.

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

서비스 클래스 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)
연락처
이름 멘사기아 주
URL https://mensagia.com/
전자 메일 support@mensagia.com
커넥터 메타데이터
게시자 멘사기아 주
웹 사이트 https://mensagia.com/
개인 정보 보호 정책 https://mensagia.com/legal#privacidad
카테고리 Communication

Mensagia는 비즈니스 자동화 통신을 위한 신뢰할 수 있는 SMS, 이메일 및 음성 메시지를 제공합니다.

필수 조건

계속하려면 다음이 필요합니다.

  • Mensagia "API 클라이언트" 계정입니다.
  • Mensagia 계정에 충분한 잔액이 있는지 확인합니다.

자격 증명을 가져오는 방법

API 키는 Mensagia 계정의 포털을 입력하여 얻을 수 있습니다.

커넥터 시작

알려진 문제 및 제한 사항

GET 메서드는 매개 변수를 허용하지 않습니다.

일반적인 오류 및 해결

수정 오류 및 해결이 없습니다.

자주 묻는 질문(FAQ)

질문이 있는 경우 당사에 문의 해 주세요.

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.

기본값 연결을 만들기 위한 매개 변수입니다. 모든 지역 공유할 수 없음

기본값

적용 가능: 모든 지역

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

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

이름 유형 Description 필수
API 키 시큐어스트링 (보안 문자열) 이 API에 대한 API 키입니다. 진실

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초

동작

2방향 SMS 가져오기

Mensagia 계정을 통해 2 Way SMS 목록을 가져옵니다.

2방향 SMS 보내기

Mensagia 계정을 통해 연락처에 2방향 SMS를 보냅니다.

2방향 SMS의 번호 가져오기

Mensagia 계정을 통해 2 Way SMS의 번호 목록을 가져옵니다.

SMS 보내기

Mensagia 계정을 통해 연락처에 SMS를 보냅니다.

SMS 캠페인 보내기

Mensagia 계정을 통해 연락처에 SMS 캠페인을 보냅니다.

연락처 만들기

Mensagia의 계정 내에 연락처를 만듭니다.

음성 메시지 보내기

이 방법을 사용하면 스페인의 전화 번호로 음성 캠페인을 수행할 수 있습니다. 음성 캠페인의 수신자는 의제, 의제 및 전화 번호 또는 전화 번호일 수 있습니다.

트랜잭션 전자 메일 보내기

Mensagia의 사용자 지정 템플릿을 사용하여 연락처에 트랜잭션 전자 메일을 보냅니다.

2방향 SMS 가져오기

Mensagia 계정을 통해 2 Way SMS 목록을 가져옵니다.

반환

Name 경로 형식 Description
메시지 ID
id integer

메시지 ID

애플리케이션 ID
application_id string

애플리케이션 ID

구성 ID
configuration_id integer

헤더 ID 보내기

Number
number string

Number

유형
type string

SMS 유형(MO 또는 MT)

To Number
enduser_number string

수용체의 수

메시지 본문
message string

메시지 본문

만든 위치에서
created_at string

만든 위치에서

2방향 SMS 보내기

Mensagia 계정을 통해 연락처에 2방향 SMS를 보냅니다.

매개 변수

Name 필수 형식 Description
Number
number True string

메시지를 보낼 번호 2 방법 SMS

To Number
enduser_number True string

받는 사람의 번호

Message
message True string

보낼 텍스트(160자 이하)입니다.

반환

Name 경로 형식 Description
메시지 ID
id integer

메시지 ID

애플리케이션 ID
application_id string

애플리케이션 ID

구성 ID
configuration_id integer

헤더 ID 보내기

Number
number string

Number

유형
type string

SMS 유형(MO 또는 MT)

To Number
enduser_number string

수용체의 수

메시지 본문
message string

메시지 본문

만든 위치에서
created_at string

만든 위치에서

2방향 SMS의 번호 가져오기

Mensagia 계정을 통해 2 Way SMS의 번호 목록을 가져옵니다.

반환

Name 경로 형식 Description
데이터
data array of object
메시지 ID
data.id integer

메시지 ID

Number
data.number string

Number

콜백 URL
data.callback_url string

콜백 URL

만든 위치에서
data.created_at string

만든 위치에서

총계
meta.pagination.total integer

총계

수량
meta.pagination.count integer

수량

페이지당
meta.pagination.per_page integer

페이지당 결과

현재 페이지
meta.pagination.current_page integer

현재 페이지

총 페이지 수
meta.pagination.total_pages integer

총 페이지 수

links
meta.pagination.links array of string

links

SMS 보내기

Mensagia 계정을 통해 연락처에 SMS를 보냅니다.

매개 변수

Name 필수 형식 Description
구성 이름
configuration_name True string

SMS의 헤더에 표시할 이름을 선택합니다.

Message
message True string

보낼 텍스트(160자 이하)입니다.

숫자
numbers True string

이 메시지를 받는 사람의 휴대폰 번호입니다. 중요: 번호에는 해당 국가 접두사여야 합니다.

시작 날짜
start_date string

'YYYY-MM-DD hh:mm' 형식으로 날짜를 보냅니다. 이 매개 변수를 지정하지 않으면 메시지가 즉시 전송됩니다.

URL Paremeters
url_parameters string

메시지에 짧은 링크, 방문 또는 양식이 있는 경우 링크 태그 지정

URL 엑스트라필드 모드
url_extrafields_mode string

배송에 단축된 링크 또는 방문이 포함된 경우 받는 사람이 콘텐츠를 볼 때 사용자 지정 필드에 표시할 값을 선택할 수 있습니다.

반환

Name 경로 형식 Description
구성 ID
data.configuration_id integer

헤더 ID 보내기

메시지 ID
data.id integer

메시지 ID

메시지 이름
data.name string

메시지의 이름

메시지 본문
data.message string

메시지 본문

가격
data.price float

메시지의 가격

팩 가격
data.price_with_packs float

팩 가격

보낸 사람 헤더
data.push_sender_name string

보낸 사람 이름 푸시

경로 이름
data.route_name string

경로 이름

보낸 메시지
data.total_messages_sent integer

전송된 총 메시지 수

보낸 메시지 팩
data.total_messages_sent_with_packs integer

팩과 함께 전송된 총 메시지

dlrs
data.dlrs array of object

dlrs

메시지 ID
data.dlrs.message_id string

메시지 ID

To Number
data.dlrs.number string

수용체의 수

보낸 메시지
data.dlrs.messages_sent integer

총 메시지 수

SMS 블랙리스트에 있습니다.
data.dlrs.in_SMS_blacklist boolean

연락처가 SMS 블랙리스트에 있는지 확인합니다.

콜백 URL
data.callback_url string

콜백 URL

시작 날짜
data.start_date string

시작 날짜

SMS 캠페인 보내기

Mensagia 계정을 통해 연락처에 SMS 캠페인을 보냅니다.

매개 변수

Name 필수 형식 Description
구성 이름
configuration_name True string

SMS의 헤더에 표시할 이름을 선택합니다.

Message
message True string

보낼 텍스트(160자 이하)입니다.

캠페인 이름
name string

캠페인 이름

사용 가능한 그룹
available_groups True string

캠페인을 안내할 그룹을 할당합니다.

시작 날짜
start_date date-time

'YYYY-MM-DD hh:mm' 형식으로 날짜를 보냅니다. 이 매개 변수를 지정하지 않으면 메시지가 즉시 전송됩니다.

블록당 호출
smsxblock integer

블록당 받는 사람 수입니다. '블록당 분'이 있는 경우 필수입니다. 두 매개 변수를 보내면 캠페인 구성이 '사용자 지정 구성'으로 정의되고 매개 변수 '일' 및 '시간 간격'의 값이 고려됩니다.

블록당 분
minutesxblock integer

몇 분마다 '블록당 통화'에서 선택한 받는 사람 블록이 전송됩니다. '블록당 호출'이 있는 경우 필수입니다. 두 매개 변수를 보내면 캠페인 구성이 '사용자 지정 구성'으로 정의되고 매개 변수 '일' 및 '시간 간격'의 값이 고려됩니다.

일 단위
days string

요일 목록은 쉼표로 구분되고 호출할 수 있는 공백이 없는 목록입니다. (1,2,3,4,5,6,7)

시간 간격
time_intervals string

호출을 보낼 수 있는 쉼표와 공백 없이 구분된 시간 간격 목록입니다. '블록당 분' 및 '블록당 호출'이 전송되는 경우에만 고려됩니다.(hh:mm-hh:mm,hh:mm-hh:mm...)

URL Paremeters
url_parameters string

메시지에 짧은 링크, 방문 또는 양식이 있는 경우 링크 태그 지정

URL 엑스트라필드 모드
url_extrafields_mode string

배송에 단축된 링크 또는 방문이 포함된 경우 받는 사람이 콘텐츠를 볼 때 사용자 지정 필드에 표시할 값을 선택할 수 있습니다.

반환

Name 경로 형식 Description
구성 ID
data.configuration_id integer

헤더 ID 보내기

메시지 ID
data.id integer

메시지 ID

메시지 이름
data.name string

메시지의 이름

메시지 본문
data.message string

메시지 본문

가격
data.price float

메시지의 가격

팩 가격
data.price_with_packs float

팩 가격

보낸 사람 헤더
data.push_sender_name string

보낸 사람 이름 푸시

경로 이름
data.route_name string

경로 이름

보낸 메시지
data.total_messages_sent integer

전송된 총 메시지 수

보낸 메시지 팩
data.total_messages_sent_with_packs integer

팩과 함께 전송된 총 메시지

dlrs
data.dlrs array of object

dlrs

메시지 ID
data.dlrs.message_id string

메시지 ID

To Number
data.dlrs.number string

수용체의 수

보낸 메시지
data.dlrs.messages_sent integer

총 메시지 수

SMS 블랙리스트에 있습니다.
data.dlrs.in_SMS_blacklist boolean

연락처가 SMS 블랙리스트에 있는지 확인합니다.

콜백 URL
data.callback_url string

콜백 URL

시작 날짜
data.start_date string

시작 날짜

연락처 만들기

Mensagia의 계정 내에 연락처를 만듭니다.

매개 변수

Name 필수 형식 Description
메일 블랙리스트에 있음
in_mail_blacklist boolean

연락처가 전자 메일 차단 목록에 있는지 지정합니다.

SMS 블랙리스트에 있습니다.
in_sms_blacklist boolean

연락처가 in_voice_blacklist 있는지 지정합니다.

음성 블랙리스트에 있습니다.
in_voice_blacklist boolean

대화 상대가 음성 블랙리스트에 있는지 지정합니다.

Number
number True string

공백이 없고 국가별 접두사 및 + 기호가 없는 연락처의 휴대폰 번호입니다.

이름
name string

Mensagia 내 연락처의 이름입니다.

전자 메일
email True string

Mensagia 내에서 전자 메일로 문의하세요.

도시
city string

연락처의 위치입니다.

Language
language string

ISO 코드의 연락처 언어입니다.

의제
groups string

주소록에 연락처 추가

반환

Name 경로 형식 Description
접촉 ID
data.id integer

Mensagia의 연락처 ID

연락처 번호
data.number string

연락처 번호

Push 연산자
data.push_operator_destination_id string

연락처의 푸시 운영자 대상

담당자 이름
data.name string

연락처 이름

전자 메일에 문의
data.email string

연락처의 전자 메일

연락처 위치
data.city string

연락처의 위치

연락처 언어
data.language string

연락처의 언어

국가 문의
data.country_id integer

연락처의 국가 ID

국가 이름
data.country_name string

연락처의 국가 이름

SMS 블랙리스트에 있습니다.
data.in_sms_blacklist boolean

연락처가 SMS 블랙리스트에 있는지 확인합니다.

음성 블랙리스트에 있습니다.
data.in_voice_blacklist boolean

대화 상대가 음성 블랙리스트에 있는지 확인합니다.

전자 메일 블랙리스트에 있습니다.
data.in_mail_blacklist boolean

연락처가 전자 메일 차단 목록에 있는지 확인합니다.

만든 위치에서
data.created_at string

에서 만든 연락처

업데이트 날짜
data.updated_at string

연락처 업데이트 날짜

데이터
data.groups.data array of object

데이터

그룹 아이디
data.groups.data.id integer

그룹 아이디

그룹 이름
data.groups.data.name string

그룹 이름

총 그룹의 사용자
data.groups.data.total_users integer

총 그룹의 사용자

그룹이 사용 중입니다.
data.groups.data.busy integer

그룹이 사용 중입니다.

에서 만든 그룹
data.groups.data.created_at string

에서 만든 그룹

그룹 업데이트 날짜
data.groups.data.updated_at string

그룹 업데이트 날짜

음성 메시지 보내기

이 방법을 사용하면 스페인의 전화 번호로 음성 캠페인을 수행할 수 있습니다. 음성 캠페인의 수신자는 의제, 의제 및 전화 번호 또는 전화 번호일 수 있습니다.

매개 변수

Name 필수 형식 Description
이름
name True string

새 음성 캠페인의 이름입니다.

유효성이 검사된 전화
vm_validated_phone_id True integer

이 음성 캠페인에 사용할 휴대폰입니다.

Locution 형식
type True string

이 음성 캠페인에 사용할 음성 변환 유형입니다.

Message
message string

호출에서 재현할 합성할 텍스트입니다. text2speech가 선택한 음성 유형인 경우 필수 필드입니다.

메시지 언어
message_language string

호출에서 재현될 텍스트를 합성할 언어의 코드입니다. text2speech가 선택한 음성 유형인 경우 필수 필드입니다.

음성 파일
voice_file_id string

음성 변환으로 사용할 오디오 라이브러리 파일입니다. 파일이 선택한 음성 형식인 경우 필수 필드입니다.

숫자
numbers string

공백이 없고 국제 접두사를 사용하여 쉼표로 구분된 전화 번호 목록입니다.

사용 가능한 그룹
available_groups string

캠페인을 보낼 연락처 목록입니다.

통화 시간 제한
vm_timeout integer

최대 호출 기간(분)입니다.

최대 재시도
max_retries integer

통화 수신자가 응답하지 않는 경우 수행할 재시도 횟수입니다.

재시도 시간(분) 1
minutes_retry_1 integer

첫 번째 호출이 응답되지 않은 후 첫 번째 재시도가 수행되는 간격(분)입니다. "최대 재시도"가 1보다 큰 경우 이 필드는 필수입니다.

재시도 시간(분) 2
minutes_retry_2 integer

첫 번째 호출이 응답되지 않은 후 첫 번째 재시도가 수행되는 간격(분)입니다. "최대 재시도"가 2보다 큰 경우 이 필드는 필수입니다.

재시도 시간(분) 3
minutes_retry_3 integer

첫 번째 호출이 응답되지 않은 후 첫 번째 재시도가 수행되는 간격(분)입니다. "최대 재시도"가 3보다 큰 경우 이 필드는 필수입니다.

재시도 시간(분) 4
minutes_retry_4 integer

첫 번째 호출이 응답되지 않은 후 첫 번째 재시도가 수행되는 간격(분)입니다. "최대 재시도"가 4보다 큰 경우 이 필드는 필수입니다.

링 시간 제한
ring_timeout integer

수신자의 휴대폰이 전화를 받을 수 있는 시간(초)입니다.

응답 코드
response_codes string

(JSON) 호출에 대한 작업을 생성할 받는 사람이 누를 수 있는 응답 코드입니다.

응답 코드 시간 제한
response_codes_timeout integer

받는 사람이 회신 코드를 누를 수 있는 시간(초)입니다. 이 필드는 '응답 코드'가 있는 경우 필수입니다.

시작 날짜
start_date string

캠페인 시작 날짜는 'YYYY-MM-DD hh:mm' 형식입니다. 이 매개 변수를 보내지 않으면 새 캠페인을 만든 후 2분 후에 캠페인이 시작됩니다.

블록당 호출
callsxblock integer

블록당 받는 사람 수입니다. '블록당 분'이 있는 경우 필수입니다. 두 매개 변수를 보내면 캠페인 구성이 '사용자 지정 구성'으로 정의되고 매개 변수 '일' 및 '시간 간격'의 값이 고려됩니다.

블록당 분
minutesxblock integer

몇 분마다 '블록당 통화'에서 선택한 받는 사람 블록이 전송됩니다. '블록당 호출'이 있는 경우 필수입니다. 두 매개 변수를 보내면 캠페인 구성이 '사용자 지정 구성'으로 정의되고 매개 변수 '일' 및 '시간 간격'의 값이 고려됩니다.

일 단위
days integer

요일 목록은 쉼표로 구분되고 호출할 수 있는 공백이 없는 목록입니다. (1,2,3,4,5,6,7)

시간 간격
time_intervals string

호출을 보낼 수 있는 쉼표와 공백 없이 구분된 시간 간격 목록입니다. '블록당 분' 및 '블록당 호출'이 전송되는 경우에만 고려됩니다.(hh:mm-hh:mm,hh:mm-hh:mm...)

반환

Name 경로 형식 Description
보낸 사람 이름
data.configuration_id integer

보낸 사람의 헤더 이름

음성 캠페인 ID
data.id integer

음성 캠페인 ID

음성 캠페인 이름
data.name string

음성의 캠페인 이름

캠페인 활성 상태
data.active integer

캠페인이 현재 활성 상태인지 확인

상태 ID
data.state_id integer

전송 상태 ID를 결정합니다.

상태
data.state_name string

상태 이름

음성 메시지
data.message string

보낸 메시지의 본문

시작 날짜
data.start_date string

보내는 예약된 날짜

유효성이 검사된 전화 ID
data.vm_validated_phone_id integer

캠페인을 보내기 위한 유효성이 검사된 전화 ID

유효성이 검사된 전화 번호
data.vm_validated_phone_number string

유효성이 검사된 전화 번호

의제
data.groups array of object

캠페인이 지시되는 의제입니다.

안건 ID
data.groups.id integer

그룹 아이디

안건 이름
data.groups.name string

안건 이름

숫자
data.numbers string

캠페인이 전달되는 숫자입니다.

일시 중지
data.vm_timeout integer

통화 시간 제한

최대 재시도
data.max_retries integer

최대 호출 재시도 횟수

최소 재시도 시간(분)
data.min_retry_minutes integer

다음 시도까지 대기하는 최소 분 간격입니다.

최대 재시도 시간(분)
data.max_retry_minutes integer

다음 시도까지 대기하는 최대 분 간격입니다.

응답 코드
data.response_codes array of object

호출에 할당된 응답 코드입니다.

코드
data.response_codes.code string

코드 이름

조치
data.response_codes.action string

코드의 작업

다음으로 전송
data.response_codes.transfer_to string

필요한 경우 호출을 리디렉션할 번호를 지정합니다.

유효성이 검사된 전화 ID
data.response_codes.vm_validated_phone_id string

유효성이 검사된 전화 ID

응답 코드 시간 제한
data.response_codes_timeout string

응답 코드 시간 제한

콜백 URL
data.callback_url string

콜백 URL

유형
data.type string

통화 유형

블록당 호출
data.callsxblock integer

블록당 호출

블록당 분
data.minutesxblock integer

블록당 분

허용되는 일 수
data.days_allowed array of string

음성 캠페인을 보낼 수 있는 날짜

허용되는 시간 간격
data.time_intervals_allowed array of string

음성 캠페인을 보낼 수 있는 시간 간격

음성 벨소리 시간 제한
data.ring_timeout integer

시도가 완료될 때까지 호출 링이 울리는 최대 시간입니다.

트랜잭션 전자 메일 보내기

Mensagia의 사용자 지정 템플릿을 사용하여 연락처에 트랜잭션 전자 메일을 보냅니다.

매개 변수

Name 필수 형식 Description
부터
from True string

보낸 사람 역할을 하는 전자 메일 주소입니다. 플랫폼에서 만든 송신 주소이거나 플랫폼에서 유효성이 검사되고 인증된 도메인이 있는 송신 주소여야 합니다.

발신자 이름
from_name string

이미 만들어진 이름을 사용하려는 경우 플랫폼의 송신 주소에 저장된 것과 다른 보낸 사람 이름을 사용하려는 경우 이 필드를 보냅니다.

에게
to True string

배송이 이루어지는 전자 메일 주소입니다.

주제
subject True string

보낼 제목입니다.

HTML
html string

보낼 HTML입니다. 템플릿 매개 변수 없이 필요합니다.

Template
template_id integer

Mensagia 계정에 구성된 전자 메일 템플릿을 사용하여 보내기 위한 HTML을 가져올 수 있습니다. 이 매개 변수를 보내면 HTML 매개 변수가 무시됩니다.

보낸 사람
start_date string

배송 날짜는 'YYYY-MM-DD hh:mm' 형식입니다. 이 매개 변수를 보내지 않으면 전송이 즉시 수행됩니다.

URL 매개 변수
url_parameters string

전자 메일 내용의 링크에 태그를 지정합니다.

Attachments
attachments string

첨부할 파일이 있는 쉼표로 구분된 URL 목록입니다. 파일에서 최대 5M까지 연결할 수 있습니다.

반환

Name 경로 형식 Description
앱 구성 ID
data.app_configuration_id integer

앱 구성 ID

시작 날짜
data.start_date string

시작 날짜

도메인 ID
data.domain_id integer

메일이 전송되는 등록된 도메인의 ID입니다.

보낸 사람 주소 ID
data.sender_address_id integer

보낸 사람 주소 ID

부터
data.from string

메시지의 보낸 사람입니다.

보낸 사람 이름
data.from_name string

메시지를 보내는 사람의 이름입니다.

유효한 전자 메일
data.to.valids array of string

유효한 전자 메일,

삭제된 전자 메일
data.to.discardeds array of string

삭제된 전자 메일,

블랙리스트에 추가된 전자 메일
data.to.blacklisteds array of string

블랙리스트에 오른

주제
data.subject string

전자 메일의 제목입니다.

attachments
data.attachments array of string

attachments