Блог CZ
Duplicitní aktualizace Telegram bota se zastaví před vytvořením poptávky v CRM.
Telegram a automatizace

Telegram bot vytváří duplicitní poptávky: idempotentní webhook a CRM

Telegram může poslat stejnou aktualizaci webhooku znovu, pokud nedostal odpověď včas. Když handler při každém doručení zakládá novou poptávku v CRM, jeden zákazník vytvoří duplicity. Potřebujete idempotentní zpracování konkrétní události, aniž by se ztratil skutečně nový požadavek stejné osoby.

Co zjistit před úpravami

Shromážděte anonymizované záznamy update_id, času doručení, HTTP odpovědi, výsledku zpracování a ID záznamu CRM. Popište trvalé úložiště a případnou frontu. Živé tokeny, kontakty zákazníků ani obsah jejich zpráv neposílejte. Jde o úkol v rámci Telegram botů a automatizace.

Šest kroků spolehlivého zpracování

1. Propojte doručení a výsledek

Uložte časovou stopu mezi update_id, odpovědí webhooku a vytvořenou CRM operací. Timeout sám o sobě neprokazuje, že zapisování selhalo; CRM už mohlo poptávku uložit a ztracena byla jen odpověď.

2. Rozlišujte opakování od nové události

Opakované doručení stejného update_id nemá vytvářet další poptávku. Nové update_id od stejného uživatele může být samostatná legitimní žádost. Deduplicita pouze podle user_id, telefonního čísla nebo chat_id by odstraňovala skutečné nové zprávy.

3. Zaveďte trvalý atomický klíč

Použijte transakci, unikátní databázový index nebo správně navrženou trvalou frontu. Pole zpracovaných ID uložené jen v paměti po restartu zmizí. Sekvence „ověřit a poté zapsat“ bez atomického zajištění selže, když dva workery provedou kontrolu současně.

4. Potvrzujte opakování bez vedlejší akce

Po příchodu již dokončeného update vracejte odpovídající potvrzení, ne další CRM záznam. Rozpracovaný stav potřebuje vlastní pravidla obnovy. Pokud se evidence události a vytváření poptávky nacházejí v různých systémech, počítejte s pádem mezi těmito kroky.

5. Propojte CRM s jednoznačným identifikátorem

Kde to CRM umožňuje, využijte externí ID nebo mechanismus idempotentního požadavku. Při chybě sítě nejprve ověřte stav předchozí operace, místo automatického vytvoření další.

6. Otestujte souběh i druhou legitimní akci

Stejné update otestujte dvakrát po sobě, současně i po restartu. Výsledkem je jediná poptávka. Následně pošlete dvě různá update od jednoho uživatele; pokud jde o dva samostatné požadavky, oba zůstanou. Vyvolejte také výpadek CRM po rezervaci klíče a prověřte obnovu.

Úprava endpointu či hostingu může vyžadovat samostatnou technickou podporu webu za potvrzených 30 €/hod při individuálně dohodnutém rozsahu, bez automatického SLA.

Proč prostý seznam ID nestačí

Častá chyba nastane mezi vytvořením CRM záznamu a odpovědí Telegramu. CRM-A už existuje, ale Telegram opakuje update 9001, protože odpověď zanikla při timeoutu. Seznam v paměti může opakování zadržet jen do restartu. Dotaz na existenci následovaný vložením bez transakce také nestačí: dva souběžné workery mohou oba vyhodnotit „neexistuje“.

Trvalá evidence propojuje identitu události, stav a obchodní výsledek. Atomický unikátní klíč chrání paralelní požadavky. Pokud externí CRM nepodporuje idempotency key, použijte stabilní externí referenci a postup dohledání. Není správné tvrdit, že jedna kontrola řetězce automaticky zajistí absolutní exactly-once přenos mezi různými systémy.

Při převzetí nejméně čtyřikrát simulujte situaci: dvě stejné události postupně, dvě současně, opakování po restartu a dva různé požadavky jedné osoby. Zkoušejte i selhání CRM mezi rezervací a uložením. Nedokončený záznam musí jít obnovit a nesmí být chybně označen jako úspěšný. Testovací chat a smyšlená jména stačí.

Šest modelových událostí

Identifikátory jsou smyšlené, nejde o skutečný incident.

  • 1. update_id 9001 založí CRM-A a uloží unikátní klíč.
  • 2. update 9001 se po timeoutu opakuje, CRM-A se nezdvojuje.
  • 3. update 9001 přijde souběžně a atomický klíč zabrání dalšímu vložení.
  • 4. Nové update_id 9002 představuje další požadavek a založí CRM-B.
  • 5. Opakování 9002 po výpadku odpovědi odkáže na existující CRM-B.
  • 6. Při nedostupném CRM zůstane událost ve frontě pro obnovu a není označena jako dokončená.

Rizika a kritéria převzetí

  • Paměťový seznam zpracovaných ID se po restartu ztratí.
  • update_id řeší opakované doručení, nikoli záměrně nový požadavek.
  • Úspěšné HTTP potvrzení webhooku není důkazem zápisu do CRM.
  • Exactly-once v distribuovaném systému nelze garantovat jednoduchou kontrolou textu.

Přejímka vyžaduje nulové duplicity pro stejné ID, zachování nových ID, atomickou ochranu souběhu, bezpečnou obnovu po výpadku a použitelné logy bez tajemství. Komerční nabídka Telegram automatizace uvádí obecné služby, nikoli pevnou cenu této integrace.

Stejný princip idempotence chrání také e-shop před opakovaným založením objednávek; související postup popisuje Integrace vytváří duplicitní objednávky: idempotentní klíč a bezpečné opakování. V tomto případě jej používáme pro aktualizace Telegramu a poptávky v CRM.

Co zaslat pro nacenění

Zašlete anonymizované logy duplicit, náčrt webhooku a název CRM, bez tokenů nebo klientských údajů. Oceníme atomickou deduplikaci, obnovu i testy. Požádejte o individuální posouzení.