Creación de un canal de Microsoft Teams
Creación de una Aplicación en Azure
- Para crear tu aplicación de bot, dirígete a https://portal.azure.com/. Necesitarás crear una cuenta si aún no tienes una.
- Después de iniciar sesión en tu cuenta, selecciona Crear un recurso.
- Busca Azure Bot en el cuadro de búsqueda.
- Selecciona Azure Bot en el marketplace.
- Selecciona Crear.
- Ingresa el nombre identificador para el bot en el campo de identificación.
- Selecciona tu firma de la lista; por defecto, parecerá una firma ya creada.
- Selecciona tu grupo de recursos o crea uno nuevo.
- Si deseas crear un grupo de recursos, selecciona Crear Nuevo, ingresa el nombre del recurso, selecciona Aceptar y elige la ubicación requerida en la lista desplegable de Ubicación del Nuevo Grupo de Recursos.
Selecciona el tipo de aplicación; se recomienda multiinquilino. Luego, selecciona Revisar + Crear.
- Selecciona Crear si la validación es aprobada. Tomará unos momentos para que tu servicio de bot sea aprovisionado.
- Selecciona Ir al recurso. ¡Ahora tu aplicación está creada!
Para crear el secreto de cliente
- Desde Configuración, selecciona Configuración. Guarda el ID de aplicación de Microsoft (ID de cliente) para referencia futura.
- Selecciona Administrar junto al ID de aplicación de Microsoft.
- En la sección Secretos de Cliente, selecciona Nuevo Secreto de Cliente. Aparecerá la ventana Agregar un Secreto de Cliente.
- Ingresa una Descripción y un período para la expiración del secreto, luego selecciona Agregar.
- Selecciona Copiar al portapapeles en la columna de Valor y guarda el ID del secreto de cliente para referencia futura.
- Necesitas buscar un dato más que necesitarás para la creación del canal en la plataforma de Weni. Para hacerlo, regresa a Inicio y selecciona tu bot. Ve a Información general en el menú de la izquierda y luego selecciona Vista JSON. Se abrirá un JSON con información sobre tu aplicación; busca el tenant id y guarda el valor.
Para agregar el canal de Microsoft Teams
- Ve a Inicio.
- En la sección de Recursos Recientes, abre tu bot.
- Selecciona Canales en el panel de la izquierda y elige Microsoft Teams de la lista de canales disponibles.
Configurar el perfil del bot
- Si deseas configurar el perfil del bot, en tu bot ve a Perfil del Bot en el menú de la izquierda y configúralo como desees. Puedes agregar fotos de perfil y otra información.
Para agregar el canal de Microsoft Teams a tu bot
- Selecciona la casilla para aceptar los términos de servicio y selecciona Aceptar.
- Selecciona Guardar.
Creación de un Canal en la Plataforma de Weni
- Después de iniciar sesión en la plataforma, elige tu organización y proyecto, y ve a Configuración.
- Selecciona Agregar Canal.
- En la lista de canales, selecciona Teams.
- Para conectar un canal, necesitarás la información sobre la aplicación que creaste anteriormente (nombre del bot, id del bot, id de la aplicación, contraseña de la aplicación y tenant id).
- Ingresa el nombre que diste a tu bot al crear la aplicación en el campo Nombre del Bot.
- En Id del Bot ingresa el ID de Aplicación que guardaste anteriormente al crear la aplicación.
- En Id de Aplicación ingresa el ID de Aplicación nuevamente.
- En Contraseña de la Aplicación ingresa el Secreto de Cliente que creaste anteriormente.
- En Tenant id ingresa el valor de tenant id que guardaste anteriormente.
- Ahora haz clic en Enviar.
- ¡Ahora tu canal está creado!
- En la página del canal a la que serás dirigido justo después de hacer clic en Enviar, tendrás el ID de ese canal, necesitaremos ese valor. Para obtenerlo, puedes copiar el ID largo que aparece al final de la URL de esta página. Después de leer/copiar todo este ID compuesto de números, letras y guiones, guárdalo.
Configurar el Endpoint en la Aplicación
- Regresa a Azure, en Inicio selecciona tu bot en Recursos Recientes y luego ve a Configuración en el menú de la izquierda.
- En Endpoint, agrega la URL de abajo; en [CHANNEL ID] coloca el ID que guardaste en el paso anterior.
https://new.push.al/c/tm/[CHANNEL ID]/receive
Ejemplo: https://new.push.al/c/tm/37b755f9-2d97-48fd-8c46-6f0f4d102d16/receive
Configurar el bot en Teams
- En la esquina inferior izquierda, selecciona Aplicaciones.
- Usa la barra de búsqueda a la izquierda y busca App Studio. Selecciónalo, instálalo y luego haz clic en abrir.
- Selecciona Crear una nueva aplicación.
- En Detalles de la Aplicación, ingresa todos los datos que ya tienes, como el nombre.
- En Identificación, ingresa el ID de la Aplicación; en Nombre del Paquete, ingresa un nombre que haga referencia a tu aplicación, por ejemplo: com.microsoft.teams.devapp
- Para la versión, usa algo como v1.0.0
- En Descripción, ingresa una descripción de tu aplicación, indicando lo que hace y para quién lo hace.
- En Información del Desarrollador, ingresa los datos de tu empresa, como el nombre y el sitio web.
- En URLs de la Aplicación, ingresa la URL de los términos de privacidad de tu empresa y en términos de uso ingresa la URL de tus términos.
- En Branding, actualiza las imágenes de perfil que deseas que tenga tu bot, haz clic en actualizar y elige tus imágenes.
- En el paso 2, bajo Capacidades, puedes establecer algunas especificaciones para tu bot; este paso no es necesario para que tu bot funcione con nuestra plataforma, por lo que omitiremos este paso.
- Ahora, en el paso 3 del menú izquierdo, haz clic en Dominios y Permisos.
- En Dominios Válidos, ingresa el dominio de nuestra plataforma para que tu bot pueda integrarse con nosotros (https://new.push.al) y haz clic en Agregar.
- En ID de la Aplicación AAD, ingresa tu Tenant ID que guardaste anteriormente.
- Para el último paso, haz clic en Probar y Distribuir en el paso 3 del menú izquierdo.
- Puedes publicar tu bot en el catálogo de tu organización para que todos los que participan en tu organización puedan agregar tu bot y enviarle mensajes. Para hacer esto, haz clic en Publicar aplicación en el catálogo de mi organización y luego en Enviar.
Importante: para que tu aplicación se publique en el catálogo de tu organización, deberá ser aceptada por el administrador de TI de tu organización. Una vez aceptada, tu bot estará disponible para instalación en el catálogo de tu empresa para todos los empleados que formen parte de ella.
