> ## Documentation Index
> Fetch the complete documentation index at: https://andcze.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

<Frame caption="Ekran konfiguracji integracji z Discordem">
  <img src="https://mintcdn.com/andcze/6Qp9zwUm8VUzRssf/images/panel/integrations.png?fit=max&auto=format&n=6Qp9zwUm8VUzRssf&q=85&s=9d62023c8b5f4c70c90661866da7f49f" alt="Panel ustawień integracji z Discordem" width="1280" height="720" data-path="images/panel/integrations.png" />
</Frame>

## 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.

<Tip>
  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.
</Tip>

## 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.

<Steps>
  <Step title="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.
  </Step>

  <Step title="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ć.
  </Step>

  <Step title="Zapisz integrację">
    Kliknij **Zapisz integrację** na dole strony. Od tej chwili sklep będzie mógł wysyłać powiadomienia na wybrany kanał.
  </Step>
</Steps>

<Warning>
  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ł.
</Warning>

<Note>
  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.
</Note>

## 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:

<Columns cols={2}>
  <Card title="Powiadomienia o zamówieniach" icon="bell">
    Wiadomość wysyłana automatycznie po każdym nowym, opłaconym zamówieniu — od razu wiesz, że ktoś coś kupił.
  </Card>

  <Card title="Codzienne raporty sprzedaży" icon="chart-line">
    Raz dziennie zbiorcze podsumowanie sprzedaży z poprzedniego dnia — przychód, liczba zamówień i klientów w jednym miejscu.
  </Card>
</Columns>

<Tip>
  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.
</Tip>

## 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ść.

<Columns cols={2}>
  <Card title="Włącznik powiadomień" icon="toggle-right">
    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.
  </Card>

  <Card title="Tytuł embeda" icon="heading">
    Nagłówek widoczny u góry wiadomości, np. „🛒 Nowe zamówienie". Maksymalnie 120 znaków.
  </Card>

  <Card title="Kolor embeda" icon="palette">
    Kolor pionowego paska przy wiadomości — wybierasz go z palety kolorów. Dopasuj go do barw swojego serwera.
  </Card>

  <Card title="Nazwa nadawcy" icon="user">
    Nazwa, pod jaką sklep będzie się przedstawiał na kanale, np. „ItemShop". Maksymalnie 80 znaków.
  </Card>

  <Card title="URL awatara nadawcy" icon="image">
    Adres obrazka profilowego widocznego przy wiadomościach — np. logo sklepu. Musi być poprawnym adresem internetowym.
  </Card>

  <Card title="Wiadomość nad embedem" icon="message-square">
    Tekst wyświetlany nad powiadomieniem (opcjonalny), w którym możesz użyć danych z zamówienia. Maksymalnie 1500 znaków.
  </Card>
</Columns>

<Note>
  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.
</Note>

### 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             |

<Tip>
  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.
</Tip>

## 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:

<Columns cols={2}>
  <Card title="Wysyłaj codzienne raporty sprzedaży" icon="power">
    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.
  </Card>

  <Card title="Personalizuj embed raportu dziennego" icon="sliders-horizontal">
    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ść).
  </Card>
</Columns>

<Note>
  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.
</Note>

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                              |

<Tip>
  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}.`
</Tip>

<Note>
  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.
</Note>

## 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.

<Warning>
  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.
</Warning>

<Note>
  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ń.
</Note>

## Najczęstsze pytania

<AccordionGroup>
  <Accordion title="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ę**.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="Wiadomości wyglądają „surowo&#x22;, 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.
  </Accordion>
</AccordionGroup>

## Dobre praktyki

<Tip>
  * **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.
</Tip>