> For the complete documentation index, see [llms.txt](https://napoveda.rocketoo.cz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://napoveda.rocketoo.cz/rocketoo/rozsireni/supportbox.md).

# SupportBox

Modul SupportBox propojuje váš e‑shop s helpdeskem SupportBox. Při otevření ticketu váš tým podpory vidí:

* Informace o zákazníkovi (jméno, e‑mail, telefon, adresa)
* Celkovou útratu zákazníka
* Seznam posledních objednávek se stavy

### K čemu je modul užitečný?

Zákaznická podpora pracuje efektivněji, když má kontext. Díky tomuto modulu nemusíte přepínat mezi systémy – všechny důležité informace máte přímo v ticketu.

### Kde najdu nastavení?

V hlavním menu klikněte na **Nastavení** → **SupportBox**. Zobrazí se vám konfigurace integrace.

## Nastavení integrace

### Zapnutí modulu

{% stepper %}
{% step %}
V menu klikněte na **Nastavení** → **SupportBox**
{% endstep %}

{% step %}
Přepněte přepínač **Zapnout integraci (endpoint)** do zapnuté polohy
{% endstep %}

{% step %}
Klikněte **Uložit**
{% endstep %}
{% endstepper %}

### Autentizační klíč

Autentizační klíč zajišťuje bezpečnou komunikaci mezi e‑shopem a SupportBoxem.

{% stepper %}
{% step %}
V poli **Klíč pro ověření** zadejte hodnotu klíče z vaší aplikace SupportBoxu.

Návod na nastavení najdete zde: <https://podpora.supportbox.cz/help/univerzalni-plugin>
{% endstep %}

{% step %}
Klikněte **Uložit**
{% endstep %}
{% endstepper %}

### Adresa zdroje dat

Tuto adresu (URL) zkopírujte – použijete ji při konfiguraci v SupportBoxu.

## Konfigurace v SupportBoxu

Po nastavení modulu v e‑shopu je potřeba dokončit propojení na straně SupportBoxu.

{% stepper %}
{% step %}

### Otevření nastavení pluginu

Přihlaste se do SupportBoxu

* Přejděte do **Nastavení** → **Schránka** → **Pluginy**
* Vyberte **Univerzální plugin**
  {% endstep %}

{% step %}

### Zadání adresy zdroje dat

Do pole pro adresu vložte URL, kterou jste zkopírovali z nastavení modulu v e‑shopu

* Uložte nastavení
  {% endstep %}

{% step %}

### Nastavení autorizace

V nastavení pluginu najděte pole **Způsob autorizace (doporučujeme HTTP hlavičky)**

* Zvolte režim **HTTP hlavičky**
* Uložte nastavení
  {% endstep %}
  {% endstepper %}

Po dokončení konfigurace se při otevření ticketu v SupportBoxu automaticky zobrazí panel s informacemi o zákazníkovi.

## Panel zákazníka

Panel se zobrazuje v pravé části ticketu v SupportBoxu. Obsahuje přehledné informace o zákazníkovi z vašeho e‑shopu.

### Informace o zákazníkovi

V horní části panelu vidíte:

* **Jméno zákazníka** – kliknutím přejdete na detail zákazníka v administraci e‑shopu
* **E‑mail** – kliknutím otevřete nový e‑mail
* **Telefon** – kliknutím zahájíte hovor (pokud je telefon uveden)
* **Adresa** – doručovací adresa zákazníka

### Celková útrata

Pod kontaktními údaji se zobrazuje celková částka, kterou zákazník utratil na vašem e‑shopu. Pomáhá rychle odhadnout hodnotu zákazníka.

### Seznam objednávek

V dolní části panelu vidíte poslední objednávky zákazníka:

* **Číslo objednávky** – kliknutím přejdete na detail objednávky v administraci
* **Stav objednávky** – barevná tečka indikuje aktuální stav
* **Částka** – celková hodnota objednávky
* **Datum vytvoření** – kdy byla objednávka vytvořena
* **Datum odeslání** – kdy bylo zboží odesláno (nebo pomlčka, pokud ještě nebylo)

Pod seznamem je odkaz **Zobrazit další objednávky**, který vás přesměruje na kompletní přehled objednávek zákazníka v administraci e‑shopu.

### Zákazník nenalezen

Pokud e‑mail z ticketu neodpovídá žádnému zákazníkovi v e‑shopu, zobrazí se zpráva „Zákazník nebyl v e‑shopu nalezen".

### Zákazník bez objednávek

Pokud je zákazník v systému, ale zatím nemá žádnou objednávku, zobrazí se zpráva „Zákazník zatím nemá žádnou objednávku".

## Často kladené otázky

### Obecné otázky

<details>

<summary>Musím platit za použití modulu?</summary>

Modul je součástí Rocketoo. Pro využití integrace potřebujete aktivní účet v SupportBoxu.

</details>

<details>

<summary>Jak rychle se zobrazí data v SupportBoxu?</summary>

Data se načítají v reálném čase při otevření ticketu.

</details>

<details>

<summary>Jsou data v bezpečí?</summary>

Ano, komunikace je chráněna autentizačním klíčem. Bez správného klíče nelze data získat.

</details>

### Nastavení

<details>

<summary>Co když zapomenu autentizační klíč?</summary>

Klíč můžete kdykoli změnit v nastavení modulu. Stačí si jen v nastavení SupportBoxu vygenerovat nový klíč a ten nastavit.

</details>

<details>

<summary>Mohu změnit adresu zdroje dat?</summary>

Ne, adresa je generována automaticky a nelze ji změnit.

</details>

<details>

<summary>Co se stane, když vypnu integraci?</summary>

Panel v SupportBoxu přestane zobrazovat data z e‑shopu.

</details>

### Panel zákazníka

<details>

<summary>Proč se nezobrazuje zákazník?</summary>

Zákazník je párován podle e‑mailové adresy. Pokud e‑mail v ticketu neodpovídá žádnému zákazníkovi v e‑shopu, panel zobrazí zprávu o nenalezení.

</details>

<details>

<summary>Kolik objednávek se zobrazuje?</summary>

V panelu se zobrazuje několik posledních objednávek. Pro kompletní přehled použijte odkaz „Zobrazit další objednávky".

</details>

<details>

<summary>Proč nevidím telefon zákazníka?</summary>

Telefon se zobrazuje pouze v případě, že ho má zákazník vyplněný ve svém profilu v e‑shopu.

</details>

<details>

<summary>Můžu z panelu upravovat data zákazníka?</summary>

Ne, panel je pouze pro zobrazení. Pro úpravy klikněte na jméno zákazníka a přejděte do administrace e‑shopu.

</details>