Registro de un bot con la API de comunicaciones en la nube

Puede usar la API de comunicaciones en la nube en Microsoft Graph para crear bots que respondan a las necesidades de los clientes y faciliten la colaboración. En este artículo se describe cómo registrar el bot y, a continuación, administrar el estado del bot.

Requisitos previos

Antes de empezar, familiarícese con los temas siguientes:

• Microsoft Entra ID (Microsoft Entra ID) y cómo el servicio ayuda a los empleados a iniciar sesión y acceder a los recursos.
• Azure Bot Service y sus funcionalidades.

Registro de un bot

Los términos "aplicación de servicio" y "bot" se pueden usar indistintamente. Puede crear un bot a través de la Azure Portal directamente o registrar un bot que no esté hospedado en Azure. Para obtener más información, consulte Registro de un bot de llamadas.

Para facilitar las cosas más adelante, resulta útil comprender los distintos tipos de permisos dentro de Microsoft Entra ID. Las aplicaciones con permisos delegados requieren un usuario que haya iniciado sesión. Los permisos basados en aplicaciones no necesitan un usuario que haya iniciado sesión y, a menudo, se pueden ejecutar como un servicio en segundo plano.

Después de registrar el bot, si desea agregar el bot a Microsoft Teams, asegúrese de comprender cómo usar el portal para desarrolladores para equipos y definir los metadatos necesarios.

Administración del estado del bot

Después de registrar el bot, decida si desea que los medios basados en audio y vídeo estén hospedados en la aplicación o en el servicio. En un nivel alto, esto implica decidir si desea acceder o no a un flujo en vivo de medios sin procesar.

A continuación, puede decidir si el bot debe tener estado o sin estado.

Bots sin estado

Cualquier máquina virtual puede controlar cualquier instancia de bot, lo que significa que si una máquina deja de funcionar, otra puede encargarse de ella. Esto hace que sea una solución resistente.

Por otro lado, una caché compartida, como REDIS, debe ser accesible para todas las máquinas virtuales.

Bots con estado

Una máquina virtual solo puede controlar una instancia de bot a la vez. Dado que todos los estados están en una máquina, no hay ninguna memoria adicional ni comprobaciones de caché de REDIS.

El inconveniente es que no es tan resistente porque la instancia del bot está solo en un equipo.

Nota:

Los bots multimedia hospedados por el servicio pueden ser con estado o sin estado. Los bots multimedia hospedados en la aplicación deben tener estado para usar bot media SDK.

Usar los SDK

Los siguientes SDK están disponibles en C#. En el futuro, proporcionaremos compatibilidad con otros idiomas.

• Si usa bots sin estado , instale el SDK de Graph Communications Core.
• Si usa bots con estado , instale el SDK de llamadas de Graph Communications.

Ejemplos

Obtenga información sobre cómo implementar diferentes escenarios mediante bots con estado, como responder a una llamada entrante con medios hospedados por la aplicación o hospedados por el servicio.

Para obtener más ejemplos, consulte el repositorio de ejemplos de comunicaciones.

Privacidad y cumplimiento

En las solicitudes a nuestras API, los datos confidenciales no deben enviarse en identificadores generados por el cliente (como identificadores de escenario, identificadores de solicitud u otros identificadores de correlación) en encabezados o en el cuerpo de la solicitud. Estos identificadores se registran en el lado del servidor para diagnósticos.

Contenido relacionado

• Introducción a la API de Teams