Dokumentation

Erste Schritte

Willkommen bei Leadara! Diese Anleitung hilft Ihnen beim schnellen Einstieg mit Ihrer eigenen Software-Instanz.

Dashboard

Das Dashboard bietet Ihnen einen Überblick über alle wichtigen Kennzahlen und Aktivitäten.

Übersichtskarten

Lead-Verlauf (Chart)

Das Liniendiagramm zeigt die Entwicklung Ihrer Lead-Eingänge über die letzten 30 Tage. Hovern Sie über einen Datenpunkt, um die exakte Anzahl für diesen Tag zu sehen.

Neueste Leads

Die Tabelle zeigt die 10 zuletzt eingegangenen Leads mit folgenden Informationen:

• Name und E-Mail-Adresse
• Zugehörige Kampagne und Formular
• Lead-Score (Qualitätsbewertung)
• Status (Neu, Kontaktiert, Qualifiziert, Konvertiert, Abgelehnt)
• Eingangsdatum und -uhrzeit

Kampagnen

Kampagnen sind die oberste Organisationsebene in Leadara. Jede Kampagne kann mehrere Formulare enthalten und ermöglicht eine getrennte Auswertung.

Kampagne erstellen

1. Klicken Sie auf Kampagnen → Neue Kampagne
2. Füllen Sie die Pflichtfelder aus:
   • Name: Eindeutiger Kampagnenname (z.B. "Weihnachtsspende 2025")
   • Beschreibung: Interne Notizen zur Kampagne (optional)
   • Budget: Geplantes Budget für Tracking-Zwecke (optional)
   • Status: Aktiv oder Pausiert
3. Klicken Sie auf Speichern

Kampagnen-Übersicht

In der Kampagnen-Liste sehen Sie:

• Kampagnenname und Status
• Anzahl zugeordneter Formulare
• Gesamtzahl der Leads
• Leads diesen Monat
• Durchschnittlicher Lead-Score
• Erstellungsdatum

Kampagnen-Detailseite

Auf der Detailseite einer Kampagne finden Sie:

• Statistiken: Detaillierte Kennzahlen zur Kampagnenperformance
• Zugeordnete Formulare: Liste aller Formulare dieser Kampagne
• Lead-Liste: Alle Leads dieser Kampagne mit Filter- und Exportfunktion
• Webhooks: Konfigurierte Integrationen für diese Kampagne

Formulare

Formulare sind das Herzstück der Lead-Generierung. Hier konfigurieren Sie, welche Daten erfasst werden und wie das Formular aussieht.

Formular erstellen

1. Navigieren Sie zu Formulare → Neues Formular
2. Konfigurieren Sie die Grundeinstellungen:
   • Name: Interner Formularname
   • Kampagne: Zuordnung zu einer Kampagne
   • Beschreibung: Interne Notizen (optional)
   • Status: Aktiv oder Inaktiv

Opt-In Einstellungen

Datenschutz-Einstellungen

• Datenschutz-Checkbox: Pflicht-Checkbox für Datenschutzerklärung
• Checkbox-Text: Anpassbarer Text (z.B. "Ich habe die Datenschutzerklärung gelesen")
• Link zur Datenschutzerklärung: URL Ihrer Datenschutzseite

Bestätigungsseite

Nach erfolgreicher Formularabsendung können Sie konfigurieren:

• Dankesnachricht: Text der auf der Bestätigungsseite angezeigt wird
• Weiterleitung: Optional: URL für automatische Weiterleitung

Formular-Builder

Mit dem visuellen Formular-Builder erstellen Sie Formulare per Drag & Drop ohne Programmierkenntnisse.

Verfügbare Feldtypen

Feld hinzufügen

1. Öffnen Sie den Formular-Builder über Formulare → [Formular] → Builder
2. Klicken Sie auf + Feld hinzufügen
3. Wählen Sie den Feldtyp aus
4. Konfigurieren Sie:
   • Feldname: Technischer Name (z.B. "first_name")
   • Label: Angezeigter Text (z.B. "Vorname")
   • Platzhalter: Hinweistext im leeren Feld
   • Pflichtfeld: Ja/Nein
   • Validierung: Zusätzliche Regeln
5. Klicken Sie auf Speichern

Felder sortieren

Ziehen Sie Felder per Drag & Drop in die gewünschte Reihenfolge. Die Sortierung wird automatisch gespeichert.

Design anpassen

Unter Design können Sie das Erscheinungsbild anpassen:

• Theme: Vordefinierte Farbschemata (Standard, Dunkel, Hell)
• Primärfarbe: Hauptfarbe für Buttons und Akzente
• Hintergrundfarbe: Formular-Hintergrund
• Textfarbe: Farbe für Labels und Text
• Rahmenradius: Abrundung der Ecken
• Button-Text: Beschriftung des Absende-Buttons
• Eigenes CSS: Benutzerdefinierte Styles

Lead-Verwaltung

Alle eingegangenen Leads werden zentral verwaltet und können gefiltert, exportiert und bearbeitet werden.

Lead-Status

Validierungsstatus

Ungültigkeitsgründe

• Duplikat: Lead existiert bereits
• Fake-Daten: Offensichtlich falsche Angaben
• Testeintrag: Eigener Testdatensatz
• Unvollständig: Wichtige Felder fehlen
• Spam: Automatisierter/unerwünschter Eintrag
• Sonstiges: Anderer Grund

Lead-Export

Exportieren Sie Leads als CSV- oder Excel-Datei:

1. Filtern Sie die gewünschten Leads
2. Klicken Sie auf Export
3. Wählen Sie das Format (CSV oder XLSX)
4. Die Datei wird heruntergeladen

Lead-Filter

Filtern Sie Leads nach:

• Kampagne
• Formular
• Status
• Validierungsstatus
• Zeitraum (von - bis)
• Lead-Score (Mindest-/Maximalwert)
• Freitextsuche (Name, E-Mail)

Lead-Scoring

Das Lead-Scoring bewertet eingehende Leads automatisch nach von Ihnen definierten Regeln. So erkennen Sie sofort die wertvollsten Leads.

Scoring-Regeln erstellen

1. Navigieren Sie zu Lead-Scoring → Neue Regel
2. Konfigurieren Sie:
   • Name: Beschreibender Name der Regel
   • Kampagne/Formular: Geltungsbereich (optional)
   • Bedingung: Wann die Regel greift
   • Punkte: Positive oder negative Punktzahl

Verfügbare Bedingungen

Standard-Regeln erstellen

Klicken Sie auf Standard-Regeln erstellen um bewährte Scoring-Regeln automatisch anzulegen:

• Business-E-Mail Bonus (+15)
• Telefon angegeben (+10)
• Firma angegeben (+10)
• Freemail-Abzug (-5)

Scores neu berechnen

Nach Änderung der Regeln können Sie alle bestehenden Leads neu bewerten lassen: Lead-Scoring → Neu berechnen

Webhooks & Integrationen

Webhooks senden Lead-Daten in Echtzeit an externe Systeme. So können Sie Leadara mit Ihrem CRM, E-Mail-Marketing oder anderen Tools verbinden.

Vorkonfigurierte Integrationen

Webhook einrichten

1. Öffnen Sie eine Kampagne
2. Navigieren Sie zum Tab Webhooks
3. Wählen Sie eine Integration aus
4. Konfigurieren Sie die Verbindung:
   • E-Mail: Empfänger-Adresse
   • Slack: Webhook-URL aus Slack
   • HubSpot: API-Key oder OAuth
   • Custom: URL, Methode, Header
5. Testen Sie die Verbindung
6. Aktivieren Sie den Webhook

Webhook-Logs

Unter Webhooks → Logs sehen Sie:

• Zeitpunkt der Ausführung
• Ziel-URL
• HTTP-Statuscode
• Gesendete Daten (JSON)
• Antwort des Servers
• Fehler bei fehlgeschlagenen Requests

Webhook-Payload

Ein typischer Webhook sendet folgende Daten:

{
  "event": "lead.created",
  "timestamp": "2025-12-17T14:30:00Z",
  "lead": {
    "id": 12345,
    "first_name": "Max",
    "last_name": "Mustermann",
    "email": "max@beispiel.de",
    "phone": "+49 123 456789",
    "company": "Musterfirma GmbH",
    "score": 75,
    "status": "new"
  },
  "campaign": {
    "id": 1,
    "name": "Spendenaktion 2025"
  },
  "form": {
    "id": 5,
    "name": "Kontaktformular"
  }
}

Formular-Einbettung

Formulare können auf verschiedene Arten in Ihre Website integriert werden.

Methode 1: JavaScript Embed (Empfohlen)

Das Formular wird asynchron geladen und passt sich automatisch an:

<div id="spendara-form-XXXXX"></div>
<script src="https://app.spendara.de/embed/XXXXX.js" async></script>

Vorteile:

• Automatische Höhenanpassung
• Responsives Design
• DSGVO-konform (Daten werden erst bei Interaktion geladen)
• Tracking von Formularaufrufen

Methode 2: iFrame

Klassische Einbettung per iFrame:

<iframe
  src="https://app.spendara.de/form/XXXXX"
  width="100%"
  height="500"
  frameborder="0"
></iframe>

Hinweis: Bei iFrame müssen Sie die Höhe manuell anpassen.

Methode 3: Direktlink

Verlinken Sie direkt auf die gehostete Formularseite:

https://app.spendara.de/form/XXXXX

Ideal für E-Mail-Kampagnen oder Social Media.

Methode 4: Landing Page

Leadara hostet eine vollständige Landing Page mit Ihrem Formular:

https://app.spendara.de/l/ihr-formular-name

URL-Parameter

Übergeben Sie Werte per URL an Hidden-Felder:

https://app.spendara.de/form/XXXXX?utm_source=google&utm_campaign=winter

Die Parameter werden automatisch in gleichnamige Hidden-Felder übernommen.

Double-Opt-In (DOI)

Das Double-Opt-In Verfahren stellt sicher, dass nur verifizierte E-Mail-Adressen in Ihre Lead-Datenbank gelangen.

Ablauf

1. Formular-Absendung: Nutzer füllt das Formular aus
2. Bestätigungsmail: System sendet E-Mail mit Bestätigungslink
3. Klick auf Link: Nutzer bestätigt seine E-Mail-Adresse
4. Lead-Erfassung: Lead wird als "bestätigt" gespeichert

E-Mail konfigurieren

Unter Formular → E-Mail-Einstellungen können Sie anpassen:

• Absendername: z.B. "Ihre Organisation"
• Absender-E-Mail: z.B. "info@ihre-domain.de"
• Betreff: z.B. "Bitte bestätigen Sie Ihre Anmeldung"
• E-Mail-Text: Mit Platzhaltern für Name und Link

Verfügbare Platzhalter

Token-Gültigkeit

Der Bestätigungslink ist standardmäßig 48 Stunden gültig. Nach Ablauf muss der Nutzer das Formular erneut ausfüllen.

Abrechnung & Pläne

Als Lizenznehmer der Leadara-Software haben Sie die vollständige Kontrolle über Ihre Preisgestaltung und Paketstruktur.

Pläne konfigurieren (Admin-Bereich)

Im Admin-Bereich unter Einstellungen → Pläne können Sie:

• Beliebig viele Pläne erstellen: Starter, Pro, Enterprise - oder ganz eigene Namen
• Preise frei festlegen: Monatlich, jährlich oder beides mit individuellen Rabatten
• Limits definieren: Leads pro Monat, Anzahl Formulare, Kampagnen, etc.
• Features zuweisen: Welcher Plan enthält Webhooks, API-Zugang, Lead-Scoring, etc.
• Testphasen einrichten: Kostenlose Testzeiträume pro Plan

Konfigurierbare Plan-Eigenschaften

Beispiel-Konfiguration

So könnte Ihre Preisstruktur aussehen:

Zahlungsmethoden konfigurieren

Unter Einstellungen → Zahlungen aktivieren Sie die gewünschten Zahlungsarten:

• Stripe: Kreditkarten (Visa, Mastercard, Amex) und SEPA-Lastschrift
• PayPal: Einmalzahlung oder wiederkehrende Zahlungen
• Rechnung: Manuelle Zahlungsabwicklung

Kundensicht: Plan wechseln

Ihre Kunden können im Portal selbstständig:

1. Zu Abrechnung → Pläne navigieren
2. Die verfügbaren Pläne vergleichen
3. Bei Upgrade: Sofortige Aktivierung mit anteiliger Berechnung
4. Bei Downgrade: Aktivierung zum Ende der Abrechnungsperiode

Rechnungsverwaltung

Alle Rechnungen werden automatisch generiert. Sie können anpassen:

• Rechnungsnummer-Format: z.B. "RE-2025-0001"
• Firmenlogo: Erscheint auf allen Rechnungen
• Fußzeile: Bankverbindung, Steuernummer, etc.
• Zahlungsziel: Anzahl Tage bis zur Fälligkeit

Profil & Einstellungen

Verwalten Sie Ihre Account-Daten und Unternehmenseinstellungen.

Profil bearbeiten

Unter Profil können Sie ändern:

• Firmenname und Ansprechpartner
• E-Mail-Adresse (Login)
• Telefonnummer
• Website-URL
• Passwort

Rechnungsadresse

Die Rechnungsadresse wird für alle Rechnungen verwendet:

• Firmenname
• Straße und Hausnummer
• PLZ und Stadt
• Land
• USt-IdNr. (optional)

Benachrichtigungen

Konfigurieren Sie, wann Sie per E-Mail informiert werden:

• Neuer Lead eingegangen
• Lead-Score über Schwellwert
• Wöchentliche Zusammenfassung
• Abo läuft aus
• Limit fast erreicht

API-Zugang

Die REST-API ermöglicht programmatischen Zugriff auf Ihre Daten. Verfügbar ab dem Professional-Plan.

API-Key erstellen

1. Gehen Sie zu Profil → API-Keys
2. Klicken Sie auf Neuer API-Key
3. Vergeben Sie einen Namen (z.B. "CRM Integration")
4. Kopieren Sie den Key (wird nur einmal angezeigt!)

Authentifizierung

Senden Sie den API-Key im Header:

Authorization: Bearer YOUR_API_KEY

Verfügbare Endpunkte

Beispiel-Request

curl -X GET "https://app.spendara.de/api/v1/leads?status=new&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Rate Limiting

API-Anfragen sind limitiert:

• Professional: 100 Requests/Minute
• Business: 500 Requests/Minute
• Enterprise: Individuell vereinbart