Webhooky
a stav doručení

Jak dnes zjistíte stav doručení

Po odeslání zprávy přes REST API dostanete id zprávy. Stav pak kdykoli zjistíte dotazem:

GET https://www.topsms.cz/api/sms/status/{id}
Authorization: Bearer VAS_CLIENT_ID:VAS_SECRET

• Odpověď obsahuje status (sent / delivered / failed / expired), časová razítka doručení či selhání a operátora příjemce
• Tytéž stavy vidíte v dashboardu v historii zpráv, včetně CSV exportu
• Detailní popis polí najdete v API dokumentaci

Push webhooky připravujeme

Webhook je HTTP POST, který vám při změně stavu zprávy pošleme na vaši URL — bez pollingu. Tuto funkci právě připravujeme: v nastavení API klíče už si můžete webhook URL uložit, doručování notifikací ale zatím není spuštěné. Jakmile funkci zapneme, dáme klientům vědět.

• Plán: POST s ID zprávy, stavem a časovým razítkem na vaši URL
• Pole pro webhook URL najdete už dnes v nastavení API klíče
• Do spuštění používejte polling přes status endpoint
• Chcete webhooky prioritně? Napište nám na info@topsms.cz

Doporučený vzor: polling bez zbytečné zátěže

SMS se typicky doručí do několika sekund. Rozumný postup: po odeslání se na stav zeptejte po 10 sekundách, pak po 30 a 60 sekundách, a zbývající zprávy dokontrolujte jednou za pár minut. Konečné stavy (delivered, failed, expired) se už nemění — dotazování na ně můžete ukončit.

• Ukládejte si id každé odeslané zprávy
• Interval dotazů: 10 s → 30 s → 60 s → dále po minutách
• Konečný stav = konec pollingu pro danou zprávu
• Hromadné kampaně: stavy pohodlněji v dashboardu / CSV exportu