Zugangsdaten bereitstellen

Diese Aufgabe übernimmt die technische Administration. Am Ende liegen die Zugangsdaten geschützt vor und können auf dem SwissMentor-Server hinterlegt werden. Access-Token, App-Secret und Verify-Token werden nicht in das Handbuch, Tickets oder Chat-Nachrichten kopiert.

Vorgehen

1. Öffnen Sie die Meta-Unternehmenseinstellungen und wählen Sie das Portfolio der App und des WhatsApp-Kontos.
2. Öffnen Sie Users → System users und wählen Sie Add, falls noch kein geeigneter Systembenutzer vorhanden ist. Geben Sie einen internen Namen ein, beispielsweise «Schulbot Integration», und legen Sie den Systembenutzer an.
3. Wählen Sie den Systembenutzer und Assign assets. Ordnen Sie ihm die für SwissMentor erstellte App und das zugehörige WhatsApp account mit den benötigten Verwaltungsrechten zu. Speichern Sie die Zuordnung.
4. Wählen Sie Generate token, dann die SwissMentor-App. Wenn die App nicht auswählbar ist, prüfen Sie zuerst ihre Zuordnung zum Portfolio und zum Systembenutzer.
5. Wählen Sie bei Set expiry die gewünschte Gültigkeit. Für einen dauerhaft laufenden Dienst können Sie Never verwenden, sofern Meta diese Option anbietet. Bei einer befristeten Gültigkeit muss der Token vor Ablauf ersetzt werden.
6. Wählen Sie unter Assign permissions die Berechtigungen whatsapp_business_messaging und whatsapp_business_management. Erzeugen Sie den Token und speichern Sie ihn direkt in der geschützten Zugangsdatenverwaltung.
7. Öffnen Sie Ihre App unter Meta for Developers über My Apps und dort App settings → Basic. Übernehmen Sie das App Secret in dieselbe geschützte Ablage. Verwechseln Sie es nicht mit der App ID.
8. Erzeugen Sie selbst einen langen zufälligen Verify-Token, beispielsweise mit dem Passwortmanager. Dieser Wert wird nicht von Meta zugeteilt. SwissMentor und die Meta-Webhook-Konfiguration müssen denselben Wert erhalten.

Meta dokumentiert die unterstützten Token-Arten und die WhatsApp-Berechtigungen in seiner Cloud-API-Referenz. Der vorübergehende Benutzer-Token aus API Setup ist für kurze Tests gedacht und ersetzt den Systembenutzer-Token nicht dauerhaft.

Fehlende Berechtigungen bei der Token-Erstellung

Wenn die beiden WhatsApp-Berechtigungen nicht auswählbar sind, prüfen Sie den WhatsApp-Anwendungsfall der ausgewählten App und die Asset-Zuordnungen. Erzeugen Sie keinen Token ohne die benötigten Berechtigungen. Die App, der Systembenutzer und das WhatsApp-Konto müssen zur gewählten Einrichtung passen.

Was Sie anschliessend bereithalten

Wert	Herkunft
Phone number ID	API Setup, bei der ausgewählten Absendernummer.
WhatsApp Business Account ID	API Setup oder Kontodetails im WhatsApp Manager.
Access-Token	Soeben für den Systembenutzer erzeugt.
App-Secret	App settings → Basic → App Secret.
Verify-Token	Selbst erzeugter zufälliger Wert für die Webhook-Bestätigung.

Zugehörige Themen

• WhatsApp-Bot aktivieren