Odpowiadanie na szybkie polecenia jako aplikacja Google Chat

Z tej strony dowiesz się, jak skonfigurować szybkie polecenia i odpowiadać na nie w aplikacji Google Chat.

Szybkie polecenie to sposób, w jaki użytkownicy mogą wywoływać aplikację Google Chat i wchodzić z nią w interakcje. Aby użyć szybkiego polecenia, otwórz menu integracji, klikając w pokoju czatu lub rozmowie, a następnie wybierz polecenie aplikacji, którego nazwa nie zaczyna się od ukośnika (/). Wybranie szybkiego polecenia powoduje bezpośrednie wywołanie aplikacji Google Chat bez konieczności dalszego wprowadzania danych przez użytkownika, co umożliwia szybkie interakcje.

Użytkownicy mogą też wywołać aplikację Google Chat za pomocą polecenia po ukośniku. Instrukcje znajdziesz w artykule Odpowiedzi na polecenia. W porównaniu z poleceniami po ukośniku szybkie polecenia mają w interfejsie Google Chat bardziej przyjazne użytkownikowi nazwy. Są one wywoływane natychmiast po wybraniu i nie wymagają od użytkownika zapamiętywania ani wpisywania nazwy polecenia po ukośniku.

Menu integracji z szybkimi poleceniami
Rysunek 1. Menu integracji zawierające szybkie polecenia dotyczące aplikacji Google Chat.

Konfigurowanie szybkiego polecenia w interfejsie Google Chat API

Aby utworzyć szybkie polecenie lub zaktualizować istniejące polecenia po ukośniku, musisz podać informacje o tym poleceniu w konfiguracji interfejsu Google Chat API w aplikacji Google Chat.

Aby skonfigurować szybkie polecenie w Google Chat API, wykonaj te czynności:

  1. W konsoli Google Cloud kliknij Menu > Interfejsy API i usługi > Włączone interfejsy API i usługi > Interfejs Google Chat API

    Otwórz stronę interfejsu Google Chat API

  2. Kliknij Konfiguracja.

  3. W sekcji Polecenia kliknij Dodaj polecenie.

  4. Wpisz identyfikator, nazwę, opis i typ polecenia:

    • Identyfikator polecenia: liczba z zakresu 1–1000, której używa aplikacja Google Chat do rozpoznawania polecenia i zwracania odpowiedzi.
    • Nazwa: wyświetlana nazwa polecenia. Nazwy mogą mieć maksymalnie 50 znaków i mogą zawierać znaki specjalne.
      • Używaj krótkich, opisowych i użytecznych słów lub wyrażeń, aby polecenia były zrozumiałe dla użytkownika. Na przykład polecenie Update contact (Zaktualizuj kontakt) służy do modyfikowania rekordu kontaktu.
    • Opis: tekst opisujący działanie polecenia. Opis może mieć maksymalnie 50 znaków i może zawierać znaki specjalne.
      • Opis powinien być krótki i jasny, aby użytkownicy wiedzieli, czego się spodziewać po wywołaniu polecenia.
      • Poinformuj użytkowników, czy aplikacja Google Chat ma odpowiadać wszystkim w pokoju czy tylko użytkownikowi, który wywołał polecenie. Na przykład w przypadku szybkiego polecenia Informacje możesz podać opis Dowiedz się więcej o tej aplikacji (widoczne tylko dla Ciebie).
    • Typ polecenia: wybierz Szybkie polecenie.

  5. Opcjonalnie: jeśli chcesz, aby aplikacja Google Chat odpowiadała na polecenie za pomocą okna dialogowego, zaznacz pole wyboru Otwórz okno dialogowe.

  6. Kliknij Zapisz.

Szybkie polecenie zostało skonfigurowane w aplikacji Google Chat.

Odpowiedź na szybkie polecenie

Gdy użytkownicy wywołują szybkie polecenie, aplikacja Google Chat otrzymuje zdarzenie interakcji APP_COMMAND. Ładunek zdarzenia zawiera obiekt appCommandMetadata z informacjami o wywołanym poleceniu (w tym identyfikator i typ polecenia), aby można było zwrócić odpowiednią odpowiedź.

Poniższy kod pokazuje przykład aplikacji Google Chat, która odpowiada na polecenie Help (Pomoc) przez obsługę zdarzeń interakcji APP_COMMAND i wykrywanie, czy dane zdarzenia zawierają pasujący identyfikator polecenia. Jeśli dane zdarzenia zawierają identyfikator polecenia, aplikacja Google Chat zwróci wiadomość prywatną:

Google 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.'
      };
  }
}

Ustaw HELP_COMMAND_ID za pomocą identyfikatora polecenia określonego podczas konfigurowania szybkiego polecenia w interfejsie Chat API. Aby przetestować ten kod, zapoznaj się z artykułem Testowanie interaktywnych funkcji aplikacji Google Chat. Aby przetestować szybkie polecenie w Google Chat, otwórz menu integracji, klikając Narzędzia Google Workspace , a następnie wybierz szybkie polecenie.

Przekształcanie dotychczasowych poleceń po ukośniku w szybkie polecenia

Aby zmienić istniejące polecenie po ukośniku na polecenie szybkie, w interfejsie Google Chat API zmień Typ polecenia z Polecenie po ukośniku na Polecenie szybkie.

Gdy użytkownicy wywołują szybkie polecenie, aplikacja Google Chat otrzymuje zdarzenie interakcji APP_COMMAND, a nie zdarzenie interakcji MESSAGE, które jest wysyłane w przypadku poleceń po ukośniku. Zaktualizuj aplikację Google Chat, aby obsługiwała ten typ zdarzenia interakcji, odczytując ładunek zdarzenia zawierający obiekt appCommandMetadata z informacjami o wywołanym szybkim poleceniu. Zobacz Odpowiedzi na szybkie polecenia.