Integracje — Discord

Skonfiguruj powiadomienia Discord o zamówieniach i codzienne raporty sprzedaży.

Dzięki integracji z Discordem Twój sklep będzie automatycznie wysyłał wiadomości na wybrany kanał — informacje o nowych zamówieniach oraz codzienne podsumowania sprzedaży. To świetny sposób, by trzymać rękę na pulsie bez logowania się do panelu.

Ekran konfiguracji integracji z Discordem

​

Gdzie to znaleźć

Discord ma własną zakładkę w menu po lewej — w sekcji Integracje → Discord (obok operatorów płatności). To tutaj podłączysz kanał i zdecydujesz, jak mają wyglądać wysyłane wiadomości.

Strona dzieli się na Połączenie (adres webhooka + przełącznik raportów dziennych) oraz dwie zakładki wyglądu: Powiadomienia o zamówieniach i Raporty dzienne. Każda z nich ma edytor embeda z podglądem na żywo — po prawej stronie od razu widzisz, jak wiadomość będzie wyglądać na Discordzie.

Wszystkie pola wyglądu (tytuł, kolor, nazwa nadawcy, wiadomość) są od razu wypełnione domyślnymi wartościami — tymi samymi, których sklep użyłby automatycznie. Nie musisz nic uzupełniać, by wiadomości wyglądały dobrze; po prostu zmień to, co chcesz.

​

Podłączenie Discorda

Aby sklep mógł wysyłać wiadomości na Twój serwer Discord, musisz podać tzw. adres webhooka. To specjalny link, który tworzysz po stronie Discorda — wskazuje on kanał, na który mają trafiać powiadomienia.

1. Utwórz webhook na Discordzie

   W ustawieniach swojego serwera Discord wejdź w Integracje → Webhooki, utwórz nowy webhook i wybierz kanał, na którym chcesz otrzymywać wiadomości. Następnie skopiuj jego adres.

2. Wklej adres webhooka w panelu

   Otwórz Integracje → Discord w menu po lewej i wklej skopiowany adres w polu Discord webhook URL (w sekcji Połączenie). Adres musi być pełnym, poprawnym linkiem (zaczyna się od https://discord.com/api/webhooks/...) — jeśli wkleisz coś innego, panel pokaże komunikat o błędnym adresie i nie pozwoli zapisać.

3. Zapisz integrację

   Kliknij Zapisz integrację na dole strony. Od tej chwili sklep będzie mógł wysyłać powiadomienia na wybrany kanał.

Adres webhooka traktuj jak hasło — nie udostępniaj go nikomu. Każdy, kto go zna, może wysyłać wiadomości na Twój kanał.

Jeśli pole adresu webhooka zostawisz puste, żadne wiadomości nie będą wysyłane — niezależnie od tego, czy poszczególne powiadomienia masz włączone. Adres webhooka to podstawa całej integracji.

​

Co możesz wysyłać na Discorda

Po podłączeniu webhooka decydujesz, jakie rodzaje wiadomości mają trafiać na kanał. Masz do dyspozycji dwa niezależne rodzaje powiadomień, każdy z własnym wyglądem i własnym włącznikiem:

Powiadomienia o zamówieniach

Wiadomość wysyłana automatycznie po każdym nowym, opłaconym zamówieniu — od razu wiesz, że ktoś coś kupił.

Codzienne raporty sprzedaży

Raz dziennie zbiorcze podsumowanie sprzedaży z poprzedniego dnia — przychód, liczba zamówień i klientów w jednym miejscu.

Oba rodzaje są od siebie całkowicie niezależne. Możesz włączyć tylko powiadomienia o zamówieniach, tylko raporty dzienne, oba naraz albo żadne. Każdy ma też osobny wygląd — inny tytuł, kolor, nazwę nadawcy i awatar.

​

Powiadomienia o zamówieniach

To wiadomości wysyłane automatycznie po każdym nowym zamówieniu. Znajdziesz je w zakładce Powiadomienia o zamówieniach, w panelu Wygląd embeda (po prawej masz podgląd na żywo). Możesz w pełni dostosować ich wygląd i treść.

Włącznik powiadomień

Przełącznik „Wysyłaj powiadomienie o nowym zamówieniu” decyduje, czy te wiadomości w ogóle mają wychodzić. Wyłącz go, jeśli chcesz na chwilę wstrzymać powiadomienia o zakupach, nie ruszając adresu webhooka.

Tytuł embeda

Nagłówek widoczny u góry wiadomości, np. „🛒 Nowe zamówienie”. Maksymalnie 120 znaków.

Kolor embeda

Kolor pionowego paska przy wiadomości — wybierasz go z palety kolorów. Dopasuj go do barw swojego serwera.

Nazwa nadawcy

Nazwa, pod jaką sklep będzie się przedstawiał na kanale, np. „ItemShop”. Maksymalnie 80 znaków.

URL awatara nadawcy

Adres obrazka profilowego widocznego przy wiadomościach — np. logo sklepu. Musi być poprawnym adresem internetowym.

Wiadomość nad embedem

Tekst wyświetlany nad powiadomieniem (opcjonalny), w którym możesz użyć danych z zamówienia. Maksymalnie 1500 znaków.

Pola tytuł, kolor, nazwa nadawcy i wiadomość są od razu wypełnione sensownymi domyślnymi wartościami — wiadomość będzie wyglądać dobrze bez żadnej konfiguracji. Zmień je tylko wtedy, gdy chcesz, żeby pasowały bardziej „pod Twój sklep”. URL awatara zostaje pusty (opcjonalny) — uzupełnij go np. logiem sklepu.

​

Dane, które możesz wstawić do wiadomości o zamówieniu

W polu Wiadomość nad embedem możesz użyć poniższych znaczników. Zostaną one automatycznie zastąpione prawdziwymi danymi z zamówienia:

Znacznik	Co wstawi
{nick}	Nick gracza, który złożył zamówienie
{product}	Nazwa kupionego produktu
{amount}	Kwota zamówienia
{server}	Serwer, którego dotyczy zakup
{orderId}	Numer zamówienia
{date}	Data zamówienia
{paymentMethod}	Wybrana metoda płatności
{quantity}	Liczba zakupionych sztuk

Używaj znaczników, aby wiadomości były spersonalizowane. Na przykład wpis: Gracz {nick} właśnie kupił {product} za {amount}! 🎉 zamieni się w konkretną wiadomość z danymi prawdziwego zamówienia.

​

Codzienne raporty sprzedaży

Oprócz powiadomień o pojedynczych zamówieniach możesz włączyć codzienne podsumowania. Raz dziennie sklep wyśle na Discorda zestawienie sprzedaży z poprzedniego dnia.

Raporty dzienne mają dwa przełączniki, którymi sterujesz osobno:

Wysyłaj codzienne raporty sprzedaży

Główny włącznik raportów — znajdziesz go w sekcji Połączenie, zaraz pod polem adresu webhooka. Dopiero gdy jest włączony, sklep w ogóle wysyła dzienne podsumowania.

Personalizuj embed raportu dziennego

Przełącznik w zakładce Raporty dzienne, w panelu Wygląd embeda. Decyduje, czy do raportu mają zostać użyte Twoje ustawienia wyglądu (tytuł, kolor, nazwa nadawcy, awatar, wiadomość).

Aby raporty zaczęły przychodzić, najpierw włącz główny przełącznik „Wysyłaj codzienne raporty sprzedaży” w sekcji Połączenie. Personalizacja w zakładce raportów tylko zmienia ich wygląd — sama z siebie nie uruchamia wysyłki.

Raporty mają takie same pola wyglądu jak powiadomienia o zamówieniach — możesz nadać im inny tytuł (np. „📊 Raport dzienny”), kolor embeda, nazwę nadawcy, awatar oraz własną wiadomość. Obowiązują te same ograniczenia: tytuł do 120 znaków, nazwa nadawcy do 80 znaków, wiadomość do 1500 znaków, a awatar musi być poprawnym adresem internetowym.

​

Dane, które możesz wstawić do raportu dziennego

Znacznik	Co wstawi
{date}	Data, której dotyczy raport
{revenue}	Łączny przychód z danego dnia
{net}	Przychód po odliczeniu kosztów (kwota netto)
{orders}	Liczba zamówień
{customers}	Liczba klientów

Tak samo jak przy zamówieniach — używaj znaczników, aby raporty były spersonalizowane. Przykład: 📊 Podsumowanie z {date}: {orders} zamówień, przychód {revenue}, netto {net}.

Znaczniki z powiadomień o zamówieniach i z raportów dziennych nie są wymienne. W raporcie dziennym używaj wyłącznie znaczników z tabeli powyżej.

​

Zapisywanie zmian

Wszystkie ustawienia integracji zapisujesz jednym przyciskiem „Zapisz integrację” na dole strony — obejmuje on obie zakładki (zamówienia i raporty). Dopóki go nie klikniesz, zmiany nie zostaną zachowane.

Jeśli w którymś polu wpiszesz coś niepoprawnego — błędny adres webhooka, zły adres awatara albo nieprawidłowy kolor — przy tym polu pojawi się czerwony komunikat, a zapis się nie powiedzie. Popraw zaznaczone pole i kliknij zapis ponownie.

Sam przycisk zapisu jest widoczny tylko dla osób z uprawnieniem do edycji ustawień. Współpracownik bez tego uprawnienia może zakładkę zobaczyć, ale nie zmieni jej ustawień.

​

Najczęstsze pytania

Nic nie przychodzi na Discorda — co sprawdzić?

Najpierw upewnij się, że pole Discord webhook URL jest wypełnione poprawnym adresem. Następnie sprawdź właściwy włącznik: dla zamówień musi być włączony przełącznik „Wysyłaj powiadomienie o nowym zamówieniu”, a dla raportów — „Wysyłaj codzienne raporty sprzedaży”. Na koniec upewnij się, że klikałeś Zapisz integrację.

Wiadomości trafiają na zły kanał.

Adres webhooka jest powiązany z konkretnym kanałem na Discordzie. Aby zmienić kanał, utwórz nowy webhook po stronie Discorda dla właściwego kanału i wklej jego adres w polu Discord webhook URL, a potem zapisz.

Raporty dzienne nie przychodzą, choć personalizację mam włączoną.

Personalizacja zmienia tylko wygląd raportu — nie uruchamia wysyłki. Włącz dodatkowo główny przełącznik „Wysyłaj codzienne raporty sprzedaży” u góry sekcji.

Chcę na chwilę wstrzymać powiadomienia, ale nie kasować webhooka.

Nie musisz usuwać adresu. Wyłącz po prostu odpowiedni przełącznik — „Wysyłaj powiadomienie o nowym zamówieniu” lub „Wysyłaj codzienne raporty sprzedaży” — i zapisz. Adres webhooka pozostanie zapisany na później.

Wiadomości wyglądają „surowo", bez nazwy i loga sklepu.

To znaczy, że pola wyglądu (tytuł, nazwa nadawcy, awatar) są puste i Discord używa wartości domyślnych. Uzupełnij Tytuł embeda, Nazwę nadawcy i URL awatara, a wiadomości nabiorą charakteru Twojego sklepu.

​

Dobre praktyki

• Osobny kanał na powiadomienia — utwórz na Discordzie dedykowany kanał (np. #zamówienia) tylko dla wiadomości ze sklepu. Łatwiej wtedy o nich nie przeoczyć.
• Pilnuj webhooka jak hasła — nie wklejaj adresu webhooka nigdzie publicznie. Kto go zna, może pisać na Twój kanał.
• Spersonalizuj wygląd — uzupełnij tytuł, nazwę nadawcy i awatar (np. logo sklepu), żeby powiadomienia od razu było widać i kojarzyły się z Twoim sklepem.
• Wykorzystaj znaczniki — wiadomości z {nick}, {product} czy {amount} są o wiele bardziej czytelne niż suchy embed. W raportach sięgaj po {revenue}, {orders} i {date}.
• Nie myl dwóch włączników raportów — najpierw główny „Wysyłaj codzienne raporty sprzedaży”, a dopiero potem personalizacja. Bez głównego raporty nie wyjdą.
• Zawsze klikaj „Zapisz integrację” — żadne ustawienie integracji nie zadziała, dopóki nie zapiszesz strony.
• Zrób próbny zakup — najlepszy test integracji to testowe zamówienie: od razu zobaczysz, czy i jak wygląda powiadomienie na kanale.