Slack

Są dwa sposoby połączenia Agenta AI ze Slackiem:

1. Slack (OAuth): zalecana integracja jednym kliknięciem. Autoryzuj Quickchat AI w swoim workspace Slack i gotowe.
2. Slack (Legacy): starszy sposób, w którym samodzielnie tworzysz aplikację Slack, wklejasz manifest i ręcznie podajesz tokeny.

Jeśli konfigurujesz integrację po raz pierwszy, zalecamy integrację OAuth.

Opcjonalne sprawdzanie przykładów

• Porównaj metody wdrożenia. Porównaj podane kanały, dostęp do witryny i wymagane funkcje z opcjami konfiguracji Quickchat AI. Narzędzie nie sprawdza Twojej witryny ani konta.

• Porównaj liczbę odpowiedzi dla budżetu kredytów. Oblicz maksymalną liczbę pełnych odpowiedzi AI dla każdego obsługiwanego modelu na podstawie podanego budżetu kredytów. Narzędzie nie sprawdza salda ani uprawnień do modeli.

Formularze są po angielsku.

Połącz ze Slack (zalecane)

W panelu Quickchat AI przejdź do External Apps, znajdź Slack i kliknij Połącz ze Slack. Spowoduje to połączenie Slack przez OAuth, aby Twój bot mógł odpowiadać w Twoim workspace.

Zostaniesz przekierowany do Slacka, aby autoryzować aplikację w swoim workspace. Zatwierdź wymagane uprawnienia, a następnie wrócisz do panelu, w którym Slack jest oznaczony jako połączony.

OAuth automatycznie nadaje pełen zestaw uprawnień (im:history, im:write, chat:write, app_mentions:read, channels:history, groups:history), więc nie trzeba edytować manifestu ani wybierać między wersją podstawową a rozszerzoną.

I to wszystko! 🎉 Twój bot czatu AI jest gotowy do testów na Slacku!

Zachowanie odpowiedzi

Obie integracje Slack udostępniają dwa przełączniki, które decydują, gdzie odpowiada Twój bot:

• Odpowiadaj wszystkim w wątku: gdy włączone, bot odpowiada na wiadomości od dowolnej osoby w wątku, a nie tylko tej, która go rozpoczęła.
• Odpowiadaj na wszystkie wiadomości na kanale: gdy włączone, bot odpowiada na wszystkie wiadomości na kanale, do którego został dodany, a nie tylko gdy jest bezpośrednio @wspomniany.

Gdy ktoś otworzy App Home bota (zdarzenie app_home_opened), bot wysyła swoją wiadomość powitalną.

Slack (Legacy)

To starsza integracja aplikacji Slack używająca ręcznych tokenów bota. Jeśli konfigurujesz integrację po raz pierwszy, użyj integracji Slack przez OAuth powyżej. Poniższy sposób z manifestem jest nadal poprawny, jeśli potrzebujesz drogi ręcznej.

W tej sekcji omówimy:

1. Utworzenie dedykowanej aplikacji Slack
2. Konfiguracja aplikacji Slack
3. Integracja bota Slack z Quickchat AI

Utwórz aplikację Slack

Aby rozpocząć integrację, potrzebujesz aplikacji Slack dla swojego bota czatu AI. Przejdź do api.slack.com/apps i kliknij create a new app.

Wskazówka

Pokażemy konfigurację aplikacji od zera. Jeśli robiłeś to wcześniej, możesz od razu skorzystać z manifestu aplikacji, który podajemy niżej.

Następnie wybierz Create an app from scratch, ustaw nazwę Asystenta AI i wybierz workspace Slack, do którego chcesz go dodać, a potem kliknij Create App.

Skonfiguruj aplikację Slack

Slack pozwala skonfigurować aplikację jednym plikiem manifest, który zawiera pełną konfigurację. Po utworzeniu aplikacji zostaniesz przekierowany do App Settings. W sekcji Features przejdź do App Manifest.

Poniżej przygotowaliśmy plik manifestu, który należy wkleić w oknie App Manifest Slacka (upewnij się, że wklejasz YAML, a nie JSON). Możesz skopiować i wkleić bez obaw — najważniejsze linie wyjaśniamy poniżej:

• Ustaw odpowiednią nazwę i opis Asystenta AI (display_information)
• Upewnij się, że karta wiadomości bota jest włączona (features/app_home/messages_tab_enabled)
• Nadaj uprawnienia do czytania i pisania wiadomości (oauth_config/scopes)
• Ustaw odpowiednie zdarzenia bota obsługiwane przez serwer Quickchat (settings/event_subscriptions/bot_events)

display_information:
  name: Talk to AI
  description: Talk to me about Quickchat!
features:
  app_home:
    home_tab_enabled: false
    messages_tab_enabled: true
    messages_tab_read_only_enabled: false
  bot_user:
    display_name: Talk to AI
    always_online: true
oauth_config:
  scopes:
    bot:
      - im:history
      - im:write
      - chat:write
settings:
  event_subscriptions:
    request_url: https://slack.quickchat.ai/chat/
    bot_events:
      - message.im
      - app_home_opened
  org_deploy_enabled: false
  socket_mode_enabled: false
  token_rotation_enabled: false

Wskazówka

Jeśli chcesz, aby można było @wspominać bota w innych kanałach i otrzymywać odpowiedzi w wątkach, rozszerz manifest w ten sposób.

display_information:
  name: Talk to AI
  description: Talk to me about Quickchat!
features:
  app_home:
    home_tab_enabled: false
    messages_tab_enabled: true
    messages_tab_read_only_enabled: false
  bot_user:
    display_name: Talk to AI
    always_online: true
oauth_config:
  scopes:
    bot:
      - im:history
      - im:write
      - chat:write
      - app_mentions:read
      - channels:history
      - groups:history
settings:
  event_subscriptions:
    request_url: https://slack.quickchat.ai/chat/
    bot_events:
      - message.im
      - app_home_opened
      - app_mention
      - message.groups
      - message.channels
  org_deploy_enabled: false
  socket_mode_enabled: false
  token_rotation_enabled: false

Zapisz manifest. Zanim zmiany zostaną zastosowane, zostaniesz poproszony o weryfikację adresu URL — kliknij link:

Gotowe! Aplikacja bota Slack została skonfigurowana. Jeśli chcesz zmienić wygląd i opis bota, przejdź do Settings → Basic information i sekcji Display Information:

Zintegruj bota Slack z Quickchat AI

Prawie koniec. Na ostatnim kroku integrujemy bota Slack z Quickchat AI. Najpierw potrzebujemy danych ze Slacka:

• App ID: Settings → Basic Information → App Credentials
• Signing Secret: Settings → Basic Information → App Credentials
• Bot User OAuth Token: Features → OAuth & Permissions → OAuth Tokens for Your Workspace 👉 Zostaniesz poproszony o instalację bota w swoim workspace. Po kliknięciu Allow wrócisz do ustawień, gdzie będzie można skopiować token OAuth.

Te informacje przydadzą się w następnym kroku, więc pozostaw kartę otwartą.

W nowej karcie otwórz dashboard Quickchat AI, przejdź do External Apps, znajdź Slack i podaj App ID, Signing Secret oraz OAuth Token.

I to wszystko! 🎉 Twój bot czatu AI jest gotowy do testów na Slacku!