Brevo Setup – Schritt-für-Schritt Anleitung

[koos]

🎯 Ziel

Vollständiges Brevo Setup für Lead Management und E-Mail Automation.

---

📋 Schritt 1: Brevo Account erstellen

Falls noch nicht vorhanden: https://www.brevo.com/de/

✅ Kostenlos bis 300 E-Mails/Tag

---

📋 Schritt 2: Kontakt-Attribute anlegen

Gehe zu: Contacts → Settings → Contact Attributes

Erstelle diese Custom Attributes:

Attribut Name	Typ	Beschreibung
COMPANY	Text	Unternehmen
ROLE	Text	Rolle (GF, Dev, etc.)
USE_CASE	Text	Beschreibung Use Case
SOURCE	Text	Woher gekommen (Google, etc.)
INTEREST_TYPE	Text	lead-general, lead-demo, lead-technical
LEAD_SCORE	Number	Lead Score (0-100)
MEETING_BOOKED	Boolean	Termin gebucht?
MEETING_DATE	Date	Datum des Termins
MEETING_TYPE	Text	erstgespraech, demo, deep-dive
UTM_SOURCE	Text	UTM Parameter
UTM_MEDIUM	Text	UTM Parameter
UTM_CAMPAIGN	Text	UTM Parameter
LANGUAGE	Text	de oder en

---

📋 Schritt 3: Listen erstellen

Gehe zu: Contacts → Lists → Create a list

Listen-Name	Beschreibung
EBICS Box - Neue Leads	Alle neuen Kontaktanfragen
EBICS Box - Demo angefragt	Leads die Demo wollen
EBICS Box - Meeting gebucht	Haben Calendly-Termin
EBICS Box - Kunden	Zahlende Kunden
EBICS Box - Newsletter	Wenn du einen Newsletter willst

---

📋 Schritt 4: API Key erstellen

Gehe zu: Settings → API Keys → Create a new API key

• Name: EBICS Box Website
• Permissions: Alle (oder mindestens Contacts + Email)

⚠️ Kopiere den API Key – den brauchst du für Lovable/Vercel.

BREVO_API_KEY=xkeysib-xxx...

---

📋 Schritt 5: Double Opt-In Template erstellen

Gehe zu: Campaigns → Templates → Create Template

Template 1: Double Opt-In (DE)

Subject: Bitte bestätigen Sie Ihre Anfrage – EBICS Box

Hallo {{contact.FIRSTNAME}},

vielen Dank für Ihr Interesse an EBICS Box!

Bitte bestätigen Sie Ihre E-Mail-Adresse:

[BUTTON: Anfrage bestätigen] → {{ doubleoptin }}

Nach der Bestätigung melden wir uns innerhalb von 24 Stunden bei Ihnen.

Viele Grüße
Jan Kus
EBICS Box / Railslove

---
Sie erhalten diese E-Mail, weil Sie das Kontaktformular auf ebicsbox.com ausgefüllt haben.

---

Template 2: Willkommen nach DOI (DE)

Subject: Ihre Anfrage ist eingegangen – EBICS Box

Hallo {{contact.FIRSTNAME}},

Ihre Anfrage ist bei uns eingegangen. 

Was Sie uns geschrieben haben:
"{{contact.USE_CASE}}"

Wir melden uns innerhalb von 24 Stunden bei Ihnen – meistens schneller.

In der Zwischenzeit können Sie:
- Einen Termin direkt buchen: https://calendly.com/jankus
- Unsere Dokumentation ansehen: https://ebicsbox.com/docs
- Use Cases durchstöbern: https://ebicsbox.com/use-cases

Viele Grüße
Jan Kus
Gründer EBICS Box

---
EBICS Box ist ein Produkt von Railslove GmbH
An der Bottmühle 5, 50678 Köln

---

📋 Schritt 6: Interne Benachrichtigung einrichten

Gehe zu: Automation → Create Automation

Trigger

Contact added to list "EBICS Box - Neue Leads"

Action

Send email to jan@railslove.com

Subject: 🔔 Neuer EBICS Box Lead: {{contact.COMPANY}}

Neuer Lead auf ebicsbox.com!

Name: {{contact.FIRSTNAME}} {{contact.LASTNAME}}
Email: {{contact.EMAIL}}
Unternehmen: {{contact.COMPANY}}
Rolle: {{contact.ROLE}}

Use Case:
{{contact.USE_CASE}}

Quelle: {{contact.SOURCE}}
Interesse: {{contact.INTEREST_TYPE}}

→ In Brevo öffnen: [Link zum Kontakt]
→ Direkt anrufen/mailen

---

📋 Schritt 7: Website Integration

Jetzt brauchst du die Verbindung Website → Brevo.

Option A: Brevo API direkt (empfohlen) ✅

Du brauchst eine Server-Funktion (Vercel Edge Function, Cloudflare Worker, etc.)

Vorteile:

• ✅ Volle Kontrolle über Design
• ✅ Custom Validation
• ✅ UTM Parameter Tracking
• ✅ Keine Brevo-Branding

Implementation:

// /api/contact.ts (Vercel Edge Function)
export async function POST(request: Request) {
  const data = await request.json();
  
  const response = await fetch("https://api.brevo.com/v3/contacts", {
    method: "POST",
    headers: {
      "api-key": process.env.BREVO_API_KEY,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      email: data.email,
      attributes: {
        FIRSTNAME: data.name.split(" ")[0],
        LASTNAME: data.name.split(" ").slice(1).join(" "),
        COMPANY: data.company || "",
        USE_CASE: data.message,
        INTEREST_TYPE: data.interest,
        SOURCE: "website",
        LANGUAGE: data.language || "de"
      },
      listIds: [YOUR_LIST_ID],
      updateEnabled: true
    })
  });
  
  return Response.json({ success: true });
}

---

Option B: Brevo Forms (einfacher)

Brevo hat eingebaute Formulare die du embedden kannst.

Vorteile:

• ✅ Schnellerer Setup
• ✅ Kein Server-Code nötig

Nachteile:

• ❌ Brevo-Styling
• ❌ Weniger Kontrolle
• ❌ Externe Dependency sichtbar

---

⚙️ Environment Variables

# .env.local
BREVO_API_KEY=xkeysib-xxxxxxxxxxxxxxxxxxxxxxxxxx
BREVO_LIST_ID_NEW_LEADS=123

---

✅ Checkliste

• Brevo Account erstellt
• 13 Custom Attributes angelegt
• 5 Listen erstellt
• API Key generiert und gespeichert
• Double Opt-In Template (DE) erstellt
• Willkommens-Template (DE) erstellt
• Interne Benachrichtigung Automation aktiv
• Website Integration gewählt (Option A oder B)
• Test-Lead erfolgreich angelegt

---

🔗 Verknüpfte Issues

• Brevo Integration – Lead Management & E-Mail Automation #13 Brevo Integration – Lead Management
• Lead Nurturing – E-Mail Automation Sequences #16 Lead Nurturing – E-Mail Sequences
• Lead Scoring & Qualification #17 Lead Scoring & Qualification

---

📁 Referenz: 20-brevo-setup.md
🏷️ Labels: brevo, integration
⚡ Priority: P0
⏱️ Estimate: 1-2h