Résolution des problèmes et FAQ

Message accepté mais non livré

Une réponse 200 du point de terminaison des messages sortants signifie qu’ElevenLabs a accepté et transmis la requête. La livraison dépend toujours de Meta. Si le message n’arrive jamais, vérifiez dans cet ordre :

1. Approbation du modèle : le modèle doit avoir le statut Approved dans WhatsApp Manager. Les modèles en attente ou rejetés ne sont pas livrés.
2. Paiements : une méthode de paiement manquante ou des paiements non réglés sur votre compte WhatsApp Business bloquent la livraison des modèles (erreur Meta 131042). Ajoutez ou mettez à jour la méthode de paiement dans WhatsApp Manager.
3. Format des paramètres : les entrées template_params doivent être des objets de composant ({"type": "body", "parameters": [...]}), chaque espace réservé du modèle doit être renseigné, et les modèles nommés nécessitent un parameter_name sur chaque valeur. Consultez les paramètres de modèle.
4. Format du destinataire : whatsapp_user_id ne contient que des chiffres avec l’indicatif pays, sans +. Consultez le format du numéro du destinataire.
5. Limites marketing : Meta limite le nombre de modèles marketing qu’un utilisateur peut recevoir sur une période donnée (erreur 131049). Les modèles utilitaires ne sont pas soumis à cette limite.

Problèmes d’importation

• Le numéro ne peut pas être importé : il est enregistré auprès d’un autre fournisseur WhatsApp ou actif dans l’application WhatsApp Business. Un numéro ne peut être enregistré qu’auprès d’un seul fournisseur. Consultez les limitations.
• Votre WABA n’apparaît pas dans le flux d’importation : vérifiez que vous êtes connecté à un compte Facebook disposant d’un accès administrateur au portefeuille professionnel propriétaire du WABA, puis réessayez l’importation.
• Les WABA créés sous une application développeur Meta ne peuvent pas être importés via le flux standard.

Vérifier si un autre partenaire gère le numéro

Un numéro qui semble inéligible, manque dans le flux d’importation ou renvoie une erreur à l’importation est souvent encore enregistré auprès d’un fournisseur précédent. Un partenaire qui contrôle le numéro explique à la fois un échec d’importation et un WABA manquant.

1. Accédez à business.facebook.com et sélectionnez le portefeuille professionnel.
2. Ouvrez Paramètres professionnels > Comptes WhatsApp.
3. Vérifiez les Numéros de téléphone de chaque compte WhatsApp jusqu’à trouver celui qui contient votre numéro.
4. Ouvrez Partenaires.
5. Déconnectez le numéro de ce partenaire, ou supprimez l’ensemble du portefeuille professionnel, puis réessayez l’importation quelques minutes plus tard.

L’agent ne répond pas aux messages entrants

L’accusé de lecture et l’indicateur de saisie permettent de cerner la cause : ils sont envoyés dès qu’un message est accepté pour traitement, avant que l’agent ne produise une réponse. Lorsque Activer l’indicateur de saisie est activé, ce qui est le paramètre par défaut, envoyez un message de test et vérifiez si votre message est marqué comme lu et si l’indicateur de saisie apparaît.

L’indicateur de saisie apparaît, mais aucune réponse n’arrive. Le message a atteint ElevenLabs et l’agent a commencé à travailler. L’échec survient lors de la production ou de la livraison de la réponse :

• L’agent requiert une variable dynamique sans valeur. Les conversations WhatsApp entrantes démarrent sans variables dynamiques fournies par l’utilisateur, seules les variables système sont renseignées. La solution consiste à utiliser un webhook d’initialisation de conversation qui renvoie toutes les variables requises par l’agent. Consultez le contexte d’initialisation. Les valeurs saisies sous Variables dynamiques dans l’éditeur d’agent sont des espaces réservés de test et ne sont pas utilisées en production.
• Meta a refusé la réponse de l’agent, par exemple en raison d’une limite de débit pour cette paire entreprise-utilisateur ou d’un problème de paiement au niveau du compte. Consultez la référence des erreurs ci-dessous.

La conversation échoue si ces variables dynamiques requises ne sont pas présentes.

Aucun indicateur de saisie n’apparaît. Le message a été abandonné avant d’atteindre l’agent :

• Aucun agent n’est attribué au numéro, ou le commutateur Activer la messagerie est désactivé. Vérifiez les paramètres du compte sur la page WhatsApp.
• L’autorisation du compte n’est plus valide : le jeton d’accès a expiré ou a été révoqué côté Meta. Réimportez le compte sur la page WhatsApp.
• Le Workspace de l’agent est en mode zéro rétention, qui ignore entièrement les messages WhatsApp entrants.
• Le message entrant est d’un type non pris en charge, par exemple une vidéo ou une réponse WhatsApp Flow. Consultez les limitations.

La première réponse après un modèle ne fonctionne pas comme prévu

Si le remplacement Premier message est activé pour votre agent dans son onglet Sécurité, il peut entrer en conflit avec les conversations de modèles sortants : le modèle a déjà servi de premier message. Si les réponses aux modèles se comportent de façon inattendue, supprimez le remplacement du premier message pour les agents utilisés avec les messages sortants WhatsApp.

Référence des erreurs Meta

Les erreurs renvoyées par Meta lors de la livraison s’affichent avec des conseils de résolution lorsque cela est possible. Les plus courantes :

Pour la liste complète, consultez la référence des codes d’erreur de Meta.

FAQ