다음을 통해 공유

봇 플랫폼(미리 보기)

봇 플랫폼의 봇을 모든 애플리케이션에 연결하고, 봇 사용자에게 메시지를 보내고, 봇 플랫폼의 기존 봇을 사용하여 특성 값을 설정합니다.

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

서비스 클래스 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)
연락처
이름 Bot Platform 지원
URL https://thebotplatform.com/contact/
전자 메일 hello@thebotplatform.com
커넥터 메타데이터
게시자 봇 플랫폼
웹 사이트 https://thebotplatform.com
개인 정보 보호 정책 https://thebotplatform.com/privacy-policy/
카테고리 통신; 웹 사이트

Bot Platform 커넥터를 사용하면 Power Automate 흐름의 데이터를 사용하여 봇의 사용자에게 메시지를 보내고, 새 특성을 만들고, 기존 특성에 대한 값을 설정할 수 있습니다. 커넥터는 API 호출을 수동으로 설정하지 않고도 API를 활용하여 이러한 모든 작업을 수행하는 대신 커넥터를 사용하여 API 작업을 더 빠르게 수행합니다.

필수 조건

봇 플랫폼의 계정이 필요합니다.

자격 증명을 가져오는 방법

Bot Platform CMS에 로그인한 후 연결하려는 봇으로 이동합니다. 사이드바 메뉴에서 'API 액세스'를 클릭하고 새 통합 앱을 만듭니다. 클라이언트 ID 및 비밀 키가 제공됩니다. 커넥터를 사용하여 Power Automate를 사용하여 봇을 인증하는 Power Automate에 이 정보를 입력합니다.

커넥터 시작

계정에 로그인한 후 통합하려는 봇으로 이동하여 'API 액세스'를 클릭하여 클라이언트 ID 및 비밀 키를 가져옵니다. 이 정보를 가져온 후 새 Power Automate Flow를 만들면 클라이언트 ID와 비밀 키를 입력하라는 메시지가 표시됩니다. 이 정보를 입력하면 봇에 액세스할 수 있는 권한을 요청하는 팝업이 나타납니다. '허용'을 누르고 당신은 모두 설정되어 있습니다!

알려진 문제 및 제한 사항

  • 현재 사용자는 전자 메일 주소를 통해서만 식별하여 정보를 봇에 다시 전달할 수 있습니다.
  • 간단한 문자 메시지 작업을 사용하여 이미지 URL을 보낼 수 없습니다.

일반적인 오류 및 해결

Microsoft Teams에 설치된 봇의 경우 이전에 봇과 상호 작용하지 않은 사용자에게 메시지를 보낼 수 없습니다. 해결 방법은 커넥터를 사용하여 메시지를 보내기 전에 먼저 플랫폼 내에서 사용자에게 브로드캐스트를 보내는 것입니다.

자주 묻는 질문(FAQ)

사용 사례에 대한 자세한 내용은 Dev Docs 페이지를 참조하세요.

연결을 만드는 중

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

기본값

적용 가능: 모든 지역

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

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

이름 유형 Description 필수
클라이언트 ID - Bot Platform clientId 문자열 클라이언트 ID를 입력하세요. 진실
봇 플랫폼 클라이언트 암호 시큐어스트링 (보안 문자열) 클라이언트 암호를 입력하세요. 진실

제한 한도

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

동작

봇 사용자에게 간단한 문자 메시지 보내기

텍스트를 사용하여 봇 사용자에게 메시지 보내기
사용자 특성 만들기

봇에서 새 특성 설정
특성 값 설정

사용자 이메일 주소를 통해 특성 값 설정

봇 사용자에게 간단한 문자 메시지 보내기

작업 ID:
SimpleTextMessage

텍스트를 사용하여 봇 사용자에게 메시지 보내기

매개 변수

Name 키 필수 형식 Description
문자 메시지
 text string

여기에 문자 메시지 입력
전자 메일 주소
 recipient string

받는 사람의 전자 메일 주소

반환

Name 경로 형식 Description
외부 작업
 data ExternalActivity

사용자 특성 만들기

작업 ID:
CreateUserAttribute

봇에서 새 특성 설정

매개 변수

Name 키 필수 형식 Description
속성 이름
 name string

특성의 이름 제공
pii인가요?
 is_pii string

개인적으로 식별할 수 있는 정보인가요?

반환

Name 경로 형식 Description
UserAttribute
 data UserAttribute

사용자 특성

특성 값 설정

작업 ID:
SetUserAttribute

사용자 이메일 주소를 통해 특성 값 설정

매개 변수

Name 키 필수 형식 Description
특성을 설정하는 사용자의 전자 메일 주소
 emailaddress True string

전자 메일 주소
특성 ID
 id True string

봇의 기존 특성
value
 value string

특성 값

정의

ExternalActivity

외부 작업

UserAttribute

사용자 특성

사용자 특성

UserAttribute