다음을 통해 공유


CardPlatform 적응형 카드(미리 보기)

CardPlatform을 사용하면 적응형 카드를 사용자에게 보낼 수 있습니다. 승인, 양식 캡처 및 일반 메시징과 같은 실행 콘텐츠에 사용할 수 있습니다. 템플릿 및 사용자 지정 카드를 지원합니다.

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

서비스 클래스 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)
연락처
이름 CardPlatform 지원
URL https://cardplatform.app/support
전자 메일 support@cardplatform.app
커넥터 메타데이터
게시자 CardPlatform
웹 사이트 https://cardplatform.app/
개인 정보 보호 정책 https://cardplatform.app/privacy/
카테고리 합작; 통신

CardPlatform을 사용하면 적응형 카드 및 실행 가능한 콘텐츠를 사용자에게 직접 보낼 수 있습니다.

Pre-requisites

CardPlatform을 사용하려면 다음을 수행해야 합니다.

  • CardPlatform 구독을 만들어 플랜 선택을 시작합니다.
  • 평가판 및 실험에 사용할 수 있는 평가판 구독이 있습니다.

자격 증명을 가져오는 방법

등록이 완료되면 전자 메일로 API 키를 받게 됩니다.

API 키가 있으면 새 연결을 만들고, API 키를 입력하고, 카드 보내기를 시작합니다.

커넥터 시작

시작하려면 먼저 메시지를 보냅니다.

  1. 메시지 보내기 작업 선택

    메시지 보내기 작업 선택

  2. 세 개의 필드를 채웁니다.

    메시지 보내기 작업 선택

    • 받는 사람 - 전자 메일 주소를 입력합니다.

    • 제목 - 제목 쓰기(예: Hello World)

    • 적응형 카드를 삽입합니다. 이 예제에서는 카드에 Hello World 를 보냅니다( 예:

      {
          "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
          "type": "AdaptiveCard",
          "version": "1.0",
          "body": [
              {
                  "type": "TextBlock",
                  "size": "Large",
                  "isSubtle": true,
                  "wrap": true,
                  "text": "Hello World"
              }
          ]
      }
      
  3. 흐름을 실행하면 Outlook에 카드가 표시됩니다.

    Outlook의 적응형 카드

알려진 문제 및 제한 사항

적응형 카드가 Outlook에 표시되지 않는 경우 문제 해결에 도움이 될 수 있는 Actionnable Message Debugger 라는 Outlook 플러그 인이 있습니다.

실행 가능한 메시지 디버거 사이트에서 설치합니다.

추가 지원은 CardPlatform 지원 사이트에서 사용할 수 있습니다.

자주 묻는 질문(FAQ)

  1. 승인을 보내면 어떻게 하나요?

    승인 보내기 작업을 사용합니다.

  2. 회신을 기다리지 않고 메시지를 보내려면 어떻게 해야 하나요?

    메시지 보내기 작업을 사용합니다.

  3. 적응형 카드를 디자인하려면 어떻게 해야 하나요?

    적응형 카드 디자이너를 사용하여 적응형 카드를 만듭니다.

  4. 적응형 카드에 대한 스키마 및 샘플은 어디에서 찾을 수 있나요?

    스키마 및 샘플은 다음에서 찾을 수 있습니다.

  5. 템플릿이란?

    템플릿을 사용하면 적응형 카드를 디자인한 다음 데이터를 적용하여 적응형 카드의 레이아웃에서 데이터를 분리할 수 있습니다.

    1. 공용 템플릿이란?

      공용 템플릿은 커뮤니티에서 만들어지고 모든 사용자가 사용할 수 있습니다. 공용 템플릿 나열 작업을 사용하여 모든 공용 템플릿을 나열할 수 있습니다.

    2. 프라이빗 템플릿이란?

      프라이빗 템플릿은 저장하고 재사용할 수 있는 템플릿의 프라이빗 컬렉션을 소유하고 있습니다.

연결을 만드는 중

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

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

기본값

적용 가능: 모든 지역

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

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

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

제한 한도

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

동작

공용 템플릿 가져오기

공용 템플릿의 내용을 검색합니다.

공용 템플릿 나열

모든 공용 템플릿의 목록을 검색합니다.

공용 템플릿 변환

퍼블릭 템플릿을 데이터로 채우고 완전히 채워진 적응형 카드를 반환합니다.

공용 템플릿 찾기

데이터의 구조를 분석하여 공용 템플릿을 찾습니다.

메시지 보내기

적응형 카드를 메시지로 보냅니다(작업 없음).

승인 보내기

승인 적응형 카드를 보내고 선택한 필드와 필드가 입력된 응답을 반환합니다.

적응형 카드 보내기

적응형 카드를 보내고 선택한 필드와 필드가 입력된 응답을 반환합니다.

프라이빗 템플릿 가져오기

이름으로 프라이빗 템플릿을 검색합니다.

프라이빗 템플릿 나열

모든 프라이빗 템플릿의 목록을 검색합니다.

프라이빗 템플릿 만들기

새 프라이빗 템플릿을 만듭니다.

프라이빗 템플릿 변환

프라이빗 템플릿을 데이터로 채우고 완전히 채워진 적응형 카드를 반환합니다.

프라이빗 템플릿 삭제

프라이빗 템플릿 집합에서 프라이빗 템플릿을 제거합니다.

프라이빗 템플릿 업데이트

프라이빗 템플릿의 내용을 업데이트합니다.

공용 템플릿 가져오기

공용 템플릿의 내용을 검색합니다.

매개 변수

Name 필수 형식 Description
공용 템플릿의 경로
path True string

공용 템플릿의 경로

반환

템플릿 목록

템플릿 목록
TemplateListSchema

공용 템플릿 나열

모든 공용 템플릿의 목록을 검색합니다.

반환

response
object

공용 템플릿 변환

퍼블릭 템플릿을 데이터로 채우고 완전히 채워진 적응형 카드를 반환합니다.

매개 변수

Name 필수 형식 Description
공용 템플릿 경로
path True string

공용 템플릿의 경로

object

반환

response
object

공용 템플릿 찾기

데이터의 구조를 분석하여 공용 템플릿을 찾습니다.

매개 변수

Name 필수 형식 Description
object

반환

response
object

메시지 보내기

적응형 카드를 메시지로 보냅니다(작업 없음).

매개 변수

Name 필수 형식 Description
받는 사람
recipients True array of string

받는 사람 전자 메일 주소

Heading
heading True string

Heading

적응형 카드
card True string

적응형 카드

반환

승인 보내기

승인 적응형 카드를 보내고 선택한 필드와 필드가 입력된 응답을 반환합니다.

매개 변수

Name 필수 형식 Description
받는 사람
recipients True array of string

받는 사람 전자 메일

Heading
heading True string

Heading

지시
instructions True string

지시

활동
actions True array of string

작업 목록

선택 유형
choiceType True string

선택 유형

승인에 대한 기본 선택
approvalChoice True string

승인에 대한 기본 선택

거부에 대한 기본 선택
rejectionChoice True string

거부에 대한 기본 선택

반환

이전 카드의 응답

적응형 카드 보내기

적응형 카드를 보내고 선택한 필드와 필드가 입력된 응답을 반환합니다.

매개 변수

Name 필수 형식 Description
받는 사람
recipients True array of string

받는 사람 전자 메일 주소

Heading
heading True string

Heading

적응형 카드
card True string

적응형 카드

아이디
id string

카드를 식별하는 ID

카드 이름
cardname string

카드 이름

반환

이전 카드의 응답

프라이빗 템플릿 가져오기

이름으로 프라이빗 템플릿을 검색합니다.

매개 변수

Name 필수 형식 Description
프라이빗 템플릿의 이름
name True string

프라이빗 템플릿의 이름

반환

response
object

프라이빗 템플릿 나열

모든 프라이빗 템플릿의 목록을 검색합니다.

반환

Name 경로 형식 Description
array of string

프라이빗 템플릿 만들기

새 프라이빗 템플릿을 만듭니다.

매개 변수

Name 필수 형식 Description
템플릿 이름
name True string

템플릿 이름

object

반환

response
object

프라이빗 템플릿 변환

프라이빗 템플릿을 데이터로 채우고 완전히 채워진 적응형 카드를 반환합니다.

매개 변수

Name 필수 형식 Description
템플릿 이름
name True string

템플릿 이름

object

반환

response
object

프라이빗 템플릿 삭제

프라이빗 템플릿 집합에서 프라이빗 템플릿을 제거합니다.

매개 변수

Name 필수 형식 Description
템플릿 이름
name True string

템플릿 이름

프라이빗 템플릿 업데이트

프라이빗 템플릿의 내용을 업데이트합니다.

매개 변수

Name 필수 형식 Description
템플릿 이름
name True string

템플릿 이름

object

정의

ResponseSchema

이전 카드의 응답

Name 경로 형식 Description
응답자
respondent string
respondentName
respondentName string
respondentEmail
respondentEmail string
choice
choice string
주석
comment string
responseDate
responseDate string

TemplateListSchema

템플릿 목록

Name 경로 형식 Description
list
list array of object
key
list.key string
templates
list.templates array of object
file
list.templates.file string
fullPath
list.templates.fullPath string

CardResponseSchema

객체

'object' 형식입니다.