The Bot Platform (プレビュー)
The Bot Platform のボットを任意のアプリケーションに接続し、ボット ユーザーにメッセージを送信し、The Bot Platform の既存のボットを使用して属性値を設定します
このコネクタは、次の製品および地域で利用可能です:
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 国防総省 (DoD) |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| お問い合わせ先 | |
|---|---|
| 件名 | The Bot Platform のサポート |
| [URL] | https://thebotplatform.com/contact/ |
| メール | hello@thebotplatform.com |
| Connector Metadata | |
|---|---|
| 発行者 | The Bot Platform |
| Web サイト | https://thebotplatform.com |
| プライバシー ポリシー | https://thebotplatform.com/privacy-policy/ |
| カテゴリー | 通信; Web サイト |
The Bot Platform コネクタを使用すると、Power Automate フローのデータを使用して、ボット内のユーザーにメッセージを送信したり、新しい属性を作成したり、既存の属性の値を設定したりできます。 コネクタは API を活用してこれらすべてのアクションを実行します。API 呼び出しを手動で設定する必要はなく、代わりにコネクタを使用するだけで API アクションをより速く実行できます。
前提条件
The Bot Platform のアカウントが必要です
資格情報の入手方法
The Bot Platform CMS にログインした後、接続するボットに移動します。 サイドバー メニューの API アクセスをクリックし、新しい統合アプリを作成します。 クライアント ID と秘密キーが提供されるので、コネクタを使用して Power Automate とボットを認証する Power Automate にこの情報を入力します。
コネクタの使用を開始する
アカウントにログインした後、統合するボットに移動し、API アクセスをクリックしてクライアント ID と秘密キーを取得します。 この情報を取得した後、新しい Power Automate フローを作成すると、そこでクライアント ID と秘密キーを入力するように求められます。 この情報を入力すると、ボットへのアクセス許可を求めるポップアップが表示されます。 '許可' を押すと準備完了です。
既知の問題と制限事項
- 現在、ユーザーはメール アドレスによってのみ識別され、ボットに情報を送信できます。
- 単純なテキスト メッセージ操作を使用して画像 URL を送信することはできません。
一般的なエラーと解決策
Microsoft Teams にインストールされているボットの場合、以前にボットと対話したことがないユーザーにメッセージを送信することはできません。 回避策は、コネクタを使用してメッセージを送信する前に、まずプラットフォーム内からユーザーにブロードキャストを送信することです。
よくあるご質問
ユースケースの詳細については、 開発ドキュメント ページ をご覧ください
接続を作成する
このコネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | Description | Required |
|---|---|---|---|
| クライアント ID - あなたはボット プラットフォームの clientId | string | 自分のクライアント ID を入力してください。 | True |
| 自分の The Bot Platform クライアント シークレット | securestring | クライアント シークレットを入力してください。 | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| ボット ユーザーに簡単なテキスト メッセージを送信する |
テキストを使用してボット ユーザーにメッセージを送信する |
| ユーザー属性の作成 |
ボットに新しい属性を設定する |
| 属性値を設定する |
ユーザーのメールアドレスを介して属性値を設定します |
ボット ユーザーに簡単なテキスト メッセージを送信する
テキストを使用してボット ユーザーにメッセージを送信する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
text
|
text | string |
ここにテキストメッセージを入力します |
|
|
メール アドレス
|
recipient | string |
受信者のメール アドレス |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
外部アクティビティ
|
data | ExternalActivity |
ユーザー属性の作成
ボットに新しい属性を設定する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Attribute name
|
name | string |
自分の属性の名前を提供する |
|
|
pii ですか?
|
is_pii | string |
個人を特定できる情報ですか? |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
UserAttribute
|
data | UserAttribute |
ユーザー属性 |
属性値を設定する
ユーザーのメールアドレスを介して属性値を設定します
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
属性が設定されているユーザーのメール アドレス
|
emailaddress | True | string |
メール アドレス |
|
属性 ID
|
id | True | string |
ボット内の既存の属性 |
|
価値
|
value | string |
属性の値 |