Crear bots para Teams

Artigo
10/17/2024

Un bot también se conoce como bot de chat o bot de conversación. Se trata de una aplicación que ejecuta tareas sencillas y repetitivas por parte de usuarios como el servicio de atención al cliente o el personal de soporte técnico. Los bots se usan a diario para, por ejemplo, proporcionar información sobre el tiempo, reservar cenas o facilitar información sobre viajes. Las interacciones con bots pueden ser preguntas y respuestas rápidas o conversaciones complejas.

Se recomienda empezar con la compilación de la primera aplicación de bot mediante JavaScript o el bot de notificación de compilación con JavaScript mediante la herramienta de desarrollo de nueva generación para Teams. Para obtener más información, consulte Introducción al kit de herramientas de Teams.

Importante

Los bots están disponibles en los entornos de Government Community Cloud (GCC), GCC-High y Department of Defense (DOD). Las aplicaciones de bot de Microsoft Teams para GCC-High y DOD están disponibles a través de Azure Bot Service y el registro del canal de bot debe realizarse en Azure Government portal.
Las direcciones URL de imagen de las tarjetas adaptables no se admiten en entornos de GCC-High y DOD. Puede reemplazar una dirección URL de imagen por DataUri codificado en Base64.
Cuando un usuario cambia el tema de Teams en un bot, el tema no se aplica al contenido compartido mediante una tarjeta adaptable.

Los bots conversacionales permiten a los usuarios interactuar con el servicio web mediante texto, tarjetas interactivas y diálogos (denominados módulos de tareas en TeamsJS v1.x).

Los bots de conversación están dotados de gran flexibilidad. Los bots pueden controlar algunos comandos básicos y tareas más complejas que implican inteligencia artificial y procesamiento de lenguaje natural. Los bots pueden formar parte de una aplicación más grande o ser independientes.

Use la combinación correcta de tarjetas, texto y diálogos para crear un bot útil. En la siguiente imagen se muestra a un usuario conversando con un bot en un chat individual con texto y tarjetas interactivas.

La captura de pantalla es un ejemplo que muestra un bot de preguntas más frecuentes de ejemplo.

Cada interacción entre el usuario y el bot se representa como una actividad. Cuando un bot recibe una actividad, se la pasa a sus controladores de actividad. Vea los controladores de actividad de bots.

Los bots son aplicaciones que tienen una interfaz de conversación. Se puede interactuar con un bot mediante texto, tarjetas interactivas y voz. Un bot se comporta de forma diferente en función de si se trata de una conversación de chat de un canal o grupo o una conversación individual. Las conversaciones se controlan a través del conector de Bot Framework. Vea conceptos básicos de la conversación.

El bot requiere información contextual, como los detalles del perfil de usuario, para tener acceso al contenido relevante y mejorar la experiencia de uso del bot. Vea obtener el contexto de Teams.

Puede enviar y recibir archivos a través del bot mediante Graph API o las API de bot de Teams. Vea enviar y recibir archivos a través del bot.

La limitación de velocidad se usa para optimizar los bots que se usan para la aplicación de Teams. Para proteger Teams y a sus usuarios, las API del bot proporcionan un límite de velocidad para las solicitudes entrantes. Consulte optimizar el bot con limitación de velocidad en Teams.

Con Microsoft Graph API para llamadas y reuniones en línea, las aplicaciones de Teams ya pueden interactuar con los usuarios mediante voz y vídeo. Consulte llamadas y bots de reuniones.

Puede usar las API de bot de Teams para obtener información de miembros de un chat o equipo. Vea cambios en las API de bot de Teams para capturar miembros del equipo o chat.

Nombre e icono del bot

Nombre del bot: puede cambiar el nombre del bot que se muestra en el entorno de Teams actualizándolo en las siguientes repeticiones:

El nombre del bot, que se muestra como un título en la ventana de chat, se actualiza y administra en el manifiesto de la aplicación (anteriormente denominado manifiesto de aplicación de Teams).
El nombre del bot que se muestra en la lista de chat de Teams y en la ventana de chat con cada mensaje se administra en Microsoft Azure Portal. En el caso de las aplicaciones cargadas personalizadas, puede actualizar el nombre del bot en la página Perfil de bot de Azure Portal.

Icono de bot: puede agregar o actualizar el icono del bot para la aplicación teams de la siguiente manera. El icono del bot actualizado se vuelve visible solo después de que el usuario cierre la sesión y vuelva a iniciar sesión en Teams. Esto se debe a que los iconos se almacenan en caché:

Aplicación de la Tienda Microsoft Teams: en el caso de las aplicaciones de la Tienda Teams, los iconos de bot se capturan del manifiesto de la aplicación. Puede actualizar el icono de perfil de bot actualizándolo a través del manifiesto de la aplicación y volviendo a publicar la aplicación.


{
  "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.16/MicrosoftTeams.schema.json",
  "manifestVersion": "1.17",
  "version": "1.0.0",
  "id": "%MICROSOFT-APP-ID%",
  "icons": {
     "outline": "A relative path to a transparent .png icon — 32px X 32px", // This icon is used for bot profile.
     "color": "A relative path to a full color .png icon — 192px X 192px"
  },
  "bots": [
  {
    "botId": "%MICROSOFT-APP-ID-REGISTERED-WITH-BOT-FRAMEWORK%",
    "scopes": [
      "team",
      "personal",
      "groupChat"
    ]
  }
  ]
...
}

Carga de una aplicación personalizada en Teams o aplicaciones personalizadas creadas para su organización (aplicaciones LOB):
- Azure Portal: puede cambiar el icono del bot; para ello, vaya a Azure Portal.
- Portal de Bot Framework: para los bots creados mediante Bot Framework Portal, puede actualizar el icono del bot en la página CONFIGURACIÓN .

Especificar los requisitos de tiempo de ejecución del host (versión preliminar del desarrollador)

Para asegurarse de que la aplicación siempre proporciona a los clientes experiencias de alta calidad, puede adaptar el comportamiento de la aplicación en los hosts de Microsoft 365 aplicables o omitirla de la navegación en contextos que no está listo para admitir. Use el manifiesto de aplicación para especificar las relaciones de dependencia entre las funcionalidades de la aplicación y los requisitos de tiempo de ejecución específicos de las pestañas estáticas, las extensiones de mensaje y los bots.

Para obtener más información, consulte cómo especificar los requisitos de tiempo de ejecución de host de Microsoft 365 en el manifiesto de la aplicación.

Incorporación de la autenticación sso a los bots de conversación

Puede agregar la autenticación de inicio de sesión único al bot de conversación mediante los pasos siguientes:

Experiencia de configuración del bot

La experiencia de configuración del bot le ayuda a habilitar la configuración del bot para que los usuarios configuren su bot durante la instalación y vuelvan a configurar el bot desde el ámbito de chat del canal o grupo donde está instalado el bot. La configuración de bots es una funcionalidad importante para las aplicaciones dentro de la plataforma teams, lo que sentará las bases para su eficacia operativa. Para obtener más información, consulte Experiencia de configuración del bot.

Ejemplos de código

Ejemplo de nombre	Descripción	.NET	Node.js	Manifiesto
Recordatorio diario de tareas del bot	En este ejemplo se muestra cómo programar una tarea periódica y obtener un recordatorio a una hora programada mediante el bot.	View	View	Ver
Hello bot mundial	Se trata de una sencilla aplicación hello world con funcionalidades de extensión de bot y mensaje.	ND	View
Notificación de tarjeta adaptable	Este es un ejemplo, que muestra cómo enviar notificaciones con diferentes tarjetas adaptables mediante bots.	ND	View
Notificación de webhook entrante	Este es un ejemplo, que muestra cómo enviar notificaciones mediante webhook entrante en canales de Microsoft Teams.	ND	View

Paso siguiente

Bots y SDK

Compartir por