Implementa comandos de barra

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Los comandos de barra te permiten registrar y anunciar comandos específicos para tu app que ayudan a los usuarios a comprender algunas de sus funciones. Cuando el usuario chatea con una app y escribe una barra, los comandos aparecen en una ventana emergente con una descripción de lo que hace cada comando.

Cuando el usuario invoca tu aplicación mediante el comando de barra, se adjunta un campo adicional al mensaje enviado a tu aplicación. Este campo indica que el usuario seleccionó un comando de barra y también el comando de barra que seleccionó (según el ID de comando especificado en la configuración de tu aplicación). Además, el comando de barra tiene una anotación, al igual que cuando el usuario interactúa con tu app por su nombre.

{
  ...
  "message": {
    ...
    "text": "/vote yes",
    "argumentText": " yes",
    "annotations": [
      {
        "length": 5,
        "startIndex": 0,
        "slashCommand": {
          "type": "INVOKE",
          "user": {
            "avatarUrl": "https://.../avatar.png",
            "displayName": "VoteBot",
            "name": "users/1234567890987654321",
            "type": "BOT"
          }
        },
        "type": "SLASH_COMMAND"
      }
    ],
    "slashCommand": {
      "commandId": 2
    }
  }
}

El ID de comando que recibirá la app corresponde al ID de comando que especificas para ese comando en la configuración de la app:

Esto permite que tu app maneje de forma explícita casos de comandos de barra con análisis de argumentos limitados:

if (message.slashCommand) {
  switch (message.slashCommand.commandId) {
    case 2:  // /vote
      return vote(message.argumentText);
  }
}

// Other existing handling for users invoking your app by name.