# SmsManager Developers ## Docs - [Upravit aktuální API klíč](https://smsmanager.cz/docs/api-reference/api/upravit-aktuální-api-klíč.md): Upravuje nastavení volajícího API klíče. Obě pole musí být přítomna (prázdný řetězec hodnotu smaže). Změna `default_callback_url` zároveň aktualizuje webhook URL u všech odesílatelů klíče. - [Vypsat podřízené API klíče](https://smsmanager.cz/docs/api-reference/api/vypsat-podřízené-api-klíče.md): Vypíše podřízené API klíče vytvořené volajícím klíčem. - [Vytvořit podřízený API klíč](https://smsmanager.cz/docs/api-reference/api/vytvořit-podřízený-api-klíč.md): Vytváří nový podřízený (sub) API klíč pod volajícím nadřazeným klíčem. Podřízené klíče může vytvářet pouze nadřazený klíč s rozsahem oprávnění `full` nebo `rest-api` (max. 19 podřízených klíčů). - [Změnit podřízený API klíč](https://smsmanager.cz/docs/api-reference/api/změnit-podřízený-api-klíč.md): Mění rozsah oprávnění a/nebo blokaci podřízeného API klíče. Podřízené klíče může měnit pouze nadřazený klíč; nadřazený klíč nemůže měnit sám sebe. - [Získat informace o aktuálním API klíči](https://smsmanager.cz/docs/api-reference/api/získat-informace-o-aktuálním-api-klíči.md): Vrací profil volajícího API klíče. Tento endpoint vždy odráží aktuální stav klíče (povolen/zablokován, odesílatelé, rozsah oprávnění). - [Nastavit fakturační kontakt](https://smsmanager.cz/docs/api-reference/billing/nastavit-fakturační-kontakt.md): Aktualizuje fakturační kontakt pro fakturační id vlastněné volajícím klíčem. Povinné je `billing_id` plus alespoň jedno kontaktní pole. Sdílené podřízené klíče nevlastní fakturační záznam a tento endpoint použít nemohou. - [Stáhnout fakturu v PDF](https://smsmanager.cz/docs/api-reference/billing/stáhnout-fakturu-v-pdf.md): Vrací jednu fakturu vykreslenou jako PDF (kódované base64). - [Vypsat faktury](https://smsmanager.cz/docs/api-reference/billing/vypsat-faktury.md): Vypíše vystavené faktury pro fakturační id vlastněné volajícím klíčem (max. 100, od nejnovějších). - [Získat fakturační kontakt](https://smsmanager.cz/docs/api-reference/billing/získat-fakturační-kontakt.md): Vrací fakturační kontakt pro fakturační id vlastněné volajícím klíčem. - [Získat údaje pro dobití bankovním převodem](https://smsmanager.cz/docs/api-reference/billing/získat-údaje-pro-dobití-bankovním-převodem.md): Vrací bankovní údaje pro dobití kreditu bankovním převodem, včetně vašeho variabilního symbolu platby (`vs`). Platby jsou párovány podle variabilního symbolu. - [Odebrat čísla z blacklistu](https://smsmanager.cz/docs/api-reference/blacklist/odebrat-čísla-z-blacklistu.md): Odebere konkrétní čísla z blacklistu, nebo pomocí `all: true` smaže celý seznam. - [Odebrat čísla z opt-out seznamu](https://smsmanager.cz/docs/api-reference/blacklist/odebrat-čísla-z-opt-out-seznamu.md): Odebere konkrétní čísla z opt-out seznamu, nebo pomocí `all: true` smaže celý seznam. - [Přidat čísla na blacklist](https://smsmanager.cz/docs/api-reference/blacklist/přidat-čísla-na-blacklist.md): Přidá telefonní čísla na blacklist účtu. Čísla jsou normalizována (českým 9místným mobilním číslům je předřazeno `420`) a zpracovávána asynchronně — volání vrací počet přijatých čísel. - [Přidat čísla na opt-out seznam](https://smsmanager.cz/docs/api-reference/blacklist/přidat-čísla-na-opt-out-seznam.md): Přidá telefonní čísla na opt-out seznam účtu. Čísla jsou normalizována a zpracovávána asynchronně — volání vrací počet přijatých čísel. - [Stáhnout blacklist](https://smsmanager.cz/docs/api-reference/blacklist/stáhnout-blacklist.md): Vrací předpodepsanou URL (platnou 60 sekund) pro stažení blacklistu ve formátu CSV. - [Stáhnout opt-out seznam](https://smsmanager.cz/docs/api-reference/blacklist/stáhnout-opt-out-seznam.md): Vrací předpodepsanou URL (platnou 60 sekund) pro stažení opt-out seznamu ve formátu CSV. Opt-out seznam se uplatňuje na zprávy s tagem `promotional`. - [Nastavit upozornění na nízký kredit](https://smsmanager.cz/docs/api-reference/credit/nastavit-upozornění-na-nízký-kredit.md): Nastavuje e-mailové upozornění na nízký kredit volajícího klíče. Všechna pole jsou povinná. - [Objednat placenou službu](https://smsmanager.cz/docs/api-reference/credit/objednat-placenou-službu.md): Objedná placenou službu z katalogu (viz `/credit/services`) a odečte poplatek z vašeho kreditu. Celkový poplatek je `setup + monthly × months`, kde počet měsíců vyplývá z minimálního intervalu služby (`year` = 12, `quarter` = 3, jinak 1). U služeb se `subject: defined` musíte předmět dodat (např. te… - [Zrušit placenou službu](https://smsmanager.cz/docs/api-reference/credit/zrušit-placenou-službu.md): Označí objednanou službu ke zrušení na konci zaplaceného období. Nedochází k žádnému okamžitému účtování ani vracení peněz; služba zůstává aktivní do konce zaplaceného období. Volání je idempotentní. - [Získat ceník](https://smsmanager.cz/docs/api-reference/credit/získat-ceník.md): Vrací ceník podle destinací, klíčovaný kanálem (`sms`, `smsdirect`, `smscustom`, `viber`) a telefonní předvolbou země. Každá položka obsahuje `mcc` země, `price_czk`, `price_eur` a volitelně ceny pro jednotlivé operátory v `operators`. - [Získat katalog služeb](https://smsmanager.cz/docs/api-reference/credit/získat-katalog-služeb.md): Vrací katalog objednatelných placených služeb (odesílatelé, virtuální čísla, SIM hosting, ...). Katalog má strukturu `services.sender...`. Ploché id služby používané v `/credit/order` se skládá jako `sender___` (např. `sender_… - [Získat nastavení upozornění na nízký kredit](https://smsmanager.cz/docs/api-reference/credit/získat-nastavení-upozornění-na-nízký-kredit.md): Vrací nastavení e-mailového upozornění na nízký kredit volajícího klíče. - [Získat stav kreditu](https://smsmanager.cz/docs/api-reference/credit/získat-stav-kreditu.md): Vrací aktuální stav kreditu a dosažené cenové hladiny volajícího klíče. - [HTTP API — odeslání SMS](https://smsmanager.cz/docs/api-reference/http-api/send.md): Jednoduché odeslání SMS přes GET/POST. API klíč se předává jako parametr (ne hlavička) — ideální pro služby, které umí jen GET/POST bez vlastní hlavičky. - [Získat přijaté zprávy podle data](https://smsmanager.cz/docs/api-reference/inbox/získat-přijaté-zprávy-podle-data.md): Vrací příchozí (přijaté) zprávy pro zadané datum. - [JSON API v2 — Reference odesílání zpráv SmsManager](https://smsmanager.cz/docs/api-reference/json-v2/overview.md): Přehled JSON API v2 pro odesílání SMS, Viber, WhatsApp a RCS zpráv. Základní URL, autentizace a souhrn endpointů. - [Webhook výsledku odesílání](https://smsmanager.cz/docs/api-reference/json-v2/sent-message-webhook.md): Webhook sentMessage — SmsManager posílá HTTP POST na vaši callback URL při každé změně stavu odchozí zprávy, od odeslání až po finální výsledek doručení. - [Webhooks](https://smsmanager.cz/docs/api-reference/json-v2/webhooks.md) - [Zrušit naplánovanou zprávu nebo hromadné nahrání](https://smsmanager.cz/docs/api-reference/messaging/zrušit-naplánovanou-zprávu-nebo-hromadné-nahrání.md): Zruší dříve naplánovanou jednotlivou zprávu (`message_id`) nebo naplánované hromadné nahrání (`bulk_id`). Uveďte právě jedno z obou polí. - [Získat URL pro hromadné nahrání](https://smsmanager.cz/docs/api-reference/messaging/získat-url-pro-hromadné-nahrání.md): Vrací předpodepsanou URL pro nahrání (platnou 60 sekund) souboru s hromadnými zprávami. Soubor je JSONL (jedna JSON zpráva na řádek, stejný formát jako `Message` v JSON API v2) nebo gzipovaný JSONL. Soubor nahrajte metodou `PUT` s `Content-Type: application/jsonl` (pro `jsonl`) nebo `application/gzi… - [Akce konektoru](https://smsmanager.cz/docs/api-reference/partner/akce-konektoru.md): Provede akci připojené integrace. Aktuálně je podporován konektor `klaviyo` s akcemi `segments`, `recipients`, `senders` a `me`. - [Registrovat push zařízení](https://smsmanager.cz/docs/api-reference/partner/registrovat-push-zařízení.md): Registruje (nebo aktualizuje) zařízení pro push notifikace. Id zařízení již registrované jiným API klíčem nelze registrovat znovu. - [Registrovat příjemce](https://smsmanager.cz/docs/api-reference/partner/registrovat-příjemce.md): Vytvoří nového příjemce (pokud je `id` vynecháno, vygeneruje se nové id) nebo aktualizuje telefonní číslo a push tokeny existujícího příjemce. Aktualizována jsou pouze zaslaná pole. - [Zahájit partnerskou registraci](https://smsmanager.cz/docs/api-reference/partner/zahájit-partnerskou-registraci.md): Zahájí onboarding v partnerském brandingu. Vrací podepsaný token (platný 1 hodinu) a hostovanou registrační URL, kde koncový uživatel dokončí registraci. Dostupné pouze pro partnerské účty. - [REST API — Referenční příručka správy účtu a zpráv](https://smsmanager.cz/docs/api-reference/rest/overview.md): SmsManager REST API pro správu účtu: správa API klíčů a podřízených klíčů, práce s kreditem a fakturací, sledování stavu zpráv, čtení přijatých zpráv, správa blacklistu a opt-out seznamů, hromadné odesílání a integrace partnerských platforem. - [Odeslání jednoduché zprávy (GET request)](https://smsmanager.cz/docs/api-reference/sending/odeslání-jednoduché-zprávy-get-request.md): Zjednodušené odeslání jedné SMS pomocí query string parametrů. Pro plnou funkčnost (flow, více příjemců, doručovací okno, ...) použijte `/message`. - [Odeslání jednoduché zprávy (POST request)](https://smsmanager.cz/docs/api-reference/sending/odeslání-jednoduché-zprávy-post-request.md): Zjednodušené odeslání jedné SMS pomocí formulářových parametrů. Pro plnou funkčnost (flow, více příjemců, doručovací okno, ...) použijte `/message`. - [Odeslání prioritní zprávy](https://smsmanager.cz/docs/api-reference/sending/odeslání-prioritní-zprávy.md): Stejné jako `/message`, ale zpráva je zpracována prioritní frontou. Použijte pro časově kritické zprávy (jednorázová hesla, transakční notifikace). Formát požadavku i odpovědi je shodný s `/message`. - [Odeslání více zpráv](https://smsmanager.cz/docs/api-reference/sending/odeslání-více-zpráv.md): Tento endpoint použijte pro odeslání dávky zpráv více příjemcům (můžete nastavit až 10 příjemců na požadavek a až 10 požadavků v jednom API volání). To znamená, že jedním HTTP API voláním můžete oslovit až 100 příjemců. Pokud chcete použít jiné kanály než SMS (Viber, WhatsApp atd.), použijte vlastno… - [Odeslání zprávy](https://smsmanager.cz/docs/api-reference/sending/odeslání-zprávy.md): Tento endpoint použijte pro odeslání zprávy jednomu nebo více příjemcům (až 10 příjemců). Pokud chcete použít jiné kanály než SMS (Viber, WhatsApp, RCS atd.), použijte vlastnost `flow`. - [Vypsat odeslané zprávy podle data](https://smsmanager.cz/docs/api-reference/status/vypsat-odeslané-zprávy-podle-data.md): Vypíše přehledové řádky zpráv po příjemcích pro zadané datum, se stránkováním pomocí kurzoru. Volitelně lze filtrovat podle tagu a/nebo telefonního čísla. - [Získat agregované statistiky podle data](https://smsmanager.cz/docs/api-reference/status/získat-agregované-statistiky-podle-data.md): Vrací agregované statistiky odesílání seskupené podle data, pro jedno nebo více dat, volitelně filtrované podle tagu. - [Získat statistiky požadavku](https://smsmanager.cz/docs/api-reference/status/získat-statistiky-požadavku.md): Vrací souhrnné statistiky jednoho odesílacího požadavku (`request_id`) pro zadané datum. - [Získat stav zprávy](https://smsmanager.cz/docs/api-reference/status/získat-stav-zprávy.md): Vrací úplný stav jedné odeslané zprávy podle jejího `message_id`. Vraceny jsou pouze zprávy odeslané volajícím klíčem. - [Start phone validation](https://smsmanager.cz/docs/api-reference/validation/start-phone-validation.md): Initiates a new phone number validation by sending an message with a verification code. Returns a validation token that must be used for subsequent verification. - [Verify code](https://smsmanager.cz/docs/api-reference/validation/verify-code.md): Verifies the code entered by the user. On successful verification, returns all data needed for backend verification including the phone number, token, code, timestamp, and HMAC proof (if account has verificationSecret configured). - [Verify HMAC proof](https://smsmanager.cz/docs/api-reference/validation/verify-hmac-proof.md): Verifies an HMAC proof for phone validation without storing any state. This endpoint is useful for backend verification when you have all the validation data but want SMS Manager to verify the HMAC calculation. - [Verify proof (optional)](https://smsmanager.cz/docs/api-reference/validation/verify-proof-optional.md): Optional endpoint to verify a proof hash from a previous successful validation. This can be used to confirm that a validation was completed successfully. - [Overview](https://smsmanager.cz/docs/api-reference/verify/overview.md) - [Povolení statistik šablon](https://smsmanager.cz/docs/api-reference/waba-analytics/povolení-statistik-šablon.md): Povolí analytiku šablon (insights) na WABA. Musí být povolena dříve, než se začnou sbírat analytická data šablon. - [Získání analytiky konverzací](https://smsmanager.cz/docs/api-reference/waba-analytics/získání-analytiky-konverzací.md): Vrací analytiku konverzací (počty a náklady) dané WABA. Časové značky jsou v sekundách Unix epochy; výchozí rozsah je posledních 30 dní. - [Získání analytiky zpráv](https://smsmanager.cz/docs/api-reference/waba-analytics/získání-analytiky-zpráv.md): Vrací analytiku zpráv (počty odeslaných / doručených) dané WABA. Časové značky jsou v sekundách Unix epochy; výchozí rozsah je posledních 30 dní. - [Získání analytiky šablon](https://smsmanager.cz/docs/api-reference/waba-analytics/získání-analytiky-šablon.md): Vrací analytiku jednotlivých šablon (odesláno, doručeno, přečteno, kliknuto). Nejprve je nutné povolit statistiky šablon přes `/whatsapp/analytics/templates/enable`. Časové značky jsou v sekundách Unix epochy; výchozí rozsah je posledních 30 dní. - [Kontrola dostupnosti telefonního čísla](https://smsmanager.cz/docs/api-reference/waba-numbers/kontrola-dostupnosti-telefonního-čísla.md): Zkontroluje, zda předpřipravené WhatsApp telefonní číslo existuje a je ověřené. - [Přeposlání ověřovacího kódu telefonního čísla](https://smsmanager.cz/docs/api-reference/waba-numbers/přeposlání-ověřovacího-kódu-telefonního-čísla.md): Přepošle ověřovací kód pro předpřiřazené telefonní číslo na e-mail nastavený při registraci. - [Seznam telefonních čísel WABA](https://smsmanager.cz/docs/api-reference/waba-numbers/seznam-telefonních-čísel-waba.md): Vypíše telefonní čísla registrovaná na WhatsApp Business účtu. - [Odeslání testovací zprávy ze šablony](https://smsmanager.cz/docs/api-reference/waba-templates/odeslání-testovací-zprávy-ze-šablony.md): Odešle příjemci ostrou zprávu ze šablony pro její otestování. Payload je sestaven z definice šablony — jako parametry se použijí ukázkové hodnoty komponent `HEADER` a `BODY`; komponenty `FOOTER` a `BUTTONS` jsou přeskočeny. - [Seznam šablon zpráv](https://smsmanager.cz/docs/api-reference/waba-templates/seznam-šablon-zpráv.md): Vypíše všechny šablony zpráv dané WABA (objekty šablon Meta jsou předávány beze změny). - [Smazání šablony zprávy](https://smsmanager.cz/docs/api-reference/waba-templates/smazání-šablony-zprávy.md): Smaže šablonu podle jejího názvu (smažou se všechny jazykové verze daného názvu). - [Vytvoření šablony z knihovny Meta](https://smsmanager.cz/docs/api-reference/waba-templates/vytvoření-šablony-z-knihovny-meta.md): Vytvoří šablonu na základě šablony z knihovny Meta Template Library. - [Vytvoření šablony zprávy](https://smsmanager.cz/docs/api-reference/waba-templates/vytvoření-šablony-zprávy.md): Vytvoří šablonu zprávy na WABA. Objekt `template` odpovídá modelu šablon zpráv Meta (`name`, `language`, `category`, `components`). Obrázkovou hlavičku lze odeslat jako base64 data URL v `components[].example.base64_image` — je automaticky nahrána do Meta a nahrazena hodnotou `header_handle`. - [Úprava šablony zprávy](https://smsmanager.cz/docs/api-reference/waba-templates/úprava-šablony-zprávy.md): Upraví existující šablonu podle jejího Meta `template_id` (nikoli podle názvu). Použijí se pouze `template.category` a/nebo `template.components`. Každá zahrnutá komponenta **nahrazuje** existující komponentu stejného `type`; vynechané komponenty zůstávají beze změny. Pro změnu obrázkové hlavičky za… - [Dokončení registrace WhatsApp](https://smsmanager.cz/docs/api-reference/waba/dokončení-registrace-whatsapp.md): Dokončí registraci: vymění Meta OAuth `code` za business token, připojí WABA k vašemu účtu, zaregistruje telefonní číslo a volitelně nastaví firemní profil. Zadejte buď `phone_number_id` (existující číslo připojené v registračním procesu), nebo `country` (bude přiděleno nové číslo z našeho poolu). - [WhatsApp Business Partner API — Přehled](https://smsmanager.cz/docs/api-reference/waba/overview.md): WhatsApp Business Partner API SmsManageru umožňuje registrovat klienty do WhatsApp Business účtů, spravovat jejich telefonní čísla a šablony zpráv a číst analytiku zpráv, konverzací i šablon. - [Seznam připojených WhatsApp účtů](https://smsmanager.cz/docs/api-reference/waba/seznam-připojených-whatsapp-účtů.md): Vypíše WhatsApp Business účty připojené k vašemu API klíči, volitelně filtrované podle `client_id`. - [Zahájení vestavěné registrace WhatsApp](https://smsmanager.cz/docs/api-reference/waba/zahájení-vestavěné-registrace-whatsapp.md): Zahájí proces vestavěné registrace (embedded signup) WhatsApp. Vytvoří krátkodobý registrační token (platný 1 hodinu) vázaný na váš API klíč a vrátí jej spolu s URL hostované registrace. Přesměrujte uživatele na `redirect_url` s vráceným `token`. - [XML API — odeslání SMS](https://smsmanager.cz/docs/api-reference/xml-api/send.md): Odeslání SMS přes XML požadavek. Vhodné pro systémy, které pracují s XML nebo umí jen jednoduchý POST. - [Authentication](https://smsmanager.cz/docs/authentication.md) - [Channels](https://smsmanager.cz/docs/concepts/channels.md) - [Message flow](https://smsmanager.cz/docs/concepts/message-flow.md) - [Message ids](https://smsmanager.cz/docs/concepts/message-ids.md) - [Normalizace telefonních čísel](https://smsmanager.cz/docs/concepts/phone-normalization.md): Jak SmsManager normalizuje telefonní čísla: odstranění nečíselných znaků a úvodních nul. Podpora mezinárodních i národních formátů a doplnění předvolby podle země účtu. - [Příjem a zpracování požadavku](https://smsmanager.cz/docs/concepts/request-acceptance.md): Jak SmsManager přijímá požadavky na api.smsmngr.com. Proč HTTP 200 OK s message_id znamená jen přijetí ke zpracování, a která validace probíhá až následně. - [Scheduling](https://smsmanager.cz/docs/concepts/scheduling.md) - [Fronty odesílání a priorita](https://smsmanager.cz/docs/concepts/sending-queues.md): Jak SmsManager řadí zprávy do front podle pole tag — a proč pro časově kritické zprávy (OTP, ověření) volit prioritní odesílání. - [Typy WhatsApp zpráv na SmsManageru](https://smsmanager.cz/docs/concepts/whatsapp-message-types.md): Vysvětlení dvou typů WhatsApp zpráv na SmsManageru a pravidel, která určují, kdy který z nich použít. - [Batch sending](https://smsmanager.cz/docs/guides/batch-sending.md) - [Phone verification](https://smsmanager.cz/docs/guides/phone-verification.md) - [Send sms](https://smsmanager.cz/docs/guides/send-sms.md) - [Send viber](https://smsmanager.cz/docs/guides/send-viber.md) - [Send whatsapp](https://smsmanager.cz/docs/guides/send-whatsapp.md) - [Testování API napojení](https://smsmanager.cz/docs/guides/testing.md): Otestujte integraci se SmsManagerem bez odesílání skutečných zpráv a bez zbytečných nákladů — pomocí testovacího čísla, testovací brány a mock (sandbox) endpointů. - [Webhooks](https://smsmanager.cz/docs/guides/webhooks.md) - [Jak nastavit SMS fallback pro WhatsApp zprávy](https://smsmanager.cz/docs/guides/whatsapp-sms-fallback.md): Odešlete WhatsApp zprávu, která automaticky přejde na SMS, pokud doručení přes WhatsApp selže. - [Dokumentace SmsManager](https://smsmanager.cz/docs/index.md): Jedno API pro SMS, Viber a WhatsApp. Začněte tutoriálem, najděte konkrétní postup, nahlédněte do API reference nebo pochopte principy platformy. - [Introduction](https://smsmanager.cz/docs/introduction.md) - [Začněte se SmsManagerem za 5 minut](https://smsmanager.cz/docs/quickstart.md): Odešlete první SMS pomocí SmsManager JSON API v2. Naučte se autentizovat, sestavit požadavek a zpracovat odpověď během několika minut. - [Errors](https://smsmanager.cz/docs/reference/errors.md) - [Phone numbers](https://smsmanager.cz/docs/reference/phone-numbers.md) - [Rate limits](https://smsmanager.cz/docs/reference/rate-limits.md) - [Parametry RCS zpráv](https://smsmanager.cz/docs/reference/rcs.md): Referenční přehled objektu rcs — prostý text, návrhy odpovědí a akční tlačítka, samostatná rich card a produktový carousel přes RCS Business Messaging. - [Parametry WhatsApp šablon](https://smsmanager.cz/docs/reference/whatsapp-templates.md): Kompletní referenční přehled parametrů objektu whatsapp_template — proměnné v těle a hlavičce, media, všechny typy tlačítek, produktový carousel a časově omezené akce (LTO). - [Parametry WhatsApp textových zpráv](https://smsmanager.cz/docs/reference/whatsapp-text.md): 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. - [Registrace WhatsApp Business účtu pro vašeho klienta](https://smsmanager.cz/docs/tutorials/whatsapp-business-registration.md): Krok za krokem projděte první registrací klienta přes WhatsApp Partner API a získáte jeho WABA ID. ## OpenAPI Specs - [waba_restapi_v1](https://smsmanager.cz/docs/openapi/waba_rest/waba_restapi_v1.yaml) - [verifyapi_v1](https://smsmanager.cz/docs/openapi/verify/verifyapi_v1.yaml) - [restapi_v1](https://smsmanager.cz/docs/openapi/rest/restapi_v1.yaml) - [jsonapi_v2](https://smsmanager.cz/docs/openapi/json/jsonapi_v2.yaml)