Kdy se kredit odečítá
Kredit se strhává v jediném okamžiku a to při odeslání zprávy. Ve stejnou chvíli probíhá i závěrečná kontrola, že zprávu lze odeslat (např. že příjemce není na blacklistu nebo se neodhlásil z odběru). Kredit se naopak neodečítá:- při naplánování odeslání — zpráva s polem
datetimedo budoucna se zařadí bez ohledu na aktuální stav kreditu, - při přípravě zprávy v administraci — dokud nedojde ke skutečnému odeslání, kredit zůstává nedotčen.
Protože se kredit rezervuje až při odeslání, odeslání se naplánuje i tehdy, když v daný moment nemáte dostatek kreditu. Kredit stačí doplnit kdykoli před okamžikem odeslání.
Kontrola kreditu při odeslání
Až ve chvíli odeslání SmsManager ověří, že máte na danou zprávu dostatek kreditu, a pokud ano, kredit odečte. Tehdy se také vyhodnotí ostatní pravidla pro odeslání (blacklist, opt-out apod.). Výše odečteného kreditu se řídí cenou zprávy podle destinace, kanálu a počtu segmentů. Za co se u jednotlivých kanálů platí, popisuje koncept Účtování zpráv podle kanálu. Podrobnosti o tom, jak SmsManager požadavek přijímá a následně zpracovává, najdete v konceptu Příjem a zpracování požadavku.Sdílené podřízené klíče (vytvořené se
shared: true) čerpají kredit z peněženky nadřazeného klíče. GET /credit u nich proto vrací stav této sdílené peněženky.Vaše cena pro destinaci
Kolik zaplatíte za zprávu na konkrétní číslo, zjistíte přesPOST /credit/price. Endpoint vrací vaše skutečné ceny pro jedno cílové číslo, rozdělené podle kanálů. Ceny už zahrnují vaši dosaženou objemovou slevu. Proto mohou být nižší než obecný ceník z GET /credit/prices.
Požadavek
Odpověď (výňatek)
pricesje klíčované kanálem:sms,viber,whatsapp_text,whatsapp_templatearcs.smsobsahuje jednu položku pro každou gateway (napříkladhigh,lowcostnebodirect) a navícdefault, který je kopiíhigh.- Ostatní kanály obsahují jen
default. - Kanály, které do dané destinace nedoručují, v
priceschybí. price_czkaprice_eurjsou ceny za jednu část zprávy.
platform omezíte odpověď na jeden kanál, například "platform": "sms". Číslo v to můžete poslat i v jiném než mezinárodním formátu. Pole normalized pak obsahuje číslo převedené na mezinárodní formát.
Nedostatek kreditu — chyba 307
Pokud v okamžiku odeslání není na účtu dostatek kreditu, zpráva je odmítnuta s chybou[307] Insufficient credit. Zpráva skončí ve stavu rejected a informaci obdržíte na vaší callback URL:
Webhook událost (výňatek)
Praktický důsledek pro vaši integraci
- Naplánování nezaručuje odeslání. I naplánovanou zprávu je potřeba pokrýt kreditem až do okamžiku jejího odeslání.
- Hlídejte si stav kreditu. Zejména u odesílání naplánovaného na budoucnost zajistěte dostatek kreditu před daným časem.
- Zpracujte stav
rejecteds kódem 307. Naslouchejte na callback URL a v poliresult_inforozlišujte[307] Insufficient creditod ostatních příčin zamítnutí. Zamítnuté zprávy po dobití kreditu v případě potřeby odešlete znovu.
Další kroky
Dobíjení kreditu
Bankovní převod, platební karta, automatické dobíjení a měsíční fakturace.
Účtování zpráv
Za co platíte u SMS, WhatsAppu, RCS a Viberu a jak funguje cena podle objemu.
Příjem a zpracování požadavku
Proč
200 OK znamená jen přijetí ke zpracování a která validace probíhá až následně.Plánování odeslání
Jak polem
datetime naplánovat zprávu na konkrétní čas v budoucnu.Chybové kódy
Význam kódu
[307] Insufficient credit a dalších stavů result_info.Webhooky
Formát doručenky, sekvence stavů a pole
result_info.