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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://napoveda.rocketoo.cz/rocketoo/rozsireni/supportbox.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.