n8n Webhook ve Desk360 Public API Kullanım

🧩 Giriş

n8n, görsel tabanlı bir otomasyon aracıdır. Her akış (workflow) tetikleyici (trigger) ve aksiyon (action) adımlarından oluşur.

Bu adımda, en çok kullanılan iki node olan Webhook ve HTTP Request node'larının nasıl kullanılacağını anlatıyoruz.

🧠 1. Webhook Node Nedir?

Webhook Node, dış sistemlerden (örneğin bir web formu, CRM, veya API) gelen HTTP isteklerini (POST, GET vb.) yakalayarak n8n akışını başlatır.

🔹 Örnek Kullanım Senaryosu

Whatsapp Business API numaranıza mesaj geldiğinde otomatik olarak n8n webhook workflow'unu tetiklemek

⚙ 2. Webhook Node Ayarları

Ayar Açıklama

HTTP Method GET, POST, PUT vb. -- genellikle POST kullanılır.

Path Webhook'un URL'sinin son kısmı. Örnek: /new-message

Response Mode On Received (istek gelir gelmez cevap döner) veya Last Node

(workflow tamamlanınca cevap döner).

Response Data İsteğe dönecek JSON veya metin cevabı.

🔹 Örnek Kurulum

Method: POST

Path: /new-message

Response Mode: Last Node

Workflow URL:

https://n8n.yourdomain.com/webhook/new-message

Bu durumda, workflow'u tetikler.

/webhook/new-message adresine gönderilen tüm HTTP POST istekleri bu workflowu tetikler.

🧩 3. HTTP Request Node Nedir?

HTTP Request Node, n8n içinden başka bir servise veya API' ye istek göndermeni sağlar.

Bu, diğer sistemlerle entegrasyon kurmanın temel yöntemidir.

🔹 Örnek Kullanım Senaryosu

Desk360 Public API'ye mesaj gönderme

⚙ 4. HTTP Request Node Ayarları

Method GET, POST, PUT, PATCH, DELETE -- isteğin türünü belirtir.

URL API adresi (örnek: https://public-api.desk360.com/...)

Authentication Basic Auth, OAuth2, Header Token gibi yetkilendirme seçenekleri

Headers Content-Type, Authorization vb. özel başlıklar

Body JSON, form-data, URL encoded formatında gönderilecek veri

Response Format JSON, Text, veya Binary

🧾 5. Webhook → AI Message Model → HTTP Request Akışı

Örneği

Bu örnek, Whatsapp Business API numaranıza mesaj geldiğinde Desk360 Public API ayarları

sayfasından ayarlanan webhook url'e POST isteği gönderir. Otomatik olarak n8n webhook

workflow'unu tetikler bu gelen POST isteğini alıp AI modelinde işleyip, AI'dan dönen yanıtı

Desk360 Public API aracılığıyla mesaj gönderen numaraya mesaj gönderir.

NOT: Webhook node kullanabilmek için Desk360 Public API ayarları sayfasından webhook

url'inizi eklemeniz gerekmektedir.

🔹 Adım 1: Webhook Node

Method: POST\

Path: /webhook/new-message\

Response Mode: Last Node

Örnek gelen veri:

{
  "messages": {
    "id": "ABEGkFMIcyRoAgo-sGaD-H6MgPEt",
    "text": "Hello",
    "from": "90xxxxxxxxxx",
    "timestamp": "1630913975",
    "name": "John Doe",
    "type": "text"
  }
}

🔹 Adım 2: AI Message Model Node (Opsiyonel)

Model: Gpt-4.1-mini veya başka bir model\

Input: Sen bir müşteri destek temsilcisi yerine yanıt veren bir chat botsun. Gelen mesaja göre uygun, yalın bir dilde mesaj dönmelisin. Mesaj: {{ $json.body.messages.text}}\

🔹 Adım 3: Desk360 Public API ile Mesaj Gönderme

Method: POST
URL: https://public-api.desk360.com/v1/integrations/:integrationId/conversations/messages
Headers:
  Authorization: Bearer <API_KEY>
  Content-Type: application/json
Body (JSON):
{
  "to": "+{{ $('Webhook').item.json.body.messages.from }}",
  "text": "{{ $json.message.content.response }}"
}

🔹 Adım 3: Webhook Response (Opsiyonel)

Node tipi: Respond to Webhook\

Response Data:

{ "status": "Message sent successfully" }

🧠 6. Örnek Workflow JSON

Aşağıdaki JSON, yukarıdaki örneğin n8n'e direkt import edilebilen halidir:

{
  "name": "Desk360-PublicApi",
  "nodes": [
    {
      "parameters": {
        "httpMethod": "POST",
        "path": "5012e5b7-e22b-4c0e-927d-",
        "authentication": "headerAuth",
        "options": {}
      },
      "type": "n8n-nodes-base.webhook",
      "typeVersion": 2.1,
      "position": [
        0,
        0
      ],
      "id": "32724226-6ec0-404f-9a54-",
      "name": "Webhook",
      "webhookId": "5012e5b7-e22b-4c0e-927d-",
      "credentials": {
        "httpHeaderAuth": {
          "id": "scRqgJBSllnf21C8",
          "name": "Header Auth account"
        }
      }
    },
    {
      "parameters": {
        "modelId": {
          "__rl": true,
          "value": "gpt-4.1-mini",
          "mode": "list",
          "cachedResultName": "GPT-4.1-MINI"
        },
        "messages": {
          "values": [
            {
              "content": "=Sen bir müşteri destek temsilcisi yerine yanıt veren bir chat botsun. Gelen mesaja göre uygun, yalın bir dilde mesaj dönmelisin.\nMesaj: {{ $json.body.messages.text }}"
            }
          ]
        },
        "jsonOutput": true,
        "options": {}
      },
      "type": "@n8n/n8n-nodes-langchain.openAi",
      "typeVersion": 1.8,
      "position": [
        208,
        0
      ],
      "id": "787749b6-09d0-42e4-99a0-",
      "name": "Message a model",
      "credentials": {
        "openAiApi": {
          "id": "Dk5hN5YnS94m3tpU",
          "name": "n8n free OpenAI API credits"
        }
      }
    },
    {
      "parameters": {
        "method": "POST",
        "url": "https://public-api.desk360.com/v1/integrations/:integrationId/conversations/messages",
        "authentication": "genericCredentialType",
        "genericAuthType": "httpBearerAuth",
        "sendBody": true,
        "specifyBody": "json",
        "jsonBody": "={\n \"to\": \"+{{ $('Webhook').item.json.body.messages.from }}\",\n \"text\": \"{{ $json.message.content.response }}\"\n}",
        "options": {}
      },
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        560,
        0
      ],
      "id": "ce449f17-ed1b-42ee-80e9-",
      "name": "HTTP Request",
      "credentials": {
        "httpBearerAuth": {
          "id": "vHYqOLNzLykjmQGl",
          "name": "Bearer Auth account"
        }
      }
    }
  ],
  "pinData": {},
  "connections": {
    "Webhook": {
      "main": [
        [
          {
            "node": "Message a model",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Message a model": {
      "main": [
        [
          {
            "node": "HTTP Request",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  }
}

✅ 7. Sonuç

Bu dokümantasyon sayesinde:

• n8n'de webhook oluşturabilir,

• Gelen verileri alıp işleyebilir,

• HTTP Request node ile Desk360 Public API' ye istek gönderebilirsin.