Introducción

La integración del canal de Microsoft Teams permite a los clientes de wolkvox interactuar directamente con sus clientes a través de la aplicación de Teams. La conexión utiliza el Bot Framework de Microsoft para recibir y enviar mensajes, así como para gestionar archivos adjuntos, habilitando una comunicación fluida y bidireccional.

Componentes de la integración

Prerrequisitos

Azure

• Suscripción activa de Microsoft Azure.
• Permisos de Contributor u Owner en la suscripción.
• Acceso a Azure Active Directory con permisos de administrador de aplicaciones.
• Registro de aplicaciones habilitado en Azure AD.

wolkvox

• Acceso a la plataforma wolkvox con credenciales válidas.
• Un punto de enrutamiento o routing point disponible para el bot.

Requisitos técnicos

• Navegador web actualizado: Chrome, Firefox o Edge.
• Teams Desktop o Teams Web para instalar la aplicación.
• Acceso a internet para realizar la conexión con Azure.

Cómo configurar Microsoft Teams en wolkvox

1. Crear el recurso Azure Bot

1. Ingresa a https://portal.azure.com e inicia sesión con tus credenciales de Microsoft Azure.
2. En la barra de búsqueda superior, escribe "Azure Bot".
3. Selecciona Azure Bot en los resultados y haz clic en + Crear

En el formulario de creación, completa los siguientes campos:

Nota: El nombre del recurso es para identificación interna en Azure y no es visible para los usuarios finales.

Nivel Free: Permite hasta 1.000 mensajes al mes. Para producción se indica usar Standard.

2. Registrar la aplicación en Azure AD

1. Ingresa un nombre descriptivo para la aplicación, por ejemplo: wolkvox-teams-bot.
2. Selecciona Single tenant para cuentas del directorio de la empresa o Multitenant para cuentas de diferentes directorios organizativos.
3. En Plataforma, selecciona Web.
4. Deja en blanco la URI de redirección.
5. Haz clic en Registrar.

3. Obtener las credenciales

Una vez creada la aplicación, obtén y guarda las siguientes credenciales:

Para generar el App Secret, ingresa a Certificates & secrets, selecciona + New client secret, escribe una descripción como teams-bot-secret, define una duración de 24 meses y haz clic en Add.

Advertencia: Copia el Client Secret inmediatamente. El valor se muestra una sola vez; si no se guarda, será necesario crear uno nuevo.

4. Configurar el webhook y habilitar Teams

1. En Azure Portal, ingresa al recurso Azure Bot creado.
2. En el menú lateral, selecciona Configuration.
3. En Messaging endpoint, registra la URL del webhook: https://teams.wolkvox.com/webhook.php
4. Haz clic en Apply.
5. En el menú lateral, selecciona Channels.
6. Busca Microsoft Teams, selecciona el ícono de Teams, acepta los términos y haz clic en Agree.

5. Configurar los permisos de mensaje

1. Ve a Azure Active Directory → App registrations.
2. Selecciona la aplicación creada.
3. Ingresa a API permissions y haz clic en + Add a permission.
4. Selecciona Microsoft Graph → Delegated permissions.
5. Agrega Teamwork.Migrate.All y Chat.ReadWrite.
6. Haz clic en Grant admin consent si cuentas con los permisos necesarios.

6. Cargar las credenciales en wolkvox

1. Inicia sesión en el Manager de wolkvox.
2. En el menú lateral, ingresa a Omnichannel.
3. Desplázate hasta la pestaña Teams.
4. Haz clic en Configurar para abrir el formulario Configuración del Bot de Teams.

Completa los campos del formulario:

7. Validar y guardar la configuración

1. Verifica que todos los campos estén correctos.
2. Haz clic en Guardar.
3. Espera a que se complete la validación contra Azure AD.
4. Después de la validación, serás redirigido al listado de configuraciones.

Resultado esperado: Si las credenciales son válidas, se mostrará "Credenciales validadas correctamente". Si son inválidas, se mostrará "Credenciales inválidas. Verifique App ID, App Secret y Tenant ID".

8. Descargar el manifest.json

1. Ingresa a Configuraciones de Teams.
2. Busca la configuración que deseas instalar.
3. Verifica que el estado sea "Verificado", identificado con una marca verde.
4. Haz clic en "Descargar manifest".

El archivo se descargará con un nombre similar a: manifest-[nombre-personalizado].json

El manifest reemplaza automáticamente los datos dinámicos de la aplicación, como el Microsoft App ID, el nombre personalizado y el dominio del webhook.
 

9. Preparar el paquete para Teams

Crea una carpeta e incluye los siguientes archivos:

mi-bot-teams.zip/
├── manifest.json
├── color.png      (192 × 192 píxeles)
└── outline.png    (32 × 32 píxeles)

Importante: Los archivos color.png y outline.png deben proporcionarse por separado. El manifest los referencia, pero no los incluye.

1. Coloca los tres archivos dentro de una carpeta.
2. Comprime la carpeta en formato .zip.
3. En Windows, usa Enviar a → Carpeta comprimida (zip). En Mac, selecciona Comprimir.

10. Instalar la aplicación en Teams

Instalación individual en Teams Desktop

1. Abre Microsoft Teams en tu computadora.
2. En el menú lateral izquierdo, haz clic en Apps.
3. Selecciona Administrar apps personalizadas.
4. Haz clic en Cargar una app personalizada.
5. Selecciona el archivo .zip y haz clic en Abrir.

1. En la ventana de confirmación, revisa el nombre de la aplicación.
2. Haz clic en Agregar.

Instalación desde Teams Web

1. Ingresa a https://teams.microsoft.com e inicia sesión con tu cuenta de Microsoft.
2. En Apps, selecciona Administrar apps personalizadas.
3. Haz clic en Cargar una app personalizada.
4. Selecciona el archivo .zip, haz clic en Cargar y después en Agregar.

11. Verificar el funcionamiento

1. Abre la conversación con el bot.
2. Envía un mensaje de prueba: "Hola".
3. Espera la respuesta.
4. Verifica que el mensaje se procese correctamente.

12. Instalar la aplicación para varios usuarios

1. Ingresa a https://admin.teams.microsoft.com con credenciales de administrador de Microsoft 365.
2. En el menú lateral, selecciona Teams apps → Manage apps.
3. Haz clic en + Upload custom app.
4. Selecciona el archivo .zip, haz clic en Add, verifica los datos del manifest y selecciona Submit.

Distribución para toda la organización

1. En Manage apps, busca la aplicación personalizada.
2. Ingresa a Permissions.
3. En Org-wide availability, selecciona Available to all users.
4. Haz clic en Save.

Distribución para usuarios específicos

1. Ingresa a Policy → Setup policies.
2. Haz clic en + Add.
3. Asigna un nombre a la política, por ejemplo: "Bot Soporte wolkvox".
4. En Upload custom apps, selecciona On.
5. Guarda la política y asígnala a los usuarios o grupos correspondientes.

Checklist final

Ubicación de las imágenes incluidas