WhatsApp

Dieser Leitfaden erklärt, wie Sie Ihren Quickchat AI Agent mit WhatsApp verbinden. Der Ablauf besteht aus zwei einfachen Schritten:

• Schritt 0 – Voraussetzungen
• Schritt 1 – WhatsApp verbinden

Wenn bei der Integration Probleme auftreten, besuchen Sie den Abschnitt Troubleshooting & FAQs oder kontaktieren Sie uns.

Video ansehen

Play

Schritt 0 – Voraussetzungen

A. Geschäftliche Telefonnummer

Entscheiden Sie, welche Telefonnummer Sie für WhatsApp verwenden. Details finden Sie in der WhatsApp-Dokumentation oder in den FAQs:

Welche Nummer kann ich in der WhatsApp Cloud API nutzen?

• Sie benötigen eine dedizierte geschäftliche Telefonnummer, die SMS oder Anrufe zur Verifizierung empfangen kann.
• Die Nummer muss gültig sein, Ihnen gehören und eine Länder- sowie Ortsvorwahl besitzen.

Kann ich eine Nummer verwenden, die bereits in WhatsApp Messenger aktiv ist?

• Nein. Sie können sie weiterhin für Anrufe und SMS nutzen, aber nicht im WhatsApp Messenger.
• Wenn die Nummer bereits im Messenger verwendet wird, löschen Sie sie zuerst. Vergessen Sie nicht, vorher Ihre WhatsApp-Chatverläufe zu sichern.
• Gesperrte Nummern müssen vor der Registrierung entsperrt werden.

Kann ich eine Nummer verwenden, die derzeit in der WhatsApp Business App genutzt wird?

• Ja. Wenn Ihre Nummer aktuell in der WhatsApp Business App aktiv ist, können Sie sie häufig in die Cloud API übernehmen, ohne den App-Account zu löschen. Mehr dazu im Meta-Leitfaden zu Coexistence Onboarding.

Kann ich eine neue Telefonnummer verwenden?

• Ja. Wenn Sie Ihre aktuelle Nummer nicht nutzen möchten, besorgen Sie sich eine neue Nummer (physische SIM oder virtuelle Nummer). Virtuelle Rufnummern erhalten Sie z. B. bei Hushed.

B. Unternehmensinformationen

Halten Sie folgende Angaben bereit (Sie geben sie im Meta-Flow an):

• Unternehmensname
• Unternehmenswebsite
• Unternehmenskategorie
• Unternehmensbeschreibung

Achtung

Selbst wenn Felder optional erscheinen, füllen Sie sie sorgfältig aus. Fehlende oder falsche Informationen können die Freigabe verzögern oder zu Einschränkungen führen.

Schritt 1 – WhatsApp verbinden

Öffnen Sie die Quickchat AI App → External Apps → WhatsApp → klicken Sie auf WhatsApp verbinden und folgen Sie dem Meta-Popup:

1. Melden Sie sich bei Ihrem Meta-(Facebook-)Konto an.
2. Prüfen Sie die Berechtigungen, die Sie mit Quickchat AI teilen (Zugriff auf das WhatsApp Business-Konto und das Business-Portfolio), und fahren Sie fort.
3. Geben Sie korrekte Unternehmensdaten an (Business Portfolio, Business Name, Website, Land usw.).
4. Erstellen oder wählen Sie Ihr WhatsApp Business Account aus.
5. Wählen Sie einen Anzeigenamen und eine Kategorie für WhatsApp Business.
6. Fügen Sie Ihre geschäftliche Telefonnummer hinzu und verifizieren Sie sie per SMS/Anruf.
7. Klicken Sie auf Confirm, um Quickchat AI die nötigen Berechtigungen zu erteilen.
8. Sobald Meta bestätigt, dass die Einrichtung abgeschlossen ist, klicken Sie auf Finish. Das Popup zeigt eine Bestätigung von Quickchat AI, dass Ihr WhatsApp-Konto verbunden wurde, und schließt automatisch.

Zurück in der Quickchat AI App wechselt das WhatsApp-Panel innerhalb von etwa 30 Sekunden auf Verbunden. Falls nicht, klicken Sie auf das Aktualisieren-Symbol im Panel. Andernfalls prüfen Sie bitte die Voraussetzungen oben, um sicherzugehen, dass Telefonnummer und Unternehmensdaten korrekt sind.

Das war’s – Sie sind live! 🎉 Kund:innen können Ihrer WhatsApp-Nummer schreiben und Ihr AI Agent antwortet automatisch.

Tipp

Senden Sie zur finalen Überprüfung eine Nachricht an die frisch verbundene WhatsApp-Nummer. Sie sollten eine Antwort Ihres AI Agents erhalten, und das Gespräch erscheint im Quickchat AI App Posteingang. Dort sehen Sie auch eine Nachricht von WhatsApp mit einem Link zu Setup guidance im WhatsApp Manager. Folgen Sie dem Link, um Ihr WhatsApp-Onboarding abzuschließen. Wenn Sie einen der Einrichtungsschritte von Meta unvollständig lassen, sendet Quickchat AI dem Kontoinhaber die verbleibenden Schritte zusätzlich per E-Mail als Erinnerung.

Troubleshooting & FAQs

Wie funktioniert die Preisgestaltung der WhatsApp Business API?

• Antworten auf von Nutzer:innen initiierte (eingehende) Anfragen gelten bei WhatsApp als Service-Nachrichten. Damit können Sie eingehende Anfragen per Human Agent oder Conversational AI bearbeiten.
• Wenn Nutzer:innen ein Unternehmen anschreiben, öffnet sich ein 24-Stunden-Servicefenster, in dem Sie mit Service-Nachrichten kostenlos antworten können. Dieses Fenster startet mit jeder Nutzer:innen-Nachricht neu.
• Nach 24 Stunden müssen Sie genehmigte Nachrichtenvorlagen (Marketing, Utility, Authentication usw.) nutzen und zahlen pro Nachricht gemäß den WhatsApp Business Platform Message Rates.
• Unterhaltungen werden von Meta kategorisiert und abgerechnet. Stellen Sie sicher, dass Ihr WhatsApp Business Account eine gültige Zahlungsmethode für ausgehende/templatebasierte Nachrichten hat.

Der Button WhatsApp verbinden funktioniert nicht. Das Meta-Popup erscheint nicht.

• Wenn Ihr Browser das Popup blockiert, erlauben Sie Pop-ups für die Quickchat AI App und klicken Sie auf Erneut versuchen. Sie können auch auf Bei Meta in diesem Tab fortfahren klicken, um dieselbe Einrichtung ohne Popup abzuschließen.

Quickchat konnte die WhatsApp-Verbindung nicht bestätigen

Quickchat zeigt diese Meldung zur Wiederherstellung an, wenn das Meta-Fenster kein Ergebnis zurückgibt und Quickchat die Verbindung weiterhin nicht bestätigen kann. Das beweist nicht, dass Meta keine Änderungen vorgenommen hat.

1. Vergewissern Sie sich, dass Sie Admin des Meta Business sind, dem das WhatsApp Business Account gehört. Falls nicht, bitten Sie einen Admin, es über dessen Facebook-Anmeldung zu verbinden.
2. Klicken Sie auf Erneut versuchen. Wenn ein Blocker das Meta-Fenster stört, verwenden Sie ein privates Fenster mit pausierten Erweiterungen oder klicken Sie auf Bei Meta in diesem Tab fortfahren.
3. Wenn die Nummer in WhatsApp Messenger aktiv ist, entfernen Sie sie dort zuerst oder verwenden Sie eine andere Nummer. Wenn sie in der WhatsApp Business App aktiv ist, folgen Sie Metas Coexistence-Onboarding.
4. Wenn das WhatsApp Business Account Aircall, Twilio, 360dialog, MessageBird oder einen anderen Anbieter nutzt, fügen Sie Quickchat AI in den Meta Business Settings als Partner hinzu:
   1. Öffnen Sie die Meta Business Settings und gehen Sie zu Konten → WhatsApp-Konten.
   2. Wählen Sie das WhatsApp Business Account aus, öffnen Sie Partner und klicken Sie auf Partner hinzufügen.
   3. Geben Sie die Business ID von Quickchat AI ein: 270696274483463.
   4. Gewähren Sie die Berechtigung WhatsApp-Konten verwalten, kehren Sie zu Quickchat AI zurück und aktualisieren Sie den Status.

Trennen Sie die Verbindung zum anderen Anbieter nur, wenn Meta auf diesem Konto nicht beide Partner zulässt. Wenn Sie unsicher sind, kontaktieren Sie den Support, bevor Sie die Verbindung zu einem aktiven Messaging-Anbieter trennen.

Die Nummernverifizierung ist fehlgeschlagen.

• Stellen Sie sicher, dass die Nummer SMS/Anrufe empfangen kann und nicht durch einen aktiven Registrierungsweg blockiert ist, den Meta nicht unterstützt. Wenn die Nummer in der Business App verwendet wird, versuchen Sie das Onboarding per Coexistence.

Ich habe das falsche Konto verbunden.

• Klicken Sie im WhatsApp-Panel auf Erneut verbinden und wiederholen Sie den Ablauf mit dem korrekten Meta Business Account und dem passenden WhatsApp Account.

Nachrichten erscheinen nicht im Quickchat-AI-Posteingang.

• Vergewissern Sie sich, dass im Popup die abschließende Meldung “WhatsApp account connected!” angezeigt wurde.
• Prüfen Sie, ob Sie den richtigen WhatsApp-Account verknüpft und den passenden AI Agent ausgewählt haben.
• Wenn Sie nach 24 Stunden ohne neue Nutzer:innen-Nachricht antworten, verwenden Sie genehmigte Vorlagen und stellen Sie sicher, dass im WhatsApp Manager eine Zahlungsmethode hinterlegt ist.

Die WhatsApp-Antworten meines AI Agents werden nicht gesendet.

Wenn die Antworten Ihres AI Agents nicht zugestellt werden können, zeigt Quickchat AI im WhatsApp-Panel unter External Apps eine Meldung “WhatsApp-Antworten schlagen fehl” sowie eine Benachrichtigung in Ihrem Dashboard an. Die häufigsten Ursachen und Lösungen:

• Freigabe des Anzeigenamens ausstehend: Meta verlangt die Freigabe des Anzeigenamens für Ihre WhatsApp-Nummer, bevor Antworten gesendet werden können. Schließen Sie sie im WhatsApp Manager ab und senden Sie dann eine Testnachricht.
• Verbindung abgelaufen oder widerrufen: Ihre WhatsApp-Verbindung ist nicht mehr gültig. Öffnen Sie das WhatsApp-Panel und klicken Sie auf Erneut verbinden, um das Senden von Antworten fortzusetzen.
• Nummer eingeschränkt: Meta hat Ihre WhatsApp-Nummer eingeschränkt (Qualitätsbewertung oder Richtlinie). Prüfen Sie ihren Status im WhatsApp Manager, um den Versand wiederherzustellen.

Die Meldung verschwindet automatisch, sobald wieder eine Antwort erfolgreich gesendet wurde.

Vorlagen- oder geschäftsinitiierte Nachrichten schlagen fehl.

• Stellen Sie sicher, dass Ihre Message Templates genehmigt sind und eine aktive Zahlungsmethode im WhatsApp Manager hinterlegt ist.
• Neue Absender starten mit Messaging-Limits, die sich nach Qualität und Verifizierung erhöhen. Wenn Sie Limits erreichen, lesen Sie Metas Hinweise zu Messaging Limits.
• Prüfen Sie Messaging-Limits und Qualitätsbewertung im WhatsApp Manager, wenn Zustellungen gedrosselt werden.

Wie erstelle ich meinen eigenen WhatsApp-Link und “Chat auf WhatsApp”-Button?

• Folgen Sie diesem WhatsApp-Tutorial.
• Oder laden Sie WhatsApp-Brand-Button-Designs herunter und verwenden Sie eines dieser Inline-Skripte:

<!-- WhatsApp Inline-Button -->
<!-- Ersetzen Sie WHATSAPP_PHONE_NUMBER und Dateiname/Pfad nach Bedarf -->
<a
  aria-label="Chat auf WhatsApp"
  href="https://wa.me/WHATSAPP_PHONE_NUMBER"
  target="_blank"
  rel="noopener noreferrer"
>
  <img
    alt="Chat auf WhatsApp"
    src="WhatsAppButtonGreenLarge.svg"
    style="
      width: 200px;
      height: auto;
      cursor: pointer;
      border-radius: 12px;
    "
  />
</a>

oder

<!-- WhatsApp Floating-Button -->
<!-- Ersetzen Sie WHATSAPP_PHONE_NUMBER und Dateiname/Pfad nach Bedarf -->
<a
  aria-label="Chat auf WhatsApp"
  href="https://wa.me/WHATSAPP_PHONE_NUMBER"
  target="_blank"
  rel="noopener noreferrer"
  style="position: fixed; right: 20px; bottom: 20px; z-index: 9999"
>
  <img
    alt="Chat auf WhatsApp"
    src="WhatsAppButtonGreenLarge.svg"
    style="
      width: 200px;
      height: auto;
      cursor: pointer;
      border-radius: 12px;
      box-shadow: rgba(0, 0, 0, 0.5) 0px 5px 15px 0px;
      transition: all 0.3s ease;
    "
    onmouseover="this.style.transform = 'scale(1.05)'"
    onmouseout="this.style.transform = 'scale(1)'"
  />
</a>

Wie kann ich meinen eigenen WhatsApp-QR-Code erstellen?

• Gehen Sie zu WhatsApp Manager → Telefonnummern → wählen Sie Ihre Geschäftstelefonnummer → Nachrichtenlinks → Nachrichtenlink erstellen.
• Alternativ finden Sie diese Funktion in Ihrer WhatsApp Business App. Folgen Sie diesem WhatsApp-Tutorial.

Kann ich die Verbindung später trennen, wenn ich Coexistence nutze?

• Ja, jederzeit. Öffnen Sie in der WhatsApp Business App Einstellungen → Konto → Business Platform → Verbindung trennen.
• Die Nummer bleibt in der Business App aktiv. Ihre Kontakte und Ihr vorhandener Chatverlauf bleiben unverändert.
• Der API-Zugriff von Quickchat AI endet sofort.
• Sie können die Integration auch pausieren, ohne die Verbindung zu trennen, indem Sie einfach keine ausgehenden Nachrichten mehr über Quickchat AI senden.

Welchen Zugriff erhält Quickchat AI auf unser WhatsApp Business Account?

• Eingeschränkter API-Zugriff, keine Kontoinhaberschaft. Ihr WhatsApp Business Account (WABA) befindet sich in Ihrem eigenen Meta Business Manager. Beim WABA-Sharing-Modell von Meta gehören Ihnen die Assets, und Quickchat AI wird als Partner hinzugefügt, den Sie jederzeit im Business Manager entfernen können.
• Wir können über die Cloud API Nachrichten senden und empfangen sowie Nachrichtenereignisse per Webhook erhalten, während die Integration aktiv ist.
• Wir können Ihr Konto nicht schließen, übertragen oder umbenennen. Wir können weder die Abrechnung ändern noch Ihre Administrator:innen entfernen.

Hilfe nötig?

Chatten Sie mit dem Quickchat Support-AI auf WhatsApp:
📱 +1 302-405-9992 — Chat starten

Oder scannen Sie den QR-Code: