Konfiguration

Nach der Installation und Aktivierung des WhatsApp Cloud API Chat & Marketing Moduls müssen Sie die Verbindung zwischen Perfex CRM und der Meta WhatsApp Cloud API konfigurieren. Dies umfasst die Einrichtung einer Meta-Anwendung, die Generierung von API-Zugangsdaten, die Konfiguration von Webhooks und die Anpassung der Moduleinstellungen.

Meta-Anwendungskonfiguration

Auf die WhatsApp Cloud API wird über eine Meta (Facebook) App zugegriffen. Wenn Sie noch keine erstellt haben, befolgen Sie diese Schritte.

Schritt 1 — Facebook Developers-Konto erstellen

1. Gehen Sie zu developers.facebook.com.
2. Melden Sie sich mit Ihrem Facebook-Konto an.
3. Wenn Sie dazu aufgefordert werden, registrieren Sie sich als Entwickler, indem Sie die Nutzungsbedingungen akzeptieren und Ihr Konto verifizieren.

Schritt 2 — Meta App erstellen

1. Klicken Sie im Facebook Developers Dashboard auf App erstellen.
2. Wählen Sie Business als App-Typ (oder Andere, falls Business für Ihren Kontotyp nicht verfügbar ist).
3. Geben Sie einen App-Namen ein (z. B. "Perfex CRM WhatsApp") und Ihre Kontakt-E-Mail.
4. Wählen Sie Ihr Geschäftskonto (oder erstellen Sie eines, falls nötig).
5. Klicken Sie auf App erstellen.

Schritt 3 — WhatsApp zu Ihrer App hinzufügen

1. Suchen Sie auf dem Dashboard Ihrer neuen App WhatsApp in der Produktliste und klicken Sie auf Einrichten.
2. Folgen Sie der geführten Einrichtung, um ein WhatsApp Business-Konto zu verknüpfen.
3. Eine Testtelefonnummer wird automatisch für die Entwicklung bereitgestellt. Sie können später Ihre eigene verifizierte Geschäftstelefonnummer hinzufügen.

info

Die Testtelefonnummer ermöglicht das Senden von Nachrichten an bis zu 5 vorab registrierte Nummern. Für den Produktiveinsatz fügen Sie Ihre eigene Geschäftstelefonnummer in den WhatsApp Business-Kontoeinstellungen hinzu und verifizieren Sie sie.

Schritt 4 — Permanentes Access Token generieren

Das standardmäßige temporäre Token läuft nach 24 Stunden ab. Für die Produktion generieren Sie ein permanentes System User Token:

1. Gehen Sie zu business.facebook.com und navigieren Sie zu Geschäftseinstellungen > System-Benutzer.
2. Erstellen Sie einen neuen System-Benutzer (oder verwenden Sie einen bestehenden) mit Admin-Zugriff.
3. Klicken Sie auf Neues Token generieren, wählen Sie Ihre WhatsApp-App und gewähren Sie die folgenden Berechtigungen:
   • whatsapp_business_messaging
   • whatsapp_business_management
4. Kopieren Sie das generierte Token — dies ist Ihr permanentes Access Token.

warnung

Das permanente Token wird nur einmal angezeigt. Speichern Sie es sicher. Falls es verloren geht, müssen Sie ein neues generieren und Ihre Moduleinstellungen aktualisieren.

Webhook-Konfiguration

Webhooks ermöglichen es WhatsApp, Ihre Perfex CRM-Instanz in Echtzeit über eingehende Nachrichten, Zustellbestätigungen und Statusaktualisierungen zu benachrichtigen.

Webhook einrichten

1. Gehen Sie im Facebook Developers Dashboard zur Seite WhatsApp > Konfiguration Ihrer App.
2. Klicken Sie unter Webhook auf Bearbeiten.
3. Geben Sie die Callback-URL ein, die vom Modul bereitgestellt wird (zu finden unter WhatsApp-Modul > Einstellungen in Perfex CRM). Sie folgt typischerweise diesem Format:

   https://ihre-perfex-domain.com/whatsapp_cloud_api/webhook

4. Geben Sie das Verify Token ein, das in den Moduleinstellungen angezeigt wird.
5. Klicken Sie auf Verifizieren und Speichern.
6. Abonnieren Sie die folgenden Webhook-Felder:
   • messages
   • message_template_status_update

tipp

Ihre Perfex CRM-Installation muss über HTTPS mit einem gültigen SSL-Zertifikat bereitgestellt werden. Meta lehnt Webhook-URLs ab, die HTTP verwenden oder ungültige/selbst signierte Zertifikate haben.

Moduleinstellungen

Nach Abschluss der Meta App-Einrichtung konfigurieren Sie das Modul innerhalb von Perfex CRM.

1. Navigieren Sie zum WhatsApp Cloud API-Modul in der Perfex CRM-Seitenleiste.
2. Gehen Sie zu Einstellungen und geben Sie Folgendes ein:

Einstellung	Beschreibung
Access Token	Das oben generierte permanente System User Token
Phone Number ID	Zu finden auf der Seite WhatsApp > Erste Schritte Ihrer Meta App
WhatsApp Business Account ID	Zu finden in den WhatsApp-Einstellungen Ihrer Meta App
Webhook Verify Token	Eine von Ihnen definierte benutzerdefinierte Zeichenkette — muss mit dem übereinstimmen, was Sie in der Meta-Webhook-Einrichtung eingegeben haben
App ID	Die ID Ihrer Meta App (auf dem App-Dashboard zu finden)

3. Klicken Sie auf Einstellungen speichern.
4. Verwenden Sie die Schaltfläche Verbindung testen, um zu überprüfen, ob das Modul mit der WhatsApp Cloud API kommunizieren kann.

Embed-Konfiguration

Für erweiterte Setups unterstützt das Modul die Einbettung des WhatsApp-Chat-Widgets auf externen Seiten oder Kundenportalen. Navigieren Sie zu WhatsApp-Modul > Einstellungen > Embed, um einen Einbettungscode-Schnipsel zu generieren und das Widget-Erscheinungsbild (Farben, Position, Willkommensnachricht) anzupassen.

Geschäftsverifizierung

Um die volle Nachrichtenkapazität und den Zugang zu allen Vorlagenkategorien freizuschalten, schließen Sie Ihre Meta Business-Verifizierung ab:

1. Gehen Sie zu business.facebook.com > Geschäftseinstellungen > Sicherheitscenter.
2. Klicken Sie auf Verifizierung starten und folgen Sie dem geführten Prozess.
3. Reichen Sie Ihre Geschäftsdokumente wie von Meta angefordert ein.
4. Die Verifizierung dauert typischerweise 2-5 Geschäftstage.

info

Ohne Geschäftsverifizierung ist Ihre Nachrichtenkapazität auf 250 eindeutige Empfänger pro 24-Stunden-Rollzeitraum begrenzt. Nach der Verifizierung steigen die Limits progressiv basierend auf Nachrichtenqualität und -volumen.

Nächste Schritte

• Nutzungsanleitung — erfahren Sie, wie Sie die Chat-Oberfläche nutzen, Kampagnen durchführen, Bots konfigurieren und Vorlagen verwalten
• WhatsApp-Protokolle — umfassende Aufzeichnungen aller automatisierten Interaktionen anzeigen