ボット プラットフォーム (プレビュー)

Bot Platform のボットを任意のアプリケーションに接続し、ボット ユーザーにメッセージを送信し、Bot Platform で既存のボットを使用して属性値を設定する

このコネクタは、次の製品とリージョンで使用できます。

サービス	クラス	リージョン
コピロット スタジオ	Premium	次を除くすべての Power Automate リージョン :      - 米国政府 (GCC)      - 米国政府 (GCC High)      - 21Vianet が運営する China Cloud      - 米国国防総省 (DoD)
ロジック アプリ	Standard	次を除くすべての Logic Apps リージョン :      - Azure Government リージョン      - Azure China リージョン      - 米国国防総省 (DoD)
Power Apps	Premium	次を除くすべての Power Apps リージョン :      - 米国政府 (GCC)      - 米国政府 (GCC High)      - 21Vianet が運営する China Cloud      - 米国国防総省 (DoD)
Power Automate	Premium	次を除くすべての Power Automate リージョン :      - 米国政府 (GCC)      - 米国政府 (GCC High)      - 21Vianet が運営する China Cloud      - 米国国防総省 (DoD)

お問い合わせ
名前	ボット プラットフォームのサポート
URL	https://thebotplatform.com/contact/
Email	hello@thebotplatform.com

コネクタ メタデータ
Publisher	ボット プラットフォーム
Web サイト	https://thebotplatform.com
プライバシー ポリシー	https://thebotplatform.com/privacy-policy/
カテゴリ	通信;ウェブサイト

Bot Platform コネクタを使用すると、Power Automate フローのデータを使用して、ボット内のユーザーにメッセージを送信し、新しい属性を作成し、既存の属性の値を設定できます。 コネクタでは、API を利用してこれらすべてのアクションを実行します。API 呼び出しを手動で設定する必要はありません。代わりに、コネクタを使用して API アクションをより迅速に実行します。

[前提条件]

Bot Platform でアカウントが必要になります

資格情報を取得する方法

The Bot Platform CMS にログインしたら、接続するボットに移動します。 サイドバー メニューで [API Access] をクリックし、新しい統合アプリを作成します。 クライアント ID とシークレット キーが提供されます。Power Automate でこの情報を入力します。この情報は、コネクタを使用して Power Automate でボットを認証する場所です。

コネクタの概要

アカウントにログインしたら、統合するボットに移動し、[API Access] をクリックしてクライアント ID とシークレット キーを取得します。 この情報を取得した後、新しい Power Automate Flow を作成すると、そこにクライアント ID とシークレット キーを入力するように求められます。 この情報を入力すると、ボットにアクセスするためのアクセス許可を求めるポップアップが表示されます。 「許可」を押して、あなたはすべて設定されています!

既知の問題と制限事項

• 現在、ユーザーは電子メール アドレスを介してのみ識別でき、ボットに情報を伝えることができます。
• 単純なテキスト メッセージ操作を使用してイメージ URL を送信することはできません。

一般的なエラーと解決方法

Microsoft Teamsにインストールされているボットの場合、以前にボットと対話していないユーザーにメッセージを送信することはできません。 回避策は、コネクタを使用してメッセージを送信する前に、まずプラットフォーム内からユーザーにブロードキャストを送信することです。

FAQ

ユース ケースの詳細については、Dev Docs のページを参照してください。

接続を作成する

コネクタでは、次の認証の種類がサポートされています。

デフォルト	接続を作成するためのパラメーター。	すべてのリージョン	共有不可

デフォルト

適用対象: すべてのリージョン

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

名前	タイプ	Description	必須
クライアント ID - ボット プラットフォームの clientId	文字列	クライアント ID を入力してください。	正しい
ボット プラットフォーム クライアント シークレット	securestring	クライアント シークレットを入力してください。	正しい

調整制限

名前	呼び出し	更新期間
接続ごとの API 呼び出し	100	60 秒

アクション

ボット ユーザーに簡単なテキスト メッセージを送信する	テキストを使用してボット ユーザーにメッセージを送信する
ユーザー属性を作成する	ボットで新しい属性を設定する
属性値を設定する	ユーザーのメール アドレスを使用して属性値を設定する

ボット ユーザーに簡単なテキスト メッセージを送信する

操作 ID:

SimpleTextMessage

テキストを使用してボット ユーザーにメッセージを送信する

パラメーター

名前	キー	必須	型	説明
SMS 送信	text		string	テキスト メッセージをここに入力します
メール アドレス	recipient		string	受信者のメール アドレス

戻り値

名前	パス	型	説明
外部アクティビティ	data	ExternalActivity

ユーザー属性を作成する

操作 ID:

CreateUserAttribute

ボットで新しい属性を設定する

パラメーター

名前	キー	必須	型	説明
属性名	name		string	属性の名前を指定する
pii ですか?	is_pii		string	個人を特定できる情報ですか?

戻り値

名前	パス	型	説明
UserAttribute	data	UserAttribute	ユーザー属性

属性値を設定する

操作 ID:

SetUserAttribute

ユーザーのメール アドレスを使用して属性値を設定する

パラメーター

名前	キー	必須	型	説明
属性が設定されているユーザーの電子メール アドレス	emailaddress	True	string	メール アドレス
属性 ID	id	True	string	ボット内の既存の属性
value	value		string	属性値

定義

ExternalActivity

外部アクティビティ

UserAttribute

ユーザー属性

ユーザー属性

UserAttribute