# Verbindung einrichten

{/* AUTO-SYNCED SOURCE: this page lives in apps/app/src/modules/wa-bot/docs/ and is mirrored into the docs app by `bun sync:module-docs`. Edit it in the module, not in apps/docs. */}

<Lead>
Die Verbindung ist der erste Schritt zum laufenden Bot: Du verknüpfst deine WhatsApp-Business-Nummer sicher über den offiziellen Weg von Meta, hinterlegst ein paar Angaben zu deinem Büro und schaltest den Bot live. Der Assistent unter **Einrichtung > Verbindung** führt dich in vier Schritten durch.
</Lead>

## Voraussetzungen

Bevor du startest, brauchst du drei Dinge. Der Assistent zeigt sie dir im Schritt **Start** noch einmal an:

<Checklist>
  <ChecklistItem>
    **Eine WhatsApp-Business-Nummer.** "Am besten eine eigene Büro-Nummer, nicht Ihre private." Deine private Nummer bleibt in jedem Fall unangetastet.
  </ChecklistItem>
  <ChecklistItem>
    **Deine Geschäftsangaben.** "Name des Büros, so wie Ihre Kundschaft ihn kennt."
  </ChecklistItem>
  <ChecklistItem>
    **Eine Datenschutz-Seite.** "Ein Link genügt. Pflicht, damit der Bot live gehen darf." Der Link muss mit https beginnen.
  </ChecklistItem>
</Checklist>

## Der Assistent in vier Schritten

<Steps>
  <Step title="Start">
    Überblick über die Voraussetzungen und den Ablauf. Hier siehst du auf einen Blick, was noch fehlt.
  </Step>
  <Step title="Verbinden">
    Du verknüpfst deine Nummer über das offizielle Meta-Fenster (siehe unten). Nach erfolgreicher Verknüpfung zeigt der Schritt deine verbundene Nummer an.
  </Step>
  <Step title="Angaben">
    Du füllst die Pflichtangaben und optionalen Texte aus: Büro-Name, Datenschutz-Seite, Erreichbarkeit und Übergabe-Notiz. Mit **Speichern** sicherst du die Angaben, der Bot bestätigt: "Ihre Angaben sind gesichert."
  </Step>
  <Step title="Live">
    Die Checkliste zeigt, ob alles bereit ist. Mit **Jetzt live schalten** geht der Bot in Betrieb.
  </Step>
</Steps>

## Nummer über Meta verbinden

Im Schritt **Verbinden** startest du mit **Mit WhatsApp verbinden** den offiziellen Meta-Ablauf: Es öffnet sich ein Popup von Meta, in dem du dein WhatsApp-Business-Konto und die Nummer verknüpfst. Die App meldet dazu "WhatsApp öffnet sich" mit dem Hinweis "Folgen Sie den Schritten im Popup."

Drei Zusagen gelten dabei immer:

- "Ihre private Nummer bleibt unangetastet"
- "Verschlüsselte Verbindung, offiziell von Meta"
- "Jederzeit wieder trennbar"

<Info title="Verbindung anfragen">
Ist der Meta-Ablauf für dein Konto noch nicht freigeschaltet, zeigt der Schritt stattdessen den Button **Verbindung anfragen**: "Die Verbindung über Meta wird gerade für Ihr Konto vorbereitet." Du kannst die Angaben in der Zwischenzeit bereits ausfüllen; das Team schaltet dich frei.
</Info>

## Deine Angaben

Im Schritt **Angaben** hinterlegst du die Texte, mit denen der Bot arbeitet:

<DefinitionList>
  <DefItem term="Name Ihres Büros (Pflicht, 3 bis 40 Zeichen)">
    "So begrüßt der Bot Ihre Kundschaft." Dieser Name erscheint in der Begrüßung und überall, wo der Bot dein Büro nennt.
  </DefItem>
  <DefItem term="Datenschutz-Seite (Pflicht fürs Live-Schalten)">
    "Ein Link zu Ihrer Datenschutzerklärung. Pflicht fürs Live-Schalten." Nur vollständige https-Adressen werden übernommen, denn dieser Link geht direkt an deine Kundschaft.
  </DefItem>
  <DefItem term="Erreichbarkeit (optional, bis 120 Zeichen)">
    "Was der Bot über Ihre Antwortzeiten sagt." Zum Beispiel "werktags von 9 bis 18 Uhr".
  </DefItem>
  <DefItem term="Notiz bei Übergabe (optional, bis 200 Zeichen)">
    "Interner Hinweis für die Kollegin, die ein Gespräch übernimmt." Diese Notiz sehen nur du und dein Team, nie die Kundschaft.
  </DefItem>
</DefinitionList>

<Tip title="Unternehmensprofil als Fallback">
Leere Felder übernimmt der Bot automatisch aus deinem zentralen Unternehmensprofil in den Plattform-Einstellungen. Einmal gepflegt, überall genutzt. Eigene Werte im Bot überschreiben das Profil jederzeit.
</Tip>

## Live schalten

Der Schritt **Live** prüft drei Bedingungen (das Go-Live-Gate):

- **Nummer verbunden**
- **Büro-Name gesetzt**
- **Datenschutz-Link gesetzt**

Sind alle drei erfüllt, meldet die Seite "Alles bereit": "Ihre Angaben sind vollständig. Schalten Sie den Bot jetzt live." Fehlt etwas, steht dort "Fast geschafft" mit dem Hinweis "Bitte verbinden Sie eine Nummer und füllen Sie Büro-Name und Datenschutz-Link aus."

Nach dem Klick auf **Jetzt live schalten** bestätigt die App "Ihr Bot ist live" und die Seite zeigt: "WhatsApp-Anfragen an deine Nummer werden jetzt automatisch beantwortet, rund um die Uhr." (Die App setzt an dieser Stelle deine verbundene Nummer ein.)

## Bot pausieren und fortsetzen

Auf der Live-Seite kannst du den Bot jederzeit mit **Bot pausieren** anhalten und mit **Bot fortsetzen** wieder starten. Pausiert speichert der Bot alle eingehenden Nachrichten weiter mit, antwortet aber nicht. Dein Team kann in der [Inbox](/tools/wa-bot/inbox) weiterhin schreiben, solange das 24-Stunden-Fenster offen ist. Derselbe Schalter heißt in den [Einstellungen](/tools/wa-bot/einstellungen) **Bot antwortet**.

## Nummer trennen

Mit **Verbindung trennen** (im Assistenten) beziehungsweise **Nummer trennen** (in den Einstellungen unter **Gefahrenzone**) beendest du die Verbindung. Die Sicherheitsabfrage sagt klar, was passiert:

<Warning title="Nummer wirklich trennen?">
"Der Bot stoppt sofort, der gespeicherte Zugriffs-Schlüssel wird gelöscht. Der Gesprächsverlauf bleibt erhalten. Eine neue Verbindung läuft wieder über den Meta-Assistenten."
</Warning>

Der Zugriffs-Schlüssel wird also sofort und vollständig gelöscht, Gespräche und Kontakte bleiben erhalten. Du kannst dieselbe oder eine andere Nummer später jederzeit neu verbinden.

## Verbindungs-Status und Qualität

Den aktuellen Zustand deiner Nummer siehst du im Assistenten, im Fuß der Tool-Seitenleiste ("Verbunden" oder "Nicht verbunden") und in den Einstellungen im Tab **Verbindung**:

<DefinitionList>
  <DefItem term="Verbunden">Die Nummer ist verknüpft und einsatzbereit.</DefItem>
  <DefItem term="Einrichtung läuft">Meta richtet die Nummer noch ein. Das kann kurz dauern.</DefItem>
  <DefItem term="Verbindung gestört">Die Verbindung zu Meta ist unterbrochen. Was dann zu tun ist, steht in der [Fehlerbehebung](/tools/wa-bot/troubleshooting).</DefItem>
  <DefItem term="Getrennt">Es ist keine Nummer verbunden.</DefItem>
</DefinitionList>

Zusätzlich zeigt die Status-Karte die **Qualitätsbewertung** deiner Nummer durch WhatsApp: "gut", "noch keine Bewertung" oder eine Herabstufung auf Gelb beziehungsweise Rot. Bei einer Herabstufung bekommt der Workspace-Owner sofort eine Benachrichtigung. Die Bewertung hält sich automatisch aktuell.

## Weiterführend

Nach der Verbindung geht es weiter mit den [Flows](/tools/wa-bot/flows) und einem Testlauf im Simulator. Alle Texte und Schalter findest du später in den [Einstellungen](/tools/wa-bot/einstellungen). Zurück zur [WhatsApp-Bot-Übersicht](/tools/wa-bot).