Antes de incluir la configuración avanzada, publique el bot! |
Índice:
- Integration, configuration and construction of the bot in MS Teams
- Using the Developer Portal
Integración, configuración y construcción del bot en MS Teams:
1- Ejecute MS Teams en tu área de trabajo o desde el web app (https://teams.microsoft.com);
2- Ejecute la aplicación App Studio desde la barra izquierda.
3- Haz clic en "Create new app"
4- Rellene los campos siguientes con la información del bot:
Nota importante: En el campo de identification, debes hacer clic en el botón "Generate" para generar un App ID aleatorio. Este App ID es extremadamente importante para la configuración de nuestros bots y se generará de forma completamente aleatoria.
A continuación se indican los campos obligatorios y los valores utilizados:
Package name: com.microsoft.teams.app
Versión: 1.0.1 (debe rellenarse obligatoriamente en este formato con 3 cifras acompañadas de puntos. Ejemplo: 0.0.1 . Si el bot va a sufrir algún cambio, es importante actualizar el número de esta versión. Depende del creador qué números utilizará)
Nota: Rellene los campos según los datos de tu empresa.
5-Una vez hecho esto, en el menú de la izquierda, seleccione la opción Bots y haga clic en Set up.
Nota: No marques la opción "My bot is a one-way notification only bot"
- Rellene los campos obligatorios y guarde la contraseña generada, ya que será necesaria para la integración con el Blip.
- Homologación: el endpoint del bot debe ser https://hmg-abs.gw.msging.net/ [ID EXTERNA DE LA CUENTA]
- Producción: el endpoint del bot debe ser https://abs.gw.msging.net/ [ID EXTERNA DE LA CUENTA]
- Configure el ámbito de aplicación según sea necesario. Si se marcan todas las opciones, el bot se convertirá en un contacto humano en los equipos.
Conecte el bot creado en Microsoft Teams con Blip
Es necesario añadir algunos parámetros en la configuración avanzada en el Blip:
💡 El dominio debe ser postmaster@abs.gw.msging.net
- AccountExternalId: identificador externo del bot. Encuentre en el menú de detalles de la aplicación.
- ApplicationId: ID de comunicación del bot. Busque en el menú Bots.
- ApplicationPassword: contraseña generada en la creación del bot.
- AudioSentence: es la frase que aparecerá cuando el usuario recibir un audio enviado por Blip.
- DocumentSentence: es la frase que aparecerá cuando el usuario recibir un documento enviado por Blip.
- GifSentence: es la frase que aparecerá cuando el usuario recibir un gif enviado por Blip
- VideoSentence: es la frase que aparecerá cuando el usuario recibir un vídeo enviado por Blip.
- WeblinkSentence: es la frase que aparecerá cuando el usuario recibir un link enviado por Blip.
- TextButton: es la frase que aparecerá en el botón cuando el usuario reciba cualquier medio enviado por Blip.
- Descargue el bot creado en el menú: Finalizar> Probar y distribuir.
- Importe el archivo descargado. La imagen abajo muestra dónde está la opción.
Uso del Portal para desarrolladores
Acceda al enlace https://dev.teams.microsoft.com/home.
1 - Crear una aplicación
2- Incluir información básica.
El ID de la aplicación que aparece en la impresión debe considerarse como AccountExternalId.
3- Al seleccionar las funciones de la aplicación, cree un bot para la aplicación.
4- Después de elegir un nombre, pon el punto final:
https://abs.gw.msging.net/AGREGARAQUÍAccountExternalId
5- Haga clic en Secretos del cliente. Al generar el secreto, guárdelo y considérelo como ApplicationPassword.
6- Después de la creación, copie el número generado y considérelo como ApplicationId.
7- Después de estos pasos, vuelva a la selección de Aplicaciones, seleccione su aplicación y regrese al menú de características de la aplicación. Haga clic en Bot nuevamente y seleccione la aplicación que acaba de crear.
Seleccione la opción Subir y descargar archivos
8- Después de guardar, continúe en las funciones de la aplicación y agregue la aplicación Grupo y canal.
La URL debe ser la misma que la ingresada en el paso 4.
9- Después de guardar, continúa con las funciones de la aplicación y agrega Mensaje y Extensión.
Seleccione el mismo bot que se creó y guardó.
10 - Foto demostrativa de las gestiones realizadas.
11- Haz clic en Publicar en la tienda. Asegúrese de que todo esté bien y descargue su paquete.
12 - Importar el archivo descargado. La siguiente imagen muestra dónde está la opción.
Nota: Recuerde que AccountExternalId (Paso 2), ApplicationId (Paso 6) y ApplicationPassword (Paso 5) son los descritos anteriormente.
- Conecte el bot que se creó en Microsoft Teams con Blip.
- Es necesario agregar algunos parámetros en la configuración avanzada en Blip:
💡 El dominio debe ser postmaster@abs.gw.msging.net
AccountExternalId: identificador externo del bot. (paso 2)
ApplicationId: ID de comunicación del bot. (paso 6)
- ApplicationPassword: contraseña generada al crear el bot.
- AudioSentence: es la frase que aparecerá cuando el usuario reciba un audio enviado por Blip.
- DocumentSentence: es la frase que aparecerá cuando el usuario reciba un documento enviado por Blip.
- GifSentence: es la frase que aparecerá cuando el usuario reciba un gif enviado por Blip.
- VideoSentence: es la oración que aparecerá cuando el usuario reciba un video enviado por Blip.
- WeblinkSentence: es la frase que aparecerá cuando el usuario reciba un enlace enviado por Blip.
- TextButton: es la frase que aparecerá en el botón cuando el usuario reciba algún medio enviado por Blip.
Elementos compatibles
Los siguientes elementos se comportan igual en Blip:
- Texto;
- Emoción;
- Imagen;
- Composición;
- Carrusel.
- Si desea utilizar la carga útil, solo se acepta application/json.
- Si no desea utilizar la carga útil, elija enlace web o título de texto únicamente.
- El carrusel admite 10 tarjetas por mensaje.
- Menú.
- El menú no coloca sus botones verticalmente. Microsoft Teams llena todo el espacio horizontal para romper la línea.
- Si desea utilizar la carga útil, solo se acepta application/json.
- Si no desea utilizar la carga útil, elija enlace web o título de texto únicamente.
Elementos sin apoyo
Los siguientes elementos no son compatibles:
- Ubicación
Elementos adaptados
Los siguientes elementos no son compatibles de forma nativa. Era necesaria una adaptación para una mejor experiencia de usuario:
- Video;
- Audio;
- Documento;
- Respuesta rápida;
- Enlace web.
Estos elementos se enviarán en la misma plantilla a continuación:
1ª Obs.: el botón abre el contenido multimedia enviado.
2º Obs.: La frase que se mostrará será la misma configurada en el Blip.
La respuesta rápida se comporta igual que el menú, donde las opciones no se ocultan después de que el usuario las elija.
Para obtener más información, acceda a la discusión sobre el tema en nuestra comunidad o los videos en nuestro canal. 😃