Help Center Połączenie błyskawiczne

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

ParametrWpiszWymaganeOpis
odciągTakTwój identyfikator nadawcy
dociągTakNumer telefonu odbiorcy (E.164)
typciągTakUstaw na "flashcall"
Identyfikator dzwoniącegociągTakNumer telefonu, z którego będziemy dzwonić do użytkownika
ttlliczba całkowitaNieCzas ż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

PoleWpiszOpis
Identyfikator wiadomościciągUnikalny identyfikator weryfikacyjny
stanciągStatus: „zaakceptowany”, „odrzucony”
Identyfikator dzwoniącegociągPełny numer identyfikacyjny rozmówcy
wzórciągWzór do dopasowania (cyfry + gwiazdki)
dociągNumer telefonu odbiorcy
ttlliczba całkowitaOkres 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