Verify Call

Démarrage rapide Verify Call

Novauth appelle le téléphone de l'utilisateur une fois. Les 4 à 6 derniers chiffres du numéro entrant sont le code de vérification — aucune saisie requise sur Android, un simple coup d'œil sur iOS.

Tester sans vrais appels ? Utilisez le Mode bac à sable — aucun vrai appel passé, codes OTP prévisibles et aucune facturation.

Flux

Votre serveurPOST /call/flash avec le numéro de téléphone de l'utilisateur

NovauthAchemine un appel via l'opérateur vocal vers l'utilisateur

Téléphone de l'utilisateurSonne une fois — l'ID d'appelant affiche le numéro de vérification

Votre application mobileLit l'ID d'appelant automatiquement (Android) ou l'utilisateur le voit (iOS)

Votre serveurPOST /call/flash/webhook pour confirmer Success ou Failed

1Initier un flash call

Envoyez une requête POST avec le numéro de téléphone de l'utilisateur. Novauth achemine immédiatement un appel via l'opérateur vocal.

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 — Réponse

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)
}

2L'application mobile lit l'ID d'appelant

Cette étape est entièrement gérée sur le terminal client — aucun appel serveur requis.

Android : Utilisez PhoneStateListener ou la permission READ_CALL_LOG pour lire l'ID d'appelant entrant automatiquement — totalement sans friction. iOS : L'utilisateur voit brièvement le numéro entrant à l'écran et appuie sur Ignorer — toujours plus rapide que la saisie d'un code à 6 chiffres.

Les 4 à 6 derniers chiffres du champ caller de l'Étape 1 servent d'OTP. Comparez-les à ce que l'application mobile lit, puis signalez le résultat à l'Étape 3.

3Signaler le résultat de vérification

Après que votre application mobile détermine si les ID d'appelant correspondent, votre backend signale le résultat à Novauth. Cela clôt l'enregistrement d'appel et active les analyses.

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

4Récupérer le relevé détaillé d'appel (optionnel)

Récupérez le CDR complet pour le débogage, l'audit ou l'analyse de fraude. Retourne les horodatages, la durée et la disposition.

Le CDR n'est disponible qu'après la fin complète de l'appel. Si vous le récupérez immédiatement après l'initiation, la réponse sera null — attendez quelques secondes ou récupérez-le après réception du rappel webhook.

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"

Référence API

POST/call/flashInitier un flash call

POST/call/flash/webhookSignaler le résultat de vérification

GET/call/flash/{uuid}/cdrObtenir le relevé détaillé d'appel

POST/call/flash/cdrLister tous les CDR (paginé)

DELETE/call/flash/{uuid}Raccrocher / annuler un appel en cours

Annuler un appel en cours

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"

Valeurs de statut webhook

SuccessID d'appelant vérifié — utilisateur authentifié

FailedAppel échoué, coupé ou rejeté par l'utilisateur

IncompleteAppel démarré mais résultat indéterminé

WrongNumberL'utilisateur signale que le numéro entrant était inattendu