Der WhatsApp-Kanal von Anyy verwendet Metas offizielle Business Cloud API. Er empfängt Direktnachrichten über signierten Webhook und sendet Antworten mit der konfigurierten geschäftlichen Telefonidentität.
Voraussetzungen
- eine Meta-App mit aktiviertem WhatsApp;
- App-ID, WhatsApp-Business-Konto-ID und Telefonnummer-ID;
- ein für die Cloud API berechtigtes Zugriffstoken;
- ein vom Betreiber gewähltes Webhook-Prüftoken;
- das Meta-App-Geheimnis; und
- eine öffentliche HTTPS-Route zum Anyy-Gateway.
Folgen Sie Metas Cloud-API-Dokumentation für die aktuelle plattformseitige Einrichtung.
Im Dashboard verbinden
- Öffnen Sie Dashboard → Kanal → Hinzufügen.
- Wählen Sie WhatsApp; der Standardeintrag verwendet Business-Cloud-API-Webhook.
- Geben Sie App-ID, Business-Konto-ID und Telefonnummer-ID ein.
- Ergänzen Sie Zugriffstoken, Webhook-Prüftoken und App-Geheimnis.
- Speichern Sie Zugangsdaten; Richtlinienänderungen erfolgen über den interaktiven CLI-Assistenten, nicht dieses Formular.
- Speichern Sie das Konto und erfüllen Sie gemeldete Meta-Voraussetzungen und Berechtigungen.
Aktivieren Sie vor Callback-Registrierung Listener und HTTPS-Proxy gemäß Nachrichtenplattformen. Der eingehende Callback-Pfad ist:
/channels/whatsapp/ACCOUNT_ID/webhook
Für das Standardkonto ist ACCOUNT_ID gleich personal. Veröffentlichen Sie den Pfad über HTTPS und abonnieren Sie dann mit demselben Prüftoken WhatsApp-Nachrichtenereignisse für die Meta-App.
Zugriffsrichtlinie
WhatsApp unterstützt Direktnachrichtenzugriff mit pairing, open, allowlist oder disabled; Standard ist pairing. Wählen Sie WhatsApp im interaktiven Assistenten anyy setup channel zum Ändern. Aktuelle Einrichtungsaktionen haben keinen Zulassungslisteneditor; siehe gemeinsame Einrichtungsgrenzen. Dieses Profil bietet weder Gruppen noch native Medienaufnahme.
Bestätigen Sie einen ausstehenden Absender erst nach Prüfung der Telefonidentität:
anyy channel pairing list
anyy channel pairing approve --request REQUEST_ID
Plattformgrenzen
In v0.1.107 akzeptiert und sendet Anyy nur an Empfängeridentitäten, die seiner integrierten EWR-/Brasilien-Ländervorwahlliste entsprechen. Offene DM-Richtlinie umgeht diese Implementierungsgrenze nicht. Prüfen Sie aktuelle Zulässigkeits- und Regionsregeln von Meta separat; die feste Liste von Anyy ist keine vollständige Aussage zur aktuellen Plattformrichtlinie.
Freie Antworten benötigen den ursprünglichen benutzerinitiierten Nachrichtenkontext und das erlaubte Antwortfenster der Plattform. Die aktuelle Route enthält die eingehende Nachrichten-ID; aufeinanderfolgende Nachrichten eines Kontakts teilen daher nicht unbedingt eine Anyy-Sitzung.
Anyy erfindet keinen Empfänger und umgeht keine Meta-Gesprächsregeln. Beginnen Sie mit einem autorisierten eingehenden Gespräch und beachten Sie Plattformrichtlinien beim Planen oder Wiederholen der Zustellung.
Die Verbindung prüfen
anyy channel doctor whatsapp
anyy channel reload
Senden Sie eine Direktnachricht an die Geschäftsnummer, schließen Sie Kopplung ab und bestätigen Sie, dass Anyy antworten kann.
Fehlerbehebung
| Problem | Prüfung |
|---|---|
| Webhook-Challenge schlägt fehl | Öffentliche HTTPS-Route und Webhook-Prüftoken |
| Ereignisse erhalten 401 | Meta-App-Geheimnis und Routing von X-Hub-Signature-256 |
| Eingang funktioniert, Versand scheitert | Zugriffstoken, Telefonnummer-ID, Berechtigungen und Zulässigkeit |
| Absender ignoriert | DM-Richtlinie, Kopplung oder Zulassungsliste |
| Spätere Antwort abgelehnt | Benutzerinitiiertes Antwortfenster und aktuelle Meta-Regeln |