다음을 통해 공유

tyntec WhatsApp Business

tyntec 대화 API를 사용하여 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)
연락처
이름 tyntec 지원
URL https://www.tyntec.com/get-help-support
전자 메일 support@tyntec.com
커넥터 메타데이터
게시자 tyntec GmbH
웹 사이트 https://www.tyntec.com
개인 정보 보호 정책 https://www.tyntec.com/data-privacy-statement
카테고리 통신; 상업

"tyntec WhatsApp Business" 커넥터는 단방향 WhatsApp 채널을 사용하도록 설정하여 Power Apps, Power Automation 또는 Azure Logic Apps의 통신 기능을 강화합니다. 이를 통해 tyntec 대화 API를 사용하여 알림, 경고, 메모 또는 고객 참여 자료를 보낼 수 있습니다.

Pre-requisites

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

API 키를 가져오는 방법

  1. 등록하세요/tyntec 계정에 로그인
  2. API 설정을 클릭합니다.
  3. API 설정에서 새 API 키를 클릭합니다.
  4. 새로 할당된 API 키 복사

WhatsApp에 비즈니스 계정 번호를 가져오는 방법

  1. 지침 [tyntec 웹 사이트](https://www.tyntec.com/docs/ whatsapp-business-api-account-information-get-started#toc--set-up-your-whatsapp-business-account-waba-)

WhatsApp 메시지 템플릿을 가져오는 방법

  1. tyntec webiste에 대한 지침 후속 작업

연결을 만드는 중

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

기본값

적용 가능: 모든 지역

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

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

이름 유형 Description 필수
apikey 시큐어스트링 (보안 문자열) 이 api에 대한 apikey 진실

제한 한도

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

동작

WABA 번호 유효성 검사

WABA 번호 유효성 검사
WhatsApp Free-Form 메시지(사용되지 않음) [사용되지 않음]

무료 양식 메시지 보내기(사용되지 않음)
Whatsapp 무료 양식 연락처 메시지 보내기

WhatsApp을 통해 연락처 메시지를 보냅니다. 지원 창에서만 사용할 수 있습니다(고객의 마지막 메시지로부터 24시간 후)
WhatsApp 무료 형식 단일 제품 보내기

WhatsApp에 단일 제품 메시지를 보냅니다. 지원 창에서만 사용할 수 있습니다(고객의 마지막 메시지로부터 24시간 후)
WhatsApp 무료 형식 빠른 회신 보내기

WhatsApp에 빠른 회신을 보냅니다. 지원 창에서만 사용할 수 있습니다(고객의 마지막 메시지로부터 24시간 후)
WhatsApp 자유 형식 문서 메시지 보내기

WhatsApp에 자유 형식 문서 메시지를 보냅니다. 지원 창에서만 사용할 수 있습니다(고객의 마지막 메시지로부터 24시간 후)
WhatsApp 템플릿 동적 URL 보내기 단추

WhatsApp 템플릿 동적 URL 단추를 보냅니다. 언제든지 사용할 수 있습니다. 등록된 템플릿이 필요합니다.
WhatsApp 템플릿 메시지 보내기(사용되지 않음) [사용되지 않음]

WhatsApp 템플릿 메시지 보내기(사용되지 않음)
WhatsApp 템플릿 문서 메시지 보내기

WhatsApp 템플릿 문서 이미지를 보냅니다. 언제든지 사용할 수 있습니다. 등록된 템플릿이 필요합니다.
Whatsapp 템플릿 비디오 메시지 보내기

Whatsapp 템플릿 비디오 메시지를 보냅니다. 언제든지 사용할 수 있습니다. 등록된 템플릿이 필요합니다.
WhatsApp 템플릿 빠른 회신 보내기

이 작업은 빠른 회신으로 WhatsApp 템플릿을 보냅니다. 언제든지 사용할 수 있습니다. 등록된 템플릿이 필요합니다.
WhatsApp 템플릿 위치 메시지 보내기

WhatsApp에 위치 템플릿 메시지를 보냅니다. 언제든지 사용할 수 있습니다. 등록된 템플릿이 필요합니다.
WhatsApp 템플릿 이미지 메시지 보내기

이미지와 함께 WhatsApp 템플릿 메시지를 보냅니다. 언제든지 사용할 수 있습니다. 등록된 템플릿이 필요합니다.
WhatsApp 템플릿 텍스트 메시지 보내기

WhatsApp 템플릿 문자 메시지를 보냅니다. 언제든지 사용할 수 있습니다. 등록된 템플릿이 필요합니다.
WhatsApp에 무료 양식 제품 목록 보내기

WhatsApp 제품 목록을 보냅니다. 지원 창에서만 사용할 수 있습니다(고객의 마지막 메시지로부터 24시간 후)
WhatsApp에 자유 형식 목록 메시지 보내기

WhatsApp에 목록 메시지를 보냅니다. 지원 창에서만 사용할 수 있습니다(고객의 마지막 메시지로부터 24시간 후)
WhatsApp에 자유 형식 문자 메시지 보내기

WhatsApp을 통해 간단한 자유 형식의 문자 메시지를 보냅니다. 지원 창에서만 사용할 수 있습니다(고객의 마지막 메시지로부터 24시간 후).
WhatsApp에 자유 형식 비디오 메시지 보내기

WhatsApp에 자유 형식의 비디오 메시지를 보냅니다. 지원 창에서만 사용할 수 있습니다(고객의 마지막 메시지로부터 24시간 후)
WhatsApp에 자유 형식 스티커 메시지 보내기

WhatsApp에 스티커 메시지를 보냅니다. 지원 창에서만 사용할 수 있습니다(고객의 마지막 메시지로부터 24시간 후)
WhatsApp에 자유 형식 위치 메시지 보내기

WhatsApp 위치 메시지를 보냅니다. 지원 창에서만 사용할 수 있습니다(고객의 마지막 메시지로부터 24시간 후)
상태 확인

메시지 상태 확인
상태 확인(사용되지 않음) [사용되지 않음]

메시지 상태 확인(사용되지 않음)
자유 형식 오디오 메시지 보내기

자유 형식의 오디오 메시지를 보냅니다. 지원 창에서만 사용할 수 있습니다(고객의 마지막 메시지로부터 24시간 후)
자유 형식 이미지 메시지 보내기

무료 이미지 메시지를 보냅니다. 지원 창에서만 사용할 수 있습니다(고객의 마지막 메시지로부터 24시간 후)

WABA 번호 유효성 검사

작업 ID:
TestPhoneNumber

WABA 번호 유효성 검사

매개 변수

Name 키 필수 형식 Description
WhatsAppBusinessNumber
 whatsAppBusinessNumber True string

유효성 검사를 위한 WABA

반환

Name 경로 형식 Description
전화번호
 phoneNumber string

사용자 번호
displayPhoneNumber
 displayPhoneNumber string

표시된 전화 번호 버전
verifiedName
 verifiedName string

확인된 이름
qualityRating
 qualityRating string

품질 등급
status
 status string

status
whatsAppAccountId
 whatsAppAccountId string

WhatsApp 계정 ID
accountName
 managedBy.accountName string

사용자의 계정 이름
accountName
 messagingVia.accountName string

관리 계정 이름
messagingTier
 messagingTier string

메시징 계층
점수
 qualityScore.score string

점수

WhatsApp Free-Form 메시지(사용되지 않음) [사용되지 않음]

작업 ID:
SendFreeformMessage

무료 양식 메시지 보내기(사용되지 않음)

매개 변수

Name 키 필수 형식 Description
에게
 to string

에게
channels
 channels True array of string

channels
보낸 사람
 from string

보낸 사람
type
 type string

type
url
 url string

url
캡션
 caption string

캡션
콘텐츠 유형
 contentType string

콘텐츠 유형
문자 메시지
 text string

문자 메시지

반환

Name 경로 형식 Description
메시지 아이디
 messageId string

메시지 아이디

Whatsapp 무료 양식 연락처 메시지 보내기

작업 ID:
SendWhatsAppContact

WhatsApp을 통해 연락처 메시지를 보냅니다. 지원 창에서만 사용할 수 있습니다(고객의 마지막 메시지로부터 24시간 후)

매개 변수

Name 키 필수 형식 Description
보낸 사람
 from string

보낸 사람
에게
 to string

에게
city
 city string

city
country
 country string

country
국가 코드
 countryCode string

국가 코드
street
 street string

street
type
 type string

type
지퍼
 zip string

지퍼
formattedName
 formattedName string

formattedName
lastName
 lastName string

lastName

반환

Name 경로 형식 Description
메시지 아이디
 messageId string

메시지 아이디
시간표시
 timestamp string

시간표시

WhatsApp 무료 형식 단일 제품 보내기

작업 ID:
SendWhatsAppProduct

WhatsApp에 단일 제품 메시지를 보냅니다. 지원 창에서만 사용할 수 있습니다(고객의 마지막 메시지로부터 24시간 후)

매개 변수

Name 키 필수 형식 Description
보낸 사람
 from string

보낸 사람
에게
 to string

에게
type
 type string

type
문자 메시지
 text string

문자 메시지
type
 type string

type
문자 메시지
 text string

문자 메시지
type
 type string

type
문자 메시지
 text string

문자 메시지
catalogId
 catalogId string

catalogId
제품 ID
 productId string

제품 ID

반환

Name 경로 형식 Description
메시지 아이디
 messageId string

메시지 아이디
시간표시
 timestamp string

시간표시

WhatsApp 무료 형식 빠른 회신 보내기

작업 ID:
SendWhatsAppQuickReply

WhatsApp에 빠른 회신을 보냅니다. 지원 창에서만 사용할 수 있습니다(고객의 마지막 메시지로부터 24시간 후)

매개 변수

Name 키 필수 형식 Description
보낸 사람
 from string

보낸 사람
에게
 to string

에게
type
 type string

type
문자 메시지
 text string

문자 메시지
type
 type string

type
문자 메시지
 text string

문자 메시지
type
 type string

type
문자 메시지
 text string

문자 메시지
payload
 payload string

payload
title
 title string

title

반환

Name 경로 형식 Description
메시지 아이디
 messageId string

메시지 아이디
시간표시
 timestamp string

시간표시

WhatsApp 자유 형식 문서 메시지 보내기

작업 ID:
SendWhatsAppDocument

WhatsApp에 자유 형식 문서 메시지를 보냅니다. 지원 창에서만 사용할 수 있습니다(고객의 마지막 메시지로부터 24시간 후)

매개 변수

Name 키 필수 형식 Description
보낸 사람
 from string

보낸 사람
에게
 to string

에게
url
 url string

url
캡션
 caption string

캡션
filename
 filename string

filename

반환

Name 경로 형식 Description
메시지 아이디
 messageId string

메시지 아이디
시간표시
 timestamp string

시간표시

WhatsApp 템플릿 동적 URL 보내기 단추

작업 ID:
SendWhatsAppTemplateDynamicButton

WhatsApp 템플릿 동적 URL 단추를 보냅니다. 언제든지 사용할 수 있습니다. 등록된 템플릿이 필요합니다.

매개 변수

Name 키 필수 형식 Description
보낸 사람
 from string

보낸 사람
에게
 to string

에게
템플릿ID
 templateId string

템플릿ID
templateLanguage
 templateLanguage string

templateLanguage
type
 type string

type
문자 메시지
 text string

문자 메시지
type
 type string

type
index
 index integer

index
문자 메시지
 text string

문자 메시지

반환

Name 경로 형식 Description
메시지 아이디
 messageId string

메시지 아이디
시간표시
 timestamp string

시간표시

WhatsApp 템플릿 메시지 보내기(사용되지 않음) [사용되지 않음]

작업 ID:
SendWhatsApp

WhatsApp 템플릿 메시지 보내기(사용되지 않음)

매개 변수

Name 키 필수 형식 Description
에게
 to True string

수신자의 전화 번호
channels
 channels True array of string

channels
보낸 사람
 from True string

WhatsApp에 비즈니스 계정 번호
템플릿ID
 templateId True string

템플릿 ID
언어 정책
 policy True string

언어 정책
language-code
 code True string

언어 코드
type
 type True string

type
type
 type string

매개 변수의 형식
하위
 subType string

작업 호출 단추에 사용됨
url
 url string

url
type
 type string

사용된 미디어 유형
filename
 filename string

filename
문자 메시지
 text string

문자 메시지

반환

Name 경로 형식 Description
메시지 아이디
 messageId string

메시지 아이디

WhatsApp 템플릿 문서 메시지 보내기

작업 ID:
SendWhatsAppTemplateDocument

WhatsApp 템플릿 문서 이미지를 보냅니다. 언제든지 사용할 수 있습니다. 등록된 템플릿이 필요합니다.

매개 변수

Name 키 필수 형식 Description
보낸 사람
 from string

보낸 사람
에게
 to string

에게
템플릿ID
 templateId string

템플릿ID
templateLanguage
 templateLanguage string

templateLanguage
type
 type string

type
url
 url string

url
type
 type string

type
문자 메시지
 text string

문자 메시지

반환

Name 경로 형식 Description
메시지 아이디
 messageId string

메시지 아이디
시간표시
 timestamp string

시간표시

Whatsapp 템플릿 비디오 메시지 보내기

작업 ID:
SendWhatsAppTemplateVideo

Whatsapp 템플릿 비디오 메시지를 보냅니다. 언제든지 사용할 수 있습니다. 등록된 템플릿이 필요합니다.

매개 변수

Name 키 필수 형식 Description
보낸 사람
 from string

보낸 사람
에게
 to string

에게
채널
 channel string

채널
콘텐츠 유형
 contentType string

콘텐츠 유형
템플릿ID
 templateId string

템플릿ID
templateLanguage
 templateLanguage string

templateLanguage
type
 type string

type
url
 url string

url
type
 type string

type
문자 메시지
 text string

문자 메시지

반환

Name 경로 형식 Description
메시지 아이디
 messageId string

메시지 아이디
시간표시
 timestamp string

시간표시

WhatsApp 템플릿 빠른 회신 보내기

작업 ID:
SendWhatsAppTemplateQuickReply

이 작업은 빠른 회신으로 WhatsApp 템플릿을 보냅니다. 언제든지 사용할 수 있습니다. 등록된 템플릿이 필요합니다.

매개 변수

Name 키 필수 형식 Description
보낸 사람
 from string

보낸 사람
에게
 to string

에게
템플릿ID
 templateId string

템플릿ID
templateLanguage
 templateLanguage string

templateLanguage
type
 type string

type
문자 메시지
 text string

문자 메시지
type
 type string

type
index
 index integer

index
payload
 payload string

payload

반환

Name 경로 형식 Description
메시지 아이디
 messageId string

메시지 아이디
시간표시
 timestamp string

시간표시

WhatsApp 템플릿 위치 메시지 보내기

작업 ID:
SendWhatsAppTemplateLocation

WhatsApp에 위치 템플릿 메시지를 보냅니다. 언제든지 사용할 수 있습니다. 등록된 템플릿이 필요합니다.

매개 변수

Name 키 필수 형식 Description
보낸 사람
 from string

보낸 사람
에게
 to string

에게
템플릿ID
 templateId string

템플릿ID
templateLanguage
 templateLanguage string

templateLanguage
longitude
 longitude float

longitude
latitude
 latitude float

latitude
이름
 name string

이름
address
 address string

address
type
 type string

type
문자 메시지
 text string

문자 메시지

반환

Name 경로 형식 Description
메시지 아이디
 messageId string

메시지 아이디
시간표시
 timestamp string

시간표시

WhatsApp 템플릿 이미지 메시지 보내기

작업 ID:
SendWhatsAppTemplateImage

이미지와 함께 WhatsApp 템플릿 메시지를 보냅니다. 언제든지 사용할 수 있습니다. 등록된 템플릿이 필요합니다.

매개 변수

Name 키 필수 형식 Description
보낸 사람
 from string

보낸 사람
에게
 to string

에게
템플릿ID
 templateId string

템플릿ID
templateLanguage
 templateLanguage string

templateLanguage
type
 type string

type
url
 url string

url
문자 메시지
 text string

문자 메시지

반환

Name 경로 형식 Description
메시지 아이디
 messageId string

메시지 아이디
시간표시
 timestamp string

시간표시

WhatsApp 템플릿 텍스트 메시지 보내기

작업 ID:
SendWhatsAppTemplateText

WhatsApp 템플릿 문자 메시지를 보냅니다. 언제든지 사용할 수 있습니다. 등록된 템플릿이 필요합니다.

매개 변수

Name 키 필수 형식 Description
보낸 사람
 from string

보낸 사람
에게
 to string

에게
템플릿ID
 templateId string

템플릿ID
templateLanguage
 templateLanguage string

templateLanguage
type
 type string

type
문자 메시지
 text string

문자 메시지
type
 type string

type
문자 메시지
 text string

문자 메시지

반환

Name 경로 형식 Description
메시지 아이디
 messageId string

메시지 아이디
시간표시
 timestamp string

시간표시

WhatsApp에 무료 양식 제품 목록 보내기

작업 ID:
SendWhatsAppProductList

WhatsApp 제품 목록을 보냅니다. 지원 창에서만 사용할 수 있습니다(고객의 마지막 메시지로부터 24시간 후)

매개 변수

Name 키 필수 형식 Description
보낸 사람
 from string

보낸 사람
에게
 to string

에게
type
 type string

type
문자 메시지
 text string

문자 메시지
type
 type string

type
문자 메시지
 text string

문자 메시지
type
 type string

type
문자 메시지
 text string

문자 메시지
catalogId
 catalogId string

catalogId
제품 ID
 productId string

제품 ID

반환

Name 경로 형식 Description
메시지 아이디
 messageId string

메시지 아이디
시간표시
 timestamp string

시간표시

WhatsApp에 자유 형식 목록 메시지 보내기

작업 ID:
SendWhatsAppList

WhatsApp에 목록 메시지를 보냅니다. 지원 창에서만 사용할 수 있습니다(고객의 마지막 메시지로부터 24시간 후)

매개 변수

Name 키 필수 형식 Description
보낸 사람
 from string

보낸 사람
에게
 to string

에게
type
 type string

type
문자 메시지
 text string

문자 메시지
type
 type string

type
문자 메시지
 text string

문자 메시지
type
 type string

type
문자 메시지
 text string

문자 메시지
title
 title string

title
title
 title string

title
payload
 payload string

payload
title
 title string

title
description
 description string

description

반환

Name 경로 형식 Description
메시지 아이디
 messageId string

메시지 아이디
시간표시
 timestamp string

시간표시

WhatsApp에 자유 형식 문자 메시지 보내기

작업 ID:
SendWhatsAppText

WhatsApp을 통해 간단한 자유 형식의 문자 메시지를 보냅니다. 지원 창에서만 사용할 수 있습니다(고객의 마지막 메시지로부터 24시간 후).

매개 변수

Name 키 필수 형식 Description
보낸 사람
 from True string

보낸 사람
에게
 to True string

에게
문자 메시지
 text True string

문자 메시지

반환

Name 경로 형식 Description
메시지 아이디
 messageId string

메시지 아이디
시간표시
 timestamp string

시간표시

WhatsApp에 자유 형식 비디오 메시지 보내기

작업 ID:
SendWhatsAppVideo

WhatsApp에 자유 형식의 비디오 메시지를 보냅니다. 지원 창에서만 사용할 수 있습니다(고객의 마지막 메시지로부터 24시간 후)

매개 변수

Name 키 필수 형식 Description
보낸 사람
 from string

보낸 사람
에게
 to string

에게
url
 url string

url
캡션
 caption string

캡션

반환

Name 경로 형식 Description
메시지 아이디
 messageId string

메시지 아이디
시간표시
 timestamp string

시간표시

WhatsApp에 자유 형식 스티커 메시지 보내기

작업 ID:
SendWhatsAppSticker

WhatsApp에 스티커 메시지를 보냅니다. 지원 창에서만 사용할 수 있습니다(고객의 마지막 메시지로부터 24시간 후)

매개 변수

Name 키 필수 형식 Description
보낸 사람
 from string

보낸 사람
에게
 to string

에게
url
 url string

url

반환

Name 경로 형식 Description
메시지 아이디
 messageId string

메시지 아이디
시간표시
 timestamp string

시간표시

WhatsApp에 자유 형식 위치 메시지 보내기

작업 ID:
SendWhatsAppLocation

WhatsApp 위치 메시지를 보냅니다. 지원 창에서만 사용할 수 있습니다(고객의 마지막 메시지로부터 24시간 후)

매개 변수

Name 키 필수 형식 Description
보낸 사람
 from string

보낸 사람
에게
 to string

에게
longitude
 longitude float

longitude
latitude
 latitude float

latitude
이름
 name string

이름
address
 address string

address

반환

Name 경로 형식 Description
메시지 아이디
 messageId string

메시지 아이디
시간표시
 timestamp string

시간표시

상태 확인

작업 ID:
StatusCheckV3

메시지 상태 확인

매개 변수

Name 키 필수 형식 Description
메시지 ID
 messageId True string

메시지 ID

반환

Name 경로 형식 Description
메시지 아이디
 messageId string

메시지 아이디
status
 status string

status
시간표시
 timestamp string

시간표시

상태 확인(사용되지 않음) [사용되지 않음]

작업 ID:
StatusCheck

메시지 상태 확인(사용되지 않음)

매개 변수

Name 키 필수 형식 Description
메시지 ID
 id True string

메시지 아이디

반환

Name 경로 형식 Description
메시지 아이디
 messageId string

메시지 아이디
deliveryChannel
 deliveryChannel string

deliveryChannel
status
 status string

status
시간표시
 timestamp string

시간표시

자유 형식 오디오 메시지 보내기

작업 ID:
SendWhatsAppAudio

자유 형식의 오디오 메시지를 보냅니다. 지원 창에서만 사용할 수 있습니다(고객의 마지막 메시지로부터 24시간 후)

매개 변수

Name 키 필수 형식 Description
보낸 사람
 from string

보낸 사람
에게
 to string

에게
url
 url string

url

반환

Name 경로 형식 Description
메시지 아이디
 messageId string

메시지 아이디
시간표시
 timestamp string

시간표시

자유 형식 이미지 메시지 보내기

작업 ID:
SendsWhatsAppImage

무료 이미지 메시지를 보냅니다. 지원 창에서만 사용할 수 있습니다(고객의 마지막 메시지로부터 24시간 후)

매개 변수

Name 키 필수 형식 Description
보낸 사람
 from string

보낸 사람
에게
 to string

에게
url
 url string

url
캡션
 caption string

캡션

반환

Name 경로 형식 Description
메시지 아이디
 messageId string

메시지 아이디
시간표시
 timestamp string

시간표시

트리거

들어오는 메시지

들어오는 메시지의 트리거
들어오는 메시지(사용되지 않음) [사용되지 않음]

들어오는 메시지의 트리거(사용되지 않음)

들어오는 메시지

작업 ID:
IncomingV2

들어오는 메시지의 트리거

매개 변수

Name 키 필수 형식 Description
WhatsApp에 비즈니스 계정 번호
 WABA True string

WhatsApp에 비즈니스 계정 번호

들어오는 메시지(사용되지 않음) [사용되지 않음]

작업 ID:
Incoming

들어오는 메시지의 트리거(사용되지 않음)