API WhatsApp

Démarrage rapide WhatsApp

Livrez des codes OTP via WhatsApp avec chiffrement de bout en bout. Atteignez plus de 2 Md d'utilisateurs dans les marchés où le SMS a de faibles taux de livraison.

L'utilisateur doit avoir WhatsApp installé et son numéro enregistré. Le message apparaîtra dans sa boîte de réception WhatsApp — aucun opt-in n'est requis pour les messages OTP envoyés via Novauth.

Tester sans vrais messages ? Utilisez le Mode bac à sable — aucun message WhatsApp envoyé, codes OTP prévisibles et aucune facturation.

1Envoyer un message OTP WhatsApp

Envoyez en POST le numéro du destinataire et le code OTP dans le champ text. Novauth l'enveloppe dans un modèle de livraison de marque avant l'envoi — transmettez uniquement le code numérique, pas une phrase complète.

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

json

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

2Vérifier le statut de livraison

Récupérez le WDR (WhatsApp Delivery Report) pour suivre la progression du message à travers le réseau 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"

3Signaler le résultat de vérification

Après que l'utilisateur a soumis le code affiché dans son WhatsApp, envoyez le résultat en POST pour clore l'enregistrement du message et consigner le résultat.

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

Référence API

POST/whatsapp/otpEnvoyer un message OTP WhatsApp

GET/whatsapp/{uuid}/wdrObtenir le rapport de livraison WhatsApp

POST/whatsapp/webhookSignaler le résultat de vérification

POST/whatsapp/wdrLister tous les enregistrements WA (paginé)

Corps de la requête — POST /whatsapp/otp

tostringrequiredTéléphone du destinataire au format E.164

textstringrequiredCode OTP à livrer (par ex. 482951). Novauth l'enveloppe dans un modèle de message de marque.