Platforma pro sledování odkazů zaznamenává, co se s vašimi odkazy děje. Webhook znamená, že o tom platforma informuje vaše další systémy hned, jak se to stane, a nečeká, až se někdo podívá do řídicího panelu. Díky této kombinaci se nový odkaz kampaně objeví ve vašem CRM ve chvíli, kdy vznikne, nebo zobrazení tajného odkazu aktualizuje tiket.
Při výběru platformy pro sledování odkazů s integrací přes webhooky nestačí zjistit, že „má webhooky“. Důležité je, které události posílá, jak je zabezpečuje a co neposílá. Tento návod probírá všechno z toho, dále jak postavit spolehlivý přijímač a kdy je lepším nástrojem API.
K čemu jsou webhooky z platformy pro odkazy
Opakovaně se objevují tři úlohy.
- Synchronizace systémů. Odkaz vytvořený v platformě se objeví v záznamu kampaně ve vašem CRM nebo nástroji pro řízení projektů, s koncovkou i cílovou adresou, aniž by ho kdokoli kopíroval.
- Spouštění pracovních postupů. Otevřený tajný odkaz označí předání jako dokončené. Odkaz, který se zničil, aniž by příjemce cokoli potvrdil, založí incident.
- Plnění datového skladu. Události dorazí do fronty a pak do tabulky, kde se propojí se zbytkem vašich dat.
K počítání se webhooky nehodí. Řídicí panel, který s každým webhookem přičte jedničku, se od reportu samotné platformy rozejde, jakmile se poprvé nějaké doručení zopakuje nebo zpozdí. Pro čísla používejte API nebo export, webhooky pro akce.
Které události hledat
Platformy se liší v tom, co posílají. Ptejte se na seznam událostí, ne na funkci.
| Skupina událostí | Typické události | Hodí se pro |
|---|---|---|
| Životní cyklus odkazu | vytvoření, úprava, smazání | Synchronizaci s CRM, auditní stopu, zachycení nechtěných úprav |
| Životní cyklus tajné zprávy | vytvoření, zobrazení, zničení | Potvrzení předání, spouštění incidentů |
| Události kliknutí | po jednotlivých kliknutích nebo v dávkách | Automatizaci v reálném čase při velkém objemu |
| Události domény | ověření, vystavení certifikátu | Provozní upozornění |
Webhooky LinkPilotu pokrývají životní cyklus odkazu (link.created, link.updated, link.deleted) a životní cyklus tajné zprávy (secret.created, secret.viewed, secret.burned). Data o kliknutích jsou dostupná přes analytické API a export CSV, ne jako webhook pro každé kliknutí. Pro většinu týmů je to správné rozdělení: kliknutí jsou objemná data pro reporting, kdežto události životního cyklu jsou ty, které mají něco spustit.
Pokud váš postup opravdu potřebuje reagovat na každé kliknutí, ověřte, že je platforma posílá v dávkách nebo omezuje jejich četnost. Jinak postavíte přijímač, který spadne, jakmile se nějaký příspěvek poprvé virálně rozšíří.
Co dalšího posoudit
- Podepisování. Každé doručení má nést podpis vypočtený z tajného klíče, který máte vy, aby váš endpoint mohl odmítnout podvrhy. Platforma, která posílá nepodepsané webhooky, po vás chce, abyste věřili jakémukoli požadavku POST.
- Opakování a pořadí. Zjistěte, kolikrát a v jakém časovém rozmezí se neúspěšné doručení opakuje, a počítejte s tím, že události mohou dorazit v jiném pořadí.
- ID událostí. Jedinečné ID každé události je to, co umožňuje idempotenci.
- Správa endpointů. Více endpointů v jednom pracovním prostoru, odběr jednotlivých událostí a protokol doručení, který si přečtete, když se něco pokazí.
- API vedle webhooků. Webhooky pro spouštěče, API pro všechno ostatní. Ověřte, že vytváření odkazů, statistiky i exporty jsou dostupné programově a že klíče lze omezit na určitý rozsah. API LinkPilotu používá klíče typu bearer s předponou
lp_live_a je k dispozici v každém tarifu. - Přístup týmu. Na tom, kdo smí přidat endpoint webhooku, záleží, protože endpoint dostává data. Role mají správci umožnit endpointy spravovat a všechny ostatní k nim nepustit.
Postavte přijímač, který nespadne
- Nejdřív ověřte podpis. Z nezpracovaného těla požadavku a svého tajného klíče vypočtěte očekávaný podpis, porovnejte ho v konstantním čase a vše, co neprojde, odmítněte ještě před parsováním.
- Odpovězte rychle. Vraťte odpověď 2xx do jedné nebo dvou sekund. Skutečnou práci dělejte z fronty, aby pomalý CRM nezpůsoboval opakování.
- Ukládejte ID událostí a přeskočte ta, která už znáte. Opakování jsou normální, dvojí zpracování je chyba na vaší straně.
- Mapujte pole výslovně. Do vlastního schématu si převezměte koncovku, cílovou adresu, štítky a časová razítka, která potřebujete. Neukládejte celou datovou část jako zdroj pravdy: je to oznámení, ne záznam.
- Zaznamenávejte každé doručení s jeho ID a výsledkem. Když pak protokol platformy hlásí doručeno a ve vašem systému se nic nestalo, zjistíte, kam se událost ztratila.
- Upozorňujte na ticho. Pokud endpoint, který obvykle dostává události každou hodinu, den mlčí, na jedné ze stran se něco rozbilo.
Před první ostrou kampaní vše vyzkoušejte s testovacím endpointem a testovacím doručením platformy. Vytvořte odkaz, upravte ho, smažte ho a sledujte, jak dorazí tři události.
Chraňte data
Datové části webhooků popisují odkazy a tajné zprávy, ne lidi. Ať to tak zůstane.
- Nikdy nedávejte osobní údaje do koncovek odkazů ani do štítků, protože pak putují v každé datové části, která se toho odkazu týká.
- Omezte endpoint na provoz z platformy pomocí podpisu a, kde to jde, i podle zdrojové adresy.
- Podpisový klíč ukládejte do správce tajných údajů, ne do konfiguračního souboru přijímače, a pravidelně ho rotujte. Pokud ho musíte předat externistovi, který přijímač staví, pošlete ho jako jednorázový tajný odkaz. Toto předání popisuje návod k podpisovému klíči webhooku.
- Myslete na souhlas, když data o kliknutích tečou do CRM. Záznam o kliknutí propojený se zákazníkem je podle většiny pravidel ochrany soukromí osobní údaj.
Měřte samotnou integraci
- Úspěšnost doručení podle protokolu platformy.
- Zpoždění zpracování od časového razítka události po záznam ve vašem systému.
- Podíl duplicit, který má být nízký, ale nikdy nulový.
- Odsouhlasení: jednou týdně porovnejte počty odkazů a součty kliknutí z API s tím, co mají vaše systémy. Rozdíl znamená ztracené doručení nebo chybu v přijímači.
Platforma pro sledování odkazů s webhooky zapojí vaše odkazy do zbytku vašich systémů. Vyberte takovou, která podepisuje, co posílá, přesně řekne, jaké události existují, a pro čísla nabízí API. Přijímač pak stavte s tím, že opakování jsou běžný případ, protože jsou.