n8n वर्कफ्लोज

AI-Corporate n8n वर्कफ्लोज को उत्पादन-व webhook के जरिए शुरू कर सकता है। यह तब उपयोगी है जब आप AI-Corporate के बाहर किसी ऑटोमेटेड प्रोसेस को शुरू करना चाहते हैं, जैसे एक टास्क बनाना, CRM-रिकॉर्ड अपडेट करना, रिपोर्टिंग फ्लो शुरू करना या फॉर्म डेटा को किसी अन्य सिस्टम में भेजना।

उदाहरण: कंपनी वेबसाइट पर समाचार लेख

मान लें कि संगठन के पास ऐसी n8n वर्कफ्लो है जो कंपनी की WordPress वेबसाइट पर समाचार लेख प्रकाशित करती है। AI-Corporate में आप केवल एक छोटा टेक्स्ट भाग भरते हैं, जैसे क्लाइंट केस, इवेंट या आंतरिक माइलस्टोन के बारे में कुछ वाक्य। उसी टेक्स्ट से आप n8n में वर्कफ्लो शुरू करते हैं।

n8n वर्कफ्लो तब निम्न कर सकता है:

1. छोटे टेक्स्ट से एक साफ नज़र आने वाला ड्राफ्ट बनाना LLM नोड और ऐसी प्रॉम्प्ट के साथ जो संगठन की टोन के साथ ठीक बैठती हो।
2. उपयुक्त आर्टवर्क बनवाना दूसरे LLM नोड के साथ, उदाहरण के लिए ब्रांड रंगों में और एक पहचानने योग्य चित्रात्मक शैली में।
3. टेक्स्ट और इमेज को ब्लॉग पोस्ट के रूप में तैयार करना या WordPress वेबसाइट पर प्रकाशित करना।

ऐसी तरह AI-Corporate और n8n साथ मिलकर काम करते हैं: AI-Corporate में उपयोगकर्ता वर्कफ्लो चुनता है और आवश्यक जानकारी भरता है। फिर n8n ऑटोमेटेड स्टेप्स चलाता है और.news लेख वेबसाइट पर ठीक से आ जाता है।

यह इंटीग्रेशन क्या करती है?

आप workflow-ओवरव्यू से n8n वर्कफ्लो शुरू करते हैं। केवल production-webhook, POST और Header Auth अनिवार्य हैं। n8n से फील्ड्स और रिटर्न-मैसेजिंग वैकल्पिक हैं और एक दूसरे से स्वतंत्र रूप से सेट किए जा सकते हैं।

• अगर वर्कफ्लो में कोई फील्ड नहीं है, तो webhook तुरंत कॉल किया जाता है।
• अगर वर्कफ्लो में फील्ड हैं, तो पहले एक फॉर्म खुलता है। उपयोगकर्ता फील्ड भरता है और फिर स्टार्ट बटन से वर्कफ्लो शुरू होता है।
• भरे गए मान POST-रिक्वेस्ट के JSON बॉडी के रूप में n8n webhook को भेजे जाते हैं।
• बिना रिटर्न-मैसेज के, AI-Corporate सिर्फ यह पुष्टि कर देता है कि वर्कफ्लो शुरू हो गया है और n8n में आगे चलता है। विंडो में स्पिनर नहीं दिखता और सीधे बंद किया जा सकता है।
• अगर पंजीकरण के दौरान यह सक्षम किया गया है, तो वर्कफ्लो बीच के स्टेप्स या समाप्ति को AI-Corporate को वापस भेज सकता है।
• अगर पंजीकरण में अनुमोदन सक्षम है, तो उपयोगकर्ता सीधे AI-Corporate में चयन कर सकता है। n8n फिर प्रतीक्षित स्टेप से आगे बढ़ता है।

AI-Corporate में n8n वर्कफ्लो बनाना

एक व्यवस्थापक निम्नलिखित तरीके से वर्कफ्लो पंजीकृत करता है:

1. Assistant पर जाएँ।
2. Workflows खोलें।
3. Nieuwe n8n workflow चुनें।
4. वर्कफ्लो का नाम और n8n उत्पादन-URL भरें।
5. Header authentication को एक हैडर नाम और गुप्त हैडर वैल्यू के साथ सेट करें।
6. Terugmeldingen uit n8n के अंतर्गत केवल वही हिस्से चुनें जो सच में इस n8n-workflow में बने थे: प्रगति, अनुमोदन और/या वर्कफ्लो का अंत।
7. POST-रिक्वेस्ट में भेजने के लिए फील्ड्स जोड़ें जो भेजे जाने चाहिए।
8. वर्कफ्लो को सेव करें।

तीनों रिटर्न-मैसेजिंग विकल्प डिफ़ॉल्ट रूप से बंद होते हैं। अगर आप बाद में callbacks या अनुमोदन स्टेप n8n में सेट करते हैं, तो AI-Corporate में भी पंजीकरण अपडेट करें। डायलॉग यह जान लेगा कि उसे सिर्फ स्टार्ट-प्रमाणन दिखाना है या आगे संकेतों का इंतजार जारी रखना है।

फील्ड्स

• फील्ड्स वैकल्पिक हैं।
• हर फील्ड की एक फील्ड-नाम और एक प्रकार होती है।
• समर्थित फील्ड-टायप: छोटा टेक्स्ट, लंबा टेक्स्ट, संख्या, हाँ/नहीं, तिथि, एक विकल्प और एकाधिक विकल्प।
• एक विकल्प और बहु-चयन में उपलब्ध विकल्प जोड़ें। एक विकल्प संक्षिप्त चयन सूची के रूप में दिखेगा; बहु-चयन चेकबॉक्स दिखाता है। चुना गया मान JSON बॉडी में भेजा जाएगा।
• आवश्यक फील्ड को शुरू करने से पहले भरना अनिवार्य है।
• फील्ड-नाम JSON बॉडी में key बनता है जो n8n को भेजा जाता है।

n8n में संगत वर्कफ़्लो बनाना

1. n8n में एक नया वर्कफ़्लो बनाएं।
2. पहली नोड के रूप में एक Webhook जोड़ें।
3. इस नोड को सही नाम दें: Start workflow. नीचे दिए गए उदाहरण एक्सप्रेशन इसी नाम का उपयोग करते हैं।
4. HTTP Method को POST पर सेट करें।
5. Authentication: Header Auth चुनें और AI-Corporate में वही हेडर-नाम और गुप्त मूल्य प्रयोग करें।
6. Respond या Response Mode को Immediately पर सेट करें।
7. Production URL को AI-Corporate में field n8n production-url में कॉपी करें। /webhook-test/ वाले टेस्ट-URL का उपयोग न करें।
8. वर्कफ्लो को सक्रिय करें।

प्राप्त डेटा body के नीचे होते हैं; तकनीकी इंटीग्रेशन डेटा body.integration के नीचे होते हैं। एडिट फील्ड्स-, सेट- या कोड-नोड में इन्हें हटा दें।

JSON बॉडी का उदाहरण

यदि आप नामों के साथ फील्ड्स define करते हैं prompt, klantnaam, doelgroepen और datum, तो n8n उदाहरण के लिये यह JSON बॉडी प्राप्त करेगा। AI-Corporate अपने आप integration-object जोड़ देता है।

{
  "prompt": "Maak een korte samenvatting van de aanvraag.",
  "klantnaam": "Voorbeeldorganisatie",
  "doelgroepen": ["medewerkers", "klanten"],
  "datum": "2026-09-22",
  "integration": {
    "runId": "chat-document-id",
    "tenant": "default",
    "callbackUrl": "https://europe-west1-ai-corporate.cloudfunctions.net/n8nWorkflowCallback",
    "callbackToken": "tijdelijk-token-voor-deze-uitvoering"
  }
}

callback-token एक निष्पादन के लिए है। इसे लॉग, स्थिर कॉन्फ़िगरेशन या अन्य सिस्टमों में न रखें।

वैकल्पिक: प्रगति और समापन वापस भेजना

AI-Corporate केवल वही वापस दिखा सकता है जो n8n द्वारा रिटर्न किया गया है। इन callbacks का उपयोग केवल जब पंजीकरण में आप ने Tussentijdse voortgang melden और/या Het einde van de workflow melden सक्षम किया हो।

हर callback-nodes को इस तरह से सेट करें:

1. Method: POST चुनें।

2. URL पर Expression पर क्लिक करें और पेस्ट करें:

   {{ $('Start workflow').first().json.body.integration.callbackUrl }}

3. Authentication: None चुनें।

4. Send Headers चालू करें और नीचे दी गई हेडर्स जोड़ें।

5. Send Body चालू करें और चुनें Body Content Type: JSON और Specify Body: Using JSON।

इन हेडर्स का प्रयोग करें:

Authorization: Bearer {{ $('Start workflow').first().json.body.integration.callbackToken }}
Content-Type: application/json

उदाहरण के लिये जब किसी स्टेप की शुरुआत हो:

{
  "tenant": "{{ $('Start workflow').first().json.body.integration.tenant }}",
  "runId": "{{ $('Start workflow').first().json.body.integration.runId }}",
  "eventId": "document-maken-gestart",
  "type": "progress",
  "executionId": "{{ $execution.id }}",
  "step": {
    "id": "document_maken",
    "label": "Document maken"
  },
  "message": "Het document wordt gemaakt."
}

• हर घटना के लिए उसी निष्पादन में एक यूनिक eventId का उपयोग करें।
• स्पष्ट Dutch step.label रखें; यह ऐप में दिखेगा।
• यदि आपने Het einde van de workflow melden सक्षम किया है, तो अंत में हमेशा type: "completed", type: "failed" या type: "rejected" भेजें।
• completed पर संभव हो तो एक output-object परिणाम के साथ जोड़ दें।
• failed पर एक स्पष्ट त्रुटि संदेश भेजें। निष्पादन फिर ऐप में भी रोक दिया जाएगा।

वैकल्पिक: ऐप में अनुमोदन पूछना

यदि वर्कफ्लो तय करने के बाद ही आगे बढ़ सकता है, तो n8n का Wait नोड उपयोग करें और On Webhook Call पर सेट करें। Wait नोड से पहले callback भेजें type: "approval_required":

Wait नोड को इस तरह सेट करें: Resume: On Webhook Call, HTTP Method: POST और Authentication: Header Auth। Start workflow के साथ वही Header Auth credential चुनें। Wait के बाद एक Switch नोड जोड़ें और उसमें चेक करें {{ $json.body.decision }}।

{
  "tenant": "{{ $('Start workflow').first().json.body.integration.tenant }}",
  "runId": "{{ $('Start workflow').first().json.body.integration.runId }}",
  "eventId": "controle-document",
  "type": "approval_required",
  "executionId": "{{ $execution.id }}",
  "step": {
    "id": "controle_document",
    "label": "Document controleren"
  },
  "approval": {
    "question": "Mag de workflow doorgaan?",
    "context": "Controleer eerst het gegenereerde document.",
    "resumeUrl": "{{ $execution.resumeUrl }}",
    "choices": [
      { "value": "approve", "label": "Goedkeuren" },
      { "value": "reject", "label": "Afwijzen" }
    ]
  }
}

उपयोगकर्ता निष्पादन विंडो में विकल्प देखते हैं। एक चुनाव के बाद Wait node में शामिल decision मिलती है। फिर एक Switch नोड से उचित अगला कदम निर्धारित करें।

चयन मान में केवल अक्षर, संख्या, _ और - हो सकते हैं। लेबल में सामान्य पठनीय टेक्स्ट हो सकता है।

उत्पादन callback-url सेट करना

AI-Corporate के लिए उत्पादन callback-url है:

https://europe-west1-ai-corporate.cloudfunctions.net/n8nWorkflowCallback

हर callback-nodes में इसे स्थिर टेक्स्ट के रूप में न रखें। HTTP Request नोड के URL-फील्ड में Expression चुनें और उपयोग करें:

{{ $('Start workflow').first().json.body.integration.callbackUrl }}

AI-Corporate प्रत्येक स्टार्ट के साथ सही उत्पादन-URL स्वतः दे देगा। ऊपर दिया गया स्थिर URL टेस्टिंग के दौरान यह देखने के लिए उपयोग करें कि एक्सप्रेशन AI-Corporate की ओर इशारा कर रहा है या AI-School या AI-Public की ओर नहीं।

Callable triggerCustomN8nWorkflow, triggerN8nWorkflow और resumeN8nWorkflow एप्लिकेशन स्वयं कॉल करता है। इन URL को n8n में सेट करने की आवश्यकता नहीं है।

त्रुटियाँ संभालना

अपेक्षित त्रुटियाँ Callback के प्रकार failed के साथ भेजें। अप्रत्याशित नोड-त्रुटियों के लिए एक केंद्रीय Error Workflow बनाएं:

1. एक नई वर्कफ्लो बनाएं जिसमें एक Error Trigger नोड हो।

2. फिर एक HTTP Request नोड जोड़ें जिसकी Method: POST हो।

3. URL में यह स्थिर उत्पादन-URL भरें:

   https://europe-west1-ai-corporate.cloudfunctions.net/n8nWorkflowExecutionFailed

4. Authentication: None चुनें और हेडर n8n-handihow-name जोड़ें प्लेटफॉर्म एडमिन की गुप्त डिफ़ॉल्ट वैल्यू के साथ।

5. एक JSON बॉडी चुनें और पेस्ट करें:

{
  "executionId": "{{ $json.execution.id }}",
  "workflowId": "{{ $json.workflow.id }}",
  "workflowName": "{{ $json.workflow.name }}",
  "lastNode": "{{ $json.execution.lastNodeExecuted }}",
  "message": "{{ $json.execution.error.message }}"
}

6. Error Workflow को सक्रिय करें।
7. सामान्य वर्कफ्लो की सेटिंग्स खोलें और Error Workflow में इसे चुनें।

स्टार्ट वर्कफ्लो के तुरंत बाद कम से कम एक callback भेजें जिसमें executionId: "{{ $execution.id }}" हो। तभी AI-Corporate किसी अप्रत्याशित त्रुटि को सही निष्पादन से जोड़ पाएगा।

महत्वपूर्ण सीमाएँ

• केवल webhook ट्रिगर समर्थित हैं।
• केवल production-webhook-urls समर्थित हैं।
• टेस्ट-वेबहुक-URLs with /webhook-test/ अस्वीकृत हैं।
• केवल POST समर्थित है।
• केवल generic header authentication समर्थित है।
• header value को एप्लिकेशन में गुप्त माना जाता है।
• Callbacktokens और resume-url केवल सर्वर-साइड प्रोसेस होते हैं और उपयोगकर्ताओं के लिए सीधे उपलब्ध नहीं हैं।
• tenant सर्वर-साइड से लॉग-इन यूजर के आधार पर निर्धारित होता है, ब्राउज़र द्वारा भेजी गई किसी वैल्यू से नहीं।

समस्याओं का समाधान

• 404 या webhook पंजीकृत नहीं: n8n में वर्कफ्लो सक्रिय करें और production-url का उपयोग करें।
• Authentication त्रुटि: जाँच करें कि header name और value दोनों में समान हों।
• डेटा गायब: जाँच करें कि एप्लिकेशन में फील्ड-नेम वे keys जो n8n से अपेक्षित हैं के अनुरूप हों।
• n8n में कोई रिक्वेस्ट नहीं: जाँच करें कि वर्कफ्लो webhook trigger से शुरू होता है और POST का उपयोग करता है।
• निष्पादन विंडो चालू रहता है: अगर आपने Het einde van de workflow melden सक्षम किया है, तो अंत में चेक करें कि n8n एक अंतिम completed, failed या rejected callback भेज रहा है। अगर आप किसी रिटर्न-मैसेजिंग की उम्मीद नहीं कर रहे तो सभी तीन विकल्प पंजीकरण से बाहर निकाल दें।
• प्रगति दिखाई नहीं दे रही: जाँच करें कि पंजीकरण में Tussentijdse voortgang melden सक्षम है, या integration-object बना हुआ है और प्रत्येक callback में एक यूनिक eventId है।
• अनुमोदन बटन काम नहीं कर रहे: Wait node, resumeUrl, header authentication और choices[].value में अनुमति दिए गए अक्षरों की जाँच करें।