एक मैसेज का सफ़र
भेजने के बाद हर प्राप्तकर्ता queued होता है और चार्ज होता है, फिर कैरियर रूट को सौंपा जाता है (sent)। बाद में कैरियर बताता है कि फ़ोन को मैसेज मिला (delivered) या नहीं (failed)।
रिपोर्ट कब आती हैं
ज़्यादातर रिपोर्ट कुछ सेकंड से कुछ मिनट में आ जाती हैं। कुछ कैरियर देर से रिपोर्ट देते हैं या बिल्कुल नहीं देते; बिना रिपोर्ट वाला मैसेज sent में ही रहता है।
रिफंड
फेल हुए मैसेज का पैसा अपने आप आपके बैलेंस में वापस आता है। हर रिफंड आप अपनी बैलेंस हिस्ट्री में मैसेज id के साथ देख सकते हैं।
Webhook पाना
API key पेज पर एक https एड्रेस जोड़ें। जब कोई मैसेज डिलीवर होता है या फेल होता है, हम मैसेज id, नंबर, स्टेटस, कीमत और आपके ref के साथ एक JSON body POST करते हैं। किसी भी 2xx स्टेटस से जवाब दें; नहीं तो हम लगभग दो घंटे में 8 बार तक दोबारा कोशिश करते हैं।
सिग्नेचर जांचना
हर webhook में X-PortSMS-Signature: t=<time>,v1=<hex> होता है। अपने signing secret के साथ टेक्स्ट t.body का HMAC-SHA256 निकालें और उसकी तुलना v1 से करें। पांच मिनट से पुरानी रिक्वेस्ट अस्वीकार करें ताकि कोई पुरानी रिक्वेस्ट दोबारा न चलाई जा सके।
