# WhatsApp kampaň

Kampaně naleznete v samostatné sekci v hlavním postranním panelu pod ikonou “megafonu”.

## Příprava kontaktů pro kampaň

Před založením kampaně je nutné si připravit seznam kontaktů, které budou použity v rámci kampaně. 

Tyto kontakty již máte obsažené v [Adresáři kontaktů](/pro-administratory/sprava-tenantu/adresar-kontaktu.md), a nebo si je importujete pomocí tlačítka **“Nahrát CSV”**. Zde vyberete CSV soubor s kontakty a v dalším kroku **namapujete sloupce obsažené v CSV souboru na existující sloupce** v Adresáři kontaktů (klientovo jméno, klientův email, klientovo tel. číslo apod.).

{% hint style="info" %}
*V dalším kroku je užitečné si **vytvořit filtr, který umožní pro účely kampaně vybrat jen omezenou množinu kontaktů, kterým bude zaslána zpráva na WhatsApp.***
{% endhint %}

{% hint style="success" %}
*Pomocí tlačítka filtr aplikujete některý z existujících filtrů, případně si vytvoříte nový filtr.* 
{% endhint %}

{% hint style="info" %}
*Tyto filtry je možné vytvářet také při zakládání kampaně, kdy už se předpokládá, že v Adresáři kontaktů jsou kontakty obsaženy.*
{% endhint %}

## Založení kampaně

Pro založení kampaně je třeba kliknout na tlačítko **“+ Vytvořit kampaň”,** následně vyberte typ **"WhatsApp"** a zadejte název kampaně. \
\
Dále vybíráte z nabídky:

* WhatsApp účet (telefonní číslo)
* Formulář (template message)
* Jazykovou mutaci (pokud jich existuje více)

{% hint style="info" %}
*Pro lepší přehlednost můžete ke kampani doplnit i poznámku.*
{% endhint %}

{% hint style="warning" %}
*Objem odesílaných zpráv je omezen na úrovni 24 hodinového okna a může se v průběhu času měnit. Více informací naleznete*[ *zde*](/pro-administratory/sprava-tenantu/nastaveni/whatsapp.md#kampane-beta)*.*
{% endhint %}

{% hint style="success" %}
*Abyste si mohli být jistí, že vybíráte vždy z aktuálního seznamu Metou schválených šablon, doporučujeme vždy synchronizovat dostupné formuláře pomocí tlačítka **Synchronizovat formuláře.***
{% endhint %}

{% hint style="danger" %}
*Stav jednotlivých formulářů se v čase může měnit (např. formulář může být zablokován, případně se může změnit počet použitelných jazykových mutací).*\
\
*Aktuální stav můžete zjistit v sekci* [*Formuláře*](/pro-administratory/sprava-tenantu/nastaveni/formulare.md)*. Detail potíží u konkrétního formuláře zobrazením nápovědy najetím myší na ikonu výstražného trojúhelníku. Nejčastěji se jedná o nevybraný multimediální obsah (obrázek, video), což lze vyřešit ve Formulářích, kde chybějící soubor zvolíte pro každou jazykovou mutaci.*
{% endhint %}

## Přidání kontaktů do kampaně

Kontakty do založené kampaně máte možnost přidat dvěma způsoby, a to:

### A) Z [Adresáře kontaktů](/pro-administratory/sprava-tenantu/adresar-kontaktu.md) (prostřednictvím dříve vytvořeného filtru)

Kromě zmíněného filtru vybíráte i **parametr, ze kterého se použijí tel. čísla klientů.** \
V návaznosti na vybrané šabloně vybíráte navíc **parametry**, které se používají pro doplnění dynamických hodnot **(unikátní pro každý kontakt)**.

{% hint style="info" %}
*Aby nebyla zákazníkovi omylem poslána prázdná hodnota, máte možnost definovat **defaultní hodnotu**, která se použije v případě, že **nahraný .csv soubor či kontakt v adresáři kontaktů neobsahuje žádnou hodnotu**.*
{% endhint %}

### B) Pomocí .csv souboru

{% hint style="success" %}
*Doporučujeme využít připravenou prázdnou šablonu, kterou si můžete stáhnout přes link, který se zobrazí po kliknutí na možnost **Nahrát CSV**.*
{% endhint %}

{% hint style="info" %}
*Pořadí nahraných sloupců v .csv souboru má vliv na to, v jaké dynamické proměnné se hodnoty sloupců objeví.* \
\
\&#xNAN;***Vysvětleme si to na příkladu:***

*Odesíláme šablonu: "Dobrý den, \[ ] \[ ], váše objednávka č. \[ ] byla vyřízena."*  

*CSV soubor obsahuje sloupce:*

* *Klientovo telefonní číslo*
* *Oslovení (pane, paní)*
* *Jméno*
* *Číslo objednávky*
  {% endhint %}

## Správa WhatsApp kampaně

Obsluha WA kampaně (spuštění, pozastavení, ukončení či nahrání kontaktů) se nijak neliší od [telefonní kampaně](/pro-administratory/sprava-tenantu/kampane/telefonni-kampan.md).

{% hint style="warning" %}
*Oproti klasickým telefonním kampaním jsou v případě WhatsAppu používány konfigurovatelné* [*Template Messages*](/pro-administratory/sprava-tenantu/nastaveni/whatsapp/template-messages.md)*. Pokud pro kampaň zvolíte takovou Template Message, která obsahuje dynamické proměnné, nesmíte zapomenout do uploadovaného .CSV souboru přidat i sloupce s odpovídajícími daty. Případně v* [*Adresáři kontaktů*](/pro-administratory/sprava-tenantu/adresar-kontaktu.md) *musí související sloupce existovat!*
{% endhint %}

{% hint style="info" %}
*Nahrané kontakty mohou nabývat následujících stavů:*

* *Počáteční - úvodní stav ihned po nahrání kontaktu* 
* *Probíhá - probíhá odesílání* [*Template Message*](/pro-administratory/sprava-tenantu/nastaveni/whatsapp/template-messages.md)
* *Odesláno - zpráva byla odeslána*
* *Doručeno - zpráva byla doručena*
* *Přečteno - zpráva byla přečtena klientem*
* *Naplánováno opakování - zpráva bude odeslána znovu viz čas ve sloupci "Další pokus"*
* *Chyba - zprávu se 3x nepodařilo odeslat (další pokusy nepokračují)*
* *Neplatný záznam - tel. číslo nahraného kontaktu nemá obvyklé parametry*
* *Odesílání se nezdařilo - technické potíže na straně poskytovatele*
* *Zrušeno administrátorem - kampaň byla ukončena a na vybrané kontakty nebyla zpráva odeslána*
  {% endhint %}


---

# 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://docs.mluvii.com/pro-administratory/sprava-tenantu/kampane/whatsapp-kampan.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.