Erreur WhatsApp 10 : permission refusée, cause et solution

L'erreur WhatsApp 10 signifie qu'une permission nécessaire à l'appel n'a pas été accordée ou a été retirée. Sur la Cloud API, le cas le plus fréquent est trompeur : créer un template AUTHENTICATION (code OTP) pour une entreprise non vérifiée par Meta renvoie « Application does not have permission for this action ». Le problème est l'entreprise, pas l'application.

Que signifie l'erreur 10 ?

Meta la classe parmi les erreurs d'autorisation :

« Permission is either not granted or has been removed. » — Meta, codes d'erreur de la Cloud API

La solution que Meta propose couvre trois pistes : vérifier dans le débogueur de jetons que l'app a reçu les permissions exigées par l'endpoint ; pour les WhatsApp Flows avec endpoint, vérifier que le numéro utilisé pour déclarer la clé publique de l'entreprise est sur liste autorisée ; et vérifier les conditions d'éligibilité de l'API appelée, car un compte non éligible reçoit précisément ce code. Dans la documentation générale de Graph, le code 10 s'appelle « API Permission Denied » (Meta, Graph API, gestion des erreurs).

Quand l'erreur 10 apparaît-elle ?

Le cas du template OTP

C'est celui qui fait perdre des heures. Sur les comptes connectés à Genuka WA, nous constatons que :

• la création d'un template AUTHENTICATION échoue avec le message « Application does not have permission for this action » quand l'entreprise n'a pas passé la vérification Meta ;
• les templates MARKETING et UTILITY du même compte sont créés normalement ;
• l'état de santé du compte porte l'erreur 141010, « The Business has not passed business verification ».

Un développeur a rapporté la même réponse sur le forum de Meta, avec error_subcode: 2388185 et le message utilisateur « This WhatsApp Business account does not have permission to create message template » (forum développeurs Meta). Le message accuse l'application. Aucun réglage de jeton ou de permission n'y change rien.

Vous ne pouvez pas non plus contourner le blocage avec un template utilitaire : dès qu'une application propose de recevoir des mots de passe à usage unique ou des codes de vérification par WhatsApp, Meta impose un template d'authentification (Meta, Authentication templates).

Où la voir dans Genuka WA ?

Genuka WA range le code 10 dans la classe config : jeton, permission ou enregistrement, rien que réessayer puisse régler.

{
  "error": "meta_rejected",
  "message": "Application does not have permission for this action",
  "meta": {
    "errorClass": "config",
    "retryable": false,
    "code": 10,
    "traceId": "AbC…"
  }
}

Comment corriger l'erreur 10 ?

Sur un template d'authentification

Sur une permission manquante

• Si vous détenez le jeton : ouvrez-le dans le débogueur de jetons, vérifiez whatsapp_business_management et whatsapp_business_messaging, et régénérez-le avec ces deux permissions s'il en manque une (Meta, support WhatsApp).
• Si vous passez par Genuka WA : vous n'avez pas de jeton Meta à corriger. Un code 10 hors template d'authentification relève de Genuka : écrivez au support avec l'en-tête x-request-id et meta.traceId.

Comment éviter l'erreur 10 ?

• Faites vérifier l'entreprise avant de prévoir des OTP sur WhatsApp. C'est un prérequis de Meta, pas une option de Genuka.
• Testez le parcours d'authentification sur un compte vérifié avant d'annoncer la fonctionnalité : un compte de test non vérifié échouera toujours.
• Gardez les deux permissions WhatsApp sur tout jeton que vous générez vous-même.

Quels codes sont liés ?

• 141010 : l'entreprise n'a pas passé la vérification Meta.
• 200 : le jeton n'a pas accès au compte, ou la permission manque (200 à 299).
• 3 : capacité ou permission manquante pour cet endpoint.
• 190 : le jeton a expiré.

FAQ

Pourquoi Meta parle-t-il de l'application alors que mon jeton est bon ?

Parce que le message est générique. Sur un template AUTHENTICATION, nous le voyons quand l'entreprise n'est pas vérifiée, alors que le jeton et ses permissions sont corrects : les templates marketing et utilitaires du même compte passent.

Puis-je envoyer des codes OTP avec un template utilitaire en attendant ?

Non. Meta exige un template d'authentification pour les codes à usage unique. En attendant la vérification, envoyez vos codes par un autre canal, SMS ou e-mail.

Faut-il régénérer ma clé API Genuka ?

Non. Votre clé Genuka n'intervient pas dans les permissions Meta. Un problème de clé produit un 401 de Genuka, jamais un code 10.

Le code 10 bloque-t-il aussi mes envois ?

Pas dans le cas du template OTP : seule la création de templates AUTHENTICATION est refusée. Vos templates marketing et utilitaires approuvés continuent de partir.

Sources

• Meta — Error codes
• Meta — Graph API, Handling errors
• Meta — Authentication templates
• Meta — Health status
• Meta — WhatsApp Business Account API
• Meta — Messaging limits
• Meta — WhatsApp support, authentication and authorization errors
• Meta — Faire vérifier votre entreprise dans Meta Business Suite
• Forum développeurs Meta — erreur 10 sur un template d'authentification