n8n workflows

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

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

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

n8n वर्कफ़्लो फिर उदाहरण के लिए:

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

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

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

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

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

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

एक व्यवस्थापक वर्कफ़्लो इस प्रकार पंजीकृत करता है:

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

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

फ़ील्ड्स

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

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

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

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

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

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

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

callback-token ekutet एक execution के साथ होता है. Logs, स्थिर कॉन्फ़िगरेशन या अन्य सिस्टमों में इसे न रखें।

वैकल्पिक: voortgang और afronding terugsturen

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

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

1. Method: POST चुनें।

2. URL में Expression पर क्लिक करें और paste करें:

   {{ $('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

नीचे दिए गए संदेश को तब भेजें जब एक स्टेप शुरू होता है:

{
  "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."
}

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

Optioneel: एप में अनुमोदन माँगना

n8n में Wait node को On Webhook Call के साथ इस्तेमाल करें जब वर्कफ़्लो चुने जाने के बाद ही आगे बढ़ सकता हो। Wait node से पहले callback भेजें जिसमें type: "approval_required" हो:

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": "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 node से सही आगे का रास्ता तय करें।

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

Production callback-url सेटअप

AI-Public के लिए production callback-url है:

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

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

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

AI-Public प्रत्येक प्रारंभ पर सही production-url स्वतः दे देगा। ऊपर दी गयी स्थाई URL testing के समय यह जाँचने के लिए है कि कायExpression AI-Public को संदर्भित कर रहा है और AI-School या AI-Corporate को नहीं।

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

त्रुटियाँ हैंडल करना

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

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

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

3. URL में यह स्थायी production-url भरें:

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

4. Authentication: None चुनें और प्लेटफ़ॉर्म-प्रबंधक की गुप्त डिफ़ॉल्ट मान के साथ header 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 के रूप में चुनें।

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

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

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

समस्याएँ हल करें

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