Prérequis
Avant de créer une connexion, vous aurez besoin des éléments suivants auprès de Meta :Création d’une connexion
La boîte à outils WhatsApp est disponible dans l’Agent Builder et le Workflow Builder. La procédure de connexion est identique dans les deux cas, mais le chemin de navigation diffère.- Agent Toolkit
- Workflow Toolkit
- Ouvrez votre agent dans l’Agent Builder
- Accédez à l’onglet Toolkits dans la barre latérale gauche
- Recherchez WhatsApp et cliquez sur Add to Agent
- Dans le panneau de la boîte à outils, cliquez sur Select a Connection > Create a Connection
- Dans la fenêtre contextuelle qui apparaît, saisissez un Connection Name, votre System User Access Token, Business Account ID.
- Saisissez votre Access Token, Business Account ID (optionnel) et un Name d’affichage pour la connexion
- Cliquez sur Save — EKB validera les identifiants avant l’enregistrement
Outils disponibles
Appel API personnalisé
L’outil Custom API Call est l’option la plus extensible. Il permet un accès direct aux points de terminaison de l’API WhatsApp Graph au-delà de ce que les autres outils couvrent, notamment :- Messages interactifs (boutons, listes)
- Cartes de localisation et de contacts
- Messages du catalogue de produits
- Gestion programmatique des modèles
- Mise à jour du profil entreprise
- Analytique et statistiques de messagerie
Notes de configuration
- Format du numéro de téléphone : Utilisez toujours le format international E.164 (par ex.
+1...,+52...). Les espaces, tirets ou l’absence de code pays entraîneront des échecs de livraison (erreur1006). - Fenêtre de session : Les messages en texte brut et les médias ne peuvent être envoyés que dans un délai de 24 heures après le dernier message du destinataire. En dehors de cette fenêtre, utilisez Send Template.
- URLs de médias : Doivent être accessibles publiquement via HTTPS. Les URLs privées, localhost ou expirées entraîneront des échecs de téléchargement (erreur
1011). Vérifiez que les types MIME correspondent au contenu du fichier. - Modèles : Doivent être approuvés dans Meta Business Manager avant utilisation. Le nombre et l’ordre des paramètres doivent correspondre exactement au modèle approuvé. Surveillez la note de qualité de vos modèles — une note basse peut entraîner la suspension d’un modèle (erreur
131056). - Limites de débit : L’API WhatsApp Business applique des limites de messagerie par numéro et par jour. Pour l’envoi en masse, utilisez des files d’attente et implémentez une logique de réessai avec backoff exponentiel.
- Sécurité : Stockez les tokens d’accès de manière sécurisée et renouvelez les identifiants périodiquement. Assurez-vous d’obtenir le consentement des utilisateurs avant d’envoyer des messages marketing.
Exemples pratiques
- Support client : Un agent reçoit une demande de support, recherche l’enregistrement client et envoie un message WhatsApp avec le numéro de ticket et les prochaines étapes — ou utilise un modèle de bouton interactif pour orienter l’utilisateur vers la bonne équipe.
- Notifications transactionnelles : Un workflow se déclenche après la passation d’une commande et envoie un modèle avec confirmation de commande, mises à jour d’expédition ou notifications de paiement.
- Livraison de documents : Un agent génère une facture ou un contrat PDF et le livre via l’outil Send Media avec une légende descriptive.
- Campagnes de diffusion : Un workflow itère sur une liste de contacts et envoie un modèle marketing approuvé avec substitution personnalisée des paramètres.
Dépannage
Si l’erreur n’est pas répertoriée ci-dessus, utilisez la Checklist de débogage :
- Vérifiez les identifiants et que la connexion est valide
- Confirmez que le numéro de téléphone du destinataire est enregistré sur WhatsApp
- Validez le format du message et la structure du payload
- Confirmez le statut d’approbation du modèle
- Vérifiez si les limites de débit de l’API ont été atteintes