Agregar un menú de bot en Microsoft Teams

Importante

Este artículo se basa en el SDK de Bot Framework v3. Si busca la versión 4.6 o posterior de la documentación actual del SDK, consulte la sección bots conversacionales .

Para ayudar a la detección y ayudar a educar a los usuarios sobre la funcionalidad del bot, ahora puede agregar menús que aparecen cada vez que el usuario interactúa con el bot. El menú mostrará el texto del comando y también proporcionará texto de ayuda, como un ejemplo de uso o una descripción del propósito del comando.

Cuando un usuario selecciona un elemento de menú, la cadena de comando se inserta en el cuadro de texto para ayudar al usuario a completar el mensaje del bot.

Compatibilidad con menús de bot en la aplicación móvil de Teams

Nota:

Los menús de bot no se muestran en dispositivos móviles.

Manifiesto de la aplicación

Para crear un menú de bot, agregue un nuevo commandLists objeto al manifiesto de la aplicación en la sección bot. Puede declarar menús individuales con comandos independientes para cada ámbito que admita el bot (personal, groupChato team) Cada menú admite hasta 10 comandos.

Extracto del manifiesto: menú único para ambos ámbitos

{
  ⋮
  "bots":[
    {
      "botId":"[Microsoft App ID for your bot]",
      "scopes": [
        "personal",
        "team"
      ],
      "commandLists":[
        {
          "scopes":[
            "team",
            "personal"
          ],
          "commands":[
            {
              "title":"Help",
              "description":"Displays this help message"
            },
            {
              "title":"Search Flights",
              "description":"Search flights from Seattle to Phoenix May 2-5 departing after 3pm"
            },
            {
              "title":"Search Hotels",
              "description":"Search hotels in Portland tonight"
            },
            {
              "title":"Best Time to Fly",
              "description":"Best time to fly to London for a 5 day trip this summer"
            }
          ]
        }
      ]
    }
  ],
  ...
}

Extracto del manifiesto: menú independiente por ámbito

{
  ...
  "bots":[
    {
      "botId":"[Microsoft app ID for your bot]",
      "scopes": [
        "groupChat",
        "team"
      ],
      "commandLists":[
        {
          "scopes":[
            "team"
          ],
          "commands":[
            {
            "title":"help",
            "description":"Displays this help message for channels"
            }
          ]
        },
        {
          "scopes":[
            "groupChat"
          ],
          "commands":[
            {
            "title":"help",
            "description":"Displays this help message for group chat"
            }
          ]
        }
      ]
    }
  ],
  ...
}

Procedimientos recomendados

• Mantenga la simplicidad: el menú del bot está diseñado para presentar las funcionalidades clave del bot.
• Manténgalo corto: las opciones de menú no deben ser instrucciones de lenguaje natural extremadamente largas y complejas, ya que deben ser comandos simples.
• Siempre disponible: las acciones o comandos del menú del bot deben ser siempre invocables, independientemente del estado de la conversación o del cuadro de diálogo en el que se encuentra el bot.