अपने सिस्टम पर webhooks भेजें

इवेंट

Webhooks कनेक्ट करें

1. Foliant में, सेटिंग्स › इंटीग्रेशन पर जाएँ।
2. Webhooks पर, कनेक्ट करें पर क्लिक करें।
3. सेटिंग्स भरें:

   फ़ील्ड	क्या डालें
   Endpoint URL	वह पता जिस पर Foliant इवेंट भेजता है। इसमें HTTPS होना ज़रूरी है, जैसे https://example.com/webhooks/foliant।
   Signing secret	वैकल्पिक। secret होने पर हर अनुरोध साइन किया जाता है, ताकि आप जाँच सकें कि वह Foliant से आया है।
   Events	भेजे जाने वाले इवेंट। डिफ़ॉल्ट रूप से दोनों चुने होते हैं।

4. कनेक्ट करें पर क्लिक करें।

हर अनुरोध में क्या होता है

{
  "id": "a unique delivery id",
  "event": "document.generated",
  "created_at": "2026-10-11T09:30:00+00:00",
  "shop": "your-store.myshopify.com",
  "data": { }
}

document.generated डेटा

• template: टेम्पलेट का uuid और name।
• document_type: invoice, credit_note, quote, या दूसरे दस्तावेज़ों के लिए खाली।
• order: उसका id, name और type (ऑर्डर या ड्राफ़्ट ऑर्डर)।
• refund_id और fulfillment_id, जब दस्तावेज़ किसी रिफ़ंड या शिपमेंट के लिए हो।
• document_number और issued_at, नंबर वाले दस्तावेज़ों के लिए।
• source: दस्तावेज़ कैसे बना, जैसे download, admin_download, export या email।
• export: एक्सपोर्ट की ID, जब दस्तावेज़ किसी एक्सपोर्ट का हिस्सा हो।
• generated_at।

export.completed डेटा

• export: उसका uuid, order_type, template_uuids, orders की संख्या, orders_skipped (चुने जाने के बाद डिलीट किए गए) और documents, requested_by (merchant या customer) और completed_at।
• download_url: एक्सपोर्ट डाउनलोड करने का लिंक, और download_url_expires_at, यानी वह लिंक कब काम करना बंद करेगा।
• download_expires_at: एक्सपोर्ट खुद कब एक्सपायर होगा।

हेडर

सिग्नेचर जाँचें

रिस्पॉन्स और दोबारा कोशिश

• कोई भी 2xx रिस्पॉन्स डिलीवर माना जाता है।
• अगर आपका endpoint 5xx एरर, 408 या 429 लौटाता है, या 10 सेकंड में जवाब नहीं देता, तो Foliant बाद में फिर से कोशिश करता है। हर बार वह थोड़ा ज़्यादा इंतज़ार करता है, अधिकतम 5 कोशिशों तक।
• दूसरे 4xx रिस्पॉन्स अंतिम होते हैं: Foliant उन पर दोबारा कोशिश नहीं करता।
• हर इवेंट प्रति दस्तावेज़ या एक्सपोर्ट एक बार डिलीवर होता है। सफल होने के बाद दोबारा कोशिश उसे कभी दो बार नहीं भेजती।

संबंधित लेख

• इंटीग्रेशन कनेक्ट और मैनेज करें
• इंटीग्रेशन गतिविधि
• Shopify Flow से ऑटोमेट करें
• PDF एक्सपोर्ट करें