Ilustracja poradnika tworzenia bota na Discorda

Uruchom swojego chatbota AI na Discordzie

Chcesz stworzyć inteligentnego bota konwersacyjnego AI na swój serwer Discord? Ten poradnik krok po kroku przeprowadzi Cię przez cały proces w zaledwie 10 minut, bez programowania!

Obejrzyj film


5 prostych kroków do własnego bota AI

Po wykonaniu tych kroków Twój serwer Discord będzie mieć w pełni działającego chatbota AI:

  1. Utwórz serwer Discord
  2. Utwórz aplikację Discord
  3. Dodaj bota na serwer
  4. Utwórz konto Quickchat AI
  5. Połącz bota Discord z Quickchat AI

Tak będzie wyglądać Twój bot AI

Po konfiguracji bot będzie dostępny na Discordzie i gotowy do naturalnych rozmów z członkami serwera.

Efekt końcowy: inteligentny bot konwersacyjny AI


Najszybsza metoda: połączenie jednym kliknięciem

Jeśli masz już konto Quickchat AI, możesz całkowicie pominąć Developer Portal. W panelu otwórz External Apps na lewym pasku, wybierz Discord, a następnie w sekcji Connect kliknij Add to your Discord server.

Ekran połączenia Discord w Quickchat AI z przyciskiem Add to your Discord server Ekran połączenia jednym kliknięciem w External Apps → Discord.

Discord poprosi o autoryzację wspólnej aplikacji Quickchat AI i wybór serwera. Kliknij Authorize. Bot jest gotowy i może odpowiadać na @wzmianki w kanałach. Potrzebujesz tylko uprawnienia Manage Server na wybranym serwerze.

Nowe konta Quickchat AI otrzymują konfigurację dopasowaną do Discorda, która prowadzi bezpośrednio do tego procesu.

Ekran wdrożenia dla nowych kont Quickchat AI dopasowany do Discorda Nowe konta zaczynają od ekranu Discord prowadzącego do połączenia jednym kliknięciem.

Poniższe kroki opisują ręczną alternatywę Use your own Discord app: tworzysz własną aplikację Discord i łączysz ją tokenem bota. Wybierz tę metodę, jeśli chcesz własną nazwę i awatar, wiadomości prywatne, Discord AI Actions lub kilka botów na jednym serwerze. Discord Actions wymagają własnego połączenia, ponieważ dostarcza ono token używany w żądaniach do Discord API.


1. Utwórz serwer Discord

Jeśli nie masz konta Discord, utwórz je na discord.com. Następnie załóż pierwszy serwer:

Tworzenie pierwszego serwera


2. Utwórz aplikację Discord

Otwórz Discord Developer Portal i utwórz nową aplikację.

Tworzenie nowej aplikacji


3. Dodaj bota na serwer Discord

Włącz dostęp bota do treści wiadomości za pomocą pokazanego przełącznika:

Włączanie dostępu do treści wiadomości

Po utworzeniu bota dodaj go na serwer. W tym celu zbuduj adres Discord i wklej go do przeglądarki:

https://discord.com/api/oauth2/authorize?client_id=<YOUR CLIENT ID>&permissions=309237713920&scope=bot

Skąd pochodzi liczba określająca uprawnienia?

Liczba 309237713920 odpowiada następującym uprawnieniom:

  • View Channels
  • Send Messages
  • Create Public Threads
  • Send Messages in Threads
  • Read Message History

To minimalny zestaw potrzebny do poprawnego działania bota. Możesz go sprawdzić na discord.com/developers/applications: wybierz aplikację, kliknij Bot po lewej i przewiń w dół.

Uprawnienia bota Discord

Gdzie znaleźć YOUR CLIENT ID?

Najprościej skopiować długą liczbę z paska adresu przeglądarki:

https://discord.com/developers/applications/<YOUR CLIENT ID>/bot

Identyfikator klienta

W tym przykładzie identyfikator to 1234567890123456789, więc pełny adres dodający bota na serwer wygląda tak:

https://discord.com/api/oauth2/authorize?client_id=1234567890123456789&permissions=309237713920&scope=bot

Jeśli na tym etapie wystąpi problem:

  • “Integration requires code grant”: Aplikacja ma włączone Require OAuth2 Code Grant. Otwórz ją w Developer Portal, przejdź do Bot, wyłącz tę opcję, zapisz i ponownie otwórz adres zaproszenia. (Szczegóły)
  • Ekran z ciastem lub napisem “baked”: To strona sukcesu Discorda. Bot został dodany. Sprawdź Server Settings → Integrations → Bots and Apps.
  • Wskazówka: Gdy wkleisz token bota do panelu Quickchat AI w kroku 5, strona integracji sama utworzy adres zaproszenia i pokaże listę kontrolną. Możesz więc pominąć ręczne składanie adresu.

4. Utwórz konto Quickchat AI

Zarejestruj się w Quickchat AI, aby Twój bot prowadził naturalne rozmowy z pomocą AI.

Quickchat AI pozwala tworzyć agentów AI z własną bazą wiedzy, AI Actions i innymi funkcjami, do wykorzystania na Discordzie, stronach internetowych i w innych kanałach.


5. Połącz bota z Quickchat AI

Aby połączyć bota z Quickchat AI, pobierz Discord Bot Token z Developer Portal.

  1. Przejdź do Bot SettingsReset TokenCopy Token.

Resetowanie tokena

  1. W panelu Quickchat AI otwórz External Apps → Discord, wybierz Use your own Discord app i wklej token. Quickchat AI uruchomi bota i pokaże jego status podczas startu.

Wklejanie tokena

Jeśli bot nie pojawia się online

Gdy uruchomienie się nie powiedzie, strona integracji pokaże dokładny błąd i link do rozwiązania. Dwie najczęstsze przyczyny:

  • Nieprawidłowy token: Token jest błędny albo został wygenerowany ponownie, co unieważnia poprzedni. Otwórz bota w Developer Portal, wybierz Bot → Reset Token, skopiuj nowy token, następnie kliknij Reconnect w Quickchat AI i wklej go. Zrzut ekranu znajdziesz w Invalid bot token.
  • Wyłączony Message Content Intent, zgłaszany jako PrivilegedIntentsRequired: Bot połączył się, ale nie może czytać wiadomości. W Developer Portal otwórz Bot → Privileged Gateway Intents, włącz Message Content Intent i zapisz. Właściwy przełącznik pokazuje Message Content Intent.

Zmiana tokena lub ustawień restartuje bota. Poczekaj do minuty, aż pojawi się online.

Jeśli własny bot jest online, ale nie odpowiada

Sprawdź, czy na tym samym serwerze nadal jest wspólny bot Quickchat AI dodany jednym kliknięciem. Jeśli są oba, odpowiada wspólny bot, a własny milczy mimo poprawnego tokena, intentów i uprawnień. Otwórz External Apps w panelu Quickchat AI, znajdź serwer pod Connected servers w konfiguracji jednym kliknięciem i usuń go stamtąd. Własny bot przejmie obsługę od razu. Zobacz Both bots are in the same server.


Twój bot AI działa!

Wróć na Discorda. Bot powinien być online i gotowy do rozmowy. Użyj @wzmianki, aby zacząć.

Aktywny bot

Po @wzmiance bot domyślnie odpowiada w kanale. Jeśli wybierzesz Thread w ustawieniu Reply in, utworzy wątek, w którym użytkownicy mogą kontynuować rozmowę bez ponownego oznaczania bota.

Rozmowa w wątku


Jak bot odpowiada

Bota można wywołać na kilka sposobów. Każdy inaczej traktuje historię rozmowy:

SytuacjaSposób wywołaniaHistoria rozmowy
@wzmianka w kanaleOznacz bota w dowolnym kanale tekstowymZależy od Reply in, opisanego poniżej
Wiadomość w wątku botaNapisz w wątku utworzonym przez botaPełna historia wątku jest zachowana
Odpowiedź na wiadomość botaUżyj funkcji odpowiedzi DiscordaZa każdym razem nowa rozmowa
Polecenie /askWpisz /ask i pytanie, tylko we wspólnym bocieZa każdym razem nowa rozmowa
Wiadomość prywatnaWyślij DM, tylko przy własnej aplikacjiZachowana przez całą sesję DM

Zwykła wiadomość w kanale niczego nie uruchamia. To celowe, aby bot nie przeszkadzał na aktywnym serwerze, i najczęstsza przyczyna wrażenia, że nowy bot nie działa. /ask jest łatwiejszą do odkrycia alternatywą: wpisanie / wyświetla polecenie. Działa ono także przy ograniczonym dostępie do treści wiadomości. Jest zarejestrowane we wspólnym bocie; przy własnej aplikacji używaj @wzmianek.

Ustawienie “Reply in”

W panelu Quickchat pod Channels > External Apps > Discord znajdziesz listę “Reply in:” z dwiema opcjami:

  • Channel, domyślnie: Bot odpowiada bezpośrednio w kanale, w którym go oznaczono. Każda @wzmianka rozpoczyna nową rozmowę bez pamięci wcześniejszych interakcji.
  • Thread: Dla każdej @wzmianki powstaje nowy wątek nazwany od bota i użytkownika, np. “Aria & john_doe”. W nim bot odpowiada na każdą wiadomość bez oznaczania i zachowuje całą historię rozmowy.

Wiadomości prywatne

DM wymagają własnej aplikacji Discord. Wspólny bot odpowiada tylko na serwerach, ponieważ obsługa niezamówionych DM pod jedną wspólną tożsamością dotyczyłaby wszystkich obsługiwanych serwerów.

Przy własnej aplikacji DM nie wymaga @wzmianki. Bot odpowiada na każdą wiadomość i zachowuje historię w ramach sesji. W DM nie ma dostępu do historii kanałów serwera.

Uwaga: Bot odpowiada tylko w wątkach, które sam utworzył. Nie reaguje na wiadomości w wątku założonym ręcznie.


Jak bot rozumie kontekst kanału

Po @wzmiance bot widzi więcej niż pojedynczą wiadomość. Automatycznie pobiera ostatnie wiadomości z kanału i dodaje je do promptu AI jako transkrypcję ze znacznikami czasu. Dzięki temu rozumie trwającą rozmowę i może odwoływać się do wcześniejszych wypowiedzi.

Z perspektywy AI taki kontekst wygląda przykładowo tak:

Most recent messages on the #general channel:
[2026-02-19 14:01] alice: Has anyone tried the new API endpoint?
[2026-02-19 14:03] bob: Yeah, I got a 429 back after about 50 requests
[2026-02-19 14:05] alice: @QuickchatBot what's the rate limit for the v2 API?

Bot czyta też wiadomości z aktywnych i zarchiwizowanych wątków kanału, więc ich dyskusje również trafiają do kontekstu.

Gdy ktoś odpowiada na konkretną wiadomość funkcją Reply, bot ogranicza kontekst do wiadomości bezpośrednio wokół niej zamiast całej niedawnej historii. Otrzymuje w ten sposób kontekst rozmowy, do której odnosi się użytkownik.

Naklejki, GIF-y, obrazy, osadzone treści i reakcje są reprezentowane adnotacjami. Bot wie więc o ich obecności, choć nie widzi ich wizualnie w transkrypcji. Tokeny @wzmianek zastępowane są czytelnymi nazwami użytkowników.

Nie wymaga to konfiguracji. Kontekst kanału jest domyślnie włączony dla wszystkich botów Quickchat AI na Discordzie.

Bot wykorzystuje kontekst kanału do odpowiedzi na kolejne pytanie

Inteligentne wyszukiwanie AI w historii serwera

Domyślnie bot czyta tylko kanał, w którym go oznaczono. Po włączeniu Smart AI search over server history AI może pobierać wiadomości z dowolnego kanału tekstowego serwera. Sama wybiera kanał na podstawie pytania.

Na przykład pytanie w #general o ustalenia dotyczące migracji w #engineering może skłonić bota do odczytania historii #engineering i udzielenia odpowiedzi na jej podstawie.

Funkcja obsługuje także filtrowanie oknem czasowym i stronicowanie, więc w razie potrzeby AI może sięgnąć dalej w przeszłość.

TrybZakresZastosowanie
DomyślnyTylko bieżący kanałOgólny bot społecznościowy
Smart AI search over server historyDowolny kanał serweraBoty wsparcia i wyszukiwanie wiedzy między kanałami

Uwaga: Smart AI search over server history jest obecnie w wersji beta. Zainteresowanych zapraszamy do kontaktu mailowego lub na serwer Discord Quickchat.

Przełącznik Smart AI search over server history w ustawieniach integracji


Wysyłanie obrazów do bota

Użytkownik może dołączyć obraz do @wzmianki, a AI przetworzy go za pomocą funkcji rozumienia obrazu. Obsługiwane formaty to PNG, JPG, JPEG, GIF i WebP. Przy kilku załącznikach bot analizuje pierwszy obraz.

Adres obrazu z CDN Discorda trafia razem z tekstem do modelu jako wejście multimodalne. AI widzi więc oba elementy w tej samej turze. Rozumienie obrazów jest domyślnie włączone i nie wymaga konfiguracji.

Przykładowe zastosowania w społecznościach Discord:

  • Społeczność programistów: Użytkownik pokazuje zrzut stosu wywołań lub błędu i prosi o wyjaśnienie.
  • Społeczność projektantów: Użytkownik udostępnia makietę interfejsu i prosi o opinię.
  • Społeczność graczy: Użytkownik pokazuje ustawienia gry i pyta o optymalizację.
  • Wsparcie e-commerce: Klient wysyła zdjęcie uszkodzonego produktu.

Użytkownik wysyła zrzut ekranu, a bot analizuje obraz, aby odpowiedzieć


Łączenie AI Actions z Discordem

AI Actions pozwalają botowi wywoływać zewnętrzne API i narzędzia podczas rozmowy. Konfigurujesz je raz w panelu Quickchat pod AI Agent > Actions & MCPs. Działają we wszystkich kanałach, w tym Discordzie, widżecie strony, WhatsAppie i Telegramie.

Dostępne są dwa typy akcji:

Typ akcjiDziałanie
API ActionŻądania HTTP GET, POST, PUT i DELETE do zewnętrznych adresów, z konfigurowalnymi parametrami, nagłówkami i treścią
Remote MCPPołączenie z serwerem Model Context Protocol, udostępniającym narzędzia i źródła danych

Przykłady rozwiązań z AI Actions na Discordzie:

  • Śledzenie zamówień: Połącz API Action z zapleczem sklepu. Członkowie mogą zapytać o zamówienie #12345 i otrzymać aktualny status.
  • Bot zgłoszeń GitHub: Połącz repozytorium przez Remote MCP, aby programiści mogli pytać o otwarte błędy oznaczone critical.
  • Bot zgłoszeń wsparcia: Odpowiada z dokumentacji i otwiera prywatny wątek zgłoszenia z oznaczeniem roli wsparcia tylko wtedy, gdy nie potrafi rozwiązać sprawy.
  • Pomocnik moderacji: Wybierz szablony timeout, kick, ban i slowmode, aby moderatorzy uruchamiali je naturalnymi poleceniami.
  • Umawianie spotkań: Połącz Remote MCP z Cal.com lub Google Calendar, aby użytkownicy rezerwowali spotkania przez Discorda.
  • Integracja CRM: Połącz HubSpot, aby bot zapisywał leady lub tworzył zgłoszenia wsparcia z rozmów.
  • Zapisywanie leadów i opinii: Połącz Google Sheets, aby leady, pytania bez odpowiedzi i prośby o demo trafiały bezpośrednio do arkusza zespołu.

Konfiguracja API Action

  1. W panelu Quickchat przejdź do AI Agent > Actions & MCPs.
  2. Kliknij Add Action. Dla obsługiwanej operacji Discord wybierz Discord Action i szablon. Szablon wsparcia pyta o serwer, kanał i rolę. Szablony moderacji instalują się bezpośrednio. Quickchat przygotowuje edytowalne żądanie, opis, parametry, przetwarzanie odpowiedzi i warunki uruchomienia.
  3. Własną akcję HTTP Request wybierz tylko dla adresu spoza galerii. Nadaj nazwę, np. “Sprawdź status zamówienia”, oraz opis, np. “Użyj, gdy użytkownik pyta o status zamówienia. Najpierw poproś o numer zamówienia.”
  4. Ustaw metodę HTTP, np. GET, adres końcowy i parametry, a następnie zapisz.

Akcja jest dostępna dla agenta w obsługiwanych kanałach. Akcje Discord z galerii są zwykłymi, edytowalnymi HTTP Request Actions, dlatego po zmianach sprawdź ich autoryzację, cele i parametry. Więcej znajdziesz w poradniku HubSpot AI Actions, poradniku moderacji Discord, obejmującym timeout, kick, ban, role i slowmode, oraz w dokumentacji Actions.

Strona Actions & MCPs z skonfigurowaną API Action


Dalsza lektura

Te poradniki rozwijają powiązane tematy:


Zarejestruj się w Quickchat AI, aby zacząć tworzyć agenta, lub dołącz do społeczności Discord: discord.gg/KqkHwvPRNH