n8n वर्कफ़्लोज़

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

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

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

इसके बाद n8n वर्कफ़्लो, उदाहरण के लिए, यह कर सकता है:

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

इस तरह AI-Public और n8n साथ काम करते हैं: AI-Public में उपयोगकर्ता वर्कफ़्लो चुनता है और आवश्यक जानकारी भरता है। इसके बाद n8n स्वचालित चरणों को निष्पादित करता है और सुनिश्चित करता है कि समाचार लेख ठीक से वेबसाइट पर पहुँच जाए।

यह एकीकरण क्या करता है?

आप workflow-overzicht से एक n8n वर्कफ़्लो शुरू करते हैं। केवल प्रोडक्शन वेबहुक, POST और Header Auth अनिवार्य हैं। n8n से आने वाले fields और callbacks वैकल्पिक हैं और उन्हें एक-दूसरे से स्वतंत्र रूप से सेट किया जा सकता है।

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

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

एक व्यवस्थापक वर्कफ़्लो को इस प्रकार register करता है:

1. Assistenten पर जाएँ।
2. Workflow assistenten टैब खोलें।
3. ऊपर वाले कार्ड में Nieuwe workflow पर क्लिक करें और n8n workflow चुनें।
4. वर्कफ़्लो का नाम और n8n प्रोडक्शन URL भरें।
5. Header authentication को एक header name और secret header value के साथ सेट करें।
6. Terugmeldingen uit n8n के अंतर्गत केवल वही भाग चुनें जो वास्तव में इस n8n-workflow में बनाए गए हैं: progress, approval, और/या वर्कफ़्लो का अंत।
7. आवश्यकता हो तो वे fields जोड़ें जिन्हें POST-request में भेजना है।
8. वर्कफ़्लो सहेजें।

तीनों callback विकल्प डिफ़ॉल्ट रूप से बंद रहते हैं। यदि बाद में आप n8n में callbacks या approval step जोड़ते हैं, तो AI-Public में registration भी अपडेट करें। इससे dialog जानता है कि उसे केवल start confirmation दिखाना है या आगे के signals का इंतज़ार करते रहना है।

Fields

• Fields वैकल्पिक हैं।
• हर field में एक field name और एक type होता है।
• समर्थित field types हैं: छोटा टेक्स्ट, लंबा टेक्स्ट, संख्या, हाँ/नहीं, तारीख, एक विकल्प, और कई विकल्प।
• Eén keuze और Meerdere keuzes में उपलब्ध विकल्प जोड़ें। Eén keuze एक कॉम्पैक्ट dropdown की तरह दिखता है; Meerdere keuzes checkbox दिखाता है। चुनी गई value या values JSON body में भेजी जाती हैं।
• अनिवार्य fields भरने के बाद ही वर्कफ़्लो शुरू किया जा सकता है।
• field name वही key बनता है जो n8n को भेजी जाने वाली JSON body में होता है।

n8n में compatible workflow बनाना

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

प्राप्त डेटा body के अंतर्गत होता है; तकनीकी integration data body.integration के अंतर्गत होता है। इसे किसी Edit Fields-, Set- या Code-node में हटाएँ नहीं।

JSON body का उदाहरण

यदि आप prompt, klantnaam, doelgroepen और datum नाम के fields परिभाषित करते हैं, तो n8n को उदाहरण के लिए यह JSON body प्राप्त होगी। AI-Public integration object अपने-आप जोड़ देता है।

{
  "prompt": "अनुरोध का एक छोटा सारांश बनाइए।",
  "klantnaam": "उदाहरण संगठन",
  "doelgroepen": ["निवासी", "कर्मचारी"],
  "datum": "2026-09-22",
  "integration": {
    "runId": "chat-document-id",
    "tenant": "default",
    "callbackUrl": "https://europe-west1-ai-public-pro.cloudfunctions.net/n8nWorkflowCallback",
    "callbackToken": "इस-निर्वाह-के-लिए-अस्थायी-टोकन"
  }
}

callback token एक ही execution से संबंधित होता है। इसे logs, स्थायी configuration, या अन्य systems में सहेजें नहीं।

वैकल्पिक: progress और completion वापस भेजना

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

हर callback node को इस प्रकार सेट करें:

1. Method: POST चुनें।

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

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

3. Authentication: None चुनें।

4. Send Headers चालू करें और नीचे दिए गए headers जोड़ें।

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

इन headers का उपयोग करें:

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

उदाहरण के लिए, जब कोई step शुरू हो, तब यह संदेश भेजें:

{
  "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": "दस्तावेज़ बनाना"
  },
  "message": "दस्तावेज़ बनाया जा रहा है।"
}

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

वैकल्पिक: ऐप में approval माँगना

जब workflow को किसी choice के बाद ही आगे बढ़ना हो, तब n8n Wait node को On Webhook Call के साथ उपयोग करें। Wait node से पहले type: "approval_required" वाला callback भेजें:

Wait node को Resume: On Webhook Call, HTTP Method: POST और Authentication: Header Auth पर सेट करें। Start workflow के समान Header Auth credential चुनें। Wait node के बाद एक Switch node जोड़ें और उसमें {{ $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": "दस्तावेज़ की जाँच"
  },
  "approval": {
    "question": "क्या workflow आगे बढ़ सकता है?",
    "context": "सबसे पहले जनरेट किए गए दस्तावेज़ की जाँच करें।",
    "resumeUrl": "{{ $execution.resumeUrl }}",
    "choices": [
      { "value": "approve", "label": "स्वीकृत करें" },
      { "value": "reject", "label": "अस्वीकृत करें" }
    ]
  }
}

उपयोगकर्ता execution window में विकल्प देखता है। विकल्प चुनने के बाद Wait node को अन्य चीज़ों के साथ decision प्राप्त होता है। इसके बाद सही आगे की कार्रवाई तय करने के लिए उदाहरण के लिए Switch node का उपयोग करें।

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

प्रोडक्शन callback-url सेट करना

AI-Public के लिए प्रोडक्शन callback-url यह है:

https://europe-west1-ai-public-pro.cloudfunctions.net/n8nWorkflowCallback

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

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

इस तरह AI-Public हर start पर अपने-आप सही प्रोडक्शन URL दे देता है। ऊपर दिया गया स्थायी URL आप परीक्षण के दौरान यह जाँचने के लिए उपयोग करें कि expression AI-Public की ओर इशारा कर रहा है, न कि AI-School या AI-Corporate की ओर।

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

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

अपेक्षित errors को failed type वाले callback से वापस भेजें। इसके अलावा, अनपेक्षित node errors के लिए एक केंद्रीय Error Workflow बनाएँ:

1. एक नया workflow Error Trigger node के साथ बनाएँ।

2. उसके बाद HTTP Request node जोड़ें, Method: POST के साथ।

3. URL में यह स्थायी प्रोडक्शन URL भरें:

   https://europe-west1-ai-public-pro.cloudfunctions.net/n8nWorkflowExecutionFailed

4. Authentication: None चुनें और n8n-handihow-name header को platform administrator की secret default value के साथ जोड़ें।

5. एक JSON body चुनें और यह पेस्ट करें:

{
  "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. सामान्य workflow की settings खोलें और Error Workflow में इसे चुनें।

Start workflow के तुरंत बाद कम से कम एक callback executionId: "{{ $execution.id }}" के साथ भेजें। तभी AI-Public किसी अप्रत्याशित error को सही execution से जोड़ सकता है।

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

• केवल webhook triggers समर्थित हैं।
• केवल production webhook URLs समर्थित हैं।
• /webhook-test/ वाले test webhook URLs अस्वीकार किए जाते हैं।
• केवल POST समर्थित है।
• केवल generic header authentication समर्थित है।
• application में header value को secret माना जाता है।
• callback tokens और resume URLs केवल server-side processed होते हैं और सीधे users के लिए उपलब्ध नहीं होते।
• tenant server-side से logged-in user के आधार पर तय होता है, browser द्वारा भेजी गई value के आधार पर नहीं।

समस्याएँ हल करना

• 404 या webhook registered नहीं: n8n में workflow सक्रिय करें और production URL उपयोग करें।
• authentication error: जाँचें कि दोनों systems में header name और value बिल्कुल समान हैं।
• डेटा गायब है: जाँचें कि application में field names n8n द्वारा अपेक्षित keys से मेल खाते हैं।
• n8n में कोई request नहीं: जाँचें कि workflow webhook trigger से शुरू होता है और POST उपयोग करता है।
• execution window चलता रहता है: यदि आपने Het einde van de workflow melden चालू किया है, तो जाँचें कि n8n अंतिम completed, failed या rejected callback भेज रहा है। यदि आपको callbacks की अपेक्षा नहीं है, तो registration में तीनों options बंद कर दें।
• progress दिखाई नहीं दे रहा: जाँचें कि registration में Tussentijdse voortgang melden चालू है, integration object सुरक्षित है, और हर callback का एक unique eventId है।
• approval buttons काम नहीं कर रहे: Wait node, resumeUrl, header authentication और choices[].value में अनुमत characters जाँचें।