Synchronizace e-mailů s Raynetem

Klienti často mění e-mailovou adresu — zaměstnanecky migrují, redomény, mění poskytovatele. Bez automatické synchronizace by admin musel ručně sledovat změny v Raynetu a aktualizovat přihlašovací údaje. ClientPortal to dělá za vás.

Jak to funguje

Když se v Raynetu změní e-mail kontaktu, Raynet pošle webhook (Person.Updated nebo Company.Updated). ClientPortal:

1. Najde příslušného uživatele v portálu (podle raynet_person_id nebo raynet_company_id)
2. Aktualizuje users.email na novou hodnotu z Raynetu
3. Klient se od příštího přihlášení loguje novou e-mailovou adresou
4. Heslo zůstává stejné — klient nepotřebuje nic dělat

Mapování klientů na Raynet

ClientPortal podle typu klienta používá různá pole z Raynetu:

Fyzická osoba (Person)

• V Raynetu vede jako Osoba (Person) s vlastním e-mailem
• V portálu mapováno přes raynet_person_id
• Webhook: Person.Updated

Firma (Company) s kontaktní osobou

• V Raynetu vede jako Firma (Company) s e-mailem
• V portálu mapováno přes raynet_company_id
• Webhook: Company.Updated

Většina B2B klientů jsou firmy — pak se synchronizuje firemní e-mail (často uváděný jako info@firma.cz nebo přímý e-mail kontaktní osoby).

Co se NEzmění

• Heslo — zůstává nedotčené, klient se přihlásí novým e-mailem se stejným heslem
• Pohledy a osobní nastavení — uložené filtry, jazyk, layout zůstávají
• Historie — všechny notifikace, tickety, audit log se zachovávají
• Přístup k datům — pokud je klient stále napojený na stejnou firmu v Raynetu, vidí stejné OP a schůzky

Edge case: Konflikt e-mailů

Pokud se nový e-mail z Raynetu shoduje s e-mailem jiného uživatele v portálu, synchronizace selže — nemůžou existovat dva uživatelé se stejným e-mailem. V takovém případě:

1. Portál automaticky odešle notifikaci adminovi
2. Synchronizace e-mailu konkrétního klienta se přeskočí
3. Stará e-mailová adresa zůstává platná pro přihlášení
4. Admin musí konflikt vyřešit ručně (typicky smazáním duplicitního účtu)

Manuální override

V některých případech potřebujete e-mail klienta nastavit jinak, než je v Raynetu (např. klient žádá o speciální alias). Můžete to udělat ručně:

1. Otevřete Správa uživatelů
2. Najděte konkrétního klienta a otevřete jeho detail
3. Klikněte na Upravit
4. Změňte e-mail a uložte

⚠️ Pozor: ruční změna může být přepsána při dalším webhooku z Raynetu. Pokud je v Raynetu jiná hodnota, příští Updated ji vrátí. Pokud chcete trvalou odchylku, změňte e-mail i v Raynetu.

Bezpečnost

• Změna e-mailu nevyžaduje žádnou akci klienta — je provedena na pozadí
• Klient o změně nedostává automatickou notifikaci (e-mail je veřejný údaj v Raynetu, ne tajemství)
• Pokud je portál napojen i na e-mail (např. notifikace), ty se pošlou na novou adresu
• Heslo nikdy neopustí portál — synchronizace se týká pouze přihlašovacího e-mailu

Předpoklad: Webhooky

Synchronizace e-mailů funguje pouze pokud máte zapnuté webhooky. Bez webhooků se e-mail aktualizuje při příští plánované synchronizaci (každých ~30 minut), což znamená dočasné okno, kdy je v portálu starý e-mail.

Detaily o webhoocích: Webhooky z Raynetu — real-time synchronizace.

Časté problémy

• 🔹 E-mail se v portálu nezměnil — zkontrolujte logy (Nastavení → Logy → kategorie webhook). Hledejte event Person.Updated nebo Company.Updated. Pokud chybí, problém je v doručení webhooku.
• 🔹 Klient se nemůže přihlásit po změně — ověřte aktuální e-mail v profilu portálu (Správa uživatelů → Detail). Pokud je tam stále starý, webhook nedorazil.
• 🔹 E-mail se synchronizoval na špatnou adresu — v Raynetu má kontakt více e-mailů (primární, sekundární). Portál bere primární. Změňte pořadí v Raynetu.
• 🔹 Klient hlásí, že mu chodí pošta na starou adresu — synchronizace probíhá při webhooku Updated, ne při běžných eventech jako Phoned nebo Noted. Ujistěte se, že máte tu správnou událost zapnutou.
• 🔹 Konflikt e-mailů — admin dostává notifikaci, problém řešíte ručně. Typicky deduplikace dvou účtů nebo přejmenování jednoho.