Microsoft Teams

paso 1 configuración en azure para registrar una aplicación en azure active directory, se debe ingresar al portal de azure ( https //portal azure com https //portal azure com/ ) y buscar el servicio de " active directory " luego, en la sección de " registros de aplicaciones ", se debe hacer click en " nuevo registro " la aplicación se llamará "asisteclick" y tipos de cuentas soportadas seleccionar la opción ' accounts in any organizational directory (any microsoft entra id tenant multitenant) and personal microsoft accounts (e g skype, xbox)' 📍 en guarda el id de aplicación y el id de directorio (tenant id) para configurar luego en asisteclick después ve a certificados y secretos y crea un nuevo certificado al crear el certificado ponele un nombre y la fecha máxima de expiración de 24 meses este certificado deberá ser renovado al vencimiento 📍 guarda el app secret value (marcado en rojo en la imagen de arrbia) puesto que lo necesitarás luego para integrar en asisteclick ahora selecciona la opción authentication y agrega la plataforma web tal como se muestra en la imagen siguiente colocar la dirección https //app asisteclick com/ms oauth2 php y dejar seleccionada la opción " tokens de acceso " luego, ve a api permissions y has click en la opción que dice grant admin consent for empresa y acepta el permiso tal como se muestra abajo verifica en la sección authentication que están seleccionadas las opciones marcadas abajo paso 2 configuración en teams ingresa a https //teams microsoft com y busca la aplicación developer portal o dev portal esta aplicación te permite crear una app personalizada para distribuir en tu compañía y que se conecte con asisteclick el primer paso es crear una nueva app dentro de dev portal , selecciona la opción aplicaciones y luego haz clic en el botón que dice nueva app esto abrirá una página en la que puedes, dentro de la sección información básica, dar a tu aplicación un nombre y una descripción, así como seleccionar el avatar de la app tal como lo verán los miembros del equipo completa la información básica de la app descripción corta, descripción larga en la sección información del desarrollador coloca lo siguiente desarrollador asisteclick website https //asisteclick com política de privacidad https //asisteclick com/privacy términos de uso https //asisteclick com/terms y en el campo id de aplicación coloca el id de aplicación creado anteriormente luego selecciona la opción herramientas del menú principal de dev portal y luego click en la opción bot management y luego en + nuevo bot debes ingresare el nombre del bot y click en el botón agregar el primer parámetro a configurar en el bot conector es la url de callback esta es la url de asisteclick a la cual microsoft teams reenviará los mensajes entrantes para que el bot las procese y responda la url de callback debe ser como https //sockets asisteclick com/teams/webhook/\<access token> https //sockets asisteclick com/teams/webhook/%3caccess token%3e ✅ el access token lo obtienes de tu cuenta de asisteclick ingresando con las credenciales de administrador en la sección mi cuenta > empresa luego selecciona la opción client secrets , crea un nuevo secreto 📍 guarda el valor como bot secret puesto que lo necesitarás más tarde 📍 vuelve al listado de bots y copia y guarda el bot id creado (como se muestra en la imagen de abajo) ya que lo necesitarás más tarde luego ve a la opción de menú aplicaciones , selecciona la aplicación creada y haz click en sección app features y ahí click en la opción bot en esta pantalla selecciona el nuevo bot creado en la opción select an existing bot , selecciona también la opción upload and download file y la opción personal al final y guarda los cambios en el siguiente paso definimos los permisos de la app en la sección permissions asegúrate de seleccionar la opción de tomar la ubicación del usuario y los dos permisos específicos para la gestión de la conversación una vez completada la configuración haz click en el botón que dice publish para bajar el paquete de la app y selecciona la opción download the app package para descagar el zip que contiene el manifiesto de la aplicación para que la app pueda ser utilizada por los usuarios debes ir a la sección de aplicaciones del menú que está en la columna vertical izquierda, seleccionar la opción administrar las aplicaciones y luego cargar la aplicación que acabamos de crear y descargar en el archivo zip una vez que subas el archivo zip verás un listado con todas las aplicaciones diseñadas incluyendo la que acabas de agregar ahora vuelve al listado de app registrations (aseguráte de hacer un refresh de la página para que tome las actualizaciones) y deberás ver dos entradas de la app que has creado, una de ellas tiene el id de la app y la otra tiene el id del bot, como se muestra abajo selecciona la app que se corresponda al id del bot y ve a la sección authentication ahi selecciona la opción " accounts in any organizational directory (any microsoft entra id tenant multitenant " de la sección supported account types y selecciona también yes en la opción allow public client flows los usuarios que quieran chatear con el bot de asisteclick deberán primero "agregarse" esta aplicación pero antes es necesario completar la integración de lado de asisteclick, esto lo hacemos en el siguiente paso paso 4 configuración en asisteclick ingresar a asisteclick con usuario y permisos de administrador sobre los bots a configuración, luego canales de atención ingresar a solapa teams, luego integrar nuevo bot aquí ingresa los valores que te guardaste previamente app id, app secret value, tenant id, bot id y bot secret luego puedes seleccionar del departament por defecto al que se vincularán las conversaciones (esto puede ser luego modificado en cada chat según la lógica del chatbot) y también seleccionas el chatbot se se activará al iniciarse una conversación configuración de single sign on en asisteclick la integración con azure ad permite centralizar la autenticación de los usuarios en la plataforma para llevar a cabo la integración se requiere crear una app en azure active directory con la configuración necesaria configurar la app de azure active directory en asisteclick asociarle a cada usuario de asisteclick su valor de “ 🙋 los usuarios de asisteclick estarán obligados a ingresar a la plataforma mediante azure ad únicamente si tienen asociado el “ nombre principal de usuario ” en su perfil aquellos usuarios que no cuenten con este valor asociado podrán seguir ingresar de manera estandar una vez configurada la app en el portal azure hay que vincular la app en asisteclick y luego asociarle a los usuarios sus respectivos nombre principal de usuario para forzar el login mediante sso configurar app de azure ad para configurar la app en asisteclick hay que ir a la sección datos de empresa y completar el bloque que dice azure active directory con la siguiente información nombre de la organización acá hay que poner una palabra única que identifica a la empresa este valor será solicitado al usuario cuando seleccione la opción de ingreso por sso y será utilizado para localizar la información de la aplicación de azure para gestionar el proceso de autorización de ingreso id de la organización id de la aplicación id de secreto configuración de los usuarios cómo último paso, en el perfil de cada usuario, hay que completar el campo “ nombre principal del usuario ” con el valor obtenido de su perfil equivalente en azure active directory este valor lo puedes encontrar en el portal de azure de esta forma el campo “ id de usuario en active directory ” está siempre deshabilitado y es completado por asisteclick luego del primer login sso del usuario y almacena el id del usuario en azure se muestra este valor como referencia de integración 🙋 la integración solo establece el control de que usuarios pueden ingresar a la plataforma y no define su perfil ni permisos en asisteclick (departamentos asignados, perfil administrador/básico y otros settings) la gestión del perfil y permisos de los usuarios se realizan siempre en asisteclick con esta configuración realizada al usuario este no podrá ingresar con su usuario y clave estandard de intentarlo, la plataforma le indificará que debe usar la opción “ ingresar con azure sso ” si tienes consultas sobre esta integración por favor envíanos un correo a soporte\@asisteclick com o contáctanos por whatsapp al +54 911 7005 2719 https //wa me/5491170052719