## Č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í](https://www.bulkgate.com/sk/dokumentacia/api-administracia-a-tokeny/api-potvrdenie-o-doruceni-a-prichadzajucich-spravach/) |
| `Zasielať doručenky hromadne` | Dávka záznamov, metódou POST s `application/json` | [Hromadné potvrdenie o doručení](https://www.bulkgate.com/sk/dokumentacia/api-administracia-a-tokeny/api-hromadne-potvrdenie-o-doruceni-a-prichadzajucich-spravach/) |

## 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í](docs:api-webhooks/webhooks_cs)

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](docs:api-webhooks/delivery-report_cs)

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í](https://www.bulkgate.com/sk/dokumentacia/api-administracia-a-tokeny/api-hromadne-potvrdenie-o-doruceni-a-prichadzajucich-spravach/).

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ť.

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