Kategoria: Formularze i API

CRM tworzy dwa leady z jednego formularza — jak to naprawić?

Poradnik techniczny · Kacper Bernecki

Webhook może zostać dostarczony więcej niż raz. Także ponowienie po timeout może utworzyć drugi rekord, mimo że pierwsze żądanie zapisało dane. Obsługa powtórzeń powinna być częścią integracji.

Krok po kroku

1. Sprawdź identyfikator zdarzenia u dostawcy i liczbę żądań w logach. Ten sam adres e-mail nie zawsze oznacza ten sam lead; klient może pytać o dwie różne oferty.

2. Wybierz stabilny identyfikator źródła i dodaj ograniczenie unikalności w bazie, np. parę dostawca plus identyfikator formularza lub zdarzenia, zależnie od jego semantyki.

3. Sprawdzenie w kodzie „czy istnieje”, a potem osobny INSERT może przegrać przy dwóch równoległych żądaniach. Użyj transakcji lub zapisu opartego na ograniczeniu unikalności.

4. Powtórzone poprawne zdarzenie powinno dostać odpowiedź zgodną z protokołem dostawcy. Nie wykonuj drugi raz wysyłki powitania i przydziału zadania.

5. Przetestuj równoległe dostarczenie tego samego payloadu oraz dwa różne zdarzenia tej samej osoby. Logi powinny umożliwiać odnalezienie wyniku bez przechowywania zbędnych danych klientów.

Jak sprawdzić, czy poprawka działa

Powtórzenie testowego webhooka nie tworzy nowego leada ani dodatkowych powiadomień. Dwa rzeczywiście odrębne zapytania nadal muszą być obsłużone. Reguła łączenia kontaktów jest osobną decyzją biznesową.