> For the complete documentation index, see [llms.txt](https://docs.mluvii.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mluvii.com/pro-administratory/sprava-tenantu/kampane/whatsapp-kampan.md).

# 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í.* \
\
***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 %}