भाषा चुनें

वेबहुक

एक्टिवेशन की घटनाएँ रियल टाइम में अपने सर्वर पर पाएँ, SmsGrab-Signature हेडर की जाँच करें, और दोबारा कोशिशों, टेस्ट डिलीवरी और अपने आप बंद होने को समझें।

इस पेज पर
  1. घटनाएँ
  2. वेबहुक बनाएँ
  3. डिलीवरी कैसी दिखती है
  4. सिग्नेचर की जाँच करें
  5. जल्दी जवाब दें
  6. दोबारा कोशिशें
  7. अपने आप बंद होना
  8. टेस्ट और दोबारा डिलीवरी

वेबहुक घटनाओं को होते ही आपके सर्वर पर भेजते हैं, इसलिए आपको बार-बार पूछना नहीं पड़ता। हर वेबहुक एक 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 कुंजी की तरह यह भी सिर्फ़ एक बार दिखता है। आप इसे बाद में बदल सकते हैं, जिसके लिए भी पासवर्ड चाहिए।

डिलीवरी कैसी दिखती है

HTTP
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 सेकंड से ज़्यादा दूर हो, और सिग्नेचर की तुलना स्थिर समय में करें।

PHP
[$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);
Python
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", ""))
JavaScript
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 दिन तक रखती है, और आप उनमें से कोई भी दोबारा भेज सकते हैं।

क्या यह लेख मददगार था?

अब भी मदद चाहिए?

हमें लिखें। हम हर संदेश का जवाब देते हैं, आमतौर पर कुछ घंटों में।

या ईमेल करें support@smsgrab.com