Prérequis
Avant de créer une connexion, vous aurez besoin des éléments suivants auprès de Meta :| Prérequis | Où l’obtenir |
|---|---|
| Compte WhatsApp Business (vérifié) | Meta Business Manager |
| Token d’accès utilisateur système | Meta Business Manager → Utilisateurs système |
| ID de numéro de téléphone | WhatsApp Manager → Numéros de téléphone |
| ID de compte entreprise | Optionnel — requis pour les appels API Graph avancés |
| Modèles de messages approuvés | Meta Business Manager → Outils de compte → Modèles de messages |
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
| Outil | Description |
|---|---|
| Send Message | Envoie un message en texte brut (jusqu’à 4 096 caractères, UTF-8) dans la fenêtre de session de 24 heures |
| Send Media | Envoie une image, une vidéo, un audio ou un document via une URL HTTPS publique, avec légende ou nom de fichier optionnel |
| Send Template | Envoie un modèle de message préapprouvé — requis pour la messagerie sortante en dehors de la fenêtre de session de 24 heures |
| Custom API Call | Effectue un appel direct à n’importe quel point de terminaison de l’API Graph Meta pour des cas d’utilisation avancés (voir ci-dessous) |
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
| Code d’erreur | Symptôme | Solution |
|---|---|---|
401 / 190 | Token d’accès invalide | Régénérez le token utilisateur système dans Meta Business Manager et mettez à jour la connexion |
33 | ID de numéro de téléphone invalide | Vérifiez l’ID de numéro de téléphone dans WhatsApp Manager |
1006 | Format de numéro de téléphone invalide | Utilisez le format E.164 — incluez + et le code pays, sans espaces ni tirets |
131005 | Modèle introuvable | Confirmez le nom du modèle et qu’il existe dans Meta Business Manager |
131056 | Modèle suspendu | Vérifiez la note de qualité du modèle dans Meta Business Manager |
1011 | Échec du téléchargement du média | Utilisez une URL HTTPS publique et confirmez que le type de fichier et le type MIME sont pris en charge |
- 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