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, será útil familiarizarse con lo siguiente:
- Azure Active Directory (Azure AD) 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 sobre el proceso de registro del bot, consulte Registro de un bot de llamadas.
Para facilitar las cosas más adelante, resulta útil comprender los distintos tipos de permisos dentro de Azure AD. 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 App Studio 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 es mejor que el bot sea con 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 comprobaciones de memoria adicional ni comprobaciones de caché de REDIS.
El inconveniente es que, dado que la instancia del bot está solo en una máquina, no es tan resistente.
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 poder usar bot media SDK.
Usar los SDK
Los siguientes SDK están disponibles en C#. Proporcionaremos soporte técnico para otros idiomas en el futuro.
- 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 se deben enviar en ningún identificador generado 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 registrarán en el lado del servidor para diagnósticos.