> ## Documentation Index
> Fetch the complete documentation index at: https://docs.salesfrank.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Leads

> Kontakte in einer Kampagne verwalten – hochladen, einsehen und Status nachverfolgen.

## Überblick

Der Tab **Leads** ist das interne CRM einer Kampagne. Hier werden alle Kontakte verwaltet, die Frank im Rahmen dieser Kampagne anrufen soll oder bereits angerufen hat. Du siehst für jeden Lead den aktuellen Status und das Gesprächsergebnis.

***

## Lead-Felder

### Standardfelder

| Feld          | Spaltenname im CSV | Pflichtfeld | Hinweise                                                          |
| ------------- | ------------------ | ----------- | ----------------------------------------------------------------- |
| Telefonnummer | `phone_number`     | ✅ Ja        | Muss im **E.164-Format** angegeben werden (z. B. `+491701234567`) |
| Vorname       | `first_name`       | Nein        |                                                                   |
| Nachname      | `last_name`        | Nein        |                                                                   |
| Unternehmen   | `company`          | Nein        |                                                                   |
| E-Mail        | `email`            | Nein        | Muss eine korrekt formatierte E-Mail-Adresse sein                 |

<Warning>
  Die Spalte für die Telefonnummer **muss** im CSV exakt `phone_number` heißen. Andere Bezeichnungen wie `Telefon`, `telefon` oder `Tel` werden nicht erkannt und führen zu einem Import-Fehler.
</Warning>

### Benutzerdefinierte Felder

Neben den Standardfeldern kannst du beliebige eigene Variablen hinzufügen, um die Anrufe zu personalisieren. Diese Variablen stehen dann im Agenten-Prompt sowie in der Startnachricht zur Verfügung (z. B. `{{branche}}`, `{{produkt_interesse}}`).

***

## Leads hochladen

### Manuell

Klicke auf **Lead hinzufügen** und fülle das Formular direkt im Dashboard aus.

### CSV- oder Excel-Datei

Lade eine `.csv`- oder `.xlsx`-Datei hoch. SalesFrank validiert automatisch die korrekte Formatierung der Telefonnummern und E-Mail-Adressen und pflegt die Leads ein.

**Vorlage CSV-Datei (Download-Format):**

```csv theme={null}
phone_number,first_name,last_name,company,email
+491701234567,Max,Mustermann,Musterfirma GmbH,max@musterfirma.de
+491709876543,Anna,Beispiel,Beispiel AG,anna@beispiel.de
```

Du kannst diese Struktur als Vorlage verwenden und mit deinen eigenen Leads befüllen. Zusätzliche Spalten (z. B. `branche`, `produkt_interesse`) sind ebenfalls möglich und stehen dann als Variablen im Prompt zur Verfügung.

<Info>
  **Automatische KI-Korrektur der Lead-Liste:** SalesFrank erkennt häufige Formatierungsfehler – z. B. fehlende Ländervorwahl, Leerzeichen in Telefonnummern oder falsche Spaltennamen – und schlägt vor dem Import automatisch eine bereinigte Version vor. Du sparst dir manuelles Nacharbeiten in Excel.
</Info>

<Warning>
  Telefonnummern müssen im E.164-Format angegeben werden (z. B. `+491701234567`). Nummern ohne Ländervorwahl werden erkannt und können automatisch korrigiert werden.
</Warning>

<Note>
  📸 **Screenshot:** Upload-Dialog für CSV/Excel mit der Vorschau der erkannten Spalten und der KI-Korrektur-Übersicht – hier Bild einfügen.
</Note>

### API

Leads können programmatisch über die SalesFrank API hinzugefügt werden. Das ist besonders für Lead-Qualifizierungskampagnen relevant, bei denen neue Leads automatisch aus externen Systemen (CRM, Formulare, Werbeanzeigen) übertragen werden sollen.

***

## Lead-Status

Jeder Lead durchläuft während einer Kampagne einen definierten Status:

| Status             | Beschreibung                                                                          |
| ------------------ | ------------------------------------------------------------------------------------- |
| **Neu**            | Lead wurde hinzugefügt, noch kein Anrufversuch                                        |
| **In Bearbeitung** | Frank hat bereits Anrufversuche unternommen, ist aber noch nicht fertig               |
| **Erreicht**       | Ein Gespräch hat stattgefunden                                                        |
| **Abgeschlossen**  | Frank hat alle Anrufversuche abgeschlossen (erreicht oder max. Versuche ausgeschöpft) |
| **Fehler**         | Technisches Problem beim Anruf (z. B. ungültige Nummer)                               |

<Note>
  📸 **Screenshot:** Lead-Tabelle in der Kampagne mit Statusspalte und farblicher Kennzeichnung – hier Bild einfügen.
</Note>

***

## Lead-Ergebnis

Das Ergebnis zeigt an, wie das zuletzt geführte Gespräch ausgegangen ist:

| Ergebnis               | Beschreibung                                               |
| ---------------------- | ---------------------------------------------------------- |
| **Keine Antwort**      | Lead wurde nicht erreicht                                  |
| **Interessiert**       | Lead hat Interesse signalisiert                            |
| **Nicht interessiert** | Lead hat kein Interesse                                    |
| **Rückruf gewünscht**  | Lead möchte zu einem späteren Zeitpunkt kontaktiert werden |
| **Termin gebucht**     | Frank hat einen Termin vereinbart                          |
| **Anrufweiterleitung** | Gespräch wurde an einen Mitarbeiter weitergeleitet         |