A Plataforma Bot (Pré-visualização)
Conecte os bots da The Bot Platform a qualquer aplicativo, envie mensagens para usuários de bots, defina valores de atributos usando seus bots existentes na The Bot Platform
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Premium | Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Automatize o poder | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | O suporte da plataforma Bot |
| URL | https://thebotplatform.com/contact/ |
| hello@thebotplatform.com |
| Metadados do conector | |
|---|---|
| Editora | A plataforma Bot |
| Sítio Web | https://thebotplatform.com |
| Política de privacidade | https://thebotplatform.com/privacy-policy/ |
| Categorias | Comunicação; Sítio Web |
O conector da Plataforma 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 de API manualmente, em vez disso, basta usar o conector para executar ações de API mais rapidamente.
Pré-requisitos
Você precisará de uma conta na Plataforma Bot
Como obter credenciais
Depois de fazer login no CMS da Plataforma de Bot, vá para o bot que você deseja conectar. Clique em 'API Access' no menu lateral e crie um novo aplicativo de integração. Ser-lhe-á fornecido um ID de cliente e uma chave secreta, introduza esta informação no Power Automate onde está a utilizar o seu conector para autenticar o bot com o Power Automate.
Introdução ao conector
Depois de entrar na sua conta, vá para o bot que você deseja integrar e clique em 'API Access' para obter seu ID de cliente e chave secreta. Depois de obter essas informações, crie um novo Power Automate Flow, você será solicitado a inserir o ID do cliente e a chave secreta lá. Depois de inserir essas informações, um pop-up aparecerá pedindo permissão para acessar o bot. Clique em 'Permitir' e está tudo pronto!
Problemas conhecidos e limitações
- Atualmente, os usuários só podem ser identificados através do endereço de e-mail para poder comunicar informações de volta ao bot.
- Não é possível enviar um url de imagem usando a operação de mensagem de texto simples.
Erros e soluções comuns
Para bots instalados no Microsoft Teams, não é possível enviar uma mensagem para um usuário que não tenha interagido 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.
FAQ
Para obter mais informações sobre nossos casos de uso, visite nossa página de Dev Docs
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Predefinição | 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.
Esta conexão não é compartilhável. Se o aplicativo avançado 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 - Seu clientId da plataforma de bot | cadeia (de caracteres) | Introduza o ID do seu cliente. | Verdade |
| Seu segredo do cliente da plataforma Bot | securestring | Introduza o segredo do cliente. | Verdade |
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Criar um atributo de usuário |
Configurar um novo atributo no bot |
| Definir um valor de atributo |
Definir um valor de atributo através do endereço de e-mail 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 no bot
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome do atributo
|
name | string |
Forneça um nome para seu atributo |
|
|
É PII?
|
is_pii | string |
É informação pessoal identificável? |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
UserAttribute
|
data | UserAttribute |
Atributo do usuário |
Definir um valor de atributo
Definir um valor de atributo através do endereço de e-mail dos usuários
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
endereço de e-mail do usuário cujo atributo está sendo definido
|
emailaddress | True | string |
endereço de correio eletrónico |
|
ID do atributo
|
id | True | string |
Atributos existentes no bot |
|
valor
|
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
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
enviar SMS
|
text | string |
Introduza a sua mensagem de texto aqui |
|
|
endereço de correio eletrónico
|
recipient | string |
endereço de e-mail do destinatário |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Atividade Externa
|
data | ExternalActivity |