Webhooky z Raynetu — real-time synchronizace

Bez webhooků čeká ClientPortal na pravidelnou synchronizaci s Raynetem — typicky každých 30 minut. To znamená, že změna v Raynetu se klientovi v portálu projeví třeba s 25 minutovým zpožděním. S webhooky se změny projeví okamžitě a ušetří se tím desítky API volání denně.

Co je webhook

Webhook je HTTP callback — Raynet pošle ClientPortalu zprávu pokaždé, když se v jeho databázi něco změní. Portál tu zprávu zpracuje, aktualizuje data a invaliduje cache. Klient na dashboardu vidí změnu téměř okamžitě.

Které události portál sleduje

Klienti a kontakty

• Person.Created — nový kontakt v Raynetu
• Person.Updated — změna kontaktu (jméno, e-mail, telefon)
• Person.Deleted — smazaný kontakt
• Company.Updated — změna firemního kontaktu (klíčové pro synchronizaci e-mailů)

Obchodní případy

• BusinessCase.Created — nový obchodní případ
• BusinessCase.Updated — změna stavu, popisu, polí
• BusinessCase.Deleted — smazaný případ

Schůzky a aktivity

• Activity.Created — nová aktivita/schůzka
• Activity.Updated — změna detailu
• Activity.Deleted — smazaná aktivita

Nastavení v Raynetu

1. Přihlaste se do Raynetu jako administrátor
2. Otevřete Nastavení → Webhooky
3. Klikněte na Přidat webhook
4. Vyplňte:
   • URL: přesnou URL najdete v ClientPortalu v Nastavení → Integrace → Webhooky. Bude vypadat jako https://clientportal.cz/api/raynet/webhook/[váš-token]
   • Secret: ClientPortal generuje secret token, který Raynet posílá s každým požadavkem. Zkopírujte ho z portálu a vložte do Raynetu.
   • Události: vyberte Person.*, Company.*, BusinessCase.*, Activity.*
5. Klikněte na Uložit

Co dělá portál po přijetí webhooku

Když přijde webhook, portál:

1. Ověří secret — pokud nesouhlasí, požadavek odmítne
2. Načte aktualizovaná data z Raynet API (jen ty záznamy, které se změnily)
3. Invaliduje cache tenanta — všechny dotčené entity
4. Aktualizuje portál — klient na dashboardu vidí změnu po obnovení stránky
5. Loguje událost v Nastavení → Logy

Šetření API quoty

Bez webhooků portál pravidelně volá Raynet API a kontroluje změny — to znamená desítky API volání denně. S webhooky portál volá API jen když přijde notifikace o změně. U typického tenanta s 50 klienty to znamená:

• Bez webhooků: ~500-1500 API volání denně
• S webhooky: ~50-100 API volání denně (pouze při skutečné změně)

Raynet má v každém plánu API limity — čím méně volání, tím méně problémů s rate limitingem.

Otestování webhooků

Po nastavení udělejte v Raynetu jakoukoliv změnu (např. upravte popis kontaktu). Pak:

1. V ClientPortalu otevřete Nastavení → Logy
2. Filtr: kategorie = webhook
3. Měli byste vidět záznam o přijaté události s timestampem

Pokud záznam chybí, webhook nedorazil — viz „Časté problémy" níže.

Časté problémy

• 🔹 Webhook nepřichází — zkontrolujte:
  • Že URL je přesně podle ClientPortalu (včetně tokenu)
  • Že firewall nebo VPN neblokuje příchozí požadavky z Raynet IP rozsahů
  • Že je secret token v Raynetu shodný s tím v portálu
• 🔹 Raynet hlásí 401 Unauthorized — secret nesouhlasí. V ClientPortalu klikněte na Regenerovat secret a zkopírujte nový do Raynetu.
• 🔹 Webhook funguje pro některé události, jiné ne — zkontrolujte, že máte v Raynetu zaškrtnuté všechny relevantní eventy. Person.Updated nezahrnuje Person.Deleted apod.
• 🔹 Můj plán Raynetu nepodporuje webhooky — webhooky jsou dostupné v plánu Profesionál a vyšším. Bez něj se musíte spolehnout na pravidelnou synchronizaci.
• 🔹 Klient nadále vidí stará data i po webhooku — vyzvěte ho k obnovení stránky (Ctrl+F5). Cache prohlížeče může držet starou verzi.

💡 Po prvním nastavení webhooků doporučujeme nechat 24 hodin běžet a pak zkontrolovat logy. Pokud vidíte stovky úspěšných záznamů, vše šlape. Pokud žádné, je problém s konektivitou.