SmartDialog
SmartDialog는 SMS 및 WhatsApp 메시지를 보내고 받는 데 사용되는 플랫폼입니다. 다양한 스마트 메시징 서비스를 제공합니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | 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://www.arenainteractive.fi/contact |
| 전자 메일 | support@arenainteractive.fi |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | 아레나 대화형 Oy |
| 웹 사이트 | https://www.arenainteractive.fi |
| 개인 정보 보호 정책 | https://www.arenainteractive.fi/privacypolicy |
| 카테고리 | 통신; 합작 |
SmartDialog 커넥터
이 커넥터는 SmartDialog 플랫폼을 사용하여 SMS 메시지를 보내고 받는 데 사용할 수 있습니다.
필수 조건
- SmartDialog 구독 및 계정. 연락해 주세요. sales@arenainteractive.fi
- 계정에 대해 OAuth를 사용하도록 설정해야 하며 클라이언트 암호를 요청해야 합니다. 이 작업은 .에서 support@arenainteractive.fi전자 메일을 보내서 수행할 수 있습니다.
설치 프로그램
- OpenAPI 정의에서 사용자 지정 커넥터 만들기의 지침을 따르세요.
- Flow 또는 PowerApp을 만들고 사용자 지정 섹션에서 SmartDialog 작업을 추가합니다. SmartDialog 계정으로 로그인합니다.
지원되는 작업
- 새 메시지(메시지 수신 트리거)
- 메시지 보내기
- WhatsApp 메시지 보내기
- 토론 회신 메시지 보내기
- 회신 메시지 보내기
- WhatsApp에 옵트인
- WhatsApp에 옵트아웃
- WhatsApp 템플릿 만들기
- 그룹 연락처 가져오기
- 그룹 연락처 만들기
- 그룹 연락처 업데이트
- 그룹 연락처 삭제
- 모든 그룹 연락처 삭제
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
|
Whats |
WhatsApp 템플릿 메시지를 보냅니다. |
|
Whats |
보낸 사람 및 받는 사람에 대한 WhatsApp 옵트아웃. (사용되지 않음) |
|
Whats |
새 WhatsApp 템플릿을 만듭니다. |
|
Whats |
보낸 사람 및 받는 사람에 대한 WhatsApp 옵트인입니다. (사용되지 않음) |
| 그룹 연락처 가져오기 |
그룹 연락처 가져오기 |
| 그룹 연락처 만들기 |
그룹 연락처 만들기 |
| 그룹 연락처 삭제 |
전화 번호를 사용하여 그룹 연락처를 삭제합니다. |
| 그룹 연락처 업데이트 |
그룹 연락처 업데이트 |
| 메시지 보내기 |
받는 사람에게 메시지를 보냅니다. |
| 모든 그룹 연락처 삭제 |
모든 그룹 연락처 삭제 |
| 토론 회신 메시지 보내기 |
받는 사람에게 토론 회신 메시지를 보냅니다. |
| 회신 메시지 보내기 |
받는 사람에게 Replymessage를 보냅니다. |
WhatsApp 메시지 보내기
WhatsApp 템플릿 메시지를 보냅니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
고객
|
Customer-Id | True | string |
보내는 데 사용할 고객입니다. |
|
서비스
|
Service-Id | True | string |
보내는 데 사용할 서비스입니다. |
|
WhatsApp 템플릿
|
TemplateName | True | string |
전송에 사용할 템플릿입니다. |
|
Address
|
Address | True | string |
메시지 받는 사람 주소입니다. |
|
BodyParameters
|
BodyParameters | array of string |
BodyParameters |
|
|
HeaderParameters
|
HeaderParameters | array of string |
HeaderParameters |
|
|
유형
|
Type | string |
단추 유형입니다. 템플릿당 하나의 형식만 동일한 형식의 여러 형식을 포함할 수 있습니다. |
|
|
문자 메시지
|
Data | string |
단추의 텍스트입니다. |
|
|
날짜/시간 보내기
|
SendDateTime | string |
메시지를 보낼 날짜 및 시간입니다. 즉시 보내려면 비워 둡니다. |
|
|
첨부 파일 URI
|
AttachmentUri | string |
템플릿에 첨부 파일이 포함된 경우 첨부 파일 URI입니다. |
|
|
SMS 대체 사용
|
UseSmsFallback | boolean |
SMS를 대체(fallback)로 사용해야 합니다. |
|
|
Dlr Url
|
DlrUrl | string |
sendprocess가 완료될 때 콜백을 받을 배달 보고서 URL입니다. |
|
|
고객 데이터
|
CustomerData | string |
이 메시지에 대한 청구/그룹화 데이터(선택 사항)입니다. |
|
|
요청 ID
|
RequestId | string |
중복 요청을 식별하는 데 사용할 수 있는 선택적 고유 요청 ID입니다. 중복 요청 ID가 검색되면 전송이 취소됩니다. 중복된 요청 ID가 있는 요청이 높은 처리량/트래픽 상황에서 차단된다는 보장은 없습니다. 지정된 requestId는 7일 동안 "기억"됩니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
메시지 ID
|
messageId | string |
새로 만든 메시지의 식별자입니다. |
|
메시지 파트 수
|
messagePartCount | integer |
이 메시지의 대략적인 메시지 부분 수입니다. |
|
받는 사람
|
recipients | array of object |
받는 사람 |
|
받는 사람 주소
|
recipients.address | string |
받는 사람 주소(전화 번호/전자 메일/사용자 ID 등). |
|
받는 사람 ID
|
recipients.id | string |
배달 상태 정보를 받는 데 사용되는 받는 사람 식별자입니다. |
WhatsApp 옵트아웃(사용되지 않음) [사용되지 않음]
보낸 사람 및 받는 사람에 대한 WhatsApp 옵트아웃. (사용되지 않음)
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
보낸 사람 주소
|
Sender | True | string |
옵트아웃할 Whatsapp ID 번호를 등록했습니다. |
|
받는 사람 주소
|
Recipient | True | string |
옵트인에서 제거할 레시피 번호입니다. |
WhatsApp 템플릿 만들기
새 WhatsApp 템플릿을 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
고객
|
Customer-Id | True | string |
템플릿을 만들 고객입니다. |
|
IdentityNumber
|
IdentityNumber | True | string |
템플릿에 사용되는 WhatsApp IdentityNumber입니다. |
|
Displayname
|
DisplayName | True | string |
템플릿 표시 이름입니다. |
|
Content
|
RawContent | True | string |
템플릿 콘텐츠입니다. |
|
템플릿 범주
|
Category | True | string |
템플릿 범주입니다. |
|
템플릿 언어
|
Language | True | string |
템플릿 언어에 대한 2자 코드입니다. |
|
단추 유형
|
Type | string |
단추의 유형입니다. |
|
|
단추 레이블
|
Label | string |
단추 레이블입니다. |
|
|
단추 데이터
|
Data | string |
단추 데이터입니다. URL(URL), 전화 번호(통화) 또는 텍스트(QuickReply). 최대 길이는 URL의 경우 2000이고 전화 번호와 텍스트의 경우 20입니다. |
|
|
첨부 파일 URL
|
AttachmentUrl | string |
예제 첨부 파일의 URL입니다. |
WhatsApp에 옵트인(사용되지 않음) [사용되지 않음]
보낸 사람 및 받는 사람에 대한 WhatsApp 옵트인입니다. (사용되지 않음)
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
보낸 사람 주소
|
Sender | True | string |
옵트인할 Whatsapp ID 번호를 등록했습니다. |
|
받는 사람 주소
|
Recipient | True | string |
옵트인할 받는 사람 번호입니다. |
그룹 연락처 가져오기
그룹 연락처 가져오기
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
고객
|
Customer | True | string |
그룹 서비스를 가져올 고객입니다. |
|
그룹 서비스
|
Group Service | True | string |
사용할 그룹 서비스입니다. |
|
Phone
|
Phone | True | string |
연락처의 전화 번호입니다. |
|
지역
|
Region | string |
전화 번호를 구문 분석하는 데 사용할 선택적 Phonenumber 지역입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Phone
|
phone | string |
연락처의 전화 번호입니다. |
|
전자 메일
|
string |
연락처의 전자 메일 주소입니다. |
|
|
이름
|
firstName | string |
연락처의 이름입니다. |
|
성
|
lastName | string |
연락처의 성입니다. |
|
성별
|
gender | string |
연락처의 성별입니다. |
|
출생 연도
|
birthYear | integer |
연락처의 출생 연도입니다. |
|
거리 주소
|
streetAddress | string |
연락처의 주소입니다. |
|
우편번호
|
zipCode | string |
연락처의 우편 번호입니다. |
|
도시
|
city | string |
연락처의 도시입니다. |
|
국가 코드
|
countryCode | string |
연락처의 국가 코드입니다. |
|
실패한 메시지
|
failedMessages | integer |
연락처에 대해 실패한 메시지 수입니다. |
|
사용자 지정 속성
|
customContactProperties | array of object |
연락처에 대해 저장된 사용자 지정 연락처 속성 컬렉션입니다. |
|
이름
|
customContactProperties.name | string |
사용자 지정 연락처 속성 이름입니다. |
|
가치
|
customContactProperties.value | string |
사용자 지정 연락처 속성 값입니다. |
그룹 연락처 만들기
그룹 연락처 만들기
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
고객
|
Customer | True | string |
그룹 서비스를 가져올 고객입니다. |
|
그룹 서비스
|
Group Service | True | string |
사용할 그룹 서비스입니다. |
|
Active
|
active | boolean |
연락처가 활성 상태인지를 나타내는 플래그입니다. |
|
|
Phone
|
phone | True | string |
연락처의 전화 번호입니다. |
|
전자 메일
|
string |
연락처의 전자 메일 주소입니다. |
||
|
이름
|
firstName | string |
연락처의 이름입니다. |
|
|
성
|
lastName | string |
연락처의 성입니다. |
|
|
성별
|
gender | string |
연락처의 성별입니다. |
|
|
출생 연도
|
birthYear | integer |
연락처의 출생 연도입니다. |
|
|
거리 주소
|
streetAddress | string |
연락처의 주소입니다. |
|
|
우편번호
|
zipCode | string |
연락처의 우편 번호입니다. |
|
|
도시
|
city | string |
연락처의 도시입니다. |
|
|
국가 코드
|
countryCode | string |
연락처의 3자 국가 코드입니다. |
|
|
이름
|
name | string |
사용자 지정 속성 이름입니다. |
|
|
가치
|
value | string |
사용자 지정 속성 값입니다. |
|
|
Phonenumber 지역
|
phoneNumberRegions | array of string |
숫자를 구문 분석하는 데 사용할 Phonenumber 지역입니다. 기본값은 빈 상태로 두면 핀란드로 설정됩니다. |
반환
만든 연락처의 고유 ID입니다.
- 연락처 ID
- uuid
그룹 연락처 삭제
전화 번호를 사용하여 그룹 연락처를 삭제합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
고객
|
Customer | True | string |
그룹 서비스를 가져올 고객입니다. |
|
그룹 서비스
|
Group Service | True | string |
사용할 그룹 서비스입니다. |
|
Phone
|
Phone | True | string |
삭제할 연락처의 전화 번호입니다. |
반환
- response
- boolean
그룹 연락처 업데이트
그룹 연락처 업데이트
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
고객
|
Customer | True | string |
그룹 서비스를 가져올 고객입니다. |
|
그룹 서비스
|
Group Service | True | string |
사용할 그룹 서비스입니다. |
|
Phone
|
Phone | True | string |
업데이트할 연락처의 전화 번호입니다. |
|
Active
|
active | boolean |
연락처가 활성 상태인지를 나타내는 플래그입니다. |
|
|
전자 메일
|
string |
연락처의 전자 메일 주소입니다. |
||
|
이름
|
firstName | string |
연락처의 이름입니다. |
|
|
성
|
lastName | string |
연락처의 성입니다. |
|
|
성별
|
gender | string |
연락처의 성별입니다. |
|
|
출생 연도
|
birthYear | integer |
연락처의 출생 연도입니다. |
|
|
거리 주소
|
streetAddress | string |
연락처의 주소입니다. |
|
|
우편번호
|
zipCode | string |
연락처의 우편 번호입니다. |
|
|
도시
|
city | string |
연락처의 도시입니다. |
|
|
국가 코드
|
countryCode | string |
연락처의 3자 국가 코드입니다. |
|
|
이름
|
name | string |
사용자 지정 연락처 속성 이름입니다. |
|
|
가치
|
value | string |
사용자 지정 연락처 속성 값입니다. |
|
|
Phonenumber 지역
|
phoneNumberRegions | array of string |
숫자를 구문 분석하는 데 사용할 Phonenumber 지역입니다. 기본값은 빈 상태로 두면 핀란드로 설정됩니다. |
반환
- response
- boolean
메시지 보내기
받는 사람에게 메시지를 보냅니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
고객
|
Customer-Id | True | string |
보내는 데 사용할 고객입니다. |
|
서비스
|
Service-Id | True | string |
보내는 데 사용할 서비스입니다. |
|
메시지 보낸 사람
|
Sender | True | string |
메시지의 보낸 사람, 영숫자, 긴 코드 또는 짧은 코드일 수 있습니다(제한 사항 적용). |
|
메시지 콘텐츠
|
Content | True | string |
메시지의 내용입니다. |
|
메시지 프로토콜
|
Protocol | True | string |
메시지를 보내는 데 사용할 프로토콜입니다. |
|
날짜/시간 보내기
|
SendDateTime | date-time |
메시지를 보낼 날짜 및 시간입니다. 즉시 보내려면 비워 둡니다. |
|
|
Address
|
Address | True | string |
메시지 받는 사람 주소입니다. |
|
첨부 파일 URI
|
AttachmentUri | string |
첨부 파일이 포함된 WhatsApp 메시지를 보낼 때 사용할 첨부 파일 URI입니다. |
|
|
고객 데이터
|
CustomerData | string |
이 메시지에 대한 청구/그룹화 데이터(선택 사항)입니다. |
|
|
광고 메시지
|
AdMessage | boolean |
메시지를 광고 메시지로 표시하기 위한 선택적 재정의 플래그 |
|
|
Dlr Url
|
DlrUrl | string |
http-get을 통한 배달 상태 콜백에 대한 URL입니다. 쿼리 문자열 값을 URL에 추가할 수 있습니다. 이 값은 유지됩니다. |
|
|
요청 ID
|
RequestId | string |
중복 요청을 식별하는 데 사용할 수 있는 선택적 고유 요청 ID입니다. 중복 요청 ID가 검색되면 전송이 취소됩니다. 중복된 요청 ID가 있는 요청이 높은 처리량/트래픽 상황에서 차단된다는 보장은 없습니다. 지정된 requestId는 7일 동안 "기억"됩니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
메시지 ID
|
MessageId | string |
새로 만든 메시지의 식별자입니다. |
|
메시지 파트 수
|
MessagePartCount | integer |
이 메시지의 대략적인 메시지 부분 수입니다. |
|
받는 사람
|
Recipients | array of object |
받는 사람 |
|
받는 사람 주소
|
Recipients.Address | string |
받는 사람 주소(전화 번호/전자 메일/사용자 ID 등). |
|
받는 사람 ID
|
Recipients.Id | string |
배달 상태 정보를 받는 데 사용되는 받는 사람 식별자입니다. |
모든 그룹 연락처 삭제
모든 그룹 연락처 삭제
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
고객
|
Customer | True | string |
그룹 서비스를 가져올 고객입니다. |
|
그룹 서비스
|
Group Service | True | string |
사용할 그룹 서비스입니다. |
반환
- response
- boolean
토론 회신 메시지 보내기
받는 사람에게 토론 회신 메시지를 보냅니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
고객
|
CustomerId | True | string |
보내는 데 사용할 고객입니다. |
|
스레드 ID
|
ThreadId | True | string |
회신할 기존 스레드의 ID입니다. |
|
메시지 콘텐츠
|
Content | True | string |
메시지의 내용입니다. |
|
고객 데이터
|
CustomerData | string |
이 메시지에 대한 청구/그룹화 데이터(선택 사항)입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
메시지 ID
|
MessageId | string |
새로 만든 메시지의 식별자입니다. |
|
메시지 파트 수
|
MessagePartCount | integer |
이 메시지의 대략적인 메시지 부분 수입니다. |
|
받는 사람
|
Recipients | array of object |
받는 사람 |
|
받는 사람 주소
|
Recipients.Address | string |
받는 사람 주소(전화 번호/전자 메일/사용자 ID 등). |
|
받는 사람 ID
|
Recipients.Id | string |
배달 상태 정보를 받는 데 사용되는 받는 사람 식별자입니다. |
|
ThreadId
|
ThreadId | string |
메시지가 전송된 스레드의 식별자입니다. |
회신 메시지 보내기
받는 사람에게 Replymessage를 보냅니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
ParentMessage Id
|
ParentMessageId | True | string |
회신할 부모 메시지 ID입니다. |
|
고객
|
Customer-Id | True | string |
보내는 데 사용할 고객입니다. |
|
서비스
|
Service-Id | True | string |
보내는 데 사용할 서비스입니다. |
|
메시지 보낸 사람
|
Sender | True | string |
메시지의 보낸 사람, 영숫자, 긴 코드 또는 짧은 코드일 수 있습니다(제한 사항 적용). |
|
메시지 콘텐츠
|
Content | True | string |
메시지의 내용입니다. |
|
메시지 프로토콜
|
Protocol | True | string |
메시지를 보내는 데 사용할 프로토콜입니다. |
|
날짜/시간 보내기
|
SendDateTime | date-time |
메시지를 보낼 날짜 및 시간입니다. 즉시 보내려면 비워 둡니다. |
|
|
Address
|
Address | True | string |
메시지 받는 사람 주소입니다. |
|
첨부 파일 URI
|
AttachmentUri | string |
첨부 파일이 포함된 WhatsApp 메시지를 보낼 때 사용할 첨부 파일 URI입니다. |
|
|
고객 데이터
|
CustomerData | string |
이 메시지에 대한 청구/그룹화 데이터(선택 사항)입니다. |
|
|
광고 메시지
|
AdMessage | boolean |
메시지를 광고 메시지로 표시하기 위한 선택적 재정의 플래그 |
|
|
Dlr Url
|
DlrUrl | string |
http-get을 통한 배달 상태 콜백에 대한 URL입니다. 쿼리 문자열 값을 URL에 추가할 수 있습니다. 이 값은 유지됩니다. |
|
|
요청 ID
|
RequestId | string |
중복 요청을 식별하는 데 사용할 수 있는 선택적 고유 요청 ID입니다. 중복 요청 ID가 검색되면 전송이 취소됩니다. 중복된 요청 ID가 있는 요청이 높은 처리량/트래픽 상황에서 차단된다는 보장은 없습니다. 지정된 requestId는 7일 동안 "기억"됩니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
메시지 ID
|
MessageId | string |
새로 만든 메시지의 식별자입니다. |
|
메시지 파트 수
|
MessagePartCount | integer |
이 메시지의 대략적인 메시지 부분 수입니다. |
|
받는 사람
|
Recipients | array of object |
받는 사람 |
|
받는 사람 주소
|
Recipients.Address | string |
받는 사람 주소(전화 번호/전자 메일/사용자 ID 등). |
|
받는 사람 ID
|
Recipients.Id | string |
배달 상태 정보를 받는 데 사용되는 받는 사람 식별자입니다. |
트리거
| 새 메시지 |
새 메시지가 2방향 서비스에 도착하는 경우 |
새 메시지
새 메시지가 2방향 서비스에 도착하는 경우
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
고객
|
Customer | True | string |
사용할 고객입니다. |
|
서비스
|
Service | True | string |
사용할 2방향 서비스입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
메시지 보낸 사람
|
sender | string |
메시지 보낸 사람입니다. |
|
메시지 받는 사람
|
recipient | string |
메시지의 받는 사람입니다. |
|
메시지 콘텐츠
|
content | string |
받은 메시지의 내용입니다. |
|
메시지 타임스탬프
|
timestamp | date-time |
메시지의 타임스탬프입니다. |
|
메시지 프로토콜
|
protocol | string |
수신된 메시지의 프로토콜입니다. |
|
attachments
|
attachments | array of object |
attachments |
|
첨부 파일 이름
|
attachments.name | string |
첨부 파일의 파일 이름입니다. |
|
첨부 파일 Mime 형식
|
attachments.mimeType | string |
첨부 파일의 mime 형식입니다. |
|
첨부 파일 리소스 위치
|
attachments.resourceLocation | string |
첨부 파일 리소스 위치입니다. |
|
메시지 ID
|
messageId | string |
받은 메시지의 고유 메시지 ID입니다. |
정의
UUID (범용 고유 식별자)
불리언
기본 데이터 형식 'boolean'입니다.