Cet article couvre les erreurs que vous pouvez rencontrer lors de l'utilisation de l'API publique WhatsApp, la façon dont les évaluations de qualité et les paliers de messagerie affectent votre capacité d'envoi, et ce que vous pouvez résoudre vous-même par rapport à ce qui nécessite une action de Meta ou du support Aircall.
Référence des erreurs
| Erreur | Ce que cela signifie | Que faire |
|---|---|---|
| 403 | Le compte est sur Essentials, n'a aucun module complémentaire WhatsApp actif, ou la fonctionnalité n'est pas activée | Confirmez le forfait et le statut du module complémentaire dans le tableau de bord Aircall. Veuillez contacter le support Aircall pour vérifier que la fonctionnalité est disponible sur votre forfait. |
| 400 — line not configured | La ligne n'a pas été enregistrée pour une utilisation de l'API publique | Appelez d'abord POST /v1/numbers/{id}/messages/configuration. |
| 400 — template not approved | Le modèle envoyé n'est pas au statut APPROVED dans Meta | Vérifiez le statut du modèle dans Meta Business Manager. Cela ne peut pas être résolu par Aircall. |
| 63016 — 24-hour window expired | L'envoi renvoie une réponse 200, mais votre webhook reçoit un rappel avec une erreur lorsque du texte libre est envoyé en dehors de la fenêtre de conversation | Utilisez un modèle approuvé pour relancer une conversation avec votre client. Consultez la section sur la fenêtre de 24 heures dans l'article Premiers pas avec l'API publique WhatsApp . |
| 400 — WABA not configured | La ligne WhatsApp n'a pas de WABA (compte WhatsApp Business) configuré | Veuillez contacter le support Aircall. Il s'agit d'un problème de configuration de ligne. |
| 400 — line OFFLINE or BLOCKED | La ligne n'est pas dans un état d'envoi actif | Vérifiez le endpoint de santé de la ligne. Si elle est BLOCKED, veuillez contacter le support Aircall. |
| 429 | Limite du palier de messagerie dépassée : plafond quotidien de conversations atteint | Limite imposée par Meta. Réinitialisation toutes les 24 heures. Ne peut pas être contournée par Aircall. |
| 131048 | Limite de taux de spam Meta : les envois depuis ce numéro sont restreints par Meta | Vérifiez la qualité de votre messagerie et contactez le support Meta Business. Aircall ne peut pas la contourner. |
| 131045 | Erreur d'enregistrement du numéro de téléphone avec un fournisseur externe | Veuillez contacter le support Aircall |
| 131000 | Erreur Meta inconnue | Si l'erreur persiste, veuillez contacter le support Aircall avec votre ID d'entreprise, l'ID de ligne, la payload d'erreur complète et un horodatage. |
La fenêtre de conversation de 24 heures
La fenêtre de conversation de WhatsApp est une règle Meta, pas un paramètre Aircall. Elle contrôle quand des messages texte libres peuvent être envoyés.
- Une fenêtre de 24 heures s'ouvre lorsqu'un client envoie un message à votre numéro, ou lorsqu'il répond à l'un de vos messages.
- Dans cette fenêtre, vous pouvez envoyer du texte libre.
- Une fois la fenêtre fermée, vous pouvez uniquement envoyer un modèle approuvé pour redémarrer la conversation.
Important: Tenter d'envoyer du texte libre en dehors d'une fenêtre ouverte renverra une erreur à votre webhook. La solution consiste toujours à envoyer d'abord un modèle approuvé. Aircall ne peut pas contourner ni prolonger la fenêtre.
Évaluation de la qualité
Meta attribue à chaque ligne WhatsApp une évaluation de qualité basée sur la façon dont les destinataires réagissent aux messages provenant de ce numéro. Si les destinataires bloquent fréquemment votre numéro ou le signalent, l'évaluation se dégrade.
- GREEN: ligne en règle, aucune restriction d'envoi.
- YELLOW: la qualité se dégrade, souvent parce que les clients signalent vos messages comme spam ou bloquent votre numéro. Vérifiez la qualité des modèles et envisagez de réduire le volume d'envoi.
- RED: Meta a restreint cette ligne. Les envois peuvent échouer. Contactez le support Meta Business.
Important: Les évaluations de qualité sont définies et contrôlées par Meta. Aircall ne peut pas les modifier. Améliorer votre évaluation nécessite de meilleurs modèles, des listes de contacts plus propres et des consentements confirmés des destinataires.
Paliers de messagerie
Meta limite le nombre de conversations initiées par l'entreprise qu'une ligne peut démarrer par période de 24 heures. C'est le palier de messagerie. Les paliers augmentent automatiquement à mesure que Meta gagne en confiance dans la qualité et les schémas d'envoi d'un numéro. Il n'existe aucun processus manuel pour demander une augmentation de palier.
| Palier | Conversations par 24 heures | Type de compte typique |
|---|---|---|
| TIER_250 | 250 | Lignes nouvelles ou non vérifiées |
| TIER_1K | 1,000 | Entreprises vérifiées standard |
| TIER_10K | 10,000 | Expéditeurs établis et de haute qualité |
| TIER_100K | 100,000 | Entreprises vérifiées à fort volume |
Remarque: Si votre intégration renvoie une erreur 429, la limite quotidienne du palier a été atteinte. La limite se réinitialise toutes les 24 heures. Intégrez une logique de nouvelle tentative dans votre intégration pour ce cas.
Ce que vous pouvez et ne pouvez pas contrôler
Certaines limitations sont définies par Meta et ne peuvent pas être modifiées par Aircall ni par vous.
Les éléments suivants ne peuvent être contournés par personne chez Aircall :
- Évaluations de qualité
- Limites des paliers de messagerie
- Débloquer un numéro que Meta a restreint
- Approuver ou rejeter les modèles de message WhatsApp
- La fenêtre de conversation de 24 heures
Contactez le support Aircall pour :
- Vérification ou activation du statut de la fonctionnalité
- Erreurs WABA not configured (400)
- Lignes OFFLINE ou BLOCKED
- Erreurs d'enregistrement de numéro de téléphone (131045)
- Erreurs inconnues persistantes (131000) : fournissez votre ID d'entreprise, l'ID de ligne, la payload d'erreur complète et l'horodatage
Contactez directement le support Meta Business pour :
- Restrictions de taux de spam (131048)
- Dégradation de l'évaluation de la qualité
- Lignes entièrement bloquées par Meta
FAQ
Mes appels API renvoient une 403 alors que nous avons un module complémentaire WhatsApp. Quel est le problème ?
Une 403 peut aussi signifier que la fonctionnalité n'est pas encore activée pour votre compte, ou que votre forfait est Essentials. Veuillez contacter le support Aircall pour confirmer que toutes les conditions d'éligibilité sont remplies : forfait Pro ou supérieur, module complémentaire WhatsApp actif, et ligne enregistrée.
Puis-je envoyer un message à un client qui ne nous a jamais envoyé de message en premier ?
Oui, utilisez un modèle approuvé. Les modèles approuvés peuvent être envoyés en dehors de la fenêtre de 24 heures pour initier le contact. Les messages texte libres nécessitent une fenêtre de conversation ouverte, ce qui signifie que le client doit vous avoir envoyé un message ou avoir répondu au cours des dernières 24 heures.
Pourquoi ma ligne affiche-t-elle une évaluation de qualité YELLOW ou RED ?
Meta dégrade les évaluations de qualité lorsque les destinataires bloquent ou signalent les messages provenant de votre numéro. Cela résulte généralement de l'envoi de messages non sollicités, de l'utilisation de modèles de faible qualité, ou de messages envoyés à des contacts qui n'ont pas donné leur consentement. Aircall ne peut pas modifier cette évaluation. Améliorez vos pratiques de messagerie et laissez le temps à l'évaluation de se rétablir naturellement.
À quelle vitesse les limites des paliers de messagerie se réinitialisent-elles ?
Toutes les 24 heures à partir du moment où la limite a été atteinte. Si vous recevez une erreur 429, attendez 24 heures avant de réessayer. Les paliers augmentent automatiquement au fil du temps à mesure que Meta gagne en confiance dans la qualité de vos envois.
Nous voulons que HubSpot ou Salesforce envoie automatiquement des messages WhatsApp. Par où commencer ?
Commencez par l'article de prise en main lié ci-dessous. Une fois votre ligne enregistrée, votre équipe CRM ou RevOps peut créer des workflows qui appellent POST /v1/messages/whatsapp/send lorsque les étapes d'une opportunité changent, que les contrats sont prêts, ou que d'autres événements déclencheurs se produisent.
Statut Aircall
Problèmes d'authentification