Aby zacząć konfiguracje modułu Discord, musimy aktywować usługę, którą znajdziemy w zakładce opłaty. Po znalezieniu na liście należy kliknąć włącz. Po aktywacji pojawi się na liście aktywnych modułów jak widoczne jest to niżej.
Następnie po aktywacji wchodzimy w Integracje, gdzie znajdujemy Kanały komunikacyjne w których jest między innymi Discord.
Po wejściu w ikonę Discord, pokazuje nam się opcja dodania bota. Należy kliknąć przycisk dodaj bota. Po zrobieniu tego pojawi nam się okno z informacjami, które musimy uzupełnić aby dodać bota.
W celu uzyskania tych danych należy wejść na stronę Discord o linku https://discord.com/developers/applications na której musimy być zalogowani na swoje konto. Następnie stworzyć nową aplikację, klikając w prawym górnym rogu „New Application” po czym nazwać dowolnie swoją aplikację.
Następnie wchodzimy w zakładkę „Add bot” gdzie dodajemy nowego bota.
Po dodaniu nowego bota należy zresetować jego token za pomocą przycisku „Reset token”.
Po zresetowaniu tokena, pojawi się nowy. Należy go zapisać, można np. skopiować do notatnika.
Musimy również zapisać ID aplikacji które znajdziemy w zakładce „General Information”.
Następnym krokiem będzie konfiguracja uprawnień naszego bota. Można to zrobić wchodząc w zakładkę OAuth2 > URL Generator. Po czym wybieramy bot i zaznaczamy uprawnienia, które są potrzebne. Po zaznaczeniu odpowiednich uprawnień poniżej wygeneruje się adres URL, który należy skopiować.
Skopiowany adres URL należy wkleić w nowej karcie wyszukiwarki. Przekieruje nas on na stronę na której wybierzmy do którego serwera ma zostać dodany bot. Po wybraniu odpowiedniego serwera i zaakceptowaniu warunków zobaczymy potwierdzenie.
Po tym możemy zobaczyć na naszym serwerze, że został dodany bot, którego stworzyliśmy.
Po dodaniu bota przechodzimy do ustawień Discorda, znajdujemy zakładkę zawansowane i włączamy tryb dewelopera. Po czym kopiujemy adres naszego serwera Discord klikając w niego prawym przyciskiem myszy i wybierając opcję kopiuj ID, zapisuje go wraz z innymi.
Po skopiowaniu ID serwera możemy wrócić do panelu sellpandera, do sekcji dodaj bota. Uzupełniamy dane w następujący sposób.
Bot zostaje dodany przez przycisk „Dodaj” i jest widoczny. Bota można również edytować i usunąć za pomocą przycisków po prawej stronie.
Aby skonfigurować alert należy wejść w zakładkę Baselinker > Discord po czym wybieramy bota i dodajemy alert.
Po kliknięciu „Dodaj alert” wyświetli nam się okno z polami które musimy uzupełnić. Nazwa alertu jest dowolna i widoczna tylko dla twórcy, kanały są pobierany automatycznie z serwera Discord.
Kiedy dodamy nasz alert, możemy go skonfigurować z baselinkerem. Należy skopiować adres URL za pomocą przycisku „Kopiuj adres”.
Po skopiowaniu adresu URL przechodzimy do naszego baselinkera. Wchodzimy w Zamówienia > Automatyczne akcje. Tutaj dodajemy automatyczną akcję, dla przykładu „Pobrano zamówienie”, dzięki czemu za każdym razem zamówienie zostanie pobrane dostaniemy alert na naszym serwerze Discord.
Używanie tagów
Do naszej integracji chcemy dodać interpolację, czyli możliwość podmniany specjalnych tagów na wartości, które będą przekazne w query.
Z perspektywy użytkowanika tag może byc dowolnym tekstem umieszczonym w treści alertu w nawiasach kwadratowych.
Przykładowa treść alertu zawierającego tagi:
Produkt [produkt_id] przekroczył stan progowy. Jego obecna ilość to: [ilosc]
Adres którym będzie wywołane wysłanie takiego alertu będzie zawierać w parametrach query wartości które mają zostać podstawione pod odpowienie tagi.
W przypadku powyższej przykładowej wiadomości adres wywołania mógłby wyglądać tak:
/api/DiscordIntegration?userId=123&token=xyz&alertId=123&product_id=456&ilosc=3
Nazwa parametru zawsze będzie odpowiadać nazwie tagu.
Podmieniamy tylko te tagi, dla których zostały podane parametry. Jeśli parametr nie został podany, to jest to błąd konfiguracji po stronie użytkownika
