# Lead-Formulare

Ein Lead-Formular sammelt Anfragen und legt fest, was mit jeder einzelnen passiert. Sie erstellen die Fragen einmal, entscheiden, ob und welcher Agent neue Leads anruft, und veröffentlichen dasselbe Formular auf mehreren Kanälen: als Link oder eingebettet auf Ihrer Website, über Ihr bestehendes Website-Formular und als Lead-Formular bei Facebook / Instagram, Google Ads, LinkedIn und TikTok. Jeder Lead wird als Kontakt gespeichert, und bei aktivem Anruf ruft der Agent innerhalb von Sekunden an.

Die Seite heißt **Lead forms** in der Seitenleiste der App, direkt unter **Integrations**. Jedes Formular hat seinen eigenen Rückruf (an oder aus, den Agent, die Anweisungen für diesen Anruf) und seine eigenen Kanäle. Zwei Formulare können also von zwei verschiedenen Agents mit unterschiedlichen Anweisungen angerufen werden.

  <ShotPlaceholder
    src="/assets/integrations/lead-forms.png"
    name="lead-forms-list"
    alt="Liste der Lead-Formulare mit dem Default-Formular"
    capture="Sidebar Lead forms, list with at least two forms, one marked Default."
  />
  <ShotPlaceholder
    src="/assets/integrations/lead-forms-channels.png"
    name="lead-forms-channels"
    alt="Lead-Formular-Editor auf dem Tab Channels"
    capture="Lead form editor, Channels tab with Your website and the Facebook and Google Ads cards."
  />

## Was Sie vorher brauchen

- Einen Agent, der die Rückrufe übernimmt. Siehe [Ihr erster Agent](https://docs.voicelogica.ai/de/getting-started/your-first-agent/).
- Eine Leitung für ausgehende Anrufe. Lead-Rückrufe sind ausgehende Anrufe und verbrauchen Ihre Minuten.
- Für Werbeplattformen: die Facebook-Seite, das Google-Ads-, LinkedIn- oder TikTok-Konto Ihrer Lead-Anzeigen, verbunden unter **Integrations**. Eine noch nicht verbundene Kanal-Karte zeigt **Connect** und führt Sie dorthin.

## Die Tabs des Editors

- **Fields** — Die Fragen in ihrer Reihenfolge, mit Live-Vorschau. Ein Formular braucht eine Telefon- oder E-Mail-Frage; fügen Sie eine Telefonfrage hinzu, wenn ein Agent anrufen soll. Halten Sie es kurz: Jede zusätzliche Frage kostet Einsendungen.
- **Call** — **Call new leads automatically**, der **Agent**, der anruft, und **What the agent should say** für diesen Anruf. Der Agent weiß bereits, was die Person ausgefüllt hat und über welchen Kanal und welche Kampagne sie kam. Schreiben Sie also, wie er sich verhalten soll, nicht die Fakten.
- **Channels** — Wo das Formular Leads sammelt: **Your website** (Link, Einbettungscode oder Ihr eigenes Formular) und eine Karte pro Plattform mit **Create on Facebook**, **Create on Google Ads** oder **Link existing form**.
- **After submit** — Die Dankesnachricht oder eine Seite, auf die der Besucher weitergeleitet wird.
- **Workflow** — Der **New lead**-Workflow des Formulars: eine E-Mail oder SMS an Ihr Team, ein CRM-Update, ein Follow-up.
- **Leads** — Jeder Lead dieses Formulars aus allen Kanälen, seine Antworten und ob der Agent angerufen hat: **Received**, **Called** oder **Failed** mit dem Grund.

## Ersteinrichtung

1. **Lead forms - New form - Fields**

   Benennen Sie das Formular, fügen Sie die Fragen hinzu, einschließlich einer Telefonfrage. Prüfen Sie die Vorschau und speichern Sie.

2. **Tab Call**

   Aktivieren Sie **Call new leads automatically**, wählen Sie den **Agent** und schreiben Sie **What the agent should say**: was gefragt, was angeboten und wie abgeschlossen wird. Leer gelassen gilt der eigene Prompt des Agents. Anrufe gehen innerhalb von Sekunden nach der Einsendung raus, auch am Wochenende, zwischen 09:00 und 21:00 Uhr; ein Lead aus der Nacht wird angerufen, sobald das Zeitfenster öffnet.

3. **Tab Channels - Your website**

   Kopieren Sie **Link to share** für einen Button oder eine Nachricht, oder **Snippet for your website** und fügen Sie es dort ein, wo das Formular erscheinen soll.

   Sie haben schon ein Kontaktformular (Elementor, WPForms, Typeform, Zapier)? Wählen Sie **My own form** und lassen Sie Ihr Formular jede Einsendung an **URL for your form** senden. Schalten Sie **Test mode** ein und senden Sie Ihr Formular einmal ab: 15 Minuten lang wird niemand angerufen, und **Fields we receive** zeigt, welches Feld Telefon, Name und E-Mail ist. Korrigieren Sie falsch erkannte Felder und speichern Sie.

4. **Tab Channels - Werbeplattformen**

   Wählen Sie pro Plattform einen Weg:

   - **Create on Facebook** erstellt aus diesem Formular das Instant Form für Facebook und Instagram, auf der gewählten **Facebook Page** und in der gewählten **Form language**. Name, Telefon und E-Mail werden aus dem Profil vorausgefüllt, jede weitere Frage wird zur benutzerdefinierten Frage. **Headline** und **Description** der Einleitung sind bearbeitbar, und Facebook fragt einmalig nach **Your privacy policy URL**.
   - **Create on Google Ads**: zuerst **Sign in with Google** mit dem Konto, das Ihre Anzeigen verwaltet, und das Werbekonto wählen. Das Panel zeigt die Texte, welche Fragen Google nicht stellen kann, und lässt Sie das Formular einer Kampagne zuordnen. Das neue Formular liefert seine Leads bereits an Voice Logica.
   - **Create on TikTok** öffnet den Instant-Form-Editor von TikTok direkt hier in einem Fenster, für das Werbekonto Ihrer Wahl. Erstellen und veröffentlichen Sie das Formular dort; sobald Sie den Editor schließen, wird das neue Formular mit diesem Formular verknüpft.
   - **Link existing form** für ein Formular, das es auf der Plattform schon gibt. Facebook, TikTok und Google Ads (nach der Anmeldung) zeigen ihre Formulare zur Auswahl. Bei LinkedIn nutzen Sie **Enter ID manually** und fügen die Formular-ID von der Plattform ein. **Every form not linked to another form** übernimmt alle Formulare der Plattform, die kein anderes Lead-Formular beansprucht.

5. **Tab Workflow** (optional)

   **Create workflow** erstellt den **New lead**-Workflow dieses Formulars. Fügen Sie einen E-Mail- oder SMS-Schritt hinzu, damit jemand von jedem Lead erfährt, und speichern Sie. Siehe [Workflows](https://docs.voicelogica.ai/de/workflows/).

6. **Testen**

   Senden Sie das Formular selbst mit Ihrer Handynummer ab. Der Lead erscheint im Tab **Leads** als **Received**, der Agent ruft Sie innerhalb von Sekunden an, und der Lead wechselt auf **Called**. Öffnen Sie den Anruf am Lead, um ihn anzuhören.

## Das Default-Formular

Das mit **Default** markierte Formular übernimmt jeden Lead, den kein anderes Formular beansprucht, zum Beispiel aus einem neuen Facebook-Formular, das noch niemand verknüpft hat. Richten Sie auch dessen Tab **Call** ein, damit diese Leads nicht unbemerkt liegen bleiben. Es kann nicht gelöscht werden.

Ein Plattform-Formular gehört immer genau einem Lead-Formular: Eine neue Verknüpfung verschiebt es, und **Unlink** schickt seine Leads zurück an das Default-Formular.

## Mit Claude oder ChatGPT

Mit [verbundenem Claude oder ChatGPT](https://docs.voicelogica.ai/de/integrations/claude-chatgpt/) genügt ein Satz, zum Beispiel: „Erstelle ein Lead-Formular mit Name, Telefon und gewünschter Leistung, lass Maria jeden Lead anrufen und veröffentliche es auf unserer Facebook-Seite.“ Der Assistent nutzt diese Tools:

- `lead_forms_create_form`, `lead_forms_update_form` (`call`, `agentId`, `prompt`, `sourceType`, `testMode`), `lead_forms_list_forms`, `lead_forms_get_form`.
- `meta_leads_publish_form` für das Facebook- / Instagram-Formular.
- `google_ads_leads_preview_form`, dann `google_ads_leads_list_campaigns`, dann `google_ads_leads_create_form` für Google Ads.
- `lead_forms_list_platform_forms` und `lead_forms_link_channel`, um ein bestehendes Plattform-Formular zu verknüpfen.
- `lead_forms_create_workflow` für den New-lead-Workflow und `lead_forms_list_leads`, um zu sehen, wer das Formular ausgefüllt hat und ob angerufen wurde.

## Fehlerbehebung

**Warum kam ein Lead an, aber der Agent hat nicht angerufen?**

Öffnen Sie den Lead im Tab **Leads**. **Failed** zeigt den Grund. Häufige Ursachen: **Call new leads automatically** ist auf dem Formular aus, das den Lead bekam (prüfen Sie welches: ein nicht verknüpftes Plattform-Formular landet beim **Default**-Formular), der Lead hat keine Telefonnummer, es war eine Test-Einsendung, oder er kam außerhalb von 09:00-21:00 Uhr und wurde in dieses Zeitfenster verschoben.

**Warum kommen Leads aus meinem eigenen Website-Formular ohne Telefonnummer an?**

Ihr Formular sendet die Telefonnummer unter einem Feldnamen, den wir nicht erkannt haben. Öffnen Sie im Tab **Channels** den Bereich **Fields we receive**, markieren Sie das richtige Feld als **Phone** und speichern Sie. Mit **Test mode** senden Sie eine Test-Einsendung, ohne dass jemand angerufen wird.

**Ich habe das Formular geändert. Warum zeigt meine Facebook-Anzeige noch das alte?**

Facebook-Formulare lassen sich nicht bearbeiten. **Update on Facebook** erstellt eine neue Version und archiviert die aktuelle; Anzeigen zeigen das alte Formular, bis Sie sie im Ads Manager auf das neue umstellen.

**Warum kann ich mein LinkedIn-Formular nicht aus einer Liste wählen?**

LinkedIn erlaubt uns nicht, Ihre Formulare aufzulisten. Kopieren Sie die Formular-ID von der Plattform und fügen Sie sie mit **Enter ID manually** ein. Facebook und TikTok zeigen ihre Formulare, sobald sie verbunden sind; Google-Ads-Formulare erscheinen in der Liste erst nach **Sign in with Google** und der Wahl des Werbekontos.

## Nächste Schritte

[Get an integration working](https://docs.voicelogica.ai/de/integrations/) - die Werbeplattformen verbinden.  
[Workflows](https://docs.voicelogica.ai/de/workflows/) - was sonst passiert, wenn ein Lead ankommt.  
[Claude und ChatGPT](https://docs.voicelogica.ai/de/integrations/claude-chatgpt/) - Formulare aus Ihrem KI-Assistenten erstellen und veröffentlichen.