वेबहुक

वेबहुक क्यों

पोलिंग बर्बादी है: sub-second पोलिंग पर रेट सीमा है, बहु-सेकंड पोलिंग विलंब जोड़ती है। वेबहुक उस क्षण इवेंट पुश करते हैं जब वे होते हैं।

पंजीकरण

Account → Webhooks → New endpoint: HTTPS URL, इवेंट प्रकार, रिट्राय रणनीति (exponential / linear / none)। साइनिंग सीक्रेट एक बार दिखाया जाता है।

इवेंट

• activation.sms_received — इनबाउंड SMS किसी सक्रियण से मेल खाया
• activation.expired — विंडो कोड के बिना बंद हुई
• activation.finished — सक्रियण की पुष्टि की
• rent.sms_received — किराये पर इनबाउंड SMS
• wallet.credited / wallet.debited — धन की गति
• support.message.received — सहायता थ्रेड में एजेंट का उत्तर

Payload

{
  "event": "activation.sms_received",
  "delivery_id": "b7e2c1a0-9f3d-4c5e-8a1b-2d3e4f5a6b7c",
  "created_at": "2026-05-26T14:30:14Z",
  "data": { "order_id": "9a1f2c3d-4e5b-6a7c-8d9e-0f1a2b3c4d5e", "phone": "+380635551822", "code": "123456", "service": "telegram" }
}

हस्ताक्षर सत्यापन

हेडर: X-Eveses-Signature: sha256=<hmac> (timestamp in X-Eveses-Timestamp)। HMAC-SHA256 आपके सीक्रेट के साथ <ts>.<raw-body> पर।

$ts  = $_SERVER['HTTP_X_EVESES_TIMESTAMP'] ?? '';
$sig = $_SERVER['HTTP_X_EVESES_SIGNATURE'] ?? '';
$expected = 'sha256=' . hash_hmac('sha256', $ts . '.' . file_get_contents('php://input'), $secret);
if (!hash_equals($expected, $sig) || abs(time() - (int) $ts) > 300) { http_response_code(401); exit; }

5 मिनट से अधिक पुराने अनुरोधों को अस्वीकार करें (रीप्ले विंडो)।

रिट्राय

विफल डिलीवरी (non-2xx या 10s के भीतर कोई प्रतिक्रिया नहीं) रणनीति के अनुसार रिट्राय। Exponential: 30s, 2min, 10min, 1h, 6h, फिर dead। डैशबोर्ड से मैन्युअल रीप्ले।