> ## Documentation Index > Fetch the complete documentation index at: https://developers.smsmanager.com/llms.txt > Use this file to discover all available pages before exploring further. # Send whatsapp SmsManager vám umožňuje odesílat WhatsApp zprávy přes váš připojený WhatsApp Business účet. Můžete odesílat předschválené **šablonové zprávy** každému přijatému číslu nebo odesílat **volné textové zprávy** v aktivním 24hodinovém zákaznickém okně. Obě typy zpráv se přirozeně vejdou do multikanálového `flow` SmsManageru, takže můžete přidat SMS zálohu pro příjemce nedostupné přes WhatsApp. *** ## Dva typy WhatsApp zpráv SmsManager podporuje **šablonové zprávy** (`whatsapp_template`) pro proaktivní oslovení a **textové zprávy** (`whatsapp_text`) pro odpovědi v aktivním 24hodinovém zákaznickém okně. Který typ zvolit a proč — včetně pravidel zákaznického okna — vysvětluje koncept [Typy WhatsApp zpráv](/cs/concepts/whatsapp-message-types). Tento návod se soustředí na to, jak je odeslat. *** ## Předpoklady * **WhatsApp Business účet** připojený k SmsManager. Postupujte podle průvodce nastavením na [app.smsmanager.com/whatsapp](https://app.smsmanager.com/whatsapp). * Vaše **Phone Number ID** z [app.smsmanager.com/whatsapp](https://app.smsmanager.com/whatsapp) — to je číselné ID (ne samotné telefonní číslo), které identifikuje vašeho WhatsApp odesílatele. * Pro šablonové zprávy: **předschválená šablona** v Meta Business Manageru s přesným názvem šablony a kódem jazyka. *** ## Odeslání WhatsApp šablonové zprávy Přihlaste se na [app.smsmanager.com/whatsapp](https://app.smsmanager.com/whatsapp) a dokončete proces připojení WhatsApp Business účtu. Po připojení zkopírujte **Phone Number ID** zobrazené na dashboardu — je to dlouhý číselný řetězec jako `514578330250514`. Použijete jej jako hodnotu `sender` ve všech vašich WhatsApp API voláních. Vytvořte svou šablonu zprávy uvnitř Meta Business Manageru nebo přes dashboard SmsManager. Šablony musí být před odesíláním schváleny Metou. Schválení obvykle trvá od několika minut po několik hodin. Poznamenejte si přesný **název šablony** (malá písmena, podtržítka) a **kód jazyka** (například `en`, `cs`, `de`) — obojí budete potřebovat v API požadavku. Použijte klíč `whatsapp_template` uvnitř pole `flow`. Nastavte `sender` na vaše Phone Number ID, `template_name` na název schválené šablony a `language` na kód jazyka šablony. Pokud šablona obsahuje proměnné značky (číslované jako `{1}`, `{2}` atd.), předejte jejich hodnoty v poli `params`. ```json Tělo požadavku theme={null} { "to": [{"phone_number": "420777123456"}], "flow": [ { "whatsapp_template": { "template_name": "order_update", "sender": "514578330250514", "language": "cs", "params": ["Jan", "ORDER-123"] } } ] } ``` ```bash cURL theme={null} curl -X POST https://api.smsmngr.com/v2/message \ -H "x-api-key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "to": [{"phone_number": "420777123456"}], "flow": [ { "whatsapp_template": { "template_name": "order_update", "sender": "514578330250514", "language": "cs", "params": ["Jan", "ORDER-123"] } } ] }' ``` Přidejte krok `sms` do pole `flow`. Pokud WhatsApp zprávu nelze doručit (například příjemce nemá WhatsApp nebo číslo nemá souhlas), SmsManager automaticky přejde na SMS. ```json Tělo požadavku theme={null} { "body": "Ahoj Jane, vaše objednávka ORDER-123 byla odeslána!", "to": [{"phone_number": "420777123456"}], "flow": [ { "whatsapp_template": { "template_name": "order_update", "sender": "514578330250514", "language": "cs", "params": ["Jan", "ORDER-123"] } }, { "sms": { "sender": "MujObchod", "gateway": "high" } } ] } ``` Při použití WhatsApp s SMS zálohou vždy nastavte kořenové `body` — stane se textem SMS zprávy, pokud flow dojde k SMS kroku. *** ## Odeslání WhatsApp textové zprávy WhatsApp textové zprávy lze odeslat pouze v rámci **24hodinového zákaznického okna** — tj. do 24 hodin od okamžiku, kdy vám příjemce naposledy poslal zprávu na vaše číslo. Odeslání mimo toto okno povede k odmítnutí zprávy. Pro proaktivní oslovování použijte šablonové zprávy. Použijte `whatsapp_text` ve svém flow k odeslání volné zprávy během otevřeného konverzačního okna: ```json Tělo požadavku theme={null} { "to": [{"phone_number": "420777123456"}], "flow": [ { "whatsapp_text": { "sender": "514578330250514", "body": "Ahoj! Vidím, že vaše objednávka byla zpožděna. Aplikovali jsme 10% slevu na vaši další nákup jako omluvu." } } ] } ``` *** ## Parametry šablony WhatsApp šablony mohou obsahovat proměnné značky na třech místech. Použijte odpovídající pole parametrů k jejich vyplnění v čase odeslání: | Pole | Vyplňuje značky v | Příklad | | ---------------- | -------------------------------------------------------------------------------- | ------------------------------- | | `params` | Proměnné v těle zprávy (pozitičně: první hodnota mapuje na první proměnnou atd.) | `["Jan", "ORDER-123", "zítra"]` | | `params_header` | Hlavička šablony (pouze textové hlavičky) | `["ORDER-123"]` | | `params_buttons` | URL tlačítek s dynamickými částmi cesty | `["abc123"]` | ```json Kompletní příklad parametrů theme={null} { "to": [{"phone_number": "420777123456"}], "flow": [ { "whatsapp_template": { "template_name": "shipping_update", "sender": "514578330250514", "language": "cs", "params_header": ["ORDER-123"], "params": ["Jan", "zítra", "9–12"], "params_buttons": ["ORDER-123"] } } ] } ``` Pořadí hodnot v každém poli `params` mapuje pozitičně na číslované značky ve vaší šabloně. Ujistěte se, že délka pole odpovídá počtu proměnných v šabloně, jinak bude požadavek odmítnut. *** ## Kompletní příklady ```bash cURL — šablonová zpráva theme={null} curl -X POST https://api.smsmngr.com/v2/message \ -H "x-api-key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "body": "Ahoj Jane, vaše objednávka ORDER-123 byla odeslána!", "to": [{"phone_number": "420777123456"}], "tag": "transactional", "callback": "https://yourapp.com/webhooks/whatsapp", "flow": [ { "whatsapp_template": { "template_name": "order_update", "sender": "514578330250514", "language": "cs", "params": ["Jan", "ORDER-123"] } }, { "sms": { "sender": "MujObchod", "gateway": "high" } } ] }' ``` ```python Python — šablonová zpráva theme={null} import requests response = requests.post( "https://api.smsmngr.com/v2/message", headers={ "x-api-key": "YOUR_API_KEY", "Content-Type": "application/json", }, json={ "body": "Ahoj Jane, vaše objednávka ORDER-123 byla odeslána!", "to": [{"phone_number": "420777123456"}], "tag": "transactional", "callback": "https://yourapp.com/webhooks/whatsapp", "flow": [ { "whatsapp_template": { "template_name": "order_update", "sender": "514578330250514", "language": "cs", "params": ["Jan", "ORDER-123"], } }, { "sms": { "sender": "MujObchod", "gateway": "high", } }, ], }, ) print(response.json()) ``` *** ## Další kroky Přidejte Viber Business Messages s bohatým obsahem a SMS zálohou. Přijímejte aktualizace stavu doručení WhatsApp a události příchozích zpráv. Odesílejte WhatsApp zprávy více příjemcům v jednom API volání. Nakonfigurujte možnosti SMS zálohy pro vaše WhatsApp zprávy.