Voraussetzungen

Bevor du startest, stelle sicher, dass du folgendes zur Hand hast:

• Eine aktive amber-Instanz mit API-Zugang

• Deinen amber API-Key (zu finden in den Benutzereinstellungen unter Zugriffsschlüssel)

• Eine laufende n8n-Instanz (Cloud oder self-hosted)

Schritt 1: API-Key in amber abrufen

Öffne amber und navigiere zu Benutzereinstellungen → Zugriffsschlüssel. Dort kannst du deinen persönlichen API-Key generieren. Kopiere ihn – du brauchst ihn gleich in n8n.

Hinweis: Behandle deinen API-Key wie ein Passwort. Teile ihn nicht öffentlich und speichere ihn sicher, weil du ihn nur einmal ansehen kannst.

Schritt 2: HTTP Request Node in n8n einrichten

amber bietet eine REST-API, über die du Suchanfragen stellen und KI-Antworten abrufen kannst. In n8n verwendest du dafür den HTTP Request-Node.

1. Füge in deinem Workflow einen neuen Node hinzu und wähle HTTP Request.

2. Stelle die Methode auf POST.

3. Trage als URL deine amber-API-Adresse ein, zum Beispiel: https://app.ambersearch.de/api/v1/chat

4. Wechsle zu Authentification und wähle "Preffered Credential Type".

5. Es wird ein neues Feld "Credential Type" auftauchen, wo du "Bearer Auth" wählen sollst.

6. Klick auf das Feld dadrunter und erstelle "New Credential".

7. Ins Feld "Bearer Auth" setz deine API ein und klick auf "Speichern".

8. Setz außerdem den Header Content-Type auf application/json.

   

Schritt 3: Anfrage-Body konfigurieren

Im Bereich Body des HTTP Request-Nodes wählst du den Typ JSON und trägst deine Anfrage ein. Ein einfaches Beispiel sieht so aus:

Example
HTML
Copy
  {
        "model": "telekom-gpt-4o",
        "temperature": 0.7,
        "stream": False,
        "tools": [],
        "messages": [
            {"role": "system", "content": "You are a helpful assistant."},
            {
                "role": "user",
                "content": "What would be the best activity to do in summer in Paris?",
            },
        ],
    },

Du kannst die Werte dynamisch befüllen, indem du n8n-Ausdrücke verwendest, zum Beispiel {{ $json.userInput }}, um die Werte aus einem vorherigen Node zu übernehmen.

Schritt 4: Antwort verarbeiten

Nach einem erfolgreichen API-Aufruf gibt amber eine JSON-Antwort zurück. Das Ergebnis der KI findest du im Feld answer. Du kannst diesen Wert in nachfolgenden Nodes weiterverwenden – etwa um ihn per Slack zu verschicken, in eine Tabelle zu schreiben oder in einer E-Mail zurückzugeben.

Ein Beispiel für die Ausgabe:

Example
HTML
Copy
{
  "content": "Laut unserer internen Richtlinie stehen dir 30 Urlaubstage pro Jahr zu.",
  "sources": [...]
}

Hinweis: Wenn du Informationen in einem spezifischen Format brauchst, dann solltest du noch einen zusätzlichen Code-Node danach einfügen. Das wird dir helfen, einen "sauberen" JSON zu bekommen. Hier ist ein Beispiel vom solchen Code mit JavaScript:

Example
HTML
Copy
// Extract the assistant message content from AmberSearch response
const choices = $input.item.json.choices;
if (!choices || choices.length === 0) {
  throw new Error('No choices returned from AmberSearch API');
}

// The content may be a string or an object depending on the model
const rawContent = choices[0]?.message?.content ?? choices[0]?.text ?? '';

// Strip any accidental markdown fences
const cleaned = rawContent.replace(/```json|```/gi, '').trim();

let parsed;
try {
  parsed = JSON.parse(cleaned);
} catch (e) {
  // Fallback: return nulls rather than crashing the entire run
  parsed = { knowledge_workers: null, industry: null, annual_revenue_eur: null };
}

return {
  json: {
    'Contact ID': $('Loop Over Items1').item.json.id,
    'Company': parsed.company ?? null,
    'Location': parsed.company_location ?? null,
    'Knowledge Workers': parsed.knowledge_workers ?? null,
    'Industry': parsed.industry ?? null,
    'Sub-industry': parsed.sub_industry ?? null,
    'Annual Revenue (€)': parsed.annual_revenue_eur ?? null
  }
};

Beispiel-Workflow: HubSpot mit amber verbinden

Ein häufiger Anwendungsfall ist die CRM-Verwaltung und Datenanreicherung durch einen Workflow:

• Trigger: Ein neuer HubSpot-Kontakt wird erstellt (HubSpot Trigger Node)

• Verarbeitung: HTTP-Request an amber mit der Nachricht als Query

• Antwort: Die automatisch recherchierten Informationen aus der amber-Antwort werden im HubSpot-Kontakt hinterlegt

Dieser Workflow lässt sich in n8n in wenigen Minuten aufbauen und ermöglicht es deinen Mitarbeitern, die amber-KI-Funktionalität sofort im CRM anzuwenden.

Falls du Fragen zur amber-API hast oder Unterstützung beim Aufbau deines Workflows benötigst, wende dich an unser Support-Team.