Le canal WhatsApp d’Anyy utilise l’API officielle Business Cloud de Meta. Il reçoit les messages privés par un webhook signé et répond avec l’identité téléphonique professionnelle configurée.
Prérequis
- une application Meta avec WhatsApp activé ;
- App ID, WhatsApp Business Account ID et Phone Number ID ;
- un jeton d’accès autorisé à utiliser Cloud API ;
- un jeton de vérification du webhook choisi par le propriétaire ;
- le secret de l’application Meta ;
- une route HTTPS publique vers le Gateway Anyy.
Suivez la documentation Cloud API de Meta pour la configuration actuelle côté plateforme.
Connexion dans Dashboard
- Ouvrez Dashboard → Channel → Add.
- Choisissez WhatsApp ; son entrée par défaut utilise Business Cloud API webhook.
- Saisissez App ID, Business Account ID et Phone Number ID.
- Ajoutez le jeton d’accès, le jeton de vérification du webhook et le secret de l’application.
- Enregistrez les identifiants ; les règles se modifient dans l’assistant CLI interactif, pas dans ce formulaire.
- Enregistrez le compte et remplissez les prérequis et autorisations Meta signalés.
Activez l’écoute et le proxy HTTPS décrits dans Plateformes de messagerie avant d’enregistrer le rappel. Son chemin entrant est :
/channels/whatsapp/ACCOUNT_ID/webhook
Pour le compte par défaut, ACCOUNT_ID vaut personal. Publiez ce chemin en HTTPS, puis abonnez l’application Meta aux événements de message WhatsApp avec le même jeton de vérification.
Règle d’accès
WhatsApp accepte les règles de messages privés pairing, open, allowlist ou disabled ; la valeur par défaut est pairing. Choisissez WhatsApp dans l’assistant interactif anyy setup channel pour changer la règle. Les actions actuelles n’ont pas d’éditeur de liste d’autorisation ; consultez les limites communes. Ce profil ne propose ni groupes ni admission native des médias.
N’approuvez un expéditeur en attente qu’après vérification de son identité téléphonique :
anyy channel pairing list
anyy channel pairing approve --request REQUEST_ID
Contraintes de la plateforme
Dans v0.1.107, Anyy accepte et envoie uniquement aux destinataires correspondant à sa liste intégrée d’indicatifs EEE/Brésil. Une règle privée ouverte ne contourne pas cette limite d’implémentation. Vérifiez séparément les règles actuelles d’éligibilité et de région de Meta ; la liste fixe d’Anyy ne décrit pas entièrement les règles actuelles de la plateforme.
Les réponses libres exigent le contexte du message d’origine envoyé par l’utilisateur et le respect de la fenêtre de réponse autorisée. La route actuelle inclut l’ID du message entrant ; plusieurs messages d’un contact ne partagent donc pas nécessairement une seule session Anyy.
Anyy n’invente aucun destinataire et ne contourne pas les règles de conversation de Meta. Partez d’une conversation entrante autorisée et tenez compte des règles de la plateforme lors de la planification ou d’une nouvelle tentative de livraison.
Vérifier la connexion
anyy channel doctor whatsapp
anyy channel reload
Envoyez un message privé au numéro professionnel, terminez l’association et vérifiez qu’Anyy peut répondre.
Dépannage
| Problème | Points à vérifier |
|---|---|
| Échec du défi webhook | Route HTTPS publique et jeton de vérification du webhook |
| Les événements reçoivent 401 | Secret de l’application Meta et transmission de X-Hub-Signature-256 |
| Réception fonctionnelle, envoi impossible | Jeton d’accès, Phone Number ID, autorisations et éligibilité |
| Expéditeur ignoré | Règle privée, état d’association ou liste d’autorisation |
| Réponse rejetée ultérieurement | Fenêtre de réponse aux messages initiés par l’utilisateur et règles Meta actuelles |