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ń, a połączenie głosowe przychodzi z numeru Bird wybranego dla kraju docelowego. Wybór opisuje sekcja Nadawcy i branding.

Jak działa weryfikacja

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, WhatsApp, Telegram lub połączenie głosowe, 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 Verifications pokazuje każdą weryfikację i jej stan; każdy stan i przyczyna są opisane w Wysyłanie weryfikacji.

Aplikacja Verify w dashboardzie

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

Widoczność

Strona Verifications 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.

Kanały

Verify dostarcza kody pięcioma 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. Połączenia głosowe nie ma w kolejności fallbacku platformy, więc kraj używa go dopiero wtedy, gdy je tam włączysz, na przykład aby dotrzeć do użytkowników, którzy nie mogą odbierać wiadomości tekstowych. 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.

Wartości domyślne i limity

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 Configure, 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.

Następne kroki