Verify Call

Verify Call brzi početak

Novauth jednom pozove telefon korisnika. Poslednjih 4–6 cifara dolaznog broja je verifikacioni kod — bez kucanja na Android-u, jedan pogled na iOS-u.

Testirate bez pravih poziva? Koristite Sandbox režim — bez pravih poziva, uz predvidljive OTP kodove i bez naplate.

Tok

Vaš serverPOST /call/flash sa telefonskim brojem korisnika

NovauthRutira poziv preko glasovnog operatera do korisnika

Telefon korisnikaZazvoni jednom — ID pozivaoca prikazuje verifikacioni broj

Vaša mobilna aplikacijaČita ID pozivaoca automatski (Android) ili ga korisnik vidi (iOS)

Vaš serverPOST /call/flash/webhook za potvrdu Success ili Failed

1Pokrenite flash poziv

Pošaljite POST zahtev sa telefonskim brojem korisnika. Novauth odmah rutira poziv preko glasovnog operatera.

POST/api/v1/connect-hub/call/flash

bash

curl -X POST https://api.novauth.com/api/v1/connect-hub/call/flash \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "callee": "+14155552671",
    "max_ring_time": 20
  }'

200 OK — Odgovor

json

{
  "uuid":   "01JQHM3P7KXNV8W2QF5DG6TYAB",   // save this — used for status reporting
  "caller": "12025550188",                      // number that will ring the user (no + prefix)
  "callee": "14155552671"                       // your user's number (no + prefix)
}

2Mobilna aplikacija čita ID pozivaoca

Ovaj korak se u potpunosti obavlja na klijentskom uređaju — nije potreban nijedan poziv ka serveru.

Android: Koristite PhoneStateListener ili dozvolu READ_CALL_LOG da automatski pročitate dolazni ID pozivaoca — potpuno bez trenja. iOS: Korisnik nakratko vidi dolazni broj na ekranu i dodirne Ignoriši — i dalje brže od kucanja šestocifrenog koda.

Poslednjih 4–6 cifara polja caller iz koraka 1 služi kao OTP. Uporedite ih sa onim što mobilna aplikacija pročita, a zatim prijavite rezultat u koraku 3.

3Prijavite rezultat verifikacije

Nakon što vaša mobilna aplikacija utvrdi da li su se ID-jevi pozivaoca poklopili, vaš backend prijavljuje ishod nazad Novauth-u. Time se zatvara zapis poziva i omogućava analitika.

POST/api/v1/connect-hub/call/flash/webhook

bash

# After your mobile app reads the caller ID, report the result:
curl -X POST https://api.novauth.com/api/v1/connect-hub/call/flash/webhook \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "uuid": "01JQHM...",
    "status": "Success"
  }'

# status options:
#   "Success"     — user verified (caller ID matched)
#   "Failed"      — call failed or user rejected
#   "Incomplete"  — call started but not resolved
#   "WrongNumber" — user reports wrong number received

4Preuzmite detaljni zapis poziva (opciono)

Povucite kompletan CDR za otklanjanje grešaka, reviziju ili analizu prevara. Vraća vremenske oznake, trajanje i ishod.

CDR je dostupan tek nakon što se poziv u potpunosti završi. Ako ga zatražite odmah nakon pokretanja, odgovor će biti null — sačekajte nekoliko sekundi ili ga preuzmite nakon prijema webhook callback-a.

GET/api/v1/connect-hub/call/flash/{uuid}/cdr

bash

# Get full call detail record
curl https://api.novauth.com/api/v1/connect-hub/call/flash/01JQHM.../cdr \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID"

API referenca

POST/call/flashPokrenite flash poziv

POST/call/flash/webhookPrijavite ishod verifikacije

GET/call/flash/{uuid}/cdrPreuzmite detaljni zapis poziva

POST/call/flash/cdrIzlistajte sve CDR-ove (paginirano)

DELETE/call/flash/{uuid}Prekinite / otkažite poziv koji zvoni

Otkažite poziv koji zvoni

bash

# Cancel a ringing call before it's answered
curl -X DELETE https://api.novauth.com/api/v1/connect-hub/call/flash/01JQHM... \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID"

Vrednosti statusa webhook-a

SuccessID pozivaoca verifikovan — korisnik je autentifikovan

FailedPoziv nije uspeo, prekinut je ili ga je korisnik odbio

IncompletePoziv je pokrenut, ali ishod nije utvrđen

WrongNumberKorisnik prijavljuje da je dolazni broj bio neočekivan