# n8n

This guide demonstrates how to integrate Scorable Judges into an n8n workflow to evaluate and refine AI-generated responses before delivering them to users.

## Architecture Overview

The flow is as follows: User → Website Chatbot → n8n Webhook → HTTP Request (Scorable Judge) → Refined AI Response → Website

## Prerequisites

* An n8n instance (Cloud or Self-hosted)
* A Scorable account
* A website where the chatbot will be embedded

***

## Step 1: Create a Webhook Node in n8n

1. Open a new workflow canvas in n8n.
2. Add a **Webhook** node.

**Webhook Settings:**

* **HTTP Method**: `POST`
* **Webhook URL Type**: `Product URL`
* **Path**: Copy and paste the last segment of the Product URL

**CORS Configuration:**

* Enable **Allowed Origins (CORS)**
* Add your website domain (e.g., `https://yourwebsite.com`)

***

## Step 2: Create a Judge on Scorable

Create a **Judge** on Scorable and define the chatbot's scope, tone of voice, and evaluation rules.

![scorableai](https://github.com/user-attachments/assets/35301c66-03b2-453b-97e7-5e8db8aedd35)

After creation, copy the following values:

* **Judge ID**
* **API Key**

![kod](https://github.com/user-attachments/assets/fffb1fa9-1e0c-48cf-b6a8-358019af31a5)

***

## Step 3: Configure the HTTP Request Node

Add an **HTTP Request** node in n8n.

![req](https://github.com/user-attachments/assets/7f79a8e4-e19e-4321-8ca4-6aa06fec921d)

**Basic Configuration:**

* **Method**: `POST`
* **URL**:

  ```
  https://api.scorable.ai/v1/judges/JUDGE_ID/refine/openai/chat/completions
  ```

  *(Replace `JUDGE_ID` with your own judge ID)*

**Headers:**

Enable **Send Headers** and add:

| Name          | Value                  |
| ------------- | ---------------------- |
| Content-Type  | `application/json`     |
| authorization | `Api-Key YOUR_API_KEY` |

***

## Step 4: Configure the Request Body

Enable **Send Body** and configure the request as JSON.

```json
{
  "model": "gpt-5.2",
  "messages": [
    {
      "role": "system",
      "content": "WRITE YOUR OWN SYSTEM PROMPT HERE. Define who your chatbot is, how it should behave, and what kind of answers it should give."
    },
    {
      "role": "user",
      "content": "{{$json.body.message}}"
    }
  ]
}
```

***

## Step 5: Respond to the Webhook

Add a **Respond to Webhook** node.

**Response Body:**

```javascript
{{
  {
    "reply": $node["HTTP Request"].json["choices"][0]["message"]["content"]
  }.toJsonString()
}}
```

**Response Headers:**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

***

## Final Result

The n8n workflow will now handle user messages, send them to Scorable for evaluation and refinement, and return only the approved responses.

![flow end](https://github.com/user-attachments/assets/5987d460-f73b-4daf-a8d8-2479a13e63f9)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.scorable.ai/integrations/n8n.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.