Discord Relay
Most na żywo między Discordem a GameVox. Wiadomości wysłane na twoich kanałach Discorda pojawiają się na twoich kanałach GameVox w ciągu kilku sekund, z nazwą i awatarem autora, a edycje, usunięcia, reakcje i załączniki są synchronizowane. Połącz go z przekaźnikiem czatu GameVox → Discord, a most zadziała w obie strony.
Co jest przekazywane
Wszystko, co dzieje się z wiadomością na Discordzie, odbite w GameVox
Wiadomości
Publikowane z wyświetlaną nazwą i awatarem autora z Discorda, więc rozmowa czyta się naturalnie po obu stronach. Działa tak samo na zwykłych kanałach, jak i na kanałach ogłoszeń, łącznie z postami przychodzącymi z kanałów obserwowanych przez twój serwer.
Edycje i usunięcia
Edytuj wiadomość na Discordzie, a kopia w GameVox się zaktualizuje; usuń ją, a odbicie zniknie. Z dołączonym przekaźnikiem GameVox → Discord edycje i usunięcia zrobione w GameVox też aktualizują kopię na Discordzie w miejscu, bez zaśmiecających czat ponownych postów z dopiskiem „(edytowano)”.
Reakcje
Reaguj z dowolnej strony połączonej wiadomości. Reakcje z Discorda pojawiają się w GameVox jako plakietki na żywo, z nazwą osoby, która zareagowała, a reakcje dodane w GameVox pojawiają się pod oryginalną wiadomością na Discordzie.
Załączniki i naklejki
Obrazy, pliki i naklejki jadą razem z wiadomością i wyświetlają się bezpośrednio w GameVox.
Uzupełnianie historii
Jednym kliknięciem ściągnij do GameVox do 500 ostatnich wiadomości z kanału Discorda, od najstarszej.
Dziennik połączeń
Dziennik połączenia bota na żywo, ze znacznikami czasu, prosto w ustawieniach serwera. Widzisz dokładnie, kiedy się połączył albo dlaczego mu się nie udało.
Chcesz, żeby wiadomości płynęły też w drugą stronę? Połącz przekaźnik z GameVox → Discord (Przekaźnik czatu) w tej samej zakładce ustawień: wiadomości z GameVox trafiają na Discorda, a edycje i usunięcia zrobione w GameVox aktualizują kopię na Discordzie w miejscu. Ochrona przed pętlą jest wbudowana: odbite wiadomości nigdy nie są przekazywane ponownie.
Konfiguracja
Około pięciu minut. Potrzebujesz uprawnienia Zarządzanie serwerem („Manage Server”) na serwerze Discord i Zarządzaj serwerem na serwerze GameVox. Kreator w aplikacji przeprowadzi cię przez te same kroki.
Utwórz bota
Otwórz Discord Developer Portal, kliknij New Application i nadaj jej nazwę, na przykład „GameVox Relay”. Konto bota powstaje razem z aplikacją, a jego nazwę członkowie będą widzieć jako most. Każda społeczność tworzy własnego bota, więc jest on w pełni pod twoją kontrolą. Nie musisz wgrywać awatara: bot automatycznie dostaje ikonę przekaźnika GameVox przy pierwszym połączeniu.
Pozwól mu czytać wiadomości
W swojej aplikacji otwórz zakładkę Bot i przewiń do Privileged Gateway Intents. Włącz Message Content Intent i zapisz.
Skopiuj token bota
Wciąż w zakładce Bot kliknij Reset Token i skopiuj go. Discord pokazuje token tylko raz; jeśli go zgubisz, po prostu zresetuj go ponownie. W GameVox jest przechowywany w zaszyfrowanej formie i po wklejeniu nigdy nikomu nie jest pokazywany.
Zaproś bota na swój serwer Discord
W GameVox otwórz Ustawienia serwera → Integracja z Discordem → Discord → GameVox i wklej token w kroku 3 kreatora. Link z zaproszeniem pojawi się automatycznie: otwórz go, wybierz swój serwer Discord i kliknij Autoryzuj. Link nadaje uprawnienia Wyświetlanie kanałów („View Channels”), Czytanie historii wiadomości („Read Message History”), Dodawanie reakcji („Add Reactions”), żeby reakcje dodane w GameVox mogły pojawiać się na Discordzie, oraz Zarządzanie webhookami („Manage Webhooks”), na którym działa kierunek wiadomości GameVox → Discord.
Upewnij się, że bot widzi twoje kanały
Zaproszenie nadaje uprawnienia dla całego serwera, ale kanały prywatne ich nie dziedziczą. W każdym kanale z ograniczonym dostępem otwórz jego uprawnienia na Discordzie i dodaj bota (albo jego rolę) z uprawnieniami Wyświetlanie kanału („View Channel”) i Czytanie historii wiadomości („Read Message History”). Jeśli bot nie widzi kanału, nic z niego nie jest przekazywane, a uzupełnianie historii kończy się błędem uprawnień.
Połącz i zweryfikuj
Wróć do kreatora GameVox i wklej ID swojego serwera Discord (prawy klik na nazwę serwera na Discordzie → Kopiuj ID serwera; jeśli tego nie widzisz, włącz Tryb dewelopera w Ustawienia użytkownika → Zaawansowane), a potem kliknij Połącz i zweryfikuj. GameVox otwiera połączenie i śledzi je na żywo: po kilku sekundach status robi się zielony, Przekaźnik połączony i zweryfikowany. Jeśli coś jest nie tak, zamiast kręcącego się kółka dostajesz dokładny powód i sposób naprawy.
Zmapuj kanały i uzupełnij historię
Po weryfikacji odblokowuje się sekcja mapowania kanałów. Dla każdego mostu: prawy klik na kanał Discorda → Kopiuj ID kanału, wklej je, wybierz kanał GameVox, do którego ma być odbijany, i kliknij Dodaj mapowanie. Nowe wiadomości zaczynają płynąć od razu. Kliknij Uzupełnianie historii przy dowolnym mapowaniu, żeby ściągnąć do 500 ostatnich wiadomości, od najstarszej.
Rozwiązywanie problemów
Każdy błąd pojawia się na karcie statusu i w Dzienniku połączeń. Oto co oznacza każdy z nich
Discord odrzucił połączenie, bo Message Content Intent jest wyłączony. W Developer Portal otwórz swoją aplikację → zakładka Bot → Privileged Gateway Intents → włącz Message Content Intent → zapisz. Potem kliknij Ponów połączenie w GameVox, a w Dzienniku połączeń zobaczysz connecting → identifying → ready.
Dla botów na mniej niż 100 serwerach (a boty przekaźnikowe zawsze takie są) przełącznik działa od razu i za darmo, bez żadnej weryfikacji przez Discorda.
Discord odrzucił token bota: jest w nim literówka albo został zresetowany w portalu po tym, jak go zapisałeś. Przejdź do zakładki Bot, kliknij Reset Token, skopiuj nowy token, wklej go w Ustawienia bota w GameVox i kliknij Aktualizuj. Nowy token automatycznie wymusza nowe połączenie.
Bot jest na twoim serwerze Discord, ale nie widzi tego konkretnego kanału. Prawie zawsze oznacza to, że kanał (albo jego kategoria) jest prywatny, a kanały prywatne nie dziedziczą uprawnień dla całego serwera nadanych przez zaproszenie.
Naprawa: na Discordzie otwórz ustawienia kanału → Uprawnienia → dodaj bota (albo jego rolę) z zezwoleniem na Wyświetlanie kanału i Czytanie historii wiadomości. Jeśli kanał synchronizuje uprawnienia z kategorią, popraw kategorię. Potem uruchom uzupełnianie jeszcze raz.
Te same zasady dostępu obowiązują przy przekazywaniu na żywo: kanał, którego bot nie widzi, nie wysyła żadnych zdarzeń.
Sprawdź po kolei:
1. Sprawdź mapowanie. ID kanału Discorda musi należeć do kanału, na którym piszesz. Kliknij prawym przyciskiem sam kanał (nie serwer), użyj Kopiuj ID kanału i porównaj z wierszem mapowania.
2. Sprawdź, czy bot widzi kanał. Te same zasady dostępu co przy błędzie 403 powyżej: jeśli kanał jest prywatny, dodaj bota do jego uprawnień.
3. Sprawdź, czy status to READY. Jeśli Dziennik połączeń pokazuje błąd, najpierw go napraw. Mapowania działają tylko wtedy, gdy połączenie jest aktywne.
4. Intent cofnięty później? Jeśli przekaźnik działał, a przestał po zmianach w Developer Portal, włącz ponownie Message Content Intent i kliknij Ponów połączenie.
Dziennik połączeń pod kartą statusu zapisuje każdy stan, przez który przechodzi połączenie bota, od najnowszego, i przetrwa restarty po naszej stronie:
connecting / identifying: otwieranie gatewaya i logowanie bota · ready: połączony i przekazuje · reconnecting: chwilowy problem z siecią, automatyczne wznawianie · intent_denied / auth_failed: wymaga twojego działania (patrz wyżej) · stopped: przekaźnik został wyłączony albo się restartuje.
Prawidłowa konfiguracja kończy się na ready. Wszystko na czerwono mówi ci dokładnie, co naprawić, a po naprawie Ponów połączenie uruchamia całą sekwencję jeszcze raz na twoich oczach.
Wymagania
Czego potrzebujesz, zanim zaczniesz
- Własny bot Discord. Tworzony za darmo w Developer Portal w około minutę, kreator konfiguracji przeprowadzi cię przez to. Jeden bot na społeczność daje ci pełną kontrolę nad jego dostępem.
- Zarządzanie serwerem na Discordzie („Manage Server”). Wymagane, żeby zaprosić bota na serwer, który odbijasz.
- Zarządzaj serwerem w GameVox. Zakładka Integracja z Discordem w ustawieniach serwera jest dostępna tylko dla właścicieli i administratorów.
- Tryb dewelopera Discorda do kopiowania ID serwerów i kanałów: Ustawienia użytkownika → Zaawansowane → Tryb dewelopera.
Połącz swoją społeczność
Trzymaj rozmowę w jednym miejscu, gdy twoja społeczność się przenosi. Skonfiguruj przekaźnik w pięć minut.