n8n iş akışları

AI-Corporate, üretim web kancasıyla n8n iş akışlarını başlatabilir. Bu, AI-Corporate dışında otomatik bir süreci başlatmak istediğinizde, örneğin bir görevi oluşturmak, bir CRM kaydını güncellemek, bir raporlama akışını başlatmak veya form verilerini başka bir sisteme iletmek için kullanışlıdır.

Örnek: Şirket sitesindeki haber makalesi

Bir kuruluşun, şirketin WordPress sitesinde haber makalesini yayımlayan bir n8n iş akışı oluşturduğunu varsayın. AI-Corporate'te yalnızca kısa bir metin girersiniz; örneğin bir müşteri vakası, etkinlik veya dahili bir kilometre taşı hakkında birkaç cümle. Bu metin ile n8n'deki iş akışını başlatırsınız.

n8n iş akışı sonra şu adımları yapabilir:

1. Kısa metinden, organizasyonun tonuna uygun bir taslak metin oluşturmak için bir LLM düğümü ve uygun bir istem kullanmak.
2. Marka renklerinde ve tanınabilir stil ile ikinci bir LLM düğümü kullanarak uygun bir illustrasyon yaptırmak.
3. Metin ve görseli bir blog gönderisi olarak hazırlamak veya WordPress sitesinde yayımlamak.

İşte AI-Corporate ve n8n birlikte nasıl çalışır: AI-Corporate'te kullanıcı iş akışını seçer ve gerekli bilgileri girer. Ardından n8n otomatik adımları gerçekleştirir ve haber makalesinin web sitesinde düzgün şekilde görünmesini sağlar.

Bu entegrasyon ne yapar?

İş akışını iş akışı özetinden başlatırsınız. Yalnızca üretim web kancası, POST ve Header Auth zorunlu. n8n'den gelen alanlar ve geri bildirimler isteğe bağlıdır ve bağımsız olarak ayarlanabilir.

• İş akışında alan yoksa, web kancası hemen çağrılır.
• İş akışında alan varsa, önce bir form açılır. Kullanıcı alanları doldurur ve ardından Başlat düğmesiyle iş akışını başlatır.
• Doldurulan değerler, JSON olarak POST isteğiyle n8n web kancasına gönderilir.
• Geri bildirim olmadan, AI-Corporate yalnızca iş akışının başlatıldığını ve n8n'de ilerlediğini doğrular. Pencere bir yükleyici göstermez ve doğrudan kapatılabilir.
• Bu, kayıt işlemine göre etkinleştirilmişse, iş akışı ara adımları veya sonu AI-Corporate'a geri gönderebilir.
• Kayıtta onaylamanın etkinleştirilmiş olması halinde, kullanıcı AI-Corporate içinde doğrudan bir seçim yapabilir. Ardından n8n bekleyen adımdan devam eder.

Bu entegrasyon ne yapar?

İş akışını, iş akışı görünümünden başlatırsınız. Sadece prodüksiyon-webhook, POST ve Başlık Doğrulama zorunludur. Alanlar ve n8n'den gelen geri bildirimler isteğe bağlıdır ve bağımsız olarak yapılandırılabilir.

• İş akışında alan yoksa, webhook hemen çağrılır.
• İş akışında alan varsa, önce bir form açılır. Kullanıcı alanları doldurur ve ardından Başlat düğmesiyle iş akışını başlatır.
• Doldurulan değerler, JSON olarak POST isteğiyle n8n webhook'una iletilir.
• Geri bildirim olmadan, AI-Corporate sadece iş akışının başlatıldığını ve ilerlediğini onaylar. Pencere ekranı spinner göstermez ve hemen kapatılabilir.
• Eğer bu kayıt sırasında etkinleştirilmişse, iş akışı bazı ara adımları veya sonunu AI-Corporate'a geri gönderebilir.
• Kayıtta onaylama etkinse, kullanıcı AI-Corporate içinde doğrudan bir seçim yapabilir. Ardından n8n, bekleyen adımdan devam eder.

AI-Corporate içinde n8n iş akışı oluşturma

Bir yöneticinin iş akışını şu şekilde kaydetmesi gerekir:

1. Asistanlar sayfasına gidin.
2. İş Akışlarını açın.
3. Yeni n8n iş akışınını seçin.
4. İş akışının adını ve n8n üretim URL'sini girin.
5. Header authentication bölümünü, bir başlık adı ve gizli başlık değeri ile ayarlayın.
6. n8n'den geri bildirimler altında sadece bu n8n iş akışında gerçekten oluşturulan öğeleri seçin: ilerleme, onay ve/veya iş akışının sonu.
7. POST isteğinde iletilmesi gereken alanları ekleyin.
8. İş akışını kaydedin.

Tüm geri bildirim seçenekleri varsayılan olarak kapalıdır. Sonradan geri arama çağrıları veya bir onay adımı eklediğinizde AI-Corporate'daki kaydı da güncelleyin. Diyalog, yalnızca başlangıç onayını mı göstereceğini yoksa ileri sinyallerini beklemeye devam mı edeceğini bilir.

Alanlar

• Alanlar isteğe bağlıdır.
• Her alanın bir alan adı ve bir türü vardır.
• Desteklenen alan türleri kısa metin, uzun metin, sayı, evet/hayır, tarihi, tek seçim ve çoklu seçimdir.
• Tek seçim ve Çoklu seçim kısmına mevcut seçenekleri ekleyin. Tek seçim kompakt bir seçim listesi olarak gösterilir; Çoklu seçim onay kutuları gösterir. Seçilen değer veya değerler JSON gövdesine iletilir.
• Zorunlu alanlar, iş akışını başlatmadan önce doldurulmalıdır.
• Alan adı, n8n'ye gönderilen JSON gövdesindeki anahtar olacaktır.

n8n ile uyumlu iş akışı nasıl oluşturulur

1. n8n'de yeni bir iş akışı oluşturun.
2. İlk düğüm olarak bir Webhook ekleyin.
3. Bu düğüme adını tam olarak Start workflow olarak verin. Aşağıdaki örnek ifadeler bu adı kullanır.
4. HTTP Method'u POST olarak ayarlayın.
5. Authentication: Header Auth'ı seçin ve AI-Corporate'takiyle aynı başlık adını ve gizli değerini kullanın.
6. Respond veya Response Mode'u Immediately olarak ayarlayın.
7. AI-Corporate'teki alanında, üretim URL'sini kopyalayın. /webhook-test/ test URL'sini kullanmayın.
8. İş akışını etkinleştirin.

Alınan veriler body altında; teknik entegrasyon verileri ise body.integration altında bulunur. Edit Fields, Set veya Code düğümlerinde bunları silmeyin.

JSON body örneği

Alanları prompt, klantnaam, doelgroepen ve datum adlarıyla tanımlarsanız, n8n bu JSON gövdesini örnek olarak alır. AI-Corporate integration nesnesini otomatik olarak ekler.

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

Callbacktoken tek bir yürütme için geçerlidir. Loglarda, sabit yapılandırmada veya diğer sistemlerde saklamayın.

İsteğe bağlı: ilerleme ve bitişi geri göndermek

AI-Corporate yalnızca n8n'in geri bildirimini gösterebilir. Kayıtta etkinleştirdiğiniz durumlarda bu geri bildirimlerin kullanımıyla bu geri çağrıları kullanın: Ara ilerleme bildirimi ve/veya İş akışının sonunu bildirme.

Her bir geri dönüş düğümü şu şekilde ayarlanabilir:

1. Method: POST'u seçin.

2. URL üzerinde Expression'a tıklayın ve şu ifadeyi yapıştırın:

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

3. Authentication: None seçin.

4. Gönderilecek Başlıkları (Send Headers) etkinleştirin ve aşağıdaki başlıkları ekleyin.

5. Gönderilecek Gövdeyi (Send Body) etkinleştirin ve Body Content Type: JSON ile Specify Body: Using JSON seçin.

Aşağıdaki başlıkları kullanın:

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

Örneğin bir adım başladığında şu mesajı gönderin:

{
  "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": "Belgenin oluşturulması başlıyor."
}

• Aynı yürütme içindeki her olay için benzersiz bir eventId kullanın.
• Uygulamada görünen adım etiketinin net bir Dutchçe olması gerekir; bu metin uygulamada gösterilir.
• İş akışının sonunu bildirme etkinse, sonunda daima type: "completed", type: "failed" veya type: "rejected" gönderin.
• completed için çıktı (output) nesnesi eklemek uygun olabilir.
• failed için anlaşılır bir hata mesajı iletin. Uygulama da bu durumda durur.

İsteğe bağlı: uygulamada onay isteme

Bir n8n Wait düğümü ile On Webhook Call kullanın; workflow yalnızca bir karar sonrası devam edecekse. Wait düğümünden önce bir geri çağrı gönderin ve type: "approval_required":

Wait düğümünü şu şekilde ayarlayın: Resume: On Webhook Call, HTTP Method: POST ve Authentication: Header Auth. Start workflow ile aynı Header Auth kimlik bilgisini seçin. Wait düğümünden sonra bir Switch düğümü ekleyin ve içinde {{ $json.body.decision }} kontrol edin.

{
  "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": "Kontrol edin önce üretilen belgeyi.",
    "resumeUrl": "{{ $execution.resumeUrl }}",
    "choices": [
      { "value": "approve", "label": "Goedkeuren" },
      { "value": "reject", "label": "Afwijzen" }
    ]
  }
}

Kullanıcı yürütme penceresinde seçenekleri görür. Bir seçimden sonra Wait düğümü, özellikle decision gibi bir değeri alır. Bundan sonra doğru devamı belirlemek için bir Switch düğümü kullanın.

Bir seçim değeri yalnızca harfler, rakamlar, _ ve - içerebilir. Etiket ise okunabilir metin içerebilir.

Üretim callback-url ayarlama

AI-Corporate için üretim callback-url şu şekildedir:

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

Bu URL'yi sabit metin olarak her geri çağrı düğümüne yapıştırmayın. HTTP İsteği düğümünün URL alanında Expression seçin ve şu ifadeyi kullanın:

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

AI-Corporate böylece her başlangıçta doğru üretim URL'sini otomatik olarak sağlar. Yukarıdaki sabit URL, test sırasında ifadenin AI-Corporate'ı işaret ettiğini doğrulamak için AI-School veya AI-Public'a yönlendirmediğini görmek için kullanılır.

triggerCustomN8nWorkflow, triggerN8nWorkflow ve resumeN8nWorkflow çağrıları uygulama tarafından kendiliğinden çağrılır. Bu URL'leri n8n'de ayarlamanıza gerek yok.

Hataları ele almak

Beklenen hataları, failed türünde bir geri çağrı ile geri döndürün. Ayrıca beklenmeyen düğüm hataları için merkezi bir Hata İş Akışı oluşturun:

1. Yeni bir workflow oluşturun ve bir Error Trigger düğümü ekleyin.

2. Ardından HTTP Request düğümü ekleyin ve Method: POST olarak ayarlayın.

3. URL alanına şu sabit prodüksiyon URL'sini girin:

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

4. Authentication: None seçin ve yönetici platformunun gizli standart değerine sahip olan n8n-handihow-name başlığını ekleyin.

5. JSON gövdesi seçin ve şu içeriği yapıştırın:

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

6. Hata İş Akışını etkinleştirin.
7. Normal iş akışının ayarlarına gidin ve Error Workflow olarak bu iş akışını seçin.

Start workflow sonrası hemen bir geri çağrı gönderin ve en az bir kez executionId: "{{ $execution.id }}" kullanın. Bu şekilde AI-Corporate beklenmeyen bir hatayı doğru yürütmeye bağlayabilir.

Önemli kısıtlamalar

• Yalnızca webhook tetikleyiciler desteklenir.
• Yalnızca prodüksiyon-webhook URL'ler desteklenir.
• /webhook-test/ ile test webhook'ları reddedilir.
• Yalnızca POST desteklenir.
• Yalnızca genel başlık doğrulama desteklenir.
• Başlık değeri uygulamada gizli olarak işlenir.
• CallbackToken'lar ve resume-url'ler yalnızca sunucu tarafında işlenir ve kullanıcılara doğrudan erişilebilir değildir.
• Tenant, giriş yapan kullanıcıdan sunucu tarafında belirlenir; tarayıcının taşıdığı bir değerden bağımsızdır.

Problemler nasıl çözülür

• 404 veya webhook kaydı yok: İş akışını n8n'de etkinleştirin ve prodüksiyon URL'sini kullanın.
• Kimlik doğrulama hatası: başlık adı ve değerinin her iki sistemde de aynı olduğundan emin olun.
• Eksik veri: uygulamadaki alan adlarının, n8n'in beklediği anahtarlarla eşleşip eşleşmediğini kontrol edin.
• n8n'de istek yok: iş akışının bir webhook tetikleyicisiyle başladığından ve POST kullandığından emin olun.
• Yürütme penceresi dönmeyi durduruyorsa: İş akışının sonunu bildirme etkinse, n8n'in son completed, failed veya rejected geri çağrısını gönderip göndermediğini kontrol edin. Geri bildirim yoksa tüm üç seçeneği devre dışı bırakın.
• İlerleme görünmüyorsa: kayıt sırasında Ara ilerleme bildirme açık mı, integration nesnesi korunuyor mu ve her geri çağrıda benzersiz bir eventId var mı kontrol edin.
• Onay düğmeleri çalışmıyorsa: Wait düğümünü, resumeUrl, başlık doğrulamasını ve choices[].value içindeki izin verilen karakterleri kontrol edin.