Przejdź do treści

Połączenie błyskawiczne

Flash Call to metoda weryfikacji telefonu, która wykorzystuje nieodebrane połączenie zamiast SMS-a do weryfikacji numerów telefonów. Jest to szybsze, bezpieczniejsze i tańsze rozwiązanie.

Przegląd

Weryfikacja połączenia Flash działa poprzez:

  1. Użytkownik prosi o weryfikację
  2. System inicjuje połączenie na telefon użytkownika
  3. Połączenie zostaje automatycznie zakończone po 1-2 dzwonkach
  4. Aplikacja użytkownika rejestruje identyfikator dzwoniącego
  5. Identyfikator dzwoniącego jest weryfikowany zgodnie z oczekiwanym wzorcem
  6. Użytkownik zostaje uwierzytelniony

Korzyści

Opłacalne

  • Do 10x taniej niż SMS
  • Brak opłat za dostarczenie wiadomości
  • Obniżone koszty weryfikacji masowej

Szybciej

  • Natychmiastowa weryfikacja (1-3 sekundy)
  • Nie trzeba czekać na dostarczenie wiadomości SMS
  • Lepsze doświadczenie użytkownika

Bardziej bezpieczne

  • Trudniejsze do przechwycenia niż SMS
  • W powiadomieniach nie widać hasła jednorazowego
  • Odporność na ataki typu SIM Swap

Globalny zasięg

  • Działa w krajach, w których obowiązują ograniczenia dotyczące SMS-ów
  • Brak problemów z filtrowaniem SMS-ów
  • Uniwersalna kompatybilność z telefonem

Podstawowe połączenie błyskawiczne

Żądanie

KOD_BLOKU_0

Parametry

Parametr Wpisz Wymagane Opis
od ciąg Tak Twój identyfikator nadawcy
do ciąg Tak Numer telefonu odbiorcy (E.164)
typ ciąg Tak Ustaw na "flashcall"
Identyfikator dzwoniącego ciąg Tak Numer telefonu, z którego będziemy dzwonić do użytkownika
ttl liczba całkowita Nie Czas życia w sekundach (domyślnie: 60)

Jak to działa

1. Użytkownik wprowadza numer telefonu

Użytkownik podaje swój numer telefonu w Twojej aplikacji:

KOD_BLOKU_1

2. Poproś o połączenie błyskawiczne

Twój serwer żąda weryfikacji połączenia flash:

KOD_BLOKU_2

3. Odpowiedź API

API zwraca oczekiwany wzorzec identyfikatora dzwoniącego:

KOD_BLOKU_3

4. Zainicjuj połączenie

System inicjuje połączenie na telefon użytkownika i kończy po 1-2 dzwonkach.

5. Przechwyć identyfikator dzwoniącego

Aplikacja użytkownika przechwytuje identyfikator rozmówcy przychodzącego połączenia:

KOD_BLOKU_4

6. Sprawdź wzór

Porównaj przechwycony identyfikator rozmówcy z oczekiwanym wzorcem:

KOD_BLOKU_5

Przykłady implementacji

Androida

KOD_BLOKU_6

iOS

KOD_BLOKU_7

Sieć (po stronie serwera)

KOD_BLOKU_8

Format odpowiedzi

Odpowiedź pomyślna

KOD_BLOKU_9

Pola odpowiedzi

Pole Wpisz Opis
Identyfikator wiadomości ciąg Unikalny identyfikator weryfikacyjny
stan ciąg Status: „zaakceptowany”, „odrzucony”
Identyfikator dzwoniącego ciąg Pełny numer identyfikacyjny rozmówcy
wzór ciąg Wzór do dopasowania (cyfry + gwiazdki)
do ciąg Numer telefonu odbiorcy
ttl liczba całkowita Okres ważności w sekundach

Dopasowanie wzorca

API zwraca wzór z gwiazdkami maskującymi niektóre cyfry:

KOD_BLOKU_10

Twoja aplikacja powinna:

  1. Przechwyć identyfikator rozmówcy przychodzącego
  2. Wyodrębnij cyfry z identyfikatora dzwoniącego
  3. Dopasuj do wzorca (gwiazdki = dowolna cyfra)
  4. Sprawdź dopasowanie w okresie TTL

Powrót do SMS-ów

Jeśli połączenie Flash nie powiedzie się, automatycznie powróć do wiadomości SMS:

KOD_BLOKU_11

Przypadki użycia

Rejestracja konta

Weryfikuj numery telefonów podczas rejestracji bez opłat za SMS-y.

Weryfikacja logowania

Uwierzytelnianie dwuskładnikowe za pomocą połączenia flash.

Aktualizacja numeru telefonu

Zweryfikuj nowy numer telefonu, gdy użytkownik zaktualizuje profil.

Potwierdzenie transakcji

Potwierdzaj transakcje o dużej wartości za pomocą połączenia błyskawicznego.

Najlepsze praktyki

TTL

  • ✅ Ustaw TTL na 60-90 sekund
  • ✅ Zezwalaj użytkownikowi na ponowną próbę po wygaśnięciu
  • ❌ Nie używaj TTL dłuższego niż 120 sekund

Doświadczenie użytkownika

  • Pokaż komunikat „Oczekiwanie na połączenie…”
  • Wyświetl licznik czasu (60 sekund)
  • Zapewnij opcję „Zamiast tego użyj SMS-a”
  • Automatyczne wykrywanie i weryfikowanie identyfikatora dzwoniącego

Obsługa błędów

  • Zajmij się brakującymi uprawnieniami telefonu
  • Limit czasu po wygaśnięciu TTL
  • Zapewnij opcję zastępczego SMS-a
  • Pokaż jasne komunikaty o błędach

Uprawnienia

Poproś o uprawnienia telefonu przed rozmową flashową:

Android: KOD_BLOKU_12

iOS: KOD_BLOKU_13

Testowanie

  • Testuj na różnych urządzeniach
  • Przetestuj z różnymi przewoźnikami
  • Scenariusze odmowy pozwolenia na testowanie
  • Przetestuj scenariusze przekroczenia limitu czasu sieci

Ograniczenia

Obsługa platformy

  • Działa na wszystkich urządzeniach mobilnych
  • Wymaga możliwości prowadzenia rozmów telefonicznych
  • Wymaga pozwolenia READ_PHONE_STATE
  • Może nie działać na tabletach bez telefonu

Sieć

  • Wymaga aktywnego połączenia telefonicznego
  • Może zawieść w złych warunkach sieciowych
  • Mogą obowiązywać ograniczenia przewoźnika
  • Stawki międzynarodowe mogą się różnić

Prywatność

  • Użytkownicy mogą blokować nieznane numery
  • Niektóre urządzenia mają blokowanie połączeń
  • Wymaga wyraźnych uprawnień
  • Weź pod uwagę obawy dotyczące prywatności użytkowników

Rozwiązywanie problemów

Połączenie nieodebrane

  • Sprawdź, czy telefon ma sygnał
  • Sprawdź format numeru (E.164)
  • Sprawdź ograniczenia przewoźnika
  • Spróbuj zastępczej wiadomości SMS

Wzór nie pasuje

  • Upewnij się, że przechwytujesz prawidłowy identyfikator dzwoniącego
  • Usuń znaki niecyfrowe
  • Sprawdź format wzoru
  • Sprawdź w okresie TTL

Odmowa pozwolenia

  • Zapytaj o uprawnienia prawidłowo
  • Wyjaśnij, dlaczego potrzebne są uprawnienia
  • Zapewnij alternatywę (SMS)
  • Postępuj elegancko

Następne kroki