WhatsApp Business API : Erreurs courantes et depannage

Ce guide fournit des solutions pour les erreurs d'integration, de modeles et de messagerie les plus frequentes rencontrees lors de l'utilisation de WhatsApp Business API avec WhatsTeam.

Erreurs d'integration et de configuration

Ce numero est enregistre sur un compte WhatsApp existant

Cette erreur se produit si votre numero de telephone est deja lie a un autre fournisseur WhatsApp Business API ou a l'application mobile WhatsApp/WhatsApp Business standard.

• Si vous utilisez un autre fournisseur API : Suivez notre guide de migration pour transferer votre numero vers WhatsTeam.
• Si vous utilisez l'application mobile : Vous devez formellement deconnecter le numero de l'application avant de pouvoir l'utiliser avec Cloud API. Notez que cela supprimera votre historique de conversations local sauf si vous avez une sauvegarde.
• Toujours bloque ? Contactez notre equipe de support a support@whats.team avec votre WhatsApp Business Account ID et votre numero de telephone pour une assistance manuelle.

Le code n'a pas pu etre envoye ou erreur 500 dans la console

Si vous ne recevez pas de code de verification ou voyez une "Erreur interne du serveur 500" lors de l'inscription :

1. Verifiez la console : Consultez la console developpeur de votre navigateur. Souvent, il s'agit d'erreurs de validation de Meta concernant les parametres de votre profil professionnel (par exemple, description trop longue).
2. Essayez le flux de premiere connexion : Si vous tentiez une migration, essayez plutot le parcours "Configuration initiale", car le compte a peut-etre deja ete partiellement cree.
3. Attendez et reessayez : Les serveurs de Meta connaissent parfois des retards transitoires. Attendez 5 a 10 minutes avant de demander un nouveau code.

Acces au WhatsApp Business Account non partage

Cela se produit lorsque la connexion entre votre Meta Business Account et WhatsTeam n'a pas ete entierement autorisee ou que les permissions ont ete revoquees.

• Resolution : Relancez le processus d'Embedded Signup et assurez-vous que toutes les cases de permissions sont cochees.

Requete get non prise en charge ou identifiant invalide

Erreur : "L'objet avec l'ID XXX n'existe pas..." Cela se produit generalement lorsqu'un identifiant Business Manager est saisi au lieu d'un identifiant WhatsApp Business Account (WABA). Verifiez que vous utilisez l'identifiant WABA que vous trouverez dans vos parametres Meta Business sous "Comptes WhatsApp".

Impossible de migrer le numero de telephone

Erreur : "Impossible de migrer le numero de telephone. Le compte WhatsApp auquel ce numero est enregistre n'est pas configure correctement."

1. Verifiez que le numero est entierement approuve dans votre Meta Business Suite.
2. Assurez-vous que le numero n'est plus actif sur aucun appareil mobile.
3. Prenez une capture d'ecran du numero verifie dans votre tableau de bord Meta et envoyez-la a notre equipe de support si le probleme persiste.

Impossible de creer le certificat (conflit 2FA)

WhatsApp ne peut pas generer de certificat de securite si l'authentification a deux facteurs (2FA) est activee sur le numero de telephone dans l'application mobile. Desactivez la 2FA dans les parametres de votre application WhatsApp avant de tenter de vous connecter a WhatsTeam.

Veuillez vous assurer d'autoriser completement l'acces

Ce message apparait generalement s'il y a un delai de synchronisation entre l'approbation de Meta et notre plateforme.

• Resolution : Actualisez votre navigateur et attendez 2 a 5 minutes pour que les permissions se propagent dans les systemes.

WABA utilisant deja un mode de paiement

Cela se produit lorsqu'un numero a ete precedemment provisionne par un fournisseur tiers qui a attache son propre mode de paiement. Vous devez completer le processus de migration pour transferer le numero sous votre propre Meta Business Account et structure de paiement.

Problemes de modeles de messages

Les modeles n'apparaissent pas dans le tableau de bord

Si vos modeles Meta approuves ne s'affichent pas dans WhatsTeam :

• Texte brut uniquement : Assurez-vous que le modele n'utilise pas de types de medias non pris en charge ou d'elements interactifs complexes pas encore pris en charge dans la vue actuelle.
• Correspondance linguistique : Verifiez que la langue du modele correspond aux parametres de langue de votre compte.
• Statut de synchronisation : L'approbation Meta peut prendre jusqu'a 24 heures. Si le modele est deja approuve dans Meta, essayez d'actualiser votre connexion dans le tableau de bord.

Formatage des variables (espaces reserves numeriques)

WhatsApp Cloud API requiert des espaces reserves numeriques (par exemple, {{1}}, {{2}}) dans le corps du modele.

• Incorrect : Bonjour {{name}}, votre commande {{order_id}} est prete.
• Correct : Bonjour {{1}}, votre commande {{2}} est prete. Vous pouvez ensuite mapper ces variables numeriques aux attributs utilisateur dans WhatsTeam lors de l'envoi du message.

Prevenir la reclassification en "Marketing"

Meta peut automatiquement reclassifier les modeles "Utilitaire" ou "Service" en "Marketing" s'ils contiennent un langage promotionnel.

• Conseil : Gardez un langage neutre, evitez les emojis dans les mises a jour transactionnelles et soyez tres specifique quant a l'objectif du service lors de la soumission pour approbation.

Problemes de livraison des messages

Message non livrable / Destinataire incapable

Cela signifie generalement que le compte WhatsApp du destinataire ne peut pas recevoir le message.

• Causes : Le numero n'est pas sur WhatsApp, l'utilisateur n'a pas accepte les dernieres Conditions d'utilisation, ou il utilise une version extremement obsolete de l'application.
• Solution : Demandez a l'utilisateur (par SMS ou email) de vous envoyer un message en premier pour "amorcer" la conversation et assurez-vous que son application est a jour.

Limites de frequence de messagerie

Si un message echoue en raison de "limites de frequence", Meta a plafonne le nombre de modeles marketing que cet utilisateur specifique peut recevoir sur une courte periode pour prevenir le spam.

• Action : Attendez 24 heures avant de tenter de renvoyer. Consultez la documentation de Meta pour plus de details.

La fenetre de conversation de 24 heures

WhatsApp applique une fenetre de service de 24 heures. Vous ne pouvez envoyer des messages en forme libre que si l'utilisateur a repondu dans les 24 dernieres heures.

• Si la fenetre est fermee : Vous devez envoyer un message modele pre-approuve pour re-engager l'utilisateur. Une fois qu'il repond, la fenetre de 24 heures pour la conversation libre se rouvre.

Type de media non pris en charge

Si une image ou un document ne parvient pas a s'envoyer :

• Verifiez que la taille du fichier respecte les limites de Meta.
• Assurez-vous que le format de fichier (par exemple, .jpg, .pdf, .mp4) est pris en charge par la plateforme WhatsApp.

Le destinataire fait partie d'une experience WhatsApp

Occasionnellement, Meta mene des experiences ou certains messages marketing ne peuvent pas etre livres a des utilisateurs specifiques. Si vous voyez une erreur mentionnant une "experience", essayez d'envoyer un type de message different ou renvoyez plus tard.

Compte restreint ou verrouille

Si vous recevez une erreur indiquant que le "Compte est verrouille", votre WABA a peut-etre ete suspendu pour violation des politiques.

• Resolution : Verifiez votre boite de reception du support Meta Business Suite pour toute notification concernant l'application des politiques et suivez leurs instructions pour faire appel ou resoudre la restriction.

Besoin d'aide supplementaire ?

Si votre probleme n'est pas couvert ici, notre equipe de support est prete a vous aider. Contactez-nous a support@whats.team.