En este artículo, aprenderá cómo integrar Microsoft Teams en la plataforma Botmaker.

Lectura estimada: 08 minutos

Microsoft Teams es una plataforma de comunicación y colaboración unificada. Combina funciones de chat y videollamadas, almacenamiento de archivos con posibilidad de trabajo colaborativo e integración de aplicaciones. La integración nativa en la plataforma Botmaker le permite lo siguiente:

• Potencia el trabajo y la comunicación de tus equipos.
• Cree diferentes bots para casos de uso especiales.

¿Cómo hacer la integración?

Para integrarse, vaya aMenú > Configuración > Canales (https://go.botmaker.com/#/integrations/channels) y seleccione Microsoft Teams.

Luego haga clic Para conectar para comenzar el tutorial de integración. Verás la siguiente pantalla, donde debes hacer clic Iniciar.

Recuerda que para conectar un bot a Microsoft Teams, deberás cumplir con los siguientes requisitos:

• Tener una licencia de Microsoft Teams y ser administrador de cuentas
• Tener descargada la aplicación Microsoft Authenticator en su teléfono celular. Lo necesitará para autenticar su cuenta de Microsoft Teams.
• Cree una aplicación desde Microsoft Teams. Las aplicaciones conectan Teams con cualquier otro software que utilices, como Botmaker, por ejemplo.

Paso 1: Habilite las aplicaciones

Para habilitar las aplicaciones, vaya ahttps://admin.teams.microsoft.com. Después de acceder, vaya a Aplicaciones de Teams > Políticas de configuración.

En Administrar políticas, seleccionar Global y Upload custom apps moviendo el botón a la posición ON, tal y como aparece en la imagen.

Luego haga clic en el botón Save que está debajo de la pantalla.

Nota: al completar cada paso del tutorial, haga clic en Siguiente para continuar con la integración.

Paso 2: crea una aplicación

Para crear una aplicación de Teams, Inicie sesión con su cuenta en la aplicación Teams.Luego ingresa a la sección Aplicaciones desde la barra lateral. Utilice el buscador para encontrar la aplicación. Developer Portal. Descárgalo o ábrelo.Abra Apps, clickea en Create a new app o en +New App si ya tienes otras aplicaciones creadas. Elija un nombre y haga clic para agregar.

Paso 3: Completa los detalles de tu aplicación

En App details, deberás completar una serie de pasos con datos sobre tu App.

• En Descriptions, completa los campos con *.
• En Developer Information, completa los campos con *.
• En App URLs, completa los campos con * (recuerda escribir la dirección poniendo https:// en la URL).
• No es necesario completar ID de aplicación (cliente)*.

Cuando esté completo, haga clic Save.

• Luego ve a Configurar/Branding en la barra lateral y cargue las imágenes solicitadas.

Paso 4: crea tu bot

Continúe la interacción realizando los siguientes procedimientos:

• Ir a Tools, clickea en Bot management y luego en Create your first bot o en +New Bot si ya has creado otros chatbots. Escribe un nombre para tu bot y haz clic para agregar.

Nota: con el bot creado, verás el nombre y el ID. Copia los dos datos y pégalos en un bloc de notas, ya que los necesitarás en el último paso.

• Entrarás al bot creado y, en el Configure, debes completar el campo Bot Endpoint Address pegando la siguiente dirección:https://go.botmaker.com/rest/msbotfwk. Después de pegar, haga clic Save.

Paso 5: Obtenga el secreto de su cliente

En la barra lateral, vaya a Secreto del cliente y haga clic en Add a client secret for your bot ,verás un código. Cópialo y pégalo en un bloc de notas, porque lo necesitarás en el paso final.

Paso 6: configura tu bot

Volver a la pestaña Apps y selecciona tu aplicación.Configure/App features, seleccione la característica Bot.

En Identify your bot, seleccionar:

• Select an existing bot y buscar su bot en la lista

En What can your bot do?, seleccionar:

• Cargar y descargar archivos

En Select the scopes in which people can use this command, seleccionar:

• Personal
• equipos

Luego haga clic Save.

Paso 7: publica tu bot

Puedes publicar tu bot a través de App o el site siguiente paso a paso:

• En la aplicación Microsoft Teams: vaya a Publish/Public to Org y haga clic Publish your app
• Luego acceda al siguiente enlace utilizando un navegador:https://admin.teams.microsoft.com/policies/manage-apps

En la pantalla que se abre verás que hay una app pendiente de aprobación. Búscalo por el nombre que le diste en la lista a continuación. Haga click en la aplicación.

• Se abrirá una ventana emergente. Compruebe si el la aplicación seleccionada es la correcta. copia App Id que aparece en los detalles.

Nota: Copie y pegue el número que se muestra, ya que lo necesitará en el paso final.

Luego haga clic en el botón Publishy cuando aparezca el mensaje de confirmación dale clic nuevamente Publish.

Paso 8: otorgar permisos al bot

Para otorgar permisos al bot, debe iniciar sesión en el Portal Azure a través de este enlace:https://aad.portal.azure.com/#view/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/~/RegisteredApps

Al iniciar sesión en Azure,seleccione su aplicación.

Ir a Manage/API permissions y luego haga clic +Add a permission.

Selecciona el API de Microsoft Graph y la opción Application permissions. Allí deberás buscar y agregar, uno a uno, los siguientes permisos:

• User.Read.All
• TeamsApplnstallation.ReadWriteForUser.All
• Chat.ReadBasic.All

Finalmente seleccione la opción:

• doneGrant admin consent for Botmaker

Paso 9: integrar con Botmaker

Pega los datos que copiaste en el bloc de notas en los pasos anteriores:

• Bot name
• Bot ID
• Client secret
• App ID

Por último, haga clic +Conectar Microsoft Teams

Para ver los detalles de integración de su Teams que ya están conectados, vaya a https://go.botmaker.com/#/integrations/channels, seleccionar Microsoft Teams y hacer clic Para configurar.

¡Listo! Integraste el MS Teams ¡Con Botmaker para mejorar el trabajo y la comunicación de tus equipos! Recuerda visitar nuestro Central de Ayuda para más informaciones.

Escrito por: Equipo Botmaker

Actualizado: 08/02/2024