WhatsApp API

Avvio rapido WhatsApp

Consegna codici OTP tramite WhatsApp con crittografia end-to-end. Raggiungi oltre 2 Mld di utenti in mercati dove gli SMS hanno bassi tassi di consegna.

L'utente deve avere WhatsApp installato e il suo numero registrato. Il messaggio apparirà nella sua casella WhatsApp — non è richiesto alcun consenso per i messaggi OTP inviati tramite Novauth.

Test senza messaggi reali? Usa la Modalità Sandbox — nessun messaggio WhatsApp inviato, codici OTP prevedibili e nessuna fatturazione.

1Invia un messaggio OTP WhatsApp

Invia tramite POST il numero del destinatario e il codice OTP nel campo text. Novauth lo racchiude in un template di consegna brandizzato prima dell'invio — passa solo il codice numerico, non una frase completa.

POST/api/v1/connect-hub/whatsapp/otp

bash

curl -X POST https://api.novauth.com/api/v1/connect-hub/whatsapp/otp \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "to":   "+14155552671",
    "text": "482951"
  }'

200 OK — Risposta

json

{
  "uuid": "01JQHM3P7KXNV8W2QF5DG6TYAB",  // save for delivery tracking
  "to":   "14155552671"                     // no + prefix
}

2Controlla lo stato di consegna

Recupera il WDR (WhatsApp Delivery Report) per tracciare il progresso del messaggio attraverso la rete WhatsApp: sent → delivered → read.

GET/api/v1/connect-hub/whatsapp/{uuid}/wdr

bash

curl https://api.novauth.com/api/v1/connect-hub/whatsapp/01JQHM.../wdr \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID"

3Segnala l'esito della verifica

Dopo che l'utente ha inviato il codice mostrato nel suo WhatsApp, invia tramite POST il risultato per chiudere il record del messaggio e registrare l'esito.

POST/api/v1/connect-hub/whatsapp/webhook

bash

# Report verification outcome after the user submits the code
curl -X POST https://api.novauth.com/api/v1/connect-hub/whatsapp/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"
  }'

Riferimento API

POST/whatsapp/otpInvia messaggio OTP WhatsApp

GET/whatsapp/{uuid}/wdrOttieni il rapporto di consegna WhatsApp

POST/whatsapp/webhookSegnala l'esito della verifica

POST/whatsapp/wdrElenca tutti i record WA (paginato)

Corpo della richiesta — POST /whatsapp/otp

tostringrequiredTelefono del destinatario in formato E.164

textstringrequiredCodice OTP da recapitare (es. 482951). Novauth lo racchiude in un template di messaggio brandizzato.