> ## 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. # Parametry WhatsApp textových zpráv > Referenční přehled objektu whatsapp_text — prostý text, náhled odkazu, media (obrázek, video, dokument, audio), tlačítka rychlé odpovědi a CTA tlačítko s odkazem. Objekt `whatsapp_text` odesílá volný obsah přes WhatsApp v otevřeném **24hodinovém zákaznickém okně** — od prostého textu přes media až po interaktivní tlačítka. Na rozdíl od [šablon](/cs/reference/whatsapp-templates) není potřeba nic předregistrovat, obsah ale lze doručit jen tehdy, když vám příjemce v posledních 24 hodinách napsal. Pravidla okna vysvětluje koncept [Typy WhatsApp zpráv](/cs/concepts/whatsapp-message-types); tato stránka je referenčním přehledem všech polí. ## Základní pole | Pole | Typ | Popis | | --------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | `sender` | string | **Phone Number ID** vašeho WhatsApp odesílatele (číselné ID, ne telefonní číslo). Povinné. | | `body` | string | Text zprávy. Zároveň slouží jako popisek (caption) u media a jako text u interaktivních zpráv. Pokud není uveden, použije se `body` z kořene požadavku. | | `preview` | boolean | U prostého textu zapíná náhled odkazu (`preview_url`). Výchozí `false`. | ```json Prostý text s náhledem odkazu theme={null} { "to": [{ "phone_number": "420777123456" }], "flow": [ { "whatsapp_text": { "sender": "514578330250514", "body": "Nová verze je venku: https://example.com/blog", "preview": true } } ] } ``` *** ## Media Media lze odeslat dvěma způsoby. **1. Zkráceně přes `body`** — pokud je `body` odkaz (začíná `http`) s rozpoznanou příponou, SmsManager z něj sám sestaví media zprávu: | Přípona v `body` | Typ | | ----------------------------------------------------------------- | -------- | | `.png`, `.jpeg` | Obrázek | | `.mp4`, `.3gp` | Video | | `.pdf`, `.doc`, `.docx`, `.xls`, `.xlsx`, `.ppt`, `.pptx`, `.txt` | Dokument | | `.mp3`, `.acc`, `.m4a`, `.ogg`, `.amr` | Audio | **2. Explicitním objektem** — předáte objekt `image`, `video`, `document` nebo `audio` s polem `link`. U obrázku, videa a dokumentu se `body` použije jako popisek (caption), pokud objekt vlastní `caption` neobsahuje. ```json Obrázek s popiskem theme={null} { "whatsapp_text": { "sender": "514578330250514", "body": "Náhled produktu", "image": { "link": "https://example.com/produkt.jpg" } } } ``` ```json Dokument s vlastním názvem souboru theme={null} { "whatsapp_text": { "sender": "514578330250514", "document": { "link": "https://example.com/faktura.pdf", "filename": "faktura.pdf" } } } ``` *** ## Tlačítka rychlé odpovědi (`buttons`) Pole `buttons` vytvoří interaktivní zprávu s tlačítky rychlé odpovědi — **maximálně 3** (další se ořežou). `body` se zobrazí jako text zprávy. | Pole tlačítka | Typ | Popis | | ------------- | ------ | ---------------------------------------------------------------------------------- | | `title` | string | Popisek tlačítka. | | `id` | string | Volitelné. Identifikátor vrácený ve webhooku po klepnutí. Výchozí `reply_`. | Volitelně přidejte `footer` (text pod zprávou) a `header` (viz [Hlavička](#hlavička-interaktivních-zpráv) níže). ```json theme={null} { "whatsapp_text": { "sender": "514578330250514", "body": "Chcete pokračovat v objednávce?", "footer": "Odpovězte prosím do 24 hodin", "buttons": [ { "id": "yes", "title": "Ano, pokračovat" }, { "id": "no", "title": "Zrušit" } ] } } ``` *** ## CTA tlačítko s odkazem (`url`) Pole `url` (spolu s `title`) vytvoří interaktivní zprávu s jedním tlačítkem, které otevře odkaz. `body` je text zprávy; volitelně lze přidat `footer` a `header`. | Pole | Typ | Popis | | ------- | ------ | -------------------- | | `url` | string | Cílová URL tlačítka. | | `title` | string | Popisek tlačítka. | ```json theme={null} { "whatsapp_text": { "sender": "514578330250514", "body": "Vaše objednávka byla odeslána.", "url": "https://example.com/track/ORD-123", "title": "Sledovat zásilku" } } ``` *** ## Hlavička interaktivních zpráv U zpráv s `buttons` nebo `url` můžete přidat pole `header` (řetězec). Typ hlavičky se určí podle tvaru hodnoty — odkaz s příponou obrázku/videa/dokumentu se zobrazí jako příslušné media, jinak jako text: ```json Obrázková hlavička theme={null} { "header": "https://example.com/banner.png" } ``` ```json Textová hlavička theme={null} { "header": "Potvrzení objednávky" } ``` *** ## Raw průchozí zápis (`raw`) Pro pokročilé případy, které toto rozhraní nepokrývá, můžete předat objekt `raw` s klíčem `interactive`, jehož obsah se odešle na WhatsApp API beze změny. ```json theme={null} { "whatsapp_text": { "sender": "514578330250514", "raw": { "interactive": { "type": "list", "body": { "text": "…" }, "action": { "…": "…" } } } } } ``` Pole se vyhodnocují v pořadí: media v `body` → objekty `document`/`audio`/`image`/`video` → `buttons` → `url` → `raw` → prostý text. Uplatní se první, které v požadavku najdeme, proto v jedné zprávě kombinujte jen jeden typ obsahu. *** ## Další kroky Praktický průvodce odesíláním šablon i volného textu. Reference parametrů proaktivních šablonových zpráv. Kdy použít šablonu a kdy volný text v 24hodinovém okně. Příjem odpovědí a klepnutí na tlačítka.