A Plataforma de Bot (versão prévia)
Conecte os bots da Plataforma bot a qualquer aplicativo, envie mensagens para usuários de bot, defina valores de atributo usando seus bots existentes na Plataforma de Bot
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | O suporte à plataforma de bot |
| URL | https://thebotplatform.com/contact/ |
| hello@thebotplatform.com |
| Metadados do conector | |
|---|---|
| Publicador | A Plataforma de Bot |
| Site | https://thebotplatform.com |
| Política de privacidade | https://thebotplatform.com/privacy-policy/ |
| Categorias | Comunicação; Site |
O conector da Plataforma de Bot permitirá que você use dados de seus fluxos do Power Automate para enviar mensagens aos usuários no bot, criar novos atributos e definir valores para atributos existentes. O conector aproveita nossa API para executar todas essas ações, sem que você precise configurar chamadas à API manualmente, em vez disso, use apenas o conector para executar ações de API com mais rapidez.
Pré-requisitos
Você precisará de uma conta na Plataforma de Bot
Como obter credenciais
Depois de fazer logon no CMS da Plataforma de Bot, acesse o bot que você deseja conectar. Clique em "Acesso à API" no menu da barra lateral e crie um novo aplicativo de integração. Você receberá uma ID do cliente e uma chave secreta, insira essas informações no Power Automate em que você está usando o conector para autenticar o bot com o Power Automate.
Introdução ao conector
Depois de fazer logon em sua conta, vá para o bot que você deseja integrar e clique em "Acesso à API" para obter a ID do cliente e a chave secreta. Depois de obter essas informações, crie um novo Fluxo do Power Automate, você será solicitado a inserir a ID do cliente e a chave secreta lá. Depois de inserir essas informações, um pop-up aparecerá solicitando permissão para acessar o bot. Clique em "Permitir" e você está pronto!
Problemas conhecidos e limitações
- Atualmente, os usuários só podem ser identificados por meio do endereço de email para poder comunicar informações de volta ao bot.
- Você não pode enviar uma URL de imagem usando a operação de mensagem de texto simples.
Erros e soluções comuns
Para bots instalados no Microsoft Teams, você não pode enviar uma mensagem para um usuário que não interagiu anteriormente com o bot. A solução alternativa seria enviar uma transmissão para o usuário de dentro da plataforma primeiro antes de usar o conector para enviar uma mensagem.
perguntas frequentes
Para obter mais informações sobre nossos casos de uso, visite nossa página do Dev Docs
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| ID do cliente – Sua ClientId da Plataforma de Bot | cadeia | Insira sua ID do cliente. | Verdade |
| Seu segredo do cliente da plataforma de bot | secureString | Insira o segredo do cliente. | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Criar um atributo de usuário |
Configurar um novo atributo em seu bot |
| Definir um valor de atributo |
Definir um valor de atributo por meio do endereço de email dos usuários |
| Enviar uma mensagem de texto simples para um usuário de bot |
Enviar uma mensagem para um usuário de bot usando texto |
Criar um atributo de usuário
Configurar um novo atributo em seu bot
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do atributo
|
name | string |
Forneça um nome para seu atributo |
|
|
é pii?
|
is_pii | string |
são informações de identificação pessoal? |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
UserAttribute
|
data | UserAttribute |
Atributo de usuário |
Definir um valor de atributo
Definir um valor de atributo por meio do endereço de email dos usuários
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
endereço de email do usuário que o atributo está sendo definido
|
emailaddress | True | string |
|
|
ID do atributo
|
id | True | string |
Atributos existentes no bot |
|
value
|
value | string |
valor do atributo |
Enviar uma mensagem de texto simples para um usuário de bot
Enviar uma mensagem para um usuário de bot usando texto
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
enviar SMS
|
text | string |
Insira sua mensagem de texto aqui |
|
|
email
|
recipient | string |
endereço de email do destinatário |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Atividade externa
|
data | ExternalActivity |