Configurar Azure para los bots de Microsoft Teams

MyZapp puede comunicarse en Microsoft Teams con dos bots distintos: Notifications y Assistant. Esta página explica cómo declararlos en Azure. No se instala ningún programa en Azure: el servicio Azure Bot simplemente retransmite los mensajes a tu instancia.

Repite este procedimiento para cada bot que quieras activar. Esta página está reservada a los administradores.

La instalación de la aplicación en Teams y los mensajes enviados por los bots llegarán con las próximas versiones del conector.

Qué necesitas

• una cuenta de Microsoft Entra autorizada a crear registros de aplicaciones;
• una suscripción de Azure y un grupo de recursos;
• una instancia accesible desde Internet por HTTPS, con un certificado reconocido públicamente.

Dirección que debes declarar para cada bot, sustituyendo <instance> por la dirección de tu instancia:

1. Registrar la aplicación en Entra

1. En el portal de Azure, abre Microsoft Entra ID › Registros de aplicaciones › Nuevo registro.
2. Pon un nombre. Tus usuarios no lo verán en Teams.
3. En Tipos de cuenta compatibles, elige Solo cuentas de este directorio organizativo.
4. Deja vacío el URI de redirección y pulsa Registrar.
5. Anota el Id. de aplicación (cliente) y el Id. de directorio (inquilino).

2. Crear el secreto

1. En la aplicación, abre Certificados y secretos › Secretos de cliente › Nuevo secreto de cliente.
2. Selecciona una duración y anota la fecha de expiración: en esa fecha, el bot dejará de escribir.
3. Copia de inmediato la columna Valor, no «Id. de secreto»: solo se muestra una vez.

3. Crear el recurso Azure Bot

1. En el portal de Azure, pulsa Crear un recurso, busca Azure Bot y luego Crear.
2. Pon un identificador, selecciona la suscripción y el grupo de recursos, y la residencia de datos Global.
3. El plan gratuito F0 es suficiente.
4. En Tipo de aplicación, elige Inquilino único.
5. En Tipo de creación, elige Usar un registro de aplicación existente y pega los dos identificadores del paso 1.
6. Pulsa Revisar y crear y luego Crear.

4. Declarar la dirección de la instancia

En el recurso Azure Bot, abre Configuración › Configuración, escribe la dirección del bot en Punto de conexión de mensajería y pulsa Aplicar.

5. Activar el canal de Teams

Abre Configuración › Canales › Microsoft Teams, acepta las condiciones, elige Microsoft Teams Commercial y luego Aplicar.

6. Configurar MyZapp

1. En Secretos, crea un secreto con el valor copiado en el paso 2 y el nombre que prefieras, por ejemplo teams-notifications-secret.
2. En Configuración, añade los parámetros siguientes, sustituyendo {Bot} por Notifications o Assistant:

7. Comprobar

Envía una solicitud POST sin autenticación a la dirección del bot:

• 401: el bot está activado y la instancia es accesible. Es el resultado esperado.
• 404: el bot está desactivado o falta un parámetro.
• Cualquier otra respuesta, o ninguna: comprueba la red, el proxy y el certificado.

Renovar el secreto

1. En Entra, crea un secreto nuevo sin retirar el anterior.
2. En Secretos, sustituye el valor del secreto. Su nombre no cambia.
3. Espera aproximadamente una hora y elimina el secreto anterior en Entra.

Cómo se reconocen las cuentas

En el primer intercambio, la dirección de Microsoft 365 de la persona se compara con la dirección de una cuenta activa de MyZapp. Si ninguna cuenta coincide, o si coinciden varias, no se crea ningún vínculo. Una cuenta desactivada pierde su vínculo la noche siguiente.