वेबहुक
एक्टिवेशन की घटनाएँ रियल टाइम में अपने सर्वर पर पाएँ, SmsGrab-Signature हेडर की जाँच करें, और दोबारा कोशिशों, टेस्ट डिलीवरी और अपने आप बंद होने को समझें।
इस पेज पर
वेबहुक घटनाओं को होते ही आपके सर्वर पर भेजते हैं, इसलिए आपको बार-बार पूछना नहीं पड़ता। हर वेबहुक एक API कुंजी से जुड़ा होता है। यह उस कुंजी से खरीदे गए नंबरों की घटनाएँ, और आपके खाते के कम बैलेंस की चेतावनियाँ पाता है।
घटनाएँ
| घटना | कब |
|---|---|
activation.created |
नंबर खरीदा गया |
activation.code_received |
हर नया SMS, अब तक के सभी संदेशों के साथ |
activation.completed |
आपने पूरा किया, या कोड के बाद समय खत्म हुआ |
activation.cancelled |
कोड से पहले रद्द, पैसा वापस |
activation.expired |
समय पर कोड नहीं आया, पैसा वापस |
activation.refunded |
कटौती की कोई भी वापसी |
balance.low |
बैलेंस आपकी तय सीमा से नीचे चला गया |
webhook.test |
आपकी शुरू की गई टेस्ट डिलीवरी |
वेबहुक बनाएँ
खाता > डेवलपर में कोई कुंजी खोलें और URL, चाही गई घटनाओं और वैकल्पिक विवरण के साथ वेबहुक जोड़ें। हर कुंजी के 3 तक वेबहुक हो सकते हैं।
URL को:
https://से शुरू होना चाहिए;- IP पते के बजाय होस्ट नाम इस्तेमाल करना चाहिए;
- सार्वजनिक पते तक ले जाना चाहिए। निजी नेटवर्क, localhost और मिलती-जुलती रेंज ठुकराई जाती हैं।
आपको whsec_ से शुरू होने वाला साइनिंग सीक्रेट मिलता है। API कुंजी की तरह यह भी सिर्फ़ एक बार दिखता है। आप इसे बाद में बदल सकते हैं, जिसके लिए भी पासवर्ड चाहिए।
डिलीवरी कैसी दिखती है
POST /your/endpoint HTTP/1.1
Content-Type: application/json
User-Agent: SmsGrab-Webhooks/1.0
SmsGrab-Event: activation.code_received
SmsGrab-Delivery: 9f7d6c1e-2b44-4c1a-8f0e-6a3d2c1b0e9f
SmsGrab-Signature: t=1790503200,v1=3b9a0c…
{ "id": "evt_4e1f…", "type": "activation.code_received", "created_at": "2026-09-27T10:06:12.004Z",
"api_version": "2026-09-27", "data": { "activation": { "id": "5c1d0c2e-…", "status": "CODE_RECEIVED" } } }
सिग्नेचर की जाँच करें
SmsGrab-Signature में एक टाइमस्टैम्प t और v1 होता है, जो आपके सीक्रेट से बना t, एक बिंदु और अनुरोध की कच्ची बॉडी का HMAC-SHA256 है। उन डिलीवरी को ठुकराएँ जिनका टाइमस्टैम्प आपकी घड़ी से 300 सेकंड से ज़्यादा दूर हो, और सिग्नेचर की तुलना स्थिर समय में करें।
[$t, $v1] = (function (string $h): array {
parse_str(str_replace(',', '&', $h), $p);
return [(int) ($p['t'] ?? 0), (string) ($p['v1'] ?? '')];
})($_SERVER['HTTP_SMSGRAB_SIGNATURE'] ?? '');
$body = file_get_contents('php://input');
$expected = hash_hmac('sha256', $t.'.'.$body, getenv('SMSGRAB_WEBHOOK_SECRET'));
$ok = abs(time() - $t) <= 300 && hash_equals($expected, $v1);
import hmac, hashlib, time
def verify(header: str, body: bytes, secret: str) -> bool:
parts = dict(p.split("=", 1) for p in header.split(","))
t = int(parts.get("t", "0"))
expected = hmac.new(secret.encode(), f"{t}.".encode() + body, hashlib.sha256).hexdigest()
return abs(time.time() - t) <= 300 and hmac.compare_digest(expected, parts.get("v1", ""))
import crypto from 'node:crypto';
export function verify(header, rawBody, secret) {
const parts = Object.fromEntries(header.split(',').map((p) => p.split('=')));
const t = Number(parts.t ?? 0);
const expected = crypto.createHmac('sha256', secret).update(`${t}.`).update(rawBody).digest('hex');
const given = Buffer.from(parts.v1 ?? '', 'utf8');
return Math.abs(Date.now() / 1000 - t) <= 300 && given.length === expected.length
&& crypto.timingSafeEqual(Buffer.from(expected, 'utf8'), given);
}
JSON पार्स करने से पहले हमेशा कच्ची बॉडी को ठीक वैसे ही जाँचें जैसे वह मिली।
जल्दी जवाब दें
10 सेकंड के अंदर किसी भी 2xx स्थिति से जवाब दें और धीमा काम बाद में करें, जैसे किसी कतार में। रीडायरेक्ट का पालन नहीं किया जाता।
दोबारा कोशिशें
विफल डिलीवरी 1 मिनट, 5 मिनट, 15 मिनट, 1 घंटे, 3 घंटे, 6 घंटे, 12 घंटे और 24 घंटे बाद दोबारा की जाती है। दोबारा कोशिश में घटना का वही id होता है, इसलिए प्रोसेस किए गए आईडी याद रखें और दोहराव छोड़ दें। एक एक्टिवेशन की घटनाएँ क्रम से आती हैं।
अपने आप बंद होना
410 Goneका जवाब वेबहुक को तुरंत बंद कर देता है।- कम से कम 24 घंटों में लगातार 50 विफल कोशिशों के बाद वेबहुक बंद हो जाता है और आपको सूचना मिलती है। अपना endpoint ठीक करें, फिर वेबहुक दोबारा चालू करें।
- कुंजी रद्द करने से उसके वेबहुक बंद हो जाते हैं।
टेस्ट और दोबारा डिलीवरी
वेबहुक के पेज से webhook.test घटना भेजें ताकि तुरंत स्टेटस कोड, जवाब का समय और कोई भी त्रुटि दिख सके। डिलीवरी सूची हर डिलीवरी 30 दिन तक रखती है, और आप उनमें से कोई भी दोबारा भेज सकते हैं।
क्या यह लेख मददगार था?
धन्यवाद! खुशी है कि मदद मिली।