सूचना चैनल

कस्टम वेबहुक सूचना सेटअप गाइड

12 Aug, 2025 15 मिनट का पठन

वेबहुक सूचनाएँ कैसे सेट करें

आपको क्या चाहिए: एक वेब सर्वर जो HTTPS POST अनुरोध प्राप्त करने में सक्षम हो और वेबहुक डेटा को संभालने के लिए बुनियादी प्रोग्रामिंग ज्ञान।

चरण 1: एक वेबहूक एंडपॉइंट बनाएँ

सबसे पहले, आपको अपने सर्वर पर एक एंडपॉइंट बनाना होगा जो वेबहूक सूचनाएं प्राप्त कर सके। विभिन्न प्रोग्रामिंग भाषाओं में उदाहरण इस प्रकार हैं:

<?php
// webhook.php
header('Content-Type: application/json');

// Get the webhook data
$input = file_get_contents('php://input');
$data = json_decode($input, true);

// Verify the webhook signature (recommended for security)
$secret = 'your-secret-token';
$signature = $_SERVER['HTTP_X_WEBHOOK_SIGNATURE'] ?? '';
$expectedSignature = 'sha256='.hash_hmac('sha256', $input, $secret);

if (!hash_equals($signature, $expectedSignature)) {
    http_response_code(401);
    exit('Unauthorized');
}

// Process the notification
if ($data['event'] === 'content_changed') {
    $taskName = $data['task']['name'];
    $url = $data['task']['url'];
    $changes = count($data['task_log']['changes']['changed'] ?? []);

    // Your custom logic here
    error_log("Content changed: {$taskName} - {$changes} changes detected");

    // Send to another service, database, etc.
    // ...
}

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

// webhook.js (Express.js)
const express = require('express');
const crypto = require('crypto');
const app = express();

app.use(express.json());

app.post('/webhook', (req, res) => {
    const secret = 'your-secret-token';
    const signature = req.headers['x-webhook-signature'];
    const expectedSignature = 'sha256=' + crypto
        .createHmac('sha256', secret)
        .update(JSON.stringify(req.body))
        .digest('hex');

    if (signature !== expectedSignature) {
        return res.status(401).send('Unauthorized');
    }

    const data = req.body;

    if (data.event === 'content_changed') {
        const taskName = data.task.name;
        const url = data.task.url;
        const changes = (data.task_log.changes.changed || []).length;

        console.log(`Content changed: ${taskName} - ${changes} changes detected`);

        // Your custom logic here
        // ...
    }

    res.json({ status: 'received' });
});

app.listen(3000, () => {
    console.log('Webhook server listening on port 3000');
});

# webhook.py (Flask)
from flask import Flask, request, jsonify
import hashlib
import hmac
import json

app = Flask(__name__)

@app.route('/webhook', methods=['POST'])
def webhook():
    secret = 'your-secret-token'
    signature = request.headers.get('X-Webhook-Signature', '')

    # Verify signature
    expected_signature = 'sha256=' + hmac.new(
        secret.encode(),
        request.data,
        hashlib.sha256
    ).hexdigest()

    if not hmac.compare_digest(signature, expected_signature):
        return jsonify({'error': 'Unauthorized'}), 401

    data = request.json

    if data['event'] == 'content_changed':
        task_name = data['task']['name']
        url = data['task']['url']
        changes = len(data.get('task_log', {}).get('changes', {}).get('changed', []))

        print(f"Content changed: {task_name} - {changes} changes detected")

        # Your custom logic here
        # ...

    return jsonify({'status': 'received'})

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=5000)

चरण 2: अपना एंडपॉइंट सुलभ बनाएँ

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

प्रोडक्शन डिप्लॉयमेंट

अपने वेब सर्वर पर डिप्लॉय करें
SSL प्रमाणपत्र के साथ एक डोमेन का उपयोग करें
उदाहरण: https://yoursite.com/webhook

विकास/परीक्षण

स्थानीय परीक्षण के लिए ngrok का उपयोग करें
चलाएँ: ngrok http 3000
प्रदत्त HTTPS URL का उपयोग करें

चरण 3: ट्रैकर में वेबहुक चैनल कॉन्फ़िगर करें

अपने नोटिफिकेशन चैनलों पर जाएँ
"Add New Channel" पर क्लिक करें और "Custom Webhook" चुनें
कॉन्फ़िगरेशन भरें:
- वेबहुक URL: आपका HTTPS एंडपॉइंट URL
- HTTP विधि: POST (अनुशंसित), PUT, या PATCH
- सीक्रेट टोकन: हस्ताक्षर सत्यापन के लिए एक सुरक्षित यादृच्छिक स्ट्रिंग
- एपीआई कुंजी: प्रमाणीकरण के लिए वैकल्पिक बेयरर टोकन
- कस्टम हेडर: JSON के रूप में वैकल्पिक अतिरिक्त हेडर
यह सत्यापित करने के लिए "Test Configuration" पर क्लिक करें कि सब कुछ ठीक से काम कर रहा है
चैनल सहेजें

चरण 4: वेबहुक डेटा को संभालें

आपका वेबहुक सामग्री परिवर्तन के बारे में व्यापक जानकारी के साथ एक JSON पेलोड प्राप्त करेगा:

{
  "event": "content_changed",
  "timestamp": "2025-08-12T14:30:00Z",
  "channel": {
    "id": 123,
    "name": "My Webhook Channel",
    "type": "webhook"
  },
  "task": {
    "id": 456,
    "name": "Product Price Monitor",
    "url": "https://example.com/product",
    "css_path": ".price",
    "content_type": "text",
    "screenshot_enabled": true,
    "frequency": "hourly",
    "render_level": "browsershot"
  },
  "user": {
    "id": 789,
    "email": "user@example.com"
  },
  "notification": {
    "subject": "Content Changed: Product Price Monitor",
    "message": "Task: Product Price Monitor\nURL: https://example.com/product\nTime: Aug 12, 2025 at 2:30 PM\n3 content changes detected",
    "is_test": false
  },
  "task_log": {
    "id": 101112,
    "content": "$29.99",
    "changes": {
      "changed": [
        {
          "path": "price",
          "old_value": "$39.99",
          "new_value": "$29.99"
        }
      ],
      "added": [],
      "removed": []
    },
    "created_at": "2025-08-12T14:30:00Z"
  },
  "screenshot": {
    "type": "url",
    "url": "https://storage.tracker.com/screenshots/abc123.png",
    "expires_at": "2025-08-19T14:30:00Z"
  },
  "metadata": {
    "api_version": "1.0",
    "webhook_id": "123",
    "sent_at": "2025-08-12T14:30:01Z",
    "user_agent": "Content-Tracker-Webhook/1.0"
  }
}

सुरक्षा सर्वोत्तम प्रथाएँ

महत्वपूर्ण सुरक्षा विचार

हमेशा HTTPS का उपयोग करें: सुरक्षा के लिए वेबहुक केवल HTTPS URL पर भेजे जाते हैं
हस्ताक्षरों की पुष्टि करें: वेबहुक की प्रामाणिकता की पुष्टि करने के लिए गुप्त टोकन का उपयोग करें
इनपुट मान्य करें: हमेशा आने वाले वेबहुक डेटा को मान्य और स्वच्छ करें
रेट लिमिटिंग: अपने वेबहुक एंडपॉइंट पर रेट लिमिटिंग लागू करें
लॉग्स की निगरानी करें: डिबगिंग और निगरानी के लिए वेबहुक रसीदों को लॉग करें

उन्नत कॉन्फ़िगरेशन

कस्टम हेडर

आप वेबहुक अनुरोधों में कस्टम हेडर जोड़ सकते हैं:

{
  "X-API-Version": "v1",
  "X-Source": "content-tracker",
  "Custom-Header": "your-value"
}

प्रमाणीकरण विधियाँ

सीक्रेट टोकन (अनुशंसित)

X-Webhook-Signature हेडर में भेजे गए HMAC-SHA256 हस्ताक्षर सत्यापन का उपयोग करता है।

एपीआई कुंजी

अतिरिक्त प्रमाणीकरण के लिए Authorization हेडर में Bearer टोकन भेजता है।

सामान्य उपयोग के मामले

डेटाबेस लॉगिंग

ऐतिहासिक विश्लेषण के लिए अपने डेटाबेस में परिवर्तन घटनाओं को संग्रहीत करें

तृतीय-पक्ष एकीकरण

Zapier, IFTTT, या कस्टम APIs जैसी अन्य सेवाओं को सूचनाएं अग्रेषित करें

कस्टम अलर्टिंग

परिवर्तन पैटर्न और सीमाओं के आधार पर कस्टम अलर्टिंग लॉजिक बनाएँ

समस्या निवारण

सत्यापित करें कि आपका एंडपॉइंट URL सही और सुलभ है
जाँचें कि आपका सर्वर चल रहा है और HTTPS अनुरोध स्वीकार कर रहा है
अपने एंडपॉइंट को मैन्युअली curl या Postman से टेस्ट करें
किसी भी त्रुटि के लिए अपने सर्वर लॉग्स की जाँच करें
सुनिश्चित करें कि आपका फ़ायरवॉल इनकमिंग HTTPS ट्रैफ़िक की अनुमति देता है

URL https:// से शुरू होना चाहिए (HTTP की अनुमति नहीं है)
लोकलहोस्ट, 127.0.0.1, या निजी आईपी पतों को इंगित नहीं कर सकता
यह सार्वजनिक रूप से सुलभ URL होना चाहिए
URL में टाइपिंग की गलतियों की जाँच करें

सुनिश्चित करें कि आप बिल्कुल वही सीक्रेट टोकन उपयोग कर रहे हैं
हस्ताक्षर गणना के लिए कच्ची अनुरोध बॉडी का उपयोग करें
जांचें कि आप X-Webhook-Signature हेडर को सही ढंग से पढ़ रहे हैं
स्थिर-समय तुलना का उपयोग करें (PHP में hash_equals, Python में hmac.compare_digest)

वेबहूक एंडपॉइंट्स को 30 सेकंड के भीतर प्रतिक्रिया देनी चाहिए
भारी संचालन के लिए वेबहुक्स को असिंक्रोनस रूप से संसाधित करें
तुरंत 200 स्टेटस कोड लौटाएँ, फिर प्रोसेस करें
समय-साध्य कार्यों के लिए कतारों या पृष्ठभूमि जॉब्स का उपयोग करें

स्थानीय विकास और परीक्षण के लिए:

ngrok इंस्टॉल करें: https://ngrok.com/download
अपने वेबहुक सर्वर को स्थानीय रूप से चलाएँ (उदाहरण के लिए, पोर्ट 3000 पर)
दूसरे टर्मिनल में: ngrok http 3000
अपने वेबहुक कॉन्फ़िगरेशन में ngrok द्वारा प्रदान किया गया HTTPS URL का उपयोग करें
"Test Configuration" बटन का उपयोग करके परीक्षण करें

टोकन लागत

लागत: वेबहुक सूचनाओं पर भेजी गई प्रत्येक सूचना के लिए 3 टोकन खर्च होते हैं। यह बेस ट्रैकिंग टास्क लागत के अतिरिक्त है।

वेबहुक पुनः प्रयास नीति

हमारी वेबहुक डिलीवरी प्रणाली में स्वचालित पुनः प्रयास शामिल हैं:

घातीय बैकऑफ़ के साथ 3 पुनः प्रयास तक
पुनः प्रयास तब होते हैं जब आपका एंडपॉइंट 5xx स्टेटस कोड लौटाता है या टाइम आउट हो जाता है
4xx स्टेटस कोड (क्लाइंट त्रुटियाँ) दोबारा प्रयास नहीं किए जाते
सफल डिलीवरी के लिए 2xx स्टेटस कोड प्रतिक्रिया आवश्यक है

प्रदर्शन टिप्स

करें

✓ 200 स्थिति के साथ शीघ्रता से प्रतिक्रिया करें
✓ वेबहुक्स को असिंक्रोनस रूप से प्रोसेस करें
✓ वेबहुक सिग्नेचर को मान्य करें
✓ वेबहूक रसीदों को लॉग करें
✓ इडेम्पोटेंसी लागू करें

न करें

✗ भारी प्रोसेसिंग सिंक्रोनस रूप से करें
✗ वेबहुक हैंडलर में बाहरी API कॉल करें
✗ वेबहुक सिग्नेचर को अनदेखा करें
✗ अनावश्यक रूप से गैर-2xx स्थिति कोड लौटाना
✗ प्रतिक्रिया देने में 30 सेकंड से अधिक समय लेना

प्रो टिप्स

अपने मौजूदा सिस्टम के साथ रीयल-टाइम इंटीग्रेशन के लिए वेबहुक्स का उपयोग करें
ऑडिट ट्रेल्स और एनालिटिक्स के लिए वेबहुक डेटा संग्रहीत करें
डिबगिंग के लिए वेबहुक रिप्ले फ़ंक्शनलिटी लागू करें
विभिन्न वातावरणों (dev, staging, prod) के लिए अलग-अलग वेबहुक URL का उपयोग करें
प्रोडक्शन के लिए Svix या Hookdeck जैसे वेबहूक प्लेटफ़ॉर्म का उपयोग करने पर विचार करें

मदद चाहिए? यदि आपको अभी भी वेबहुक्स सेटअप करने में परेशानी हो रही है, तो व्यक्तिगत सहायता के लिए हमारी सहायता टीम से संपर्क करें ।

स्लैक सूचना सेटअप गाइड

सामग्री में बदलाव के बारे में अपनी टीम को सूचित रखने के लिए स्लैक सूचनाएं सेट करें।

6 मिनट का पठन 12 Aug, 2025

सूचना चैनल

Discord सूचना सेटअप गाइड

अपने समुदाय या टीम के लिए डिस्कॉर्ड वेबहुक सूचनाओं को कॉन्फ़िगर करें।

5 मिनट का पठन 12 Aug, 2025

सूचना चैनल

माइक्रोसॉफ्ट टीम्स सूचना सेटअप गाइड

Microsoft Teams में रिच एडैप्टिव कार्ड सूचनाएं सेट अप करें।

6 मिनट का पठन 12 Aug, 2025

क्या अभी भी सहायता चाहिए?

हमारी सहायता टीम आपके किसी भी सवाल में मदद के लिए उपलब्ध है।

अधिक सहायता लेख सहायता से संपर्क करें

कस्टम वेबहुक सूचना सेटअप गाइड

वेबहुक सूचनाएँ कैसे सेट करें

चरण 1: एक वेबहूक एंडपॉइंट बनाएँ

चरण 2: अपना एंडपॉइंट सुलभ बनाएँ

प्रोडक्शन डिप्लॉयमेंट

विकास/परीक्षण

चरण 3: ट्रैकर में वेबहुक चैनल कॉन्फ़िगर करें

चरण 4: वेबहुक डेटा को संभालें

सुरक्षा सर्वोत्तम प्रथाएँ

महत्वपूर्ण सुरक्षा विचार

उन्नत कॉन्फ़िगरेशन

कस्टम हेडर

प्रमाणीकरण विधियाँ

सीक्रेट टोकन (अनुशंसित)

एपीआई कुंजी

सामान्य उपयोग के मामले

डेटाबेस लॉगिंग

तृतीय-पक्ष एकीकरण

कस्टम अलर्टिंग

समस्या निवारण

टोकन लागत

वेबहुक पुनः प्रयास नीति

प्रदर्शन टिप्स

करें

न करें

प्रो टिप्स

लोकप्रिय कीवर्ड

संबंधित सहायता लेख

स्लैक सूचना सेटअप गाइड

Discord सूचना सेटअप गाइड

माइक्रोसॉफ्ट टीम्स सूचना सेटअप गाइड

क्या अभी भी सहायता चाहिए?

कस्टम वेबहुक सूचना सेटअप गाइड

वेबहुक सूचनाएँ कैसे सेट करें

चरण 1: एक वेबहूक एंडपॉइंट बनाएँ

चरण 2: अपना एंडपॉइंट सुलभ बनाएँ

प्रोडक्शन डिप्लॉयमेंट

विकास/परीक्षण

चरण 3: ट्रैकर में वेबहुक चैनल कॉन्फ़िगर करें

चरण 4: वेबहुक डेटा को संभालें

उदाहरण वेबहुक पेलोड

सुरक्षा सर्वोत्तम प्रथाएँ

महत्वपूर्ण सुरक्षा विचार

उन्नत कॉन्फ़िगरेशन

कस्टम हेडर

प्रमाणीकरण विधियाँ

सीक्रेट टोकन (अनुशंसित)

एपीआई कुंजी

सामान्य उपयोग के मामले

डेटाबेस लॉगिंग

तृतीय-पक्ष एकीकरण

कस्टम अलर्टिंग

समस्या निवारण

वेबहुक प्राप्त नहीं हुआ

अमान्य वेबहुक URL त्रुटि

हस्ताक्षर सत्यापन विफल हो रहा है

टाइमआउट या धीमी प्रतिक्रियाएँ

स्थानीय रूप से वेबहुक का परीक्षण

टोकन लागत

वेबहुक पुनः प्रयास नीति

प्रदर्शन टिप्स

करें

न करें

प्रो टिप्स

लोकप्रिय कीवर्ड

संबंधित सहायता लेख

स्लैक सूचना सेटअप गाइड

Discord सूचना सेटअप गाइड

माइक्रोसॉफ्ट टीम्स सूचना सेटअप गाइड

क्या अभी भी सहायता चाहिए?

हम आपकी गोपनीयता का सम्मान करते हैं

कुकी प्राथमिकताएँ

आवश्यक कुकीज़ (हमेशा सक्रिय)

कार्यात्मक कुकीज़

एनालिटिक्स कुकीज़

मार्केटिंग कुकीज़