Novinky v TopSMS (říjen 2026): plánované odeslání, Verify API, testovací klíče a MCP server pro AI
Přehled novinek v SMS bráně TopSMS od září: plánované odeslání přes API, ochrana proti dvojímu odeslání (Idempotency-Key), důvody nedoručení, ověřovací kódy (Verify API), testovací klíče, log požadavků a webhooků, fronta pro velké dávky a MCP server pro Claude a další AI asistenty.
Od zářijových novinek jsme nasadili hlavně věci pro vývojáře a pro spolehlivost velkých rozesílek. Všechno je dostupné všem účtům automaticky a bez příplatku, platíte dál jen odeslané SMS.
Plánované odeslání přes API
Do /api/sms/send i /api/sms/send-bulk stačí přidat pole send_at a zpráva odejde v zadaný čas, až 30 dní dopředu:
{ "to": "+420601234567", "text": "Pripominame zitrejsi termin v 10:00.", "send_at": "2026-10-15T09:00:00+02:00" }
Odpověď obsahuje jobId. Naplánované odeslání zrušíte přes DELETE /api/sms/jobs/{jobId} a cena se vrátí na kredit. Připomínky termínů tak můžete naplánovat hned při rezervaci a o čas odeslání se nestarat. Kampaně v dashboardu šly plánovat už dřív.
Žádné dvojí odeslání: Idempotency-Key
Když vám při odesílání vypadne spojení, nevíte, jestli SMS odešla. Pošlete požadavek znovu se stejnou hlavičkou Idempotency-Key a SMS neodejde podruhé. Dostanete původní odpověď s hlavičkou Idempotent-Replayed: true. Funguje pro odeslání, hromadné odeslání i ověřovací kódy a klíč platí 24 hodin. Jako klíč se hodí ID objednávky nebo UUID.
Proč zpráva nedorazila: pole errorCode
Nedoručené zprávy mají nově strojový důvod v poli errorCode (ve stavu zprávy, ve webhooku i ve výsledcích dávky) a srozumitelnější hlášku v dashboardu:
expired: telefon byl po celou dobu platnosti vypnutý nebo mimo signál,undelivered: číslo neexistuje, není aktivní nebo SMS nepřijímá,rejected: operátor zprávu odmítl (například blokace SMS od firem),repeated_failure: na stejné číslo selhalo doručení aspoň potřetí za 90 dní, číslo nejspíš neexistuje a vyplatí se ho vyřadit.
Kompletní seznam je v REST API dokumentaci.
Verify API: ověřovací kódy dvěma voláními
Ověření telefonu při registraci nebo přihlášení bez vlastní logiky: POST /api/verify/send pošle kód, POST /api/verify/check ho ověří. Kód generujeme a bezpečně ukládáme my a hlídáme i limity pokusů a ochranu proti zneužití. Návod s ukázkami v PHP a Node.js najdete v článku Ověřovací SMS kódy (OTP) přes API, popis na stránce Verify API.
Testovací API klíče
Při vytváření klíče zaškrtnete Testovací klíč. Takový klíč nic neodesílá ani neúčtuje, ale odpovídá stejně jako ostrý a za pár sekund pošle simulovanou doručenku na váš webhook. Čísla končící 0000 simulují selhání, 0001 vypršení platnosti. Celou integraci tak odladíte bez nákladů a bez vlastního telefonu.
Log požadavků a webhooků v dashboardu
U každého API klíče je nově tlačítko Log a webhook. Uvidíte v něm posledních 100 volání (čas, endpoint, stav, délku a tělo požadavku) a každý pokus o doručení webhooku včetně odpovědi vašeho serveru. Tamtéž nastavíte nebo změníte URL webhooku a pošlete si testovací událost. Když integrace nefunguje, hned vidíte proč.
Velké dávky přes frontu
Hromadné odeslání nad 50 příjemců (nebo s "async": true) se přijme okamžitě s odpovědí 202 a jobId a odesílá se na pozadí. Průběh sledujete přes GET /api/sms/jobs/{jobId}. Tisíce SMS tak odešlete bez čekání na odpověď a bez vypršení spojení. Přes stejnou frontu jdou i kampaně z dashboardu.
MCP server: SMS z Clauda, Cursoru a dalších AI asistentů
Vydali jsme oficiální MCP server TopSMS (balíček topsms-mcp na npm, zapsaný v oficiálním MCP registru). AI asistentovi pak stačí říct třeba „pošli zákazníkovi SMS, že je objednávka připravená“ nebo „naplánuj připomínku na zítra v 9:00“. Umí odeslat i naplánovat SMS, zjistit stav doručení, poslat a ověřit kód a zkontrolovat kredit. Instalace jedním příkazem:
claude mcp add topsms -e TOPSMS_CLIENT_ID=... -e TOPSMS_SECRET=... -- npx -y topsms-mcp
Aplikace pro Make
Pro automatizace bez programování je tu oficiální aplikace TopSMS v Make: šest hotových modulů, připojení přes API klíč a trigger na doručenky, bez obecného HTTP modulu. Do zařazení do veřejného katalogu Make ji přidáte přes odkaz v článku SMS z Make.
Sender ID: poplatek při podání, při zamítnutí vracíme
Jednorázový poplatek 500 Kč za vlastní jméno odesílatele se nově strhne z kreditu už při podání žádosti. Pokud operátoři žádost zamítnou, vrátíme ho celý. Odesílatele schvalují operátoři hromadně několikrát měsíčně, takže počítejte s 1–2 týdny. Chystáte kampaň na Black Friday? Zažádejte do konce října, víc v průvodci Black Friday 2026 přes SMS.
A dál?
Máte nápad, co by vám ušetřilo práci? Napište na info@topsms.cz, podle vašich tipů plánujeme, co uděláme dál.
Ještě nemáte účet? Registrace je zdarma a 10 SMS na vyzkoušení máte v ceně.