Šablony - Tlačítka

Stejně jako mohou být parametry v textu zprávy, tak i URL tlačítka mohou obsahovat parametry pro doplnění při odesílání pomocí API.

Při vytváření šablony u tlačítky nastavce typ na "DYNAMICKÝ" a zajdete URL, které bude vždy stejné (např. název domény https://www.smsmanager.cz nebo adresu, do které se má doplnit parametr: https://www.smsmanager.cz/?page=). Při použití API pak vkládáte do parametrů tu část, která se doplní za URL. Viz příklady.

Speciální tlačítka jsou také vyžadována pro typ volání apod.

Statická tlačítka

Pokud v šabloně definujete statická tlačítka (obsahující konkrétní URL nebo telefonní číslo), není nutné toto tlačítko uvádět při odeslání šablony.

Dynamnická tlačítka

Pokud v šabloně použijete dynamická tlačátka, je nutné je definovat také při odeslání šablony a je nutné dodržet stejné pořadí parametrů jako je pořadí tlačítek v šabloně. Např. pokud máte v šabloně 2 tlačítka a jen druhé z nich je dynamické, vložte na první místo hodnotu null.

Pouze jedno dynamické tlačítko:

...
    "whatsapp_template": {
        "template_name": "...",
        "language": "cs",
        "sender": "51457833025121",
        "parameters_buttons":[
            "kontaktujte-nas"
        ]
    }
...

Dvě tlačítka, první je statické, druhé je dynamické

...
    "whatsapp_template": {
        "template_name": "...",
        "language": "cs",
        "sender": "51457833025121",
        "parameters_buttons":[
            null,
            "kontaktujte-nas"
        ]
    }
...

Postback v tlačítkách

Pokud chcete pracovat s tlačítky, které vám zpátky pošlou custom data (tzv. "postback" tlačátka s vlastním payloadem) tak namísto pole řetězců použijte podobný zápis jako v případě pojmenovaných proměnných:

...
    "whatsapp_template": {
        "template_name": "...",
        "language": "cs",
        "sender": "51457833025121",
        "parameters_buttons":[
            {"url": "kontaktujte-nas"},
            {"payload": "TAP_BUTTON_CONTACT"}
        ]
    }
...

Kupón v tlačítku

Jednná se o speciální typ tlačítka, který dovolí zkopírovat kupón do schránky.

...
    "whatsapp_template": {
        "template_name": "...",
        "language": "cs",
        "sender": "51457833025121",
        "parameters_buttons":[
            {"coupon": "ABCD10"}
        ]
    }
...

WhatsApp volání

Speciální tlačítko, které dovoluje zavolat přes WhatsApp na váš profil (hovor je přijat ve webovém rozhraní). Tlačítko nemusí být součástí požadvku, pokud neměníte parametry (doba po kterou lze uskutečnit hovor).

...
    "whatsapp_template": {
        "template_name": "...",
        "language": "cs",
        "sender": "51457833025121",
        "parameters_buttons":[
            {"voice_call": {"ttl_minutes": 5}}
        ]
    }
...

Produkt

Tlačítko, které zobrazuje produkt v rámci WhatsApp katalogu

...
    "whatsapp_template": {
        "template_name": "...",
        "language": "cs",
        "sender": "51457833025121",
        "parameters_buttons":[
            {"catalog": "2lc20305pt"}
        ]
    }
...

Multi-produkt

Pokud šablona má definovaný MPM lze jej poslat následujícím způsobem

...
    "whatsapp_template": {
        "template_name": "...",
        "language": "cs",
        "sender": "51457833025121",
        "parameters_buttons":[
            {"mpm": {"2lc20305pt":
                        [{"title": "Název sekce",
                        "product_items": [
                                {"product_retailer_id": "2lc20305pt"},
                                {"product_retailer_id": "nseiw1x3ch"},
                                {"product_retailer_id": "n6k6x0y7oe"}
                            ]}
                        ]
            }}
        ]
    }
...

Flow

Tlačítko, které zobrazí tzv. "Flow" formulář sloužící ke sběru dat

...
    "whatsapp_template": {
        "template_name": "...",
        "language": "cs",
        "sender": "51457833025121",
        "parameters_buttons":[
            {"flow": null}
        ]
    }
...

...
    "whatsapp_template": {
        "template_name": "...",
        "language": "cs",
        "sender": "51457833025121",
        "parameters_buttons":[
            {"flow": {
                "data":{
                    "first_name": "Tomáš",
                    "last_name": "Marný"
                }
            }}
        ]
    }
...

info

Flow tlačítko musí být uvedeno i když neobsahuje žádné parametry