Rispondere ai comandi rapidi come app Google Chat

Questa pagina spiega come configurare e rispondere ai comandi rapidi per l'app Google Chat.

Un comando rapido è un modo per invocare e interagire con un'app Chat. Per utilizzare un comando rapido, apri il menu di integrazione facendo clic su Strumenti Google Workspace in uno spazio o in una conversazione di Chat e poi seleziona un comando dell'app con un nome che non inizia con una barra (/). Se selezioni un comando rapido, l'app Chat viene invocata direttamente senza ulteriori input da parte dell'utente, consentendo interazioni rapide.

Gli utenti possono anche richiamare un'app di chat tramite un comando slash. Per la procedura, consulta Rispondi ai comandi con barra. Rispetto ai comandi slash, i comandi rapidi sono formattati con un nome più intuitivo nell'interfaccia utente di Chat, vengono richiamati immediatamente dopo la selezione e non richiedono all'utente di ricordare o digitare il nome del comando slash.

Menu di integrazione con comandi rapidi
Figura 1: il menu di integrazione contenente i comandi rapidi per un'app di Chat.

Configurare un comando rapido nell'API Google Chat

Per creare un comando rapido o aggiornare i comandi slash esistenti in comandi rapidi, devi specificare le informazioni sul comando nella configurazione dell'app Chat per l'API Google Chat.

Per configurare un comando rapido nell'API Google Chat, completa i seguenti passaggi:

  1. Nella console Google Cloud, fai clic su Menu > API e servizi > API e servizi abilitati > API Google Chat

    Vai alla pagina dell'API Google Chat

  2. Fai clic su Configurazione.

  3. In Comandi, fai clic su Aggiungi un comando.

  4. Inserisci un ID comando, un nome, una descrizione e un tipo di comando per il comando:

    • ID comando:un numero compreso tra 1 e 1000 utilizzato dalla tua app Chat per riconoscere il comando e restituire una risposta.
    • Nome:il nome visualizzato del comando. I nomi possono contenere fino a 50 caratteri e possono includere caratteri speciali.
      • Utilizza parole o frasi brevi, descrittive e strategiche per rendere chiari i comandi per l'utente. Ad esempio, utilizza Aggiorna contatto per un comando che modifica un record del contatto.
    • Descrizione:il testo che descrive cosa fa il comando. Le descrizioni possono contenere fino a 50 caratteri e possono includere caratteri speciali.
      • Mantieni la descrizione breve e chiara in modo che gli utenti sappiano cosa aspettarsi quando richiamano il comando.
      • Comunica agli utenti se l'app Chat risponde a tutti gli utenti dello spazio o in privato all'utente che richiama il comando. Ad esempio, per il comando rapido Informazioni, potresti descriverlo come Scopri di più su questa app (visibile solo a te).
    • Tipo di comando:seleziona Comando rapido.

  5. (Facoltativo) Se vuoi che l'app Chat risponda al comando con una finestra di dialogo, seleziona la casella di controllo Apri una finestra di dialogo.

  6. Fai clic su Salva.

Il comando rapido è ora configurato per l'app Chat.

Rispondere a un comando rapido

Quando gli utenti richiamano un comando rapido, l'app Chat riceve un APP_COMMAND evento di interazione. Il payload dell'evento contiene l'oggetto appCommandMetadata con i dettagli del comando invocato (incluso l'ID comando e il tipo di comando), in modo da poter restituire una risposta appropriata.

Il codice seguente mostra un esempio di app di Chat che risponde al comando Help gestendo gli APP_COMMANDeventi di interazione e rilevando se il payload dell'evento contiene l'ID comando corrispondente. Se il payload dell'evento contiene l'ID comando, l'app Chat restituisce un messaggio privato:

Apps Script 

// Handle the APP_COMMAND event type.
function onAppCommand(event) {
  // Executes the command logic based on its ID.
  // Command IDs are set in the Google Chat API configuration.
  switch (event.appCommandMetadata.appCommandId) {
    case HELP_COMMAND_ID:
      return {
        privateMessageViewer: event.user,
        text: 'The Avatar app replies to Google Chat messages.'
      };
  }
}

Imposta HELP_COMMAND_ID con l'ID comando specificato quando hai configurato il comando rapido nell'API Chat. Per testare questo codice, consulta Testare le funzionalità interattive per le app Google Chat. Per testare un comando rapido in Chat, apri il menu di integrazione facendo clic su Strumenti Google Workspace e poi selezionando il comando rapido.

Trasformare i comandi slash esistenti in comandi rapidi

Per modificare un comando slash esistente in un comando rapido, modifica il comando slash nell'API Google Chat cambiando Tipo di comando da Comando slash a Comando rapido.

Quando gli utenti richiamano un comando rapido, l'app Chat riceve un evento di interazione APP_COMMAND anziché un evento di interazione MESSAGE inviato per i comandi slash. Aggiorna la tua app Chat per gestire questo tipo di evento di interazione leggendo il payload dell'evento contenente l'oggetto appCommandMetadata con i dettagli del comando rapido invocato. Consulta Rispondere a un comando rapido.