Dostosuj bota czatu
Ten poradnik pokazuje, jak zmienić aplikację bota po stronie dostawcy bez wychodzenia z Control Center.
Wymagania wstępne
Dział zatytułowany „Wymagania wstępne”- Rola
ownerlubadminw obszarze roboczym - Połączony dostawca. Wiersz Dostosuj bota pojawia się dopiero wtedy, gdy obszar roboczy jest połączony
- Aplikacja, którą Control Center może zarządzać. W przypadku Slacka oznacza to, że połączenie przechowuje token odświeżania konfiguracji aplikacji (
xoxe-…); jeśli go nie ma, wiersz mówi o tym i pozostaje wyłączony
Co możesz zmienić
Dział zatytułowany „Co możesz zmienić”| Pole | Znaczenie | Limit |
|---|---|---|
| Nazwa aplikacji | Jak dostawca wyświetla aplikację na liście | 1–35 znaków |
| Nazwa bota (co członkowie wpisują po @) | Co członkowie wpisują po @ |
1–80 znaków |
| Krótki opis | Jedna linia wyświetlana przez dostawcę | Maksymalnie 140 znaków |
| Co bot mówi, że potrafi | Wyświetlane nad wiadomością prywatną z botem | Maksymalnie 300 znaków |
| Polecenie z ukośnikiem | Polecenie wywoływane przez członków, bez ukośnika | Małe litery, tylko a–z 0–9 _ -, obcinane po 32 znakach |
| Wiadomości prywatne | Czy bot udostępnia doświadczenie wiadomości prywatnych i agenta | Włączone lub wyłączone |
Control Center weryfikuje cztery pola tekstowe, zanim wywoła dostawcę, dzięki czemu dostajesz komunikat „the app name must be between 1 and 35 characters” zamiast nieprzejrzystego invalid_manifest z serwera, którego nie widzisz. Polecenie nie jest odrzucane, lecz normalizowane: wiodący ukośnik jest usuwany, reszta zamieniana na małe litery, wszystko poza a–z 0–9 _ - jest odrzucane, a pusty wynik wraca do wartości cc.
Edytuj bota
Dział zatytułowany „Edytuj bota”- Przejdź do Ustawienia → Obszar roboczy → Ogólne i przewiń do karty Mostki czatu
- W bloku dostawcy kliknij Dostosuj bota
- Okno dialogowe otwiera się na bieżących wartościach aplikacji, odczytanych z powrotem od dostawcy — więc punktem wyjścia jest zmiana, którą ktoś wprowadził we własnym interfejsie Slacka
- Zmień, co trzeba, i zapisz
Odczytywanie tych bieżących wartości kosztuje rotację tokenu po stronie Slacka — dlatego wiersz wymaga świadomego kliknięcia, a nie jest czymś, co strona robi przy wczytywaniu.
Zapis nakłada Twoje zmiany na bieżącą definicję aplikacji. Wszystko, czego Control Center nie modeluje — drugie polecenie z ukośnikiem dodane w Slacku, krok workflow, niepowiązane ustawienie — pozostaje nietknięte. Zakresy i zdarzenia są scalane, nigdy odejmowane.
Po zapisaniu Control Center odczytuje tożsamość bota ponownie, aby nazwa w ustawieniach zgadzała się z nazwą w aplikacji czatu.
Zainstaluj ponownie, gdy zmienią się uprawnienia
Dział zatytułowany „Zainstaluj ponownie, gdy zmienią się uprawnienia”Gdy zapis zmienia uprawnienia, okno dialogowe pozostaje otwarte i mówi: „Slack zmienił uprawnienia aplikacji. Zainstaluj ją ponownie, aby zaczęły obowiązywać.“, z przyciskiem Zainstaluj ponownie, który otwiera stronę instalacji tej aplikacji w zespole Slacka. W Slacku to Install App → Reinstall to Workspace.
Zmień nazwę polecenia z ukośnikiem
Dział zatytułowany „Zmień nazwę polecenia z ukośnikiem”Zmień Polecenie z ukośnikiem i zapisz. Most tworzy wtedy instrukcje, używając polecenia, którym został wywołany ostatnio, więc tekst pomocy i instrukcje linkowania podążają za zmianą nazwy, zamiast wskazywać polecenie, które już nie istnieje.
Zmiana nazwy nie psuje istniejących wątków w moście: wątki są kluczowane rozmową, a nie poleceniem.
Czego Control Center nie zmieni
Dział zatytułowany „Czego Control Center nie zmieni”- Ustawienia strukturalne. Transport (Socket Mode), wymagane zakresy i subskrypcje zdarzeń są narzucane, a nie udostępniane. Aplikacja, którą da się wyciszyć z ekranu ustawień, to zgłoszenie do wsparcia, a nie funkcja
- Ikona bota. Zmienić ją mogą wyłącznie własne ustawienia aplikacji dostawcy, i okno dialogowe tak mówi
- Własne migracje funkcji dostawcy. Aplikacja, która działa już na dawnej formie asystenta Slacka, pozostaje przy niej; to okno edytuje opis, a nie migruje aplikacji
Rozwiązywanie problemów
Dział zatytułowany „Rozwiązywanie problemów”Wiersz „Dostosuj bota” w ogóle się nie pojawia
Dział zatytułowany „Wiersz „Dostosuj bota” w ogóle się nie pojawia”Obszar roboczy nie jest jeszcze połączony. Wiersz pojawia się dopiero wtedy, gdy blok dostawcy pokazuje aktywne połączenie. Zobacz Skonfiguruj integrację Slack.
Wiersz „Dostosuj bota” jest wyłączony
Dział zatytułowany „Wiersz „Dostosuj bota” jest wyłączony”Połączenie nie ma poświadczeń do zarządzania aplikacją — podtytuł wiersza mówi: „Do edycji bota Control Center potrzebuje tokenu konfiguracji aplikacji. Połącz się ponownie i dołącz taki token.“. W przypadku Slacka wygeneruj parę tokenów konfiguracji aplikacji na api.slack.com/apps i połącz się ponownie z wypełnionym tokenem odświeżania. Jest to oczekiwane w przypadku aplikacji zbudowanej ręcznie albo utworzonej przez Utwórz w Slack, ponieważ Slack nigdy nie zgłasza, którą aplikację utworzył.
„Control Center does not know which app to edit”
Dział zatytułowany „„Control Center does not know which app to edit””Zapisane połączenie nie zawiera identyfikatora aplikacji — zwykle dotyczy to aplikacji połączonej ręcznie, zanim identyfikator został zapisany. Połącz obszar roboczy ponownie albo utwórz aplikację z poziomu Control Center.
Nowa nazwa bota nie pojawiła się w czacie
Dział zatytułowany „Nowa nazwa bota nie pojawiła się w czacie”Dostawcy krótko buforują metadane aplikacji. Jeśli nazwa jest nieaktualna po minucie, sprawdź, czy zapis nie poprosił Cię o ponowną instalację aplikacji.