Najpierw zamapuj proces
Opisz źródło leada, wymagane pola, system rekordów, właściciela i następną akcję. Jeśli nowy lead powinien utworzyć zadanie lub wysłać powiadomienie w Telegramie, należy to do tego samego przepływu pracy.
Rozdziel dane wprowadzane przez odwiedzającego, dodawane przez witrynę i obliczane przez CRM. Zapobiega to nadpisaniu jednego pola przez dwa systemy różnymi znaczeniami.
Pola, wartości UTM i zgoda
Nazwy i typy pól powinny być zgodne z umową API. Telefon, e-mail, źródło, kampania i strona, z której wysłano zapytanie wymagają uzgodnionych formatów.
Przesyłaj tylko niezbędne dane osobowe i zapisuj zgodę, jeśli jest to wymagane. Sekrety API pozostają na serwerze, a nie w pakiecie JavaScript.
- Własny identyfikator leada ułatwiający śledzenie.
- Adres URL i strona odsyłająca jako kontekst.
- Wartości UTM bez zastępowania zapisanych danych pustymi wartościami.
- Czas i strefa czasowa w zdefiniowanym formacie.
Deduplikacja i idempotencja
Odwiedzający może kliknąć dwukrotnie, przeglądarka może ponowić próbę, a webhook może ponownie dostarczyć to samo zdarzenie. Bez idempotencji pojawiają się zduplikowane leady i zadania.
Zduplikowana reguła zależy od branży: e-mail, telefon, identyfikator zamówienia lub dedykowany identyfikator leada. Nie łącz różnych osób tylko dlatego, że mają ten sam adres firmy.
| Zdarzenie | Zabezpieczenie |
|---|---|
| Ponowne przesłanie | Blokada przycisku i identyfikator żądania |
| Limit czasu po utworzeniu | Sprawdź identyfikator przed ponowną próbą |
| Webhook się powtarza | Klucz idempotencji |
| Ten sam kontakt powraca | Nowa aktywność zgodnie z regułami biznesowymi |
Co jeśli CRM jest niedostępny
Frontend nie powinien zgłaszać powodzenia przed potwierdzeniem przechowywania lub bezpieczną kolejką. Tymczasowe awarie wymagają ograniczonej liczby ponownych prób i dziennika umożliwiającego ręczne odzyskiwanie.
Pomocne może być awaryjne powiadomienie w Telegramie lub wiadomość e-mail, ale nie może ona ujawniać tajemnic ani niepotrzebnych danych. Odbiorca powinien wiedzieć, że lead nie znajduje się jeszcze w CRM.
- Zapisz identyfikator i status bezpiecznego żądania.
- Ponów próbę tylko w przypadku spodziewanych tymczasowych błędów.
- Powiadom osobę odpowiedzialną o trwałej awarii.
- Po przywróceniu działania porównaj logi z rekordami w CRM.
Jak przetestować integrację
Przetestuj poprawny lead, brakujące pola, nieprawidłowe formaty, podwójne wysłanie formularza, awarię CRM i opóźnioną odpowiedź. Sprawdź oddzielnie wartości UTM, źródło, właściciela i powiadomienie menedżera.
Po wdrożeniu przeprowadź oznaczony test produkcyjny i usuń go w ramach uzgodnionego procesu.
Często zadawane pytania
Czy przeglądarka może wysłać formularz bezpośrednio do CRM?
Zwykle nie jest to bezpieczne, ponieważ ujawnia sekret API. Użyj endpointu po stronie serwera lub oficjalnej integracji.
Czy Telegram jest potrzebny, gdy istnieje CRM?
Niekoniecznie. Przydaje się do szybkich powiadomień, natomiast CRM pozostaje systemem ewidencji.
Jak można wykryć utratę leadów?
Uzgodnij identyfikatory żądań serwera z rekordami CRM i scenariuszami błędów testowych, a nie tylko pomyślnymi zgłoszeniami.