Webhooks

Veb Qarmaqlar

Mesaj və OTP hadisələrini real vaxtda backend-inizə göndərin.

İş prinsipi

WhatsOTP hər mühüm hadisə baş verdikdə (mesaj göndərildi, çatdırıldı, OTP doğrulandı və s.) sizin təyin etdiyiniz URL-ə HTTP POST sorğusu göndərir.

Backend-iniz bu JSON məlumatını qəbul edib, öz sisteminizdə sifariş / müştəri / bildiriş statusunu yeniləyə bilər.

Dəstəklənən hadisələr

`message.sent` mesaj WhatsApp API-a göndərildi
`message.delivered` mesaj istifadəçinin cihazına çatdırıldı
`message.failed` mesaj göndərilməsi alınmadı
`otp.verified` OTP uğurla doğrulandı
`otp.failed` OTP doğrulama zamanı xəta

Payload nümunəsi və imza

Aşağıda `otp.verified` hadisəsi üçün nümunə webhook payload göstərilib.

POST https://your-backend.com/webhooks/whatsotp

Headers:
  X-WhatsOTP-Signature: sha256=...

Body:
{
  "event": "otp.verified",
  "data": {
    "phone": "+994501234567",
    "request_id": "req_otp_123456",
    "verified_at": "2025-11-12T18:45:00Z",
    "metadata": {
      "user_id": "123",
      "ip": "127.0.0.1"
    }
  }
}

Təhlükəsizlik üçün `X-WhatsOTP-Signature` header-i vasitəsilə imza göndərilir. Backend tərəfdə gizli açarınızla bu imzanı yoxlayın və yalnız doğrulandıqdan sonra məlumatı qəbul edin.