Přeskočit na hlavní obsah

Šablony - Hlavička zprávy

V rámci šablony lze definovat hlavičku zprávy. Podporované formáty jsou text, obrázek, video, dokument (PDF).

Odeslání​

Text v hlavičce​

Pokud máte v hlavičce definovaný text a obsahuje parametry, zadejte je následujícím způsobem dle typu parametru (očíslované proměnné vs pojmenované proměnné), vložte je jako hodnotu do parametru parameters_header.

Parametr v hlavičce může být jen jeden.

Očíslované proměnné:

Dobrý den {{0}},
...
    "parameters_header": [
        "Tomáši"
    ]
...

nebo

...
    "parameters_header": [
        {"text": "Tomáši"}
    ]
...

Pojmenované proměnné:

Dobrý den {{jmeno}},
...
    "parameters_header": [
        {
            "text": {"jmeno": "Tomáši"}
        }
    ]
...

Obrázek v hlavičce​

Při vytváření šablony nahrajete konkrétní obrázek které slouží jako příklad pro schválení.

V rámci API volání se pak tato hodnota může měnit podobně, jako v případě proměnných v textu zprávy. Použijte parametr parameters_header. Pozor, každá zpráva, může mít jen jeden parameter v rámci hlavičky, nicméně pro budoucí kompatibilitu zachováváme stejný formát tohoto parametru jako pro parametry v rámci textu zprávy (tedy pole).

Na základě adresy souboru (zda končí jpg/jpeg/png) se pak nastavují odpovídající parametry pro správné zobrazení.

Podporované formáty jsou jen png nebo jpg. Maximální velikost 5 MB.

...
    "parameters_header": [
        "https://www.adresa-obrazku.com/nazev-souboru.jpg"
    ]
...

nebo můžete explicitně určit, typ zprávy:

...
    "parameters_header": [
        {
            "image": {
                "link":"https://www.adresa-obrazku.com/nazev-souboru.jpg"
            }
        }
    ]
...

Video v hlavičce​

Podporované formáty jsou jen mp4 nebo 3gp. Video musí být v formátu H.264 video a AAC audio (video nesmí být bez zvukové stopy). Maximální velikost je 16 MB.

...
    "parameters_header": [
        "https://www.adresa-obrazku.com/nazev-souboru.mp4"
    ]
...

nebo

...
    "parameters_header": [
        {
            "video": {
                "link": "https://www.adresa-obrazku.com/nazev-souboru.mp4"
            }
        }
    ]
...

Dokument (PDF)​

Podporovaný formát je jen pdf (max. velikost 100 MB).

...
    "parameters_header": [
        "https://www.adresa-obrazku.com/nazev-souboru.pdf"
    ]
...

nebo

...
    "parameters_header": [
        {
            "document": {
                "link":"https://www.adresa-obrazku.com/invoice.pdf"
            }
        }
    ]
...

Poloha​

...
    "parameters_header": [
        {
            "location": {
                "latitude": "50.1045378",
                "longitude": "14.4501183",
                "name": "SmsManager",
                "address": "Komunardů 36, Praha 7"
            }
        }
    ]
...

Produkt​

Speciální Single-Product-Message pro zaslání produktu z nahraného katalogu

...
    "parameters_header": [
        {
            "product": {
                "product_retailer_id": "nqryix03ez",
                "catalog_id": "194836987003835"
            }
        }
    ]
...