Agregar un chatbot a Microsoft Teams

Seleccione la versión de Power Virtual Agents que está usando aquí:

Ahora que ha publicado su bot, puede ponerlo a disposición de los usuarios en Microsoft Teams para que usted, sus compañeros de equipo y la organización en general puedan interactuar con él. Necesita publicar el bot al menos una vez antes de que los usuarios puedan interactuar con el bot en Microsoft Teams.

El usuario puede:

  • Personalizar la apariencia de su bot en Microsoft Teams
  • Instalar el bot usted mismo en Microsoft Teams
  • Compartir el enlace de instalación del bot con otros usuarios
  • Mostrar el bot en la tienda de aplicaciones de Microsoft Teams
    • Muestre el bot a usuarios compartidos agregándolo a la sección Generado por sus compañeros de la tienda de aplicaciones de Microsoft Teams
    • Comparta el bot con la organización enviando el bot para aprobación del administrador para que aparezca en la sección Creado por su organización de la tienda de aplicaciones de Microsoft Teams
  • Descargar el manifiesto de la aplicación Teams generado previamente para distribuirlo en el inquilino de Microsoft Teams

Nota

Al agregar el bot a Microsoft Teams, algunos de sus datos, como el contenido del bot y el contenido del chat del usuario final, se compartirán con Microsoft Teams (lo que significa que sus datos fluirán fuera de los límites de cumplimiento y geográficos o regionales de su organización).
Para obtener más información, consulte la directiva de privacidad de la aplicación Microsoft Teams.

Requisitos previos

Conectar el bot al canal de Microsoft Teams

Después de publicar el bot al menos una vez, puede conectarlo al canal de Microsoft Teams para permitir a los usuarios chatear con el bot en Microsoft Teams.

Nota

Le recomendamos que active la configuración de seguridad para bots creados para Microsoft Teams o el uso interno de los empleados para que pueda asegurarse de que el bot no sea accesible para personas ajenas a su organización.

Conectarse a Microsoft Teams:

  1. Vaya a Administrar y, luego, Canales en el panel de navegación lateral.

  2. Seleccione Microsoft Teams.

  3. Seleccione Activar Teams.

    En el control flotante de Microsoft Teams que aparece, seleccione Activar en Teams para habilitar el uso compartido

    Nota

    Si no ve esta opción, entonces el canal de Microsoft Teams puede que ya esté habilitado.

Personalizar la apariencia del bot en Microsoft Teams

Es importante proporcionar la descripción y apariencia correctas para el bot antes de ponerlo a disposición de otros usuarios, ya que los educa sobre cuál es el propósito del bot y su marca, cuando corresponda.

  1. Vaya a Administrar y, luego, Canales en el panel de navegación lateral.

  2. Seleccione Microsoft Teams.

  3. Seleccione Editar detalles para cambiar el icono, el color y las descripciones del bot. Estos se mostrarán en la tienda de aplicaciones de Microsoft Teams y la pestaña Acerca de la aplicación después de que el usuario instale el bot. Revise las recomendaciones sobre los formatos del icono Microsoft Teams.

    Puede realizar cambios en el icono, el color de fondo y las descripciones

    Importante

    Las actualizaciones de los detalles del bot no se aplicarán a los usuarios que ya hayan instalado el bot desde un enlace compartido o la sección Generado por sus compañeros. Deberán reinstalar el bot para recibir las actualizaciones.
    Las actualizaciones de los detalles del bot no se aplicarán a los bots que hayan sido aprobados por un administrador. Deberá volver a enviar el bot para su aprobación para tener los últimos detalles actualizados para los usuarios.

  4. Seleccione Más para agregar información adicional:

    • Nombre del desarrollador

    • Sitio web

    • Declaración de privacidad

    • Condiciones de uso

      Debe proporcionar esta información para mantener informado al usuario sobre el bot. Vea el tema Declaración de privacidad y condiciones de uso para obtener más detalles y ejemplos.

  5. Seleccione Guardar para volver a la pantalla donde puede hacer que el bot esté disponible en Teams. Verá que se muestran las actualizaciones del color, el icono y la descripción.

Nota

La personalización de iconos en esta sección solo se aplica al avatar de bot para bots que son aprobados por el administrador y no se aplica a los usuarios que instalan el bot con un enlace de instalación directo o desde la tienda de aplicaciones de Microsoft Teams sección Generado por sus compañeros. Puede personalizar el avatar del bot en Personaliza la apariencia del bot. Icono de avatar de bot en el chat de Teams.

Instalar un bot como una aplicación en Microsoft Teams

Una vez que haya publicado un bot, puede agregarlo a su propia versión de Microsoft Teams directamente desde la aplicación Power Virtual Agents.

Importante

El contenido nuevo de un bot recién publicado no aparecerá en las conversaciones en curso. Después de 30 minutos de inactividad, el bot se actualizará.
Puede escribir Comenzar de nuevo en una conversación existente para iniciar una nueva conversación de inmediato y ver las últimas actualizaciones del bot.

Debe agregar su bot a su propia versión de Teams antes de compartirlo con otros.

  1. Vaya a Administrar y, luego, Canales en el panel de navegación lateral.

  2. Seleccione Microsoft Teams.

  3. Seleccione Abrir el bot para que el mensaje de instalación se inicie en Microsoft Teams. Seleccione Agregar para que se agregue como una aplicación en Teams. Esto solo instala el bot para usted.

Instale el bot usted mismo en el panel Teams

  1. Vaya a Administrar y, luego, Canales en el panel de navegación lateral.

  2. Seleccione Microsoft Teams.

  3. Seleccione Opciones de disponibilidad y seleccione Copiar enlace

    Importante

    Solo los usuarios que pueden acceder al bot pueden usar el enlace de instalación para instalar el bot. Puede compartir el bot para dar a los usuarios acceso al chat con el bot.

    Copie el enlace desde las opciones de disponibilidad de Teams.

  4. Comparta el enlace copiado con los usuarios para que puedan instalar el bot en Microsoft Teams.

Mostrar el bot en la tienda de aplicaciones de Microsoft Teams

Una vez que haya publicado su bot, puede mostrarlo en la tienda de aplicaciones de Microsoft Teams para que los usuarios puedan encontrarlo e instalarlo.

Mostrar a usuarios compartidos

Puede compartir su bot agregándolo a la tienda de aplicaciones de Microsoft Teams, Creado para su organización > Generado por sus compañeros. Solamente los usuarios compartidos encontrarán el bot allí.

Importante

Solo los usuarios compartidos podrán encontrar e instalar el bot en la sección Generado por sus compañeros de la tienda de aplicaciones de Microsoft Teams. El bot no se mostrará a todos en la organización, incluso si está configurado para permitir que todos lo usen. Para mostrar el bot en la organización, envíe el bot para aprobación del administrador para que aparezca en la sección Creado por su organización de la tienda de aplicaciones de Microsoft Teams. El bot solo se puede mostrar en la sección Generado por sus compañeros de la tienda de aplicaciones de Microsoft Teams cuando el número total de usuarios compartidos no exceda la directiva de detección de la tienda de aplicaciones Teams del inquilino. Para mostrar el bot más allá del límite de la directiva de su organización, asóciese con su administrador para mostrar el bot a la organización .

La sección Generado por sus compañeros en la parte inferior de la sección Creado para su organización en la tienda de aplicaciones de Teams.

  1. Vaya a Administrar y, luego, Canales en el panel de navegación lateral.

  2. Seleccione Microsoft Teams.

  3. Seleccione Opciones de disponibilidad.

  4. Seleccione Mostrar a mis compañeros de equipo y usuarios compartidos y revise quién tiene acceso al bot.

    Muestre el bot en la sección Generado por sus compañeros de la tienda de aplicaciones de Teams.

  5. Confirme la casilla Visible en Generado por sus compañeros y seleccione Compartir.

    Seleccione la casilla Visible en Generado por sus compañeros en la interfaz de usuario para compartir.

  6. Esto agregará automáticamente el bot a la sección Generado por sus compañeros y mostrará una etiqueta verde Agregado a Teams en la página de opciones de disponibilidad.

El menú lateral muestra que el bot se ha agregado a Teams.

Nota

Si su aplicación no aparece en la sección Generado por sus compañeros, su aplicación Teams podría estar almacenando información en caché. Intente cerrar sesión y volver a iniciarla (si está usando la aplicación de escritorio) o actualizar su navegador (si está usando la aplicación web de Teams).

Quitar el bot de la sección Generado por sus compañeros

Puede quitar el bot para que no aparezca en la sección Generado por sus compañeros. Esto no afecta a los usuarios que ya han instalado el bot.

  1. Vaya a Administrar y, luego, Canales en el panel de navegación lateral.

  2. Seleccione Microsoft Teams.

  3. Seleccione Opciones de disponibilidad.

  4. Seleccione Mostrar a mis compañeros de equipo y usuarios compartidos y quite la selección de la casilla Visible en Generado por sus compañeros.

    Desactive la casilla Visible en Generado por sus compañeros en la interfaz de usuario para compartir.

  5. Seleccione Compartir. Ahora el bot dejará de aparecer en la sección Generado por sus compañeros de la tienda de aplicaciones de Microsoft Teams.

Mostrar a la organización

Puede compartir el bot con su organización enviando el bot para aprobación del administrador para que aparezca en la sección Generado para la organización > Generado por sus compañeros. Esta es una excelente manera de distribuir ampliamente su bot al asociarse con su administrador para implementar el bot para todos en la organización o un subconjunto de usuarios.

La sección Creado por su organización en la parte suuperior de la sección Creado para su organización en la tienda de aplicaciones de Teams.

Los administradores también pueden preinstalar y anclar el bot para los usuarios de la organización para que puedan acceder a ella directamente desde la barra de aplicaciones en Microsoft Teams.

Antes de enviar el bot a su organización, asegúrese de que:

  • El bot está listo para su lanzamiento y que cumple los estándares, reglas y directivas de la empresa.
  • Usted se coordina con otros administradores de bots: una vez que el bot ha sido enviado, un usuario diferente no puede volver a enviarlo hasta que el envío anterior sea aprobado o rechazado por un administrador.
  • Ha quitado el bot, en su caso, de la sección Generado por sus compañeros. Enviar el bot para la aprobación del administrador podría resultar en que su bot aparezca en dos lugares. Vea las instrucciones en la sección sobre quitar un bot para obtener detalles.

Nota

Una vez que un bot sea aprobado por un administrador, la disponibilidad del bot en la sección Generado por su organización será completamente administrada por su administrador. Solo un administrador puede eliminar el bot de la sección Generado por su organización.

Enviar para la sección Generado por su organización

  1. Vaya a Administrar y, luego, Canales en el panel de navegación lateral.

  2. Seleccione Microsoft Teams.

  3. Seleccione Opciones de disponibilidad.

  4. Confirme que el bot no se muestra a compañeros de equipo ni a usuarios compartidos. Quítelo si dice Agregado a Teams.

  5. Seleccione Mostrar a todas las personas de mi organización.

    Muestre el bot a la organización en las opciones de disponibilidad del panel de Teams.

  6. Revise los requisitos para el envío y seleccione Enviar para aprobación del administrador.

    Nota

    Asegúrese de revisar el contenido y de que esté listo para que lo revise un administrador. Deberá enviar nuevas solicitudes al administrador para actualizar el icono y las descripciones de los bots que fueron aprobados previamente.
    Una vez aprobado, todos los usuarios nuevos y existentes del bot en Teams recibirán la actualización.
    Esto solo se aplica a los detalles del bot. Puede seguir realizando actualizaciones de contenido en su bot publicando el contenido más reciente sin necesidad de volver a enviarlo al administrador.

  7. Aparecerá un mensaje de confirmación final. Seleccione para continuar. El bot se enviará a su administrador para que lo aprueben, y verá una nota que indica el estado de su envío.

    El estado tiene una nota naranja con información sobre el estado del envío, incluidos el nombre del bot, el número de versión y el estado actual de Esperando aprobación

    Nota

    Después de enviar el bot para la aprobación del administrador, no debe cambiar la configuración de acceso del bot para que sea inferior a todos los miembros de su organización.
    Esto hará que los usuarios de la organización no puedan chatear con el bot después de instalarlo desde la sección Generado por su organización de la tienda de aplicaciones de Microsoft Teams.
    Trabaje con su administrador en la directiva de aplicaciones de Microsoft Teams sobre quién puede encontrar e instalar el bot.

  8. Deberá esperar la aprobación de su administrador. Puede comprobar el estado más reciente seleccionando Actualizar o abriendo la ventana Poner el bot a disposición de otros usuarios ventana desde la página Publicar.

  9. Después de que su administrador apruebe el bot, el estado se actualizará a Aprobado. Puede abrir directamente el bot y compartir el enlace de la versión aprobada con otros usuarios.

  10. Opcionalmente, asóciese con su administrador para preanclar o instalar la aplicación para los usuarios en la directiva de aplicaciones de Microsoft Teams para que puedan encontrar el bot directamente en su carril de aplicaciones de la izquierda de Microsoft Teams.

Nota

Si su aplicación no aparece en la sección Generado por su organización, aunque se haya marcado como Aprobada, su aplicación Teams podría estar almacenando información en caché. Intente cerrar sesión y volver a iniciarla (si está usando la aplicación de escritorio) o actualizar su navegador (si está usando la aplicación web de Teams).

Descargar el manifiesto de la aplicación Teams del bot (avanzado)

Puede descargar el manifiesto de la aplicación Teams del bot para realizar cambios detallados en el manifiesto directamente y compartirlo con su administrador o usuarios en el inquilino. También puede cargar directamente el manifiesto de la aplicación en Microsoft Teams si la política de su organización le permite cargar aplicaciones personalizadas.

  1. Vaya a Administrar y, luego, Canales en el panel de navegación lateral.

  2. Seleccione Microsoft Teams.

  3. Seleccione Opciones de disponibilidad.

  4. Seleccione Descargar .zip.

    Descargue el archivo zip de manifiesto de la aplicación de Teams desde las opciones de disponibilidad del panel de Teams.

  5. El manifiesto se generará como un archivo .zip y se guardará de acuerdo con los ajustes para guardar de su navegador.

Desconectar el bot de Teams

Puede desconectar el bot para que los usuarios ya no puedan chatear con el bot en Teams. Esto significa que el bot no responderá a nadie que intente chatear con él e interrumpirá a cualquiera que esté usando el bot. Debe considerar detenidamente la necesidad de desconectar su bot antes de hacerlo.

Los bots ya no se muestran en la sección Generado por sus compañeros de la tienda de aplicaciones de Microsoft Teams y no se puede instalar desde el enlace compartido. Los bots que agregan los usuarios en Microsoft Teams seguirá existiendo hasta que el usuario los desinstale.

Para los bots aprobados por un administrador, los bots seguirán mostrándose en la sección Creado por su organización de la tienda de aplicaciones de Microsoft Teams. Deberá ponerse en contacto con su administrador para eliminar el bot

  1. Vaya a Administrar y, luego, Canales en el panel de navegación lateral.

  2. Seleccione Microsoft Teams.

  3. Seleccione Desconectar de Teams.

    Desconecte el canal de Teams en el panel de canales de Teams.

  4. Revise la información sobre la desconexión de su bot y seleccione Desconectar para continuar.

Siempre puede volver a conectar su bot después de desconectarse seleccionando Activar Teams en la ventana Poner el bot a disposición de otros usuarios de la página Publicar.

Limitaciones conocidas

  • Actualmente solo el ámbito Personal es compatible con Microsoft Teams, por lo que los usuarios solo pueden tener una conversación privada con el bot.
  • Configuración del icono de avatar de bot desde el panel de navegación lateral Administrar > Detalles no aparecerá para los bots aprobados por un administrador. Los bots aprobados por un administrador usarán el icono de la aplicación como avatar del bot.
  • Teams tiene limitación de frecuencia en bots. Según las necesidades de su negocio, es posible que desee mantener el contenido de su bot conciso para los bots que se agregan a Microsoft Teams.
  • Actualmente, si su bot es compatible con la autenticación de usuario final, el usuario no podrá cerrar sesión explícitamente. Esto generará un error en la certificación de Microsoft Teams AppSource si publica su bot en el Panel de vendedores. Esto no se aplica al uso personal o del inquilino del bot. Obtenga más información en Publicar su aplicación de Microsoft Teams y Directiva de validación de AppSource.
  • La desconexión del bot de Teams puede demorarse unos minutos antes de que los usuarios de Microsoft Teams no puedan obtener acceso al bot.