SMS को webhook API एंडपॉइंट पर कैसे फॉरवर्ड करें?

त्वरित उत्तर: Forward SMS आपके टेक्स्ट मैसेज को JSON webhook के रूप में किसी भी HTTP एंडपॉइंट पर भेज सकता है। ऐप में Webhook डेस्टिनेशन बनाएं, अपना एंडपॉइंट URL दर्ज करें, और Shortcuts ऑटोमेशन सेट करें। आपका एंडपॉइंट मैसेज कंटेंट, सेंडर और टाइमस्टैम्प के साथ POST रिक्वेस्ट प्राप्त करेगा।

Webhook SMS फॉरवर्डिंग क्या है?

Webhook SMS फॉरवर्डिंग आपके टेक्स्ट मैसेज को स्वचालित रूप से किसी भी HTTP एंडपॉइंट पर भेजती है जिसे आप नियंत्रित करते हैं। प्लेटफॉर्म-विशिष्ट इंटीग्रेशन (Slack, Discord, Teams) के विपरीत, webhooks आपको मैसेज प्रोसेस करने के तरीके पर पूर्ण नियंत्रण देते हैं। यह कस्टम इंटीग्रेशन, लॉगिंग सिस्टम, या ऑटोमेशन वर्कफ्लो बनाने वाले डेवलपर्स के लिए आदर्श है।

जब कोई मैसेज आता है, Forward SMS आपके एंडपॉइंट पर मैसेज कंटेंट, सेंडर जानकारी और मेटाडेटा युक्त स्ट्रक्चर्ड JSON पेलोड के साथ POST रिक्वेस्ट भेजता है।

Webhooks का उपयोग क्यों करें

Webhooks वह लचीलापन प्रदान करते हैं जो पहले से बने इंटीग्रेशन नहीं दे सकते:

कस्टम ऑटोमेशन: SMS प्राप्त होने पर कोई भी वर्कफ्लो ट्रिगर करें - डेटाबेस अपडेट करें, नोटिफिकेशन भेजें, स्क्रिप्ट चलाएं, या किसी भी सर्विस के साथ इंटीग्रेट करें
डेटा लॉगिंग: अनुपालन, एनालिटिक्स, या बैकअप उद्देश्यों के लिए सभी इनकमिंग मैसेज को अपने डेटाबेस में स्टोर करें
मल्टी-सर्विस राउटिंग: कंटेंट या सेंडर के आधार पर मैसेज को अलग-अलग डेस्टिनेशन पर रूट करने के लिए अपने लॉजिक से प्रोसेस करें
इंटरनल टूल्स: अपने इंटरनल डैशबोर्ड और टूल्स में SMS-पावर्ड फीचर्स बनाएं
IoT इंटीग्रेशन: SMS अलर्ट को अपने IoT सिस्टम, होम ऑटोमेशन, या मॉनिटरिंग इंफ्रास्ट्रक्चर से कनेक्ट करें

Webhook पेलोड फॉर्मेट

जब कोई मैसेज फॉरवर्ड किया जाता है, आपका एंडपॉइंट निम्नलिखित JSON पेलोड के साथ POST रिक्वेस्ट प्राप्त करता है:

{
  "timestamp": "2025-01-31T14:30:00Z",
  "content": "Your verification code is 123456",
  "sender": "+1234567890",
  "contact": "Bank of Example"
}

पेलोड फ़ील्ड्स

| फ़ील्ड | टाइप | विवरण | |-------|------|-------------| | timestamp | string | मैसेज फॉरवर्ड होने का ISO 8601 फॉर्मेटेड टाइमस्टैम्प | | content | string | टेक्स्ट मैसेज कंटेंट | | sender | string | सेंडर का फोन नंबर (यदि उपलब्ध हो) | | contact | string | आपकी एड्रेस बुक से कॉन्टैक्ट नाम (यदि मैच हो) |

Webhook फॉरवर्डिंग सेट करना

स्टेप 1: Forward SMS डाउनलोड करें

App Store से Forward SMS डाउनलोड करें।

स्टेप 2: Webhook डेस्टिनेशन बनाएं

ऐप खोलें, "Add Destination" पर टैप करें, और "Webhook" सेलेक्ट करें। अपना एंडपॉइंट URL दर्ज करें। सुरक्षा के लिए URL HTTPS होना चाहिए।

स्टेप 3: अपना एंडपॉइंट टेस्ट करें

यह सत्यापित करने के लिए "Send test message" बटन का उपयोग करें कि आपका एंडपॉइंट webhook सही ढंग से प्राप्त करता है। पेलोड आने की पुष्टि के लिए अपने सर्वर लॉग्स चेक करें।

स्टेप 4: Shortcuts ऑटोमेशन सेट करें

मैसेज फॉरवर्डिंग ट्रिगर करने वाला ऑटोमेशन बनाने के लिए हमारी Shortcuts सेटअप गाइड फॉलो करें।

इम्प्लीमेंटेशन उदाहरण

विभिन्न भाषाओं में webhook हैंडल करने के उदाहरण यहां हैं:

Node.js (Express)

const express = require('express');
const app = express();

app.use(express.json());

app.post('/webhook/sms', (req, res) => {
  const { timestamp, content, sender, contact } = req.body;

  console.log(`Received SMS from ${sender}: ${content}`);

  // Process the message (save to database, trigger automation, etc.)

  res.status(200).json({ received: true });
});

app.listen(3000);

Python (Flask)

from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route('/webhook/sms', methods=['POST'])
def handle_sms():
    data = request.json

    sender = data['sender']
    content = data['content']

    print(f"Received SMS from {sender}: {content}")

    # Process the message

    return jsonify({'received': True}), 200

if __name__ == '__main__':
    app.run(port=3000)

PHP

<?php
$payload = json_decode(file_get_contents('php://input'), true);

$sender = $payload['sender'];
$content = $payload['content'];
$timestamp = $payload['timestamp'];

error_log("Received SMS from $sender: $content");

// Process the message

http_response_code(200);
echo json_encode(['received' => true]);
?>

Ruby (Sinatra)

require 'sinatra'
require 'json'

post '/webhook/sms' do
  payload = JSON.parse(request.body.read)

  sender = payload['sender']
  content = payload['content']

  puts "Received SMS from #{sender}: #{content}"

  # Process the message

  content_type :json
  { received: true }.to_json
end

सुरक्षा संबंधी विचार

HTTPS का उपयोग करें

webhook पेलोड को ट्रांजिट में एन्क्रिप्ट करने के लिए हमेशा HTTPS एंडपॉइंट का उपयोग करें। Forward SMS को webhook URLs के लिए HTTPS की आवश्यकता होती है।

एरर्स को सुचारू रूप से हैंडल करें

आपके एंडपॉइंट को रिसीप्ट स्वीकार करने के लिए 2xx स्टेटस कोड रिटर्न करना चाहिए। यदि Forward SMS को एरर रिस्पॉन्स मिलता है, तो यह फेलियर लॉग करेगा।

ट्रबलशूटिंग

Webhook मैसेज प्राप्त नहीं कर रहा

URL चेक करें: सुनिश्चित करें कि आपका एंडपॉइंट URL सही है और इंटरनेट से एक्सेसिबल है
HTTPS वेरिफाई करें: URL को HTTP नहीं, HTTPS का उपयोग करना चाहिए
फायरवॉल रूल्स चेक करें: आपके सर्वर को इनकमिंग POST रिक्वेस्ट स्वीकार करनी चाहिए
एंडपॉइंट टेस्ट करें: कनेक्टिविटी वेरिफाई करने के लिए ऐप में टेस्ट बटन का उपयोग करें

मैसेज धीरे आ रहे हैं

Shortcuts ऑटोमेशन चेक करें: सुनिश्चित करें कि ऑटोमेशन कन्फर्मेशन की आवश्यकता के बिना चलता है
बैकग्राउंड ऐप रिफ्रेश: iOS सेटिंग्स में Forward SMS के लिए इसे इनेबल करें
नेटवर्क समस्याएं: आपके iPhone और सर्वर दोनों को स्थिर इंटरनेट कनेक्शन की आवश्यकता है

पेलोड पार्स नहीं हो रहा

Content-Type: रिक्वेस्ट Content-Type: application/json का उपयोग करती है
JSON पार्सिंग: सुनिश्चित करें कि आपका सर्वर JSON बॉडी को सही ढंग से पार्स करता है
कैरेक्टर एन्कोडिंग: मैसेज UTF-8 एन्कोडेड हैं

FAQ

क्या मैं मल्टीपल webhook एंडपॉइंट पर फॉरवर्ड कर सकता हूं?

हां, Forward SMS में मल्टीपल Webhook डेस्टिनेशन बनाएं। प्रत्येक डेस्टिनेशन का अलग एंडपॉइंट URL हो सकता है, और सभी फॉरवर्ड किए गए मैसेज प्राप्त करेंगे।

अगर मेरा एंडपॉइंट डाउन है तो क्या होगा?

यदि आपका एंडपॉइंट एरर रिटर्न करता है या पहुंच योग्य नहीं है, तो मैसेज फॉरवर्डिंग फेल हो जाएगी। ऐप डिबगिंग के लिए इन फेलियर्स को लॉग करता है। फॉलबैक या मॉनिटरिंग सिस्टम इम्प्लीमेंट करने पर विचार करें।

क्या webhooks पर रेट लिमिट है?

Forward SMS से कोई आर्टिफिशियल रेट लिमिट नहीं है। मैसेज उतनी तेजी से फॉरवर्ड होते हैं जितनी तेजी से वे आते हैं और आपका एंडपॉइंट उन्हें प्रोसेस कर सकता है।

क्या मैं फ़िल्टर कर सकता हूं कि कौन से मैसेज फॉरवर्ड किए जाएं?

वर्तमान में, Shortcuts ऑटोमेशन ट्रिगर करने वाले सभी मैसेज फॉरवर्ड किए जाते हैं। अनचाहे मैसेज को इग्नोर करने के लिए आप अपने webhook एंडपॉइंट में फ़िल्टरिंग लॉजिक इम्प्लीमेंट कर सकते हैं।

क्या मैं HTTPS के बजाय HTTP का उपयोग कर सकता हूं?

नहीं, सुरक्षा कारणों से Forward SMS को HTTPS एंडपॉइंट की आवश्यकता होती है। यह सुनिश्चित करता है कि आपका मैसेज डेटा ट्रांजिट में एन्क्रिप्टेड है।