¿Cómo integrar Microsoft Teams con Botmaker?

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

Lectura estimada: 08 minutos

Microsoft Teams es una plataforma unificada de comunicación y colaboración. Combina funcionalidades 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 te posibilitará realizar lo siguiente:

  • Potenciar el trabajo y la comunicación de tus equipos.
  • Crear distintos bots para casos de uso especiales.

¿Cómo realizar la integración?

Para realizar la integración, ingresa a Menú> Configuración>Canales (https://go.botmaker.com/#/integrations/channels) y selecciona Microsoft Teams.

01

02

Luego, haz clic en Conectar para iniciar el tutorial de la integración. Verás la siguiente pantalla, donde debes hacer clic en Comenzar.

Ten en cuenta que, para conectar un bot en Microsoft Teams, debes cumplir con los siguientes requisitos:

  • Contar con una licencia de Microsoft Teams y ser administrador/a de la cuenta.

  • Tener descargada la App Microsoft Authenticator en tu teléfono móvil. La necesitarás para autenticar tu cuenta de Microsoft Teams.

  • Crear una aplicación desde Microsoft Teams. Las aplicaciones conectan con Teams cualquier otro software que uses, por ejemplo, Botmaker.

03

04

Paso 1: Habilita las aplicaciones

Para habilitar las aplicaciones, ingresa en https://admin.teams.microsoft.com/.

Una vez allí, dirígete a Teams Apps > Setup Policies.

En Manage policies, selecciona Global y activa Upload custom apps moviendo el switch a la posición ON, tal como ves en la imagen.

Luego, haz clic en el botón Save que se encuentra debajo de la pantalla.

Nota: Al completar cada paso del tutorial, cliquea en Siguiente para avanzar con la integración.

05

06

Paso 2: Crea una app

Para crear una App de Teams, inicia sesión con tu cuenta en la aplicación Teams.

A continuación, dirígete a la sección Apps de la barra lateral. Utiliza el buscador para encontrar la aplicación Developer Portal. Agrégala o ábrela.

En la pestaña Apps, haz clic en Create a new app o en +New App si ya tienes creadas otras apps. Elige un nombre y haz clic en Agregar.

07

08

Paso 3: Completa los detalles de tu app

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

  • En Descriptions, completa los campos con *.
  • En Developer Information, completa los campos con *.
  • En App URLs, completa los campos con * (recuerda poner la dirección anteponiendo https:// a la url)
  • No es necesario que completes Application (client) ID*.

Una vez completo, haz clic en Save

  • Luego ve a Configure/Branding en la barra lateral y sube las imágenes que te solicitan.

09

10

Paso 4: Crea tu bot

Continúa la integración siguiendo los siguientes procedimientos:

  • Dirígete a Tools, haz clic en Bot management y haz clic en Create your first bot o en +New Bot si ya has creado otros. Ponle un nombre y haz clic en Agregar.

Nota: Una vez creado el bot, verás el nombre y el ID. Copia ambos datos y pégalos en un block de notas. Los necesitarás en el paso final.

  • Entrarás al bot que has creado y en la parte de Configure deberás llenar el campo de Bot Endpoint Address pegando la siguiente dirección: https://go.botmaker.com/rest/msbotfwk. Una vez pegado, haz clic en Save.

11

12

Paso 5: Obtén tu Client Secret

Dirígete a Client Secret en la barra lateral y haz clic en Add a client secret for your bot.

Visualizarás un código. Cópialo en un bloc de notas, ya que lo necesitarás en el paso final.

Siguiente

13

14

Paso 6: Configura tu bot

Regresa a la solapa Apps y selecciona tu App. En Configure/App features, selecciona el feature Bot.

En Identify your bot selecciona:

Select an existing bot y busca tu bot en el listado

En What can your bot do? selecciona:

Upload and download files

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

Personal

Teams

Luego haz clic en Save

15

16

Paso 7: Publica tu bot **

Para publicar tu bot, deberás hacerlo desde la App y desde el website. Sigue los pasos a continuación:

En la pantalla que se abre, verás que hay una app pendiente de aprobación. Búscala por el nombre que le diste en el listado que está debajo. Haz clic en ella.

  • Se abrirá un pop-up. Chequea que sea la App correcta. Copia el App Id que aparece en los detalles.

Nota: Copia y guarda el número que te muestra, ya que lo necesitarás en el paso final.

Luego haz clic en el botón Publish y cuando aparezca el mensaje de confirmación vuelve a hacer clic en Publish.

17

18

Paso 8: Otorga permisos al bot

Para otorgarle permisos al bot, deberás ingresar al Portal Azure desde este link: https://aad.portal.azure.com/#view/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/~/RegisteredApps

Una vez en Azure, selecciona tu App.

Ve a Manage/API permissions y luego haz clic en + Add a permission.

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

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

Finalmente, tilda la opción:

doneGrant admin consent for Botmaker

19

20

Paso 9: Integra a Botmaker

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

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

Finalmente, haz clic en +Conectar Microsoft Teams

21

22

23

Para ver los detalles de la integración de las cuentas de Teams que ya tienes conectadas, ve a https://go.botmaker.com/#/integrations/channels, selecciona Microsoft Teams y haz clic en Configurar.

24

¡Listo! Ya has integrado MS Teams con Botmaker para potenciar el trabajo y la comunicación de tus equipos! Recuerda visitar nuestro Centro de Ayuda para mayor información.

Escrito por: Equipo Botmaker

Actualizado: 27/12/2022

Articulos relacionados

Tags

Información de Botmaker
Integración de canales