Webhooky

Čo webhook posiela

Webhook je adresa na vašej strane, na ktorú BulkGate hlási, čo sa so správami stalo. Portál ho nazýva Potvrdenie o doručení, ale posiela naň dve veci naraz:

Čo príde	Ako to spoznáte
Potvrdenie o doručení	Záznam so stavom odoslanej správy a jej `smsID`
Prichádzajúca SMS (odpoveď)	Záznam so `status` `10`, odosielateľom v poli `from` a textom správy

Nejde teda o dvojaké nastavenie — jedna adresa obslúži potvrdenia o doručení aj odpovede.

Formát dát sa riadi tým, či máte zapnuté hromadné zasielanie:

Režim	Ako dáta chodia	Popis formátu
predvolený	Jedna požiadavka na každú správu, metódou GET	Potvrdenie o doručení
`Zasielať doručenky hromadne`	Dávka záznamov, metódou POST s `application/json`	Hromadné potvrdenie o doručení

Kde sa webhook nastavuje

Miesto sa líši podľa toho, aké rozhranie používate. Vo všetkých prípadoch vedú prvé dva kroky rovnako — v menu portálu kliknite na Moduly a API a v časti Moje API a Moduly otvorte kartu svojej aplikácie.

Rozhranie	Kde v detaile aplikácie
HTTP API	Karta `Nastavenie`, časť `Web hooky`, dlaždica `Potvrdenie o doručení`
`Email > SMS`	Len `Email pre doručenky` — potvrdenia o doručení chodia e-mailom, nie na URL

Ako webhook zapnem

Dlaždica ukazuje, či je niečo nastavené. Kým nie je, je tu Nemáte žiadne nastavenia. a tlačidlo Konfigurovať.

Časť Web hooky s dlaždicou Potvrdenie o doručení

Tlačidlom Konfigurovať (alebo Upraviť, ak už nastavenie máte) sa otvorí okno Nastavenie potvrdenia o doručení.

Okno Nastavenie potvrdenia o doručení s poľom URL pre doručenky

Do poľa URL pre doručenky zadajte adresu začínajúcu http:// alebo https:// — iný zápis portál neprijme. K tomu sú tri zaškrtávacie políčka:

Voľba	Čo urobí
`Vypnite kontrolu dostupnosti URL`	Portál pred uložením neoverí, že adresa odpovedá
`Zasielať len v prípade chyby`	Potvrdenie o doručení príde len pri neúspešnej správe
`Zasielať doručenky hromadne`	Potvrdenia o doručení chodia po dávkach namiesto po jednom

Nastavenie uložíte tlačidlom Uložiť.

Tip

Hromadné zasielanie sa hodí pri veľkých objemoch — namiesto jednej požiadavky na každú správu príde jedna požiadavka s poľom záznamov. Formát dávky popisuje Hromadné potvrdenie o doručení.

Hneď ako webhook nastavíte, dlaždica vypíše tri riadky — URL s adresou a pri oboch voľbách Zasielať len v prípade chyby a Zasielať doručenky hromadne ikonu podľa toho, či sú zapnuté.

Ako webhook zruším

Šípka vedľa tlačidla Upraviť rozbalí ponuku s voľbou Zmazať. Potvrdzovacie okno Zmazať nastavenie upozorní, že o nastavenie potvrdení o doručení prídete a prestanú vám chodiť.

Upozornenie

Zrušením webhooku sa zastavia aj prichádzajúce správy — odpovede na vaše SMS nemajú kam doraziť.

Bola táto stránka užitočná?

Opýtať sa AI Skopírované