다음을 통해 공유

TrueDialog SMS

TrueDialog 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)
연락처
이름 TrueDialog 지원
URL https://www.truedialog.com/help/
전자 메일 support@truedialog.com
커넥터 메타데이터
게시자 TrueDialog Dynamics
웹 사이트 https://www.truedialog.com/
개인 정보 보호 정책 https://www.truedialog.com/privacy-policy/
카테고리 Communication

TrueDialog의 SMS API는 다른 SMS 소프트웨어보다 미리 빌드된 기능이 더 많은 엔터프라이즈급입니다. 개발자를 위해 빌드된 SMS API는 매우 안정적이고 안전하며 추가 옵트아웃 및 규정 준수 보호를 위해 미리 빌드된 ISO 9001 데이터베이스를 포함합니다. 또한 우리의 전체 기능을 통해 사용할 수 Enterprise-Grade SMS 문자 메시지 소프트웨어.

필수 조건

계속하려면 다음 자격 증명이 필요합니다.

  • Microsoft Power Apps 또는 Power Automate 계획
  • TrueDialog 계정 및 계획 및 계정에 대한 TrueDialog API 키 및 비밀 코드입니다. 등록하려면 여기를 클릭하십시오.

자격 증명을 가져오는 방법

등록하려면 여기를 클릭하십시오. TrueDialog에 등록하면 API 키 및 비밀 코드가 자격 증명 전자 메일에 표시됩니다. 시작에 대한 도움말은 팀에 문의하세요. 세계적 수준의 Client Services 팀은 등록을 안내하고 회사의 요구에 가장 적합한 계정을 선택합니다.

문의:

메일 주소 support@truedialog.com
라이브 채팅 https://www.truedialog.com/
Phone 512-501-5940

TrueDialog 커넥터 시작

자격 증명이 있으면 커넥터 사용을 시작할 수 있습니다.

활동

SMS 보내기

가장 중요한 작업은 "SMS 보내기"입니다. 단일 또는 여러 받는 사람에게 SMS를 보낼 수 있습니다. 이 작업에는 다음과 같은 몇 가지 필수 필드가 있습니다.

  • 계정 ID – 현재 사용자 정보 가져오기 응답에서 사용되거나 하드 코딩될 수 있습니다.
  • 채널 – 기본 연결된 전화 번호를 사용하기 위해 기본값 22를 그대로 둡니다.
  • 대상 – 서식이 없는 유효한 미국 전화 번호(예: +15125453809)
  • 메시지 – 메시지 자체입니다.
  • Execute – 보내기를 연기하지 않으려면 기본값 True를 그대로 둡니다.

유발 요소

계정에 등록된 콜백 목록은 다음에서 찾을 수 있습니다. https://ui.truedialog.com/Callbacks

수신된 메시지

가장 중요한 트리거입니다. 이 작업은 최종 사용자가 연결된 전화 번호로 텍스트를 입력할 때마다 흐름을 트리거합니다.

트리거를 등록하려면 계정 ID가 필요합니다. TD 포털을 통해 계정 ID를 가져올 수 있습니다. 이 ID는 오른쪽 위 모서리에 있는 계정 이름 옆에 있습니다.

들어오는 메시지에는 메시지 텍스트 및 기타 필요한 필드가 포함됩니다.

수신된 메시지 중지

이 작업은 STOP 또는 동의어의 최종 사용자 텍스트가 있을 때마다 흐름을 트리거합니다. 또한 TrueDialog 시스템에서 연락처를 자동으로 옵트아웃합니다. 옵트아웃 연락처에 메시지를 보내려면 SMS를 보낼 때 forceOptIn 플래그를 True로 설정합니다. 이 ForceOptIt 기능을 주의해서 사용하고 옵트아웃된 레코드를 추적해야 합니다.

커넥터를 시작하기 위한 단계별 프로세스를 사용자에게 제공합니다. 여기서는 예상되는 인기 트리거 및 작업과 같은 일반적인 사용 사례와 자동화 시나리오에서 도움이 될 수 있는 방법을 강조 표시해야 합니다. 가능한 경우 이미지를 포함합니다.

배달 알림 수신됨

이 작업은 각 배달 알림 수신에 대한 흐름을 트리거합니다. 모든 이동 통신 사업자가 알림 영수증을 보내는 것은 아닙니다.

잘못된 대상

대상 휴대폰 중 하나가 유효하지 않거나 블랙리스트에 추가된 경우에도 SMS를 보낼 수 있으며 오류가 표시되지 않습니다. 이렇게 하려면 메시지를 보낼 때 "IgnoreInvalidTargets" 속성을 true로 설정해야 합니다. 보낸 SMS 받는 사람 목록에 잘못된 전화 번호가 표시되면 이 작업은 흐름을 트리거합니다.

알려진 문제 및 제한 사항

TrueDialog API에는 사용자 지정 커넥터에 비해 더 많은 기능이 있습니다.

자주 묻는 질문(FAQ)

undrlying API에 대한 최신 설명을 보려면 여기를 방문하세요.

여기에서 자주 묻는 질문과 해당 답변에 대한 분석을 제공합니다. 기본 서비스와 상호 작용하거나 커넥터 자체에 대한 FAQ를 다룰 수 있습니다.

연결을 만드는 중

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

기본값

적용 가능: 모든 지역

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

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

이름 유형 Description 필수
사용자 이름 시큐어스트링 (보안 문자열) 이 API의 사용자 이름 진실
암호 시큐어스트링 (보안 문자열) 이 API의 암호 진실

제한 한도

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

동작

SMS 보내기

단일 또는 여러 받는 사람에게 SMS 보내기
계정 정보 가져오기

계정에 대한 정보 가져오기
연락처 검색

전화 번호 또는 전자 메일 주소를 통해 연락처를 검색합니다.
연락처 만들기

TrueDialog에서 연락처 레코드 만들기
연락처 업데이트

연락처 업데이트
현재 사용자 정보 가져오기

연결에서 자격 증명을 사용한 사용자에 대한 정보 가져오기

SMS 보내기

작업 ID:
Campaign_Push

단일 또는 여러 받는 사람에게 SMS 보내기

매개 변수

Name 키 필수 형식 Description
계정 ID
 accountId True string

SMS를 보내는 데 사용할 계정 ID
채널
 Channels True array of string

채널
Targets
 Targets True array of string

Targets
ContactListIds
 ContactListIds array of string

연락처 목록 ID
ExcludeListIds
 ExcludeListIds array of string

목록 ID 제외
미디어 ID
 MediaId integer

미디어 ID
Message
 Message True string

Message
단일 사용 무시
 IgnoreSingleUse boolean

단일 사용 무시
ForceOptIn
 ForceOptIn boolean

강제 Opt-In
Schedules
 Schedules array of string

작업과 연결된 일정 목록
Execute
 Execute True boolean

만들 때 작업을 실행해야 하는 경우 true를 설정합니다.
IgnoreInvalidTargets
 IgnoreInvalidTargets boolean

잘못된 숫자를 무시해야 하는지를 나타냅니다.

반환

몸
PushCampaignResponse

계정 정보 가져오기

작업 ID:
Account_Get_Info

계정에 대한 정보 가져오기

매개 변수

Name 키 필수 형식 Description
검색해야 하는 계정의 ID
 accountId True string

계정 ID

반환

몸
AccountResponse

연락처 검색

작업 ID:
Contact_Search

전화 번호 또는 전자 메일 주소를 통해 연락처를 검색합니다.

매개 변수

Name 키 필수 형식 Description
구독의 계정 ID
 accountId True string

연락처가 표시되는 계정입니다.
검색할 전화 번호
 phone True string

전달된 전화 번호 또는 전자 메일을 사용하여 기존 연락처를 찾습니다.

반환

아이템
ContactSearchRequest

연락처 만들기

작업 ID:
Contact_Create

TrueDialog에서 연락처 레코드 만들기

매개 변수

Name 키 필수 형식 Description
계정 ID
 accountId True string

만든 연락처에 대한 부모 계정으로 사용할 계정 ID
전화번호
 PhoneNumber string

사용 가능한 경우 휴대폰 번호입니다. 이 필드 또는 전자 메일 필드가 필요합니다.
전자 메일
 Email string

연락처의 전자 메일 주소입니다. 이 필드 또는 PhoneNumber 필드는 필수입니다.
이름 (FirstName)
 FirstName string

연락처의 이름입니다.
성씨
 LastName string

연락처의 성입니다.

반환

몸
ContactResponse

연락처 업데이트

작업 ID:
Contact_Update

연락처 업데이트

매개 변수

Name 키 필수 형식 Description
계정 ID
 accountId True string

업데이트된 연락처의 부모 계정으로 사용되는 계정 ID
접촉 ID
 contactid True string

업데이트할 연락처의 ID
전화번호
 PhoneNumber string

사용 가능한 경우 휴대폰 번호입니다. 이 필드 또는 전자 메일 필드가 필요합니다.
전자 메일
 Email string

연락처의 전자 메일 주소입니다. 이 필드 또는 PhoneNumber 필드는 필수입니다.
이름 (FirstName)
 FirstName string

연락처의 이름입니다.
성씨
 LastName string

연락처의 성입니다.

반환

몸
ContactResponse

현재 사용자 정보 가져오기

작업 ID:
User_Get_Self_Info

연결에서 자격 증명을 사용한 사용자에 대한 정보 가져오기

반환

몸
UserResponse

트리거

배달 알림 수신됨

이 작업은 각 배달 알림 수신에 대한 흐름을 트리거합니다.
수신된 메시지

이 작업은 최종 사용자가 에 텍스트를 입력할 때마다 흐름을 트리거합니다.
수신된 메시지 중지

이 작업은 STOP 또는 동의어의 최종 사용자 텍스트가 있을 때마다 흐름을 트리거합니다.
수신된 키워드

이 작업은 키워드의 최종 사용자 텍스트가 있을 때마다 흐름을 트리거합니다.
잘못된 대상

이 작업은 SMS를 보내는 동안 대상이 필터링된 경우 흐름을 트리거합니다.

배달 알림 수신됨

작업 ID:
Delivery_Notice_received

이 작업은 각 배달 알림 수신에 대한 흐름을 트리거합니다.

매개 변수

Name 키 필수 형식 Description
구독의 계정 ID
 accountId True string

대부분의 경우 루트 계정 ID를 사용하여 알림을 구독합니다.

반환

Name 경로 형식 Description
콜백 타임스탬프
 CallbackTimestamp string

콜백이 전송된 날짜 및 시간입니다. 형식: yyyy-MM-ddTHH:mm:ss
CallbackToken
 CallbackToken string

콜백 토큰
TransactionId
 TransactionId string

트랜잭션 ID
AccountId
 AccountId integer

계정 ID
어카운트 이름
 AccountName string

콜백이 연결된 계정의 이름
상태 ID
 StatusId integer

2 = 배달됨; 3 = 배달되지 않음; 7 = 알 수 없음
상태
 Status string

배달 코드 - 배달된 메시지 또는 오류 코드에 대해 확인합니다. 배달되지 않은 경우 - null
ChannelId
 ChannelId integer

채널 ID
채널 코드
 ChannelCode string

메시지가 전송된 채널의 코드(긴 코드의 실제 전화 번호)
MessageId
 MessageId string

MessageId
전화번호
 PhoneNumber string

전화 번호
연락처 ID
 ContactId integer

연락처 ID
ActionId
 ActionId integer

작업 ID
Message
 Message string

실제 메시지 텍스트

수신된 메시지

작업 ID:
Incoming_SMS_Received

이 작업은 최종 사용자가 에 텍스트를 입력할 때마다 흐름을 트리거합니다.

매개 변수

Name 키 필수 형식 Description
구독의 계정 ID
 AccountId True string

대부분의 경우 루트 계정 ID를 사용하여 알림을 구독합니다.

반환

Name 경로 형식 Description
어카운트 이름
 AccountName string

콜백이 연결된 계정의 이름
채널 코드
 ChannelCode string

메시지가 전송된 채널의 코드(긴 코드의 실제 전화 번호)
ChannelId
 ChannelId integer

메시지가 전송된 채널의 ID
연락처 ID
 ContactId integer

연락처 ID(알 수 없는 연락처의 경우 null)가 있는 경우
Message
 Message string

실제 메시지 텍스트
전화번호
 PhoneNumber string

대상 전화 번호
AccountId
 AccountId integer

콜백이 연결된 계정의 ID입니다.
콜백 타임스탬프
 CallbackTimestamp string

콜백이 전송된 날짜 및 시간입니다. 형식: yyyy-MM-ddTHH:mm:ss
CallbackToken
 CallbackToken string

콜백 토큰
TransactionId
 TransactionId string

고유 토큰

수신된 메시지 중지

작업 ID:
Stop_received

이 작업은 STOP 또는 동의어의 최종 사용자 텍스트가 있을 때마다 흐름을 트리거합니다.

매개 변수

Name 키 필수 형식 Description
구독의 계정 ID
 accountId True string

대부분의 경우 루트 계정 ID를 사용하여 알림을 구독합니다.

반환

Name 경로 형식 Description
콜백 타임스탬프
 CallbackTimestamp string

콜백이 전송된 날짜 및 시간입니다. 형식: yyyy-MM-ddTHH:mm:ss
CallbackToken
 CallbackToken string

콜백 토큰
TransactionId
 TransactionId string

트랜잭션 ID
AccountId
 AccountId integer

계정 ID
어카운트 이름
 AccountName string

콜백이 연결된 계정의 이름
ChannelId
 ChannelId integer

채널 ID
채널 코드
 ChannelCode string

메시지가 전송된 채널의 코드(긴 코드의 실제 전화 번호)
연락처 ID
 ContactId integer

연락처 ID
ContactAccountId
 ContactAccountId integer

연락처 레코드를 소유하는 계정의 ID입니다.
ContactAccountName
 ContactAccountName string

연락처 레코드를 소유하는 계정의 이름입니다.
전화번호
 PhoneNumber string

옵트아웃된 최종 사용자의 전화 번호

수신된 키워드

작업 ID:
Keyword_received

이 작업은 키워드의 최종 사용자 텍스트가 있을 때마다 흐름을 트리거합니다.

매개 변수

Name 키 필수 형식 Description
구독의 계정 ID
 accountId True string

대부분의 경우 루트 계정 ID를 사용하여 알림을 구독합니다.

반환

Name 경로 형식 Description
콜백 타임스탬프
 CallbackTimestamp string

콜백이 전송된 날짜 및 시간 형식: yyyy-MM-ddTHH:mm:ss
CallbackToken
 CallbackToken string

콜백 토큰
TransactionId
 TransactionId string

트랜잭션 ID
AccountId
 AccountId integer

콜백이 연결된 계정의 ID입니다.
어카운트 이름
 AccountName string

콜백이 연결된 계정의 이름
캠페인 ID
 CampaignId integer

캠페인 ID
ChannelId
 ChannelId integer

채널 ID
채널 코드
 ChannelCode string

메시지가 전송된 채널의 코드(긴 코드의 실제 전화 번호)
연락처 ID
 ContactId integer

키워드를 제출한 연락처의 ID
키워드
 Keyword string

제출된 실제 키워드
KeywordId
 KeywordId integer

제출된 키워드의 ID
Message
 Message string

실제 메시지 텍스트
전화번호
 PhoneNumber string

키워드를 제출한 최종 사용자의 전화 번호입니다.

잘못된 대상

작업 ID:
Invalid_Targets

이 작업은 SMS를 보내는 동안 대상이 필터링된 경우 흐름을 트리거합니다.

매개 변수

Name 키 필수 형식 Description
구독의 계정 ID
 accountId True string

대부분의 경우 루트 계정 ID를 사용하여 알림을 구독합니다.

반환

Name 경로 형식 Description
콜백 타임스탬프
 CallbackTimestamp string

콜백이 전송된 날짜 및 시간입니다. 형식: yyyy-MM-ddTHH:mm:ss
CallbackURL
 CallbackURL string

콜백 URL
TransactionId
 TransactionId string

트랜잭션 ID
AccountId
 AccountId integer

계정 ID
ActionId
 ActionId integer

작업 ID
RunId
 RunId integer

실행 ID
InvalidTargets
 InvalidTargets array of object

잘못된 대상
목표/타겟
 InvalidTargets.Target string

필터링된 대상
ReasonId
 InvalidTargets.ReasonId integer

이유의 ID입니다. 0 - 유효하지 않음, 1 - 옵트아웃, 2 - 중복, 3 - 차단됨, 4 - 배달할 수 없음, 5 - 일회용
이유
 InvalidTargets.Reason string

이유에 대한 간단한 설명

정의

AccountResponse

Name 경로 형식 Description
아이디
 id integer

계정의 ID입니다.
status
 status integer

계정의 현재 상태입니다.
부모 ID
 parentId integer

이 계정의 부모인 계정의 식별자입니다.
이름
 name string

계정 이름
만든
 created string

계정을 만든 경우입니다.
allowCallback
 allowCallback boolean

이 계정에서 콜백 메커니즘을 사용할 수 있는지 설정합니다.
callbackToken
 callbackToken string

콜백 토큰
type
 type integer

계정 유형(마스터 또는 하위 계정)
계정 유형
 accountType integer

계정 유형 이름
isApproved
 isApproved boolean

계정이 승인되었거나 승인되지 않음

ContactResponse

Name 경로 형식 Description
accountId
 accountId integer

계정 ID
전화번호
 phoneNumber string

전화 번호
메일 주소
 email string

메일 주소
preferredLanguageId
 preferredLanguageId string

기본 설정 언어 ID
선호 언어
 preferredLanguage string

기본 설정 언어
assignedId
 assignedId string

할당된 ID
이름 (첫 번째 이름)
 firstName string

이름 (First Name)
lastName
 lastName string

성 이름
phoneStatusId
 phoneStatusId integer

휴대폰 상태 ID
phoneStatus
 phoneStatus integer

휴대폰 상태
phoneHardErrorCount
 phoneHardErrorCount integer

휴대폰 하드 오류 수
phoneSoftErrorCount
 phoneSoftErrorCount integer

휴대폰 소프트 오류 수
phoneTotalHardErrorCount
 phoneTotalHardErrorCount integer

휴대폰 총 하드 오류 수
phoneTotalSoftErrorCount
 phoneTotalSoftErrorCount integer

휴대폰 총 소프트 오류 수
phoneLastHardError
 phoneLastHardError string

휴대폰 마지막 하드 오류
phoneLastSoftError
 phoneLastSoftError string

휴대폰 마지막 소프트 오류
phoneHardErrorSince
 phoneHardErrorSince string

휴대폰 하드 오류 이후
phoneSoftErrorSince
 phoneSoftErrorSince string

휴대폰 일시 오류 이후
statusId
 statusId integer

상태 ID
만든
 created string

만든
modified
 modified string

modified
작성자
 createdBy string

만든 사람
modifiedBy
 modifiedBy string

수정한 작성자
아이디
 id integer

아이디

ContactSearchRequest

Name 경로 형식 Description
아이디
 id integer

아이디
accountId
 accountId integer

계정 ID
statusId
 statusId integer

상태 ID
전화번호
 phoneNumber string

전화 번호
메일 주소
 email string

메일 주소
assignedId
 assignedId string

할당된 ID
이름 (첫 번째 이름)
 firstName string

이름 (First Name)
lastName
 lastName string

성 이름
subscriptions
 subscriptions array of

subscriptions
attributes
 attributes array of

attributes
phoneStatusId
 phoneStatusId integer

휴대폰 상태 ID
만든
 created string

만든
작성자
 createdBy string

만든 사람
modified
 modified string

modified
modifiedBy
 modifiedBy string

수정한 작성자

PushCampaignResponse

Name 경로 형식 Description
channels
 channels array of

channels
targets
 targets array of string

targets
targetsUrl
 targetsUrl string

대상 URL
targetsColumn
 targetsColumn string

targets 열
contactListIds
 contactListIds array of

연락처 목록 ID
excludeListIds
 excludeListIds array of

목록 ID 제외
campaignId
 campaignId integer

캠페인 ID
mediaId
 mediaId string

미디어 ID
message
 message string

message
보낸 사람
 from string

보낸 사람
제목
 subject string

제목
ignoreSingleUse
 ignoreSingleUse boolean

단일 사용 무시
forceOptIn
 forceOptIn boolean

강제 Opt-In
statusId
 statusId integer

상태 ID
roundRobinById
 roundRobinById boolean

라운드 로빈 바이 ID
globalRoundRobin
 globalRoundRobin boolean

글로벌 라운드 로빈
status
 status string

status
아이디
 id integer

아이디
accountId
 accountId integer

계정 ID
만든
 created string

만든
modified
 modified string

modified
작성자
 createdBy string

만든 사람
modifiedBy
 modifiedBy string

수정한 작성자
schedules
 schedules array of

schedules

UserResponse

Name 경로 형식 Description
사용자 이름
 userName string

사용자 이름
accountId
 accountId integer

계정 ID
메일 주소
 email string

메일 주소
이름 (첫 번째 이름)
 firstName string

이름 (First Name)
lastName
 lastName string

성 이름
전화번호
 phoneNumber string

전화 번호
isAdmin
 isAdmin boolean

은 관리자입니다.
key
 apiKey.key string

key
secret
 apiKey.secret string

secret
lastActivity
 apiKey.lastActivity string

마지막 작업
타입아이디
 apiKey.typeId integer

형식 ID
type
 apiKey.type integer

type
label
 apiKey.label string

label
사용자 이름
 apiKey.userName string

사용자 이름
validTo
 apiKey.validTo string

유효한 To
accountId
 apiKey.accountId integer

계정 ID
아이디
 apiKey.id integer

아이디
isChatUser
 isChatUser boolean

은 채팅 사용자입니다.
reportOnly
 reportOnly boolean

보고서만
requestNumber
 requestNumber boolean

요청 번호
canCreateContact
 canCreateContact boolean

연락처를 만들 수 있습니다.
isAlertAgent
 isAlertAgent boolean

경고 에이전트입니다.
동의하여
 agreed boolean

동의하여
주석
 comment string

주석
isApproved
 isApproved boolean

승인됨
isLockedOut
 isLockedOut boolean

가 잠겨 있습니다.
lastLockoutDate
 lastLockoutDate string

마지막 잠금 날짜
생성일
 creationDate string

만들기 날짜
lastLoginDate
 lastLoginDate string

마지막 로그인 날짜
lastActivityDate
 lastActivityDate string

마지막 활동 날짜
lastPasswordChangedDate
 lastPasswordChangedDate string

마지막 암호 변경 날짜