Przegląd Verify

Bird Verify potwierdza, że użytkownik kontroluje adres e-mail lub numer telefonu. Poproś Bird o wysłanie jednorazowego kodu weryfikacyjnego, odbierz go w swojej aplikacji i zapytaj Bird, czy się zgadza. Przepływ wymaga dwóch wywołań API: POST /v1/verify/verifications wysyła kod, a POST /v1/verify/verifications/check go sprawdza. Współdzieleni nadawcy Bird nie wymagają rejestracji nadawcy ani konfiguracji szablonu. E-mail, SMS i WhatsApp mogą domyślnie korzystać z Bird Verify, Authifly lub nadawcy należącego do Twojego obszaru roboczego; Telegram używa własnego zweryfikowanego konta powiadomień. Wybór opisuje sekcja Nadawcy i branding.

Tworzysz weryfikację z odbiorcą: adresem e-mail, numerem telefonu lub oboma. Bird generuje numeryczny kod weryfikacyjny i dostarcza go kanałami odbiorcy. Adres e-mail otrzymuje kod przez e-mail; numer telefonu otrzymuje go przez SMS lub WhatsApp, w kolejności i dostępności ustawionej przez konfigurację krajów dla kraju docelowego. Użytkownik wpisuje kod w Twojej aplikacji, a Ty przesyłasz go do endpointu sprawdzającego, który odpowiada success: true lub false z podaniem przyczyny.

Weryfikacja przechodzi przez krótki cykl życia: zaczyna się jako pending i kończy jako verified (poprawny kod dotarł na czas), failed (zbyt wiele błędnych prób) lub expired (okno czasowe upłynęło). Strona Weryfikacje pokazuje każdą weryfikację i jej stan; każdy stan i przyczyna są opisane w Wysyłanie weryfikacji.

W dashboardzie Verify jest jedną z aplikacji obszaru roboczego. Jej strony i miejsce, w którym znajduje się przewodnik do każdej z nich:

Strona Weryfikacje wyświetla każdą weryfikację w obszarze roboczym i otwiera szczegóły odbiorcy, planu kanałów i czasu. Programowo odpowiedź sprawdzająca zawiera bieżący stan weryfikacji. Subskrybuj zdarzenia Verify, aby otrzymywać powiadomienia o utworzeniu, dostarczeniu i pomyślnej weryfikacji. Endpointy listowania i odczytu są dostępne w dashboardzie, ale nie w publicznym API.

Verify dostarcza kody czterema kanałami. Który z nich otrzyma odbiorca, zależy od typu odbiorcy, a w przypadku numerów telefonów od konfiguracji krajów.

Dla odbiorcy telefonicznego najpierw próbowany jest WhatsApp, a SMS działa jako fallback w większości krajów, choć w niektórych domyślnie pierwszy jest SMS. Telegram znajduje się po SMS i przed e-mailem w kolejności fallbacku platformy. Możesz zmienić kolejność lub wyłączyć kanał per kraj. Jeśli wysyłka się nie powiedzie, dostarczanie przechodzi do następnego kanału w planie. Możesz też przejść dalej, gdy użytkownik zgłosi, że kod nie dotarł; zobacz Wyślij kod innym kanałem. Nadawcy i branding pokazuje każdą wiadomość i dostępne ustawienia nadawcy.

Obszar roboczy zaczyna z domyślnymi wartościami platformy Bird dotyczącymi samego kodu (długość, czas życia), limitu prób sprawdzenia i okresu oczekiwania na ponowne wysłanie. Każdą z nich możesz dostosować w dashboardzie w sekcji Konfiguracja, a długość kodu także per żądanie; wartości i zakresy znajdują się w Ustawienia weryfikacji. Ponad nimi działają zabezpieczenia przed nadużyciami, których nie konfigurujesz: limity wysyłek i sprawdzeń per odbiorca, wymienione w Zabezpieczenia przed nadużyciami. Sama wiadomość z kodem domyślnie ma język numeru telefonu odbiorcy, jeden z 40 wbudowanych tłumaczeń, a options.language nadpisuje go per żądanie. Zobacz Język wiadomości.