La plataforma bot (versión preliminar)
Conexión de los bots de Bot Platform a cualquier aplicación, envío de mensajes a usuarios del bot, establecimiento de valores de atributo mediante los bots existentes en The Bot Platform
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Compatibilidad con la plataforma de bots |
| URL | https://thebotplatform.com/contact/ |
| Correo Electrónico | hello@thebotplatform.com |
| Metadatos del conector | |
|---|---|
| Publicador | La plataforma de bots |
| Sitio web | https://thebotplatform.com |
| Directiva de privacidad | https://thebotplatform.com/privacy-policy/ |
| Categorías | Comunicación; Sitio web |
El conector de Bot Platform le permitirá usar datos de los flujos de Power Automate para enviar mensajes a los usuarios del bot, crear nuevos atributos y establecer valores para los atributos existentes. El conector aprovecha nuestra API para realizar todas estas acciones, sin tener que configurar las llamadas API manualmente, sino simplemente usar el conector para realizar acciones de API más rápido.
Prerrequisitos
Necesitará una cuenta en The Bot Platform
Obtención de credenciales
Después de iniciar sesión en The Bot Platform CMS, vaya al bot que desea conectar. Haga clic en "Acceso a API" en el menú de la barra lateral y cree una nueva aplicación de integración. Se le proporcionará un identificador de cliente y una clave secreta, escriba esta información en Power Automate, donde usa el conector para autenticar el bot con Power Automate.
Introducción al conector
Después de iniciar sesión en la cuenta, vaya al bot que desea integrar y haga clic en "Acceso a API" para obtener el identificador de cliente y la clave secreta. Después de obtener esta información, cree un nuevo flujo de Power Automate, se le pedirá que escriba el identificador de cliente y la clave secreta allí. Después de escribir esta información, aparecerá un elemento emergente que solicita permiso para acceder al bot. ¡Pulsa 'Permitir' y estás listo!
Problemas y limitaciones conocidos
- Actualmente, los usuarios solo se pueden identificar a través de la dirección de correo electrónico para poder comunicar información al bot.
- No se puede enviar una dirección URL de imagen mediante la operación de mensaje de texto simple.
Errores y soluciones comunes
En el caso de los bots instalados en Microsoft Teams, no puede enviar un mensaje a un usuario que no haya interactuado previamente con el bot. La solución alternativa sería enviar una difusión al usuario desde dentro de la plataforma antes de usar el conector para enviar un mensaje.
Preguntas más frecuentes
Para obtener más información sobre nuestros casos de uso, visite nuestra página Dev Docs.
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Id. de cliente: el clientId de la plataforma de bots | cuerda / cadena | Escriba el identificador de cliente. | Cierto |
| Secreto de cliente de La plataforma de bots | securestring | Escriba el secreto de cliente. | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Creación de un atributo de usuario |
Configuración de un nuevo atributo en el bot |
| Envío de un mensaje de texto simple a un usuario de bot |
Envío de un mensaje a un usuario de bot mediante texto |
| Establecimiento de un valor de atributo |
Establecimiento de un valor de atributo a través de la dirección de correo electrónico de los usuarios |
Creación de un atributo de usuario
Configuración de un nuevo atributo en el bot
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre del atributo
|
name | string |
Proporcione un nombre para el atributo. |
|
|
¿es pii?
|
is_pii | string |
¿Es información de identificación personal? |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
UserAttribute
|
data | UserAttribute |
Atributo de usuario |
Envío de un mensaje de texto simple a un usuario de bot
Envío de un mensaje a un usuario de bot mediante texto
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
texto
|
text | string |
Escriba el mensaje de texto aquí. |
|
|
dirección de correo electrónico
|
recipient | string |
dirección de correo electrónico del destinatario |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Actividad externa
|
data | ExternalActivity |
Establecimiento de un valor de atributo
Establecimiento de un valor de atributo a través de la dirección de correo electrónico de los usuarios
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
dirección de correo electrónico del usuario que se está configurando el atributo
|
emailaddress | True | string |
dirección de correo electrónico |
|
Id. de atributo
|
id | True | string |
Atributos existentes en el bot |
|
value
|
value | string |
valor de atributo |