Avec Papo (https://papo.global/), vous pouvez utiliser l'API REST pour envoyer des modèles de message approuvés (HSM) sur WhatsApp, en automatisant les notifications transactionnelles et les campagnes sans accéder à l'interface. L'API permet de lister les boîtes de réception Cloud API de votre compte, de récupérer les modèles approuvés par Meta et de les envoyer à un ou plusieurs contacts, à condition que vous disposiez d'un jeton d'API et que les modèles soient synchronisés sur la plateforme.
| Action de l'API | Ce qu'elle fait | Exemple d'utilisation |
|---|---|---|
| Lister les boîtes WhatsApp | Retourne les boîtes de réception WhatsApp Cloud API associées au compte | Sélectionner la bonne boîte avant l'envoi |
| Lister les modèles approuvés | Renvoie les modèles de message (HSM) avec le statut « approuvé » pour une boîte de réception donnée | Vérifier les HSM disponibles pour l'envoi |
| Envoyer un HSM à un contact | Envoie un modèle approuvé à un seul numéro de téléphone, en remplissant les variables | Notification de commande, rappel de rendez-vous |
| Envoyer un HSM à plusieurs contacts | Envoie le même modèle à une liste de contacts en une seule fois | Campagne marketing, communication de masse |
Comment fonctionne l'envoi de HSM via l'API
L'API de Papo reflète les fonctionnalités de la plateforme. Pour envoyer un modèle de message WhatsApp, vous n'avez pas besoin de créer quoi que ce soit de nouveau via le code : les modèles sont créés et soumis directement dans le Gestionnaire de commerce de Meta et, après approbation, apparaissent automatiquement dans votre compte Papo. L'API se contente de consulter la liste des modèles approuvés et d'effectuer l'envoi.
Le flux d'intégration typique consiste à :
- Générer un jeton d'API dans le panneau de Papo.
- Identifier la boîte de réception WhatsApp Cloud API où le modèle a été synchronisé.
- Obtenir la liste des modèles approuvés (HSM) de cette boîte.
- Préparer la requête avec les paramètres nécessaires : ID du modèle, langue, numéro du destinataire avec indicatif pays et les valeurs des variables (si le modèle contient
{{1}},{{2}}etc.). - Envoyer la requête — que ce soit pour un seul contact ou pour un ensemble de numéros, chacun avec ses propres variables personnalisées.
Étape par étape pour utiliser l'API
1. Générez un jeton d'API
Dans le menu de configuration de votre compte Papo, accédez à la section API ou jetons d'accès. Créez un jeton avec les permissions nécessaires pour gérer les conversations et les messages. Conservez le jeton en lieu sûr ; il sera envoyé dans l'en-tête de toutes les requêtes.
2. Listez les boîtes WhatsApp disponibles
Avant d'envoyer un modèle, vous devez savoir quelle boîte de réception (inbox) contient les modèles approuvés. Utilisez le point de terminaison qui retourne les boîtes WhatsApp Cloud API de votre compte. Notez l'identifiant de la boîte que vous souhaitez utiliser — il sera obligatoire dans les étapes suivantes.
3. Consultez les modèles approuvés (HSM)
Avec l'identifiant de la boîte en main, appelez le point de terminaison qui liste les modèles avec le statut APPROVED. La réponse fournira pour chaque modèle le nom, la langue disponible, la catégorie (Marketing, Utilitaire ou Authentification) et les paramètres attendus. Cette étape est importante pour confirmer que le modèle est autorisé et pour savoir quelles variables remplir.
4. Montez la requête d'envoi
L'opération d'envoi pour un seul contact nécessite essentiellement :
- L'ID du modèle (ou le nom, selon l'implémentation).
- La langue du modèle (par exemple,
pt_BR). - Le numéro de téléphone du contact, incluant l'indicatif pays (ex. :
5511999999999). - Un objet avec les valeurs des variables, si le modèle contient des placeholders.
Pour un envoi en masse (plusieurs contacts), l'appel accepte une liste de destinataires, chacun avec son numéro et, éventuellement, ses propres variables. Le modèle est le même pour tous.
5. Envoyez et vérifiez la réponse
L'API renvoie une confirmation synchrone que la demande d'envoi a été acceptée. Pour suivre le statut réel de livraison (livré, lu, échec), vous pouvez configurer un webhook sortant — Papo notifie en temps réel les événements de la conversation. L'article sur la réception d'événements en temps réel (listé dans « Lire aussi ») explique comment activer cette fonctionnalité.
Qui doit utiliser l'API pour l'envoi de HSM
Toute entreprise qui souhaite automatiser les communications transactionnelles à partir de systèmes externes bénéficie de l'API. Au lieu de dépendre de l'interface de Papo pour chaque notification, vous pouvez intégrer l'envoi directement à votre ERP, CRM ou plateforme e-commerce. Exemples courants :
- Confirmation d'achat ou mise à jour du statut de la commande.
- Rappel de consultation ou de rendez-vous envoyé 24 heures avant.
- Relance de facture échue avec le lien de paiement.
- Communication de modification de vol ou de réservation.
L'API est particulièrement utile lorsque la règle qui détermine quand envoyer le modèle réside dans un autre logiciel — par exemple, un système de logistique qui déclenche la notification de livraison dès que le colis part pour le transport.
Questions fréquentes
L'API de Papo a-t-elle un coût supplémentaire ?
L'API est disponible dans les forfaits Papo. Vous pouvez générer des jetons et utiliser les points de terminaison selon le forfait souscrit. Les détails des limites et des frais par requête se trouvent sur la page des forfaits et dans la documentation de l'API.
Dois-je créer les modèles de message via l'API ?
Non. Les modèles doivent être créés et soumis à l'approbation dans le Gestionnaire de commerce de Meta. Dès qu'ils sont approuvés, ils sont automatiquement synchronisés dans Papo et apparaissent dans la liste des modèles de l'API.
Puis-je envoyer des HSM à des numéros qui ne sont pas dans le CRM de Papo ?
Oui. Le destinataire n'a pas besoin d'être préalablement enregistré dans le CRM de la plateforme. Il suffit d'indiquer le numéro WhatsApp (avec indicatif pays et indicatif régional) dans la requête. Cependant, vous devez avoir le consentement (opt-in) du client pour recevoir la communication, en particulier si le modèle est de catégorie Marketing.
Comment savoir si le message a été livré ?
La réponse immédiate de l'API confirme que la demande a été acceptée et envoyée à WhatsApp. Pour surveiller les échecs, les livraisons et les lectures en temps réel, il est nécessaire d'activer le webhook d'événements (sortant) de Papo. Consultez le guide des webhooks dans le centre d'aide.
Existe-t-il une limite de débit pour les envois via l'API ?
Oui. Papo applique des limites de débit pour protéger la stabilité du service et respecter les politiques de WhatsApp. Il est recommandé de maintenir des vitesses modérées — éviter les pics soudains aide à préserver la santé du numéro. Les valeurs exactes se trouvent dans la documentation de l'API.
Puis-je utiliser l'API pour des campagnes marketing de masse ?
Oui, à condition d'utiliser exclusivement des modèles approuvés de catégorie Marketing et d'avoir un opt-in explicite des destinataires. Envoyer des messages indésirables peut générer des signalements et mettre votre numéro en risque de blocage. Planifiez les envois avec un contrôle de cadence et respectez toujours les politiques de WhatsApp.
Lire aussi
- Comment recevoir les événements en temps réel de Papo via Webhook (sortant)
- Comment utiliser l'API de Papo pour créer et mettre à jour des contacts en masse
Commencez à automatiser vos envois de HSM dès maintenant – essai gratuit →
Créez votre compte Papo et envoyez des modèles de message approuvés sans frais pour le premier utilisateur.