API de WhatsApp

Inicio rápido de WhatsApp

Entrega códigos OTP por WhatsApp con cifrado de extremo a extremo. Llega a más de 2000 M de usuarios en mercados donde el SMS tiene bajas tasas de entrega.

El usuario debe tener WhatsApp instalado y su número registrado. El mensaje aparecerá en su bandeja de entrada de WhatsApp: no se requiere opt-in para los mensajes OTP enviados a través de Novauth.

¿Deseas probar sin mensajes reales? Usa el Modo Sandbox: sin mensajes de WhatsApp enviados, códigos OTP predecibles y sin facturación.

1Enviar un mensaje OTP de WhatsApp

Envía mediante POST el número del destinatario y el código OTP en el campo text. Novauth lo envuelve en una plantilla de entrega con marca antes de enviarlo: pasa solo el código numérico, no una oración 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 — Respuesta

json

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

2Comprobar estado de entrega

Obtén el WDR (informe de entrega de WhatsApp) para rastrear el progreso del mensaje a través de la red de 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"

3Reportar el resultado de la verificación

Después de que el usuario envíe el código mostrado en su WhatsApp, realiza un POST del resultado para cerrar el registro del mensaje y registrar el resultado.

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

Referencia de API

POST/whatsapp/otpEnviar mensaje OTP de WhatsApp

GET/whatsapp/{uuid}/wdrObtener informe de entrega de WhatsApp

POST/whatsapp/webhookReportar resultado de verificación

POST/whatsapp/wdrListar todos los registros de WA (paginado)

Cuerpo de la solicitud — POST /whatsapp/otp

tostringrequiredTeléfono del destinatario en formato E.164

textstringrequiredCódigo OTP a entregar (p. ej. 482951). Novauth lo envuelve en una plantilla de mensaje con marca.