Novinka Spustili jsme novou aplikaci NG Emailing. Proč vznikla a co je v ní jinakNová aplikace: proč vznikla

Webhooky: události o doručení do vašeho systému

Stručně

Webhook založíte v API a integrace na záložce Webhooky: zadáte veřejnou HTTPS adresu svého systému a vyberete události. NG Emailing na ni pošle podepsané zprávy o stavu transakčních e-mailů, takže se váš systém nemusí ptát. Webhooky jsou jen v placených tarifech.

Tarif Free API ani transakční e-maily nemá. Webhooky spravuje vlastník nebo administrátor projektu a fungují jen pro přístupy v ostrém provozu. Potřebujete také veřejnou HTTPS adresu a vývojáře, který ji obslouží. Ceny najdete na stránce Ceník.

API a integrace, záložka Webhooky: dvě adresy s událostmi Doručeno, Vráceno, Stížnost a Odhlášení, úspěšností a stavem Aktivní
API a integrace, záložka Webhooky: dvě adresy s událostmi Doručeno, Vráceno, Stížnost a Odhlášení, úspěšností a stavem Aktivní

Založení webhooku

  1. V levém menu otevřete API a integrace a záložku Webhooky.
  2. Zvolte Nový webhook.
  3. Zadejte HTTPS adresu svého systému a vyberte události, o které máte zájem. Adresa musí existovat a být veřejná. Když to aplikace nemůže ověřit, zkuste to později.
  4. Po vytvoření se zobrazí podpisové tajemství. Zobrazíme ho jen jednou, proto si ho hned uložte. Znovu se ukáže až po otočení tajemství.

V tabulce webhooků pak vidíte adresu, události, úspěšnost a stav. Sloupec Úspěšnost ukazuje, kolik procent doručení za posledních 30 dní váš systém přijal, například „95 % (19 z 20)“.

Události

Webhook hlásí změny stavu transakčních zpráv. Mezi událostmi jsou i Otevření a Kliknutí. Ty chodí jen u zpráv ze šablony se zapnutým měřením otevření a prokliků a mohou je vyvolat i roboti. Automatická odpověď příjemce, například zpráva o nepřítomnosti, není vrácení. Zpráva zůstane doručená. Přesný seznam událostí a tvar zpráv najdete ve veřejné dokumentaci API. Změna adresy nebo událostí platí jen pro budoucí události, starší doručení zůstávají na původní adrese.

Podpis a ověření

Váš systém musí u každé přijaté zprávy ověřit podpis pomocí tajemství. Zprávy, které podpis nemají nebo se neshodují, zahoďte. Postup ověření popisuje dokumentace API. Tajemství nikomu neposílejte. Když uniklo, použijte v nabídce … volbu Otočit tajemství a nové vložte do svého systému.

Opakované doručení a duplicity

Test a ruční opakování doručení nikdy neodešlou e-mail. Opakování pošle stejnou událost se stejným ID. Váš systém proto musí umět rozpoznat duplicitu podle ID události a nezpracovat ji podruhé.

Zkušební událost, historie a pozastavení

V nabídce … u webhooku najdete:

  • Poslat zkušební událost, kterou ověříte, že váš systém zprávu přijme.
  • Historie doručení, kde uvidíte jednotlivá doručení.
  • Upravit a Otočit tajemství.
  • Vypnout a Zapnout. Vypnutí webhook dočasně zastaví, a to i ve chvíli, kdy váš systém neodpovídá. Události, které nastanou během vypnutí, neodešleme ani po zapnutí.
  • Archivovat. Archivace je nevratná.

Když to nejde

  • Webhook nejde založit. Zkontrolujte tarif a svou roli. Webhooky spravuje vlastník nebo administrátor.
  • Aplikace adresu odmítne. Musí to být veřejná HTTPS adresa, která existuje.
  • Události nechodí. Zkontrolujte, zda webhook není vypnutý a zda je váš přístup v ostrém provozu. Testovací klíč webhook neodešle.
  • Úspěšnost je nízká. Váš systém odpovídá chybou nebo neodpovídá. Podívejte se do Historie doručení.

Časté dotazy

Říká webhook, že e-mail dorazil do schránky?

Ne. Hlásí stav, který aplikace zná od odesílací služby. Stav Předáno neznamená Doručeno a umístění ve schránce aplikace nezná.

Musím použít webhook, nebo jde událost zjistit jinak?

Události lze číst také opakovaným dotazem (polling). Webhook je pohodlnější, protože vám je pošleme sami. Obě možnosti popisuje dokumentace API.

Napojíte webhooky na konkrétní e-shop nebo CRM?

Hotová napojení na konkrétní e-shopy ani CRM aplikace nenabízí. Webhook přijímá váš vlastní systém. Plánované funkce najdete na stránce Co chystáme.

Další krok

Přehled API, webhooků a transakčních e-mailů najdete na stránce API a integrace. Jak v aplikaci dohledat konkrétní zprávu, vysvětluje návod Transakční zprávy: stav a proč zpráva nedorazila.

Nevíte si rady? V aplikaci se zeptejte AI pomocníka nebo napište podpoře. Jak podpora funguje

První kampaň můžete odeslat ještě dnes

Začnete zdarma a bez platební karty. Stačí ověřit doménu, nahrát kontakty a vybrat šablonu.

Free: 100 kontaktů a 200 e-mailů měsíčně.

Používáme nezbytné cookies. Se souhlasem také měříme návštěvnost a reklamu (Google Analytics, Google Ads). Podrobnosti