# Kampagnen

Den Agenten eine Nummernliste nach Zeitplan anrufen lassen — mit Wiederholungen und Protokollierung jedes Anrufs

> Full REST + WebSocket API reference: https://api.happ.tools/reference

Eine **Kampagne** ist eine Serie ausgehender KI-Anrufe: Der Agent telefoniert Ihre Kundenliste mit eigenem Prompt, eigener Stimme und eigener Telefonnummer ab. Angerufen wird nur innerhalb der von Ihnen festgelegten Zeitfenster; nimmt niemand ab oder ist besetzt, wird der Anruf wiederholt. Jeder Anruf landet mit Transkript und Aufzeichnung im **Verlauf**.

Sie finden die Kampagnen in der Seitenleiste des Agenten unter **Konfigurieren** > **Kampagnen**.

<CampaignsPageDemo />

## Bevor Sie beginnen [#before-you-start]

* Dem Agenten ist eine aktivierte **Telefonnummer** zugeordnet — siehe [Telefonnummern](/docs/agents/phones). Ohne Nummer wird die Kampagne mit einem Konfigurationsfehler pausiert.
* Der Workspace verfügt über **Guthaben**. Anrufe werden wie normale Telefonie-Nutzung abgerechnet; ist das Guthaben aufgebraucht, wird die Kampagne pausiert und nach dem Aufladen fortgesetzt.
* Zum Erstellen und Ausführen von Kampagnen benötigen Sie Schreibzugriff auf **Anrufe**.

## Kampagne erstellen [#create-a-campaign]

**Neue Kampagne** öffnet einen Einrichtungsdialog in drei Schritten.

**1. Grundlagen**

| Feld          | Funktion                                                                                                                                                                          |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Kampagnenname | Mindestens 2 Zeichen, z. B. „Frühjahrs-Reaktivierung“                                                                                                                             |
| Agent         | Fest auf diesen Agenten eingestellt — angerufen wird mit seinem Prompt, seiner Stimme und seiner Sprache                                                                          |
| Leitungen     | Wie viele Anrufe gleichzeitig laufen, 1–100 (Standard 1 — Nummern werden nacheinander gewählt). Durch Ihren Tarif begrenzt; lässt sich auch während der laufenden Kampagne ändern |

**2. Zeitplan**

| Feld                  | Funktion                                                                                                                                                |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Zeitzone              | Bestimmt, nach welcher Uhrzeit sich Zeitfenster und Datumsangaben richten                                                                               |
| Startdatum / Enddatum | Optional. Ist das Enddatum überschritten, endet die Kampagne, und alle noch nicht erreichten Kontakte werden als **Nicht erreicht** markiert            |
| Anruffenster          | Zeiträume von–bis (neue Fenster standardmäßig 09:00–18:00). Angerufen wird nur innerhalb dieser Fenster. Ohne Fenster wird zu jeder Tageszeit angerufen |

**3. Wiederholungen und Start**

| Feld               | Funktion                                                                      |
| ------------------ | ----------------------------------------------------------------------------- |
| Max. Versuche      | 1–10 (Standard 3). Danach wird die Nummer als nicht erreicht markiert         |
| Wiederholungsmodus | **Sofort**, **Nach N Minuten** (1–1440) oder **Im nächsten Fenster**          |
| Wiederholen bei    | **Keine Antwort**, **Besetzt**, **Fehlgeschlagen** — standardmäßig alle aktiv |

**Kampagne erstellen** speichert sie als **Entwurf** und öffnet **Quellen** — dort legen Sie fest, woher die Nummern kommen.

## Nummern hinzufügen [#add-numbers]

Eine Kampagne erhält ihre Nummern aus einer oder mehreren Quellen:

| Quelle           | Funktionsweise                                                                                                                                                                                                                                                                                                |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Eingefügte Liste | Eine Nummer pro Zeile oder CSV mit `,` oder `;`. Die erste Spalte ist die Telefonnummer; weitere Spalten werden zu Anrufvariablen (benannt nach der Kopfzeile, sonst `var1…varN`), die der Agent im Prompt verwenden kann. Bis zu 10.000 Nummern pro Upload; ungültige Nummern und Duplikate werden verworfen |
| CRM-Auswahl      | Bedingungen über KeyCRM, NetHunt oder SalesDrive mit Live-Vorschau. Läuft sofort und danach in Intervallen oder nach Zeitplan; Nummern, die in den letzten N Tagen angerufen wurden, werden übersprungen                                                                                                      |
| CRM-Ereignis     | Kopieren Sie die Webhook-URL in Ihr CRM; jedes Ereignis fügt eine Nummer hinzu. Optionaler Phasenfilter — nur anrufen, wenn der Deal in einer bestimmten Phase ist. Eine solche Kampagne endet nie von selbst                                                                                                 |
| Google Sheet     | Teilen Sie die Tabelle mit der Service-Account-E-Mail, die Happ anzeigt, fügen Sie den Link ein, wählen Sie das Tabellenblatt und die Telefonspalte, und ordnen Sie weitere Spalten Prompt-Variablen zu                                                                                                       |

```
+380991234567
phone,name,city
+380991234568,Anna,Kyiv
```

## Ausführen [#run-it]

Solange die Kampagne im Status **Entwurf** ist, wird niemand angerufen — klicken Sie auf **Kampagne starten**.

| Status                | Aktionen                       |
| --------------------- | ------------------------------ |
| Entwurf               | Kampagne starten, Löschen      |
| Läuft                 | Pausieren, Kampagne abbrechen  |
| Pausiert              | Fortsetzen, Kampagne abbrechen |
| Beendet / Abgebrochen | Löschen                        |

* **Pausieren** stoppt neue Anrufe; bereits an den Anbieter übergebene Anrufe können noch abgeschlossen werden.
* **Abbrechen** storniert alle noch wartenden Nummern und kann nicht rückgängig gemacht werden.
* Einstellungen können nur im Status **Entwurf** oder **Pausiert** bearbeitet werden; **Leitungen** lassen sich auch während der Ausführung ändern (wirksam nach etwa 20 Sekunden).
* Happ pausiert eine laufende Kampagne automatisch bei **Guthaben nicht ausreichend** oder einem **Konfigurationsfehler** (keine Telefonnummer, Telefonnummer deaktiviert). Beheben Sie die Ursache und klicken Sie auf **Fortsetzen**.

## Ergebnisse [#results]

* **Übersicht** — Fortschritt und Zähler: gesamt, in Warteschlange, wird gewählt, erreicht, nicht erreichbar, abgebrochen.
* **Kontakte** — jede Nummer mit Status (**Wartet**, **Wird gewählt**, **Erreicht**, **Nicht erreicht**, **Abgebrochen**), genutzten Versuchen, letztem Ergebnis und nächstem Versuch.
* **Versuchsverlauf** — klicken Sie auf eine Nummer, um das Ergebnis jedes Versuchs zu sehen (**Verbunden**, **Keine Antwort**, **Besetzt**, **Fehlgeschlagen**, **Nicht gewählt**), und auf **Anruf öffnen** für Transkript und Aufzeichnung.

**API:** [api.happ.tools/reference](https://api.happ.tools/reference)

## Weiter [#next]

* [Telefonnummern](/docs/agents/phones) — die Nummer zuordnen, von der der Agent anruft
* [Stimme](/docs/agents/voice) — wie der Agent klingt und spricht
* [Analyse](/docs/workspace/analysis) — die Anrufe der Kampagne mit einem Monitor bewerten