WhatsApp API

WhatsApp brzi početak

Isporučujte OTP kodove preko WhatsApp-a sa end-to-end enkripcijom. Dosegnite više od 2 milijarde korisnika na tržištima gdje SMS ima niske stope isporuke.

Korisnik mora imati instaliran WhatsApp i registrovan broj. Poruka će se pojaviti u njegovom WhatsApp sandučetu — za OTP poruke poslate kroz Novauth nije potreban opt-in.

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

1Pošaljite WhatsApp OTP poruku

POST-ujte broj primaoca i OTP kod u polju text. Novauth ga prije slanja umotava u brendirani šablon isporuke — proslijedite samo numerički kod, ne cijelu rečenicu.

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 — Odgovor

json

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

2Provjerite status isporuke

Preuzmite WDR (izvještaj o isporuci WhatsApp-a) da pratite napredak poruke kroz WhatsApp mrežu: 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"

3Prijavite ishod verifikacije

Nakon što korisnik pošalje kod prikazan u njegovom WhatsApp-u, POST-ujte rezultat da zatvorite zapis poruke i zabilježite ishod.

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"
  }'

API referenca

POST/whatsapp/otpPošaljite WhatsApp OTP poruku

GET/whatsapp/{uuid}/wdrPreuzmite izvještaj o isporuci WhatsApp-a

POST/whatsapp/webhookPrijavite ishod verifikacije

POST/whatsapp/wdrIzlistajte sve WA zapise (paginirano)

Tijelo zahtjeva — POST /whatsapp/otp

tostringrequiredTelefon primaoca u E.164 formatu

textstringrequiredOTP kod za isporuku (npr. 482951). Novauth ga umotava u brendirani šablon poruke.