Power Automate + CaptchaAI : résolution de CAPTCHA Microsoft Flow

Power Automate ne propose aucune action native pour les CAPTCHA : dès qu'un formulaire protégé apparaît dans un flux, l'exécution s'arrête et attend une intervention humaine. Trois actions du connecteur HTTP suffisent pourtant — envoyer le défi à CaptchaAI, interroger le résultat dans une boucle Do until, puis injecter le token.

Ce guide le construit pour reCAPTCHA v2 : paramètres exacts de chaque action, attente bornée, erreurs fréquentes en production.

Ce qu'il faut préparer

Un cas concret : rapprochement de factures fournisseurs

Une équipe finance basée à Lyon récupère chaque lundi les relevés d'un portail fournisseur protégé par reCAPTCHA v2. Jusqu'ici, un comptable ouvrait le portail, cliquait la case, exportait le CSV. Le flux reprend cette séquence sans l'attente.

Deux réflexes dès la conception : hébergez l'environnement Power Platform dans une région européenne si vos données le justifient, et n'écrivez ni identifiants ni données personnelles dans les sorties d'actions — l'historique d'exécution les conserve, ce qui touche vos obligations RGPD.

Étape 1 : créer le flux et ses entrées

Créez un flux cloud instantané avec un déclencheur manuel (un déclencheur planifié convient aussi), puis ajoutez-lui deux entrées texte :

Les passer en entrée rend le flux réutilisable pour tous vos portails.

Étape 2 : envoyer le défi à CaptchaAI

L'action HTTP de soumission

Ajoutez une action HTTP. Les noms de paramètres sont sensibles à la casse.

Lire la réponse

Ajoutez une action Analyser JSON juste après, avec ce schéma :

{
  "type": "object",
  "properties": {
    "status": { "type": "integer" },
    "request": { "type": "string" }
  }
}

Contenu : @{body('HTTP')}

Étape 3 : valider la réponse de soumission

Une action Condition sur @{body('Parse_JSON')?['status']} sépare les deux sorties possibles.

Étape 4 : construire la boucle d'interrogation

Avant la boucle, initialisez deux variables de type Chaîne : solveStatus à pending et solvedToken vide.

Dans la branche « Si oui », ajoutez une boucle Do until dont la condition est : @{variables('solveStatus')} n'est pas égal à pending. Quatre actions s'y enchaînent :

1. Délai de 5 secondes — interroger plus vite n'accélère rien.
2. HTTP vers res.php, qui réclame le résultat.
3. Analyser JSON, schéma de l'étape 2, nommée Parse_JSON_2.
4. Condition sur le statut renvoyé.

La requête d'interrogation se configure ainsi :

La condition finale, @{body('Parse_JSON_2')?['status']} est égal à 1, tranche trois cas :

Bornez enfin la boucle dans ses paramètres avancés : 20 itérations maximum, délai d'expiration PT3M (3 minutes). Sans ces bornes, un portail muet fait tourner le flux jusqu'au quota.

Étape 5 : injecter le token résolu

Après la boucle, une Condition sur @{variables('solveStatus')} sépare les deux issues. Si la valeur est solved, poussez le token dans la requête finale, ou transmettez-le à un autre connecteur (Teams, Outlook, Dataverse).

Sinon, notifiez l'échec avec l'identifiant de la tâche. Le token est à usage unique et sa durée de vie est courte : soumettez le formulaire dans la même exécution.

Dépannage

Le flux ne démarre pas

Le flux démarre puis dérape

Dimensionner les threads

Un thread reste occupé de la soumission jusqu'au retour du token : un flux quotidien n'en mobilise qu'un, et BASIC couvre cinq flux simultanés. Si vous parallélisez une liste avec Appliquer à chacun, ne dépassez pas vos threads disponibles — au-delà, les tâches attendent et les boucles épuisent leurs 20 itérations pour rien.

Récapitulatif : le flux complet

[Manual Trigger (sitekey, pageurl)]
    ↓
[Initialize Variables: solveStatus, solvedToken]
    ↓
[HTTP: Submit to CaptchaAI /in.php]
    ↓
[Parse JSON]
    ↓
[Condition: status = 1?]
    ↓ Yes
[Do Until: solveStatus ≠ pending]
    ├── [Delay: 5 seconds]
    ├── [HTTP: Poll CaptchaAI /res.php]
    ├── [Parse JSON]
    └── [Condition: Solved or Error?]
    ↓
[Condition: solveStatus = solved?]
    ↓ Yes
[HTTP: Submit form with token]
    ↓
[Compose: Success response]

Dupliquez ce squelette pour chaque portail : seules les entrées changent.

Questions fréquentes

Faut-il une licence Power Automate Premium pour ce flux ?

Oui, pour le connecteur HTTP. Deux replis possibles : un connecteur personnalisé, ou une Azure Function appelée depuis le flux.

Combien de threads ce flux consomme-t-il ?

Un seul par CAPTCHA en cours, libéré dès le retour du token. La facturation dépend des résolutions simultanées, pas du temps d'attente.

CaptchaAI prend-il en charge hCaptcha depuis Power Automate ?

Non — hCaptcha n'est pas pris en charge, FunCaptcha non plus. Pour un type pris en charge, changez method : turnstile pour Cloudflare Turnstile, post pour les CAPTCHA d'image.

Que se passe-t-il si la boucle atteint ses 20 itérations sans token ?

Le flux sort avec solveStatus resté à pending et part dans la branche d'échec. Relancez l'exécution plutôt que de rallonger l'attente : le défi expire aussi côté portail.

Où lire le code d'erreur quand une exécution échoue ?

Dans l'historique d'exécution, sur la sortie de l'action HTTP concernée : le champ request y porte le code exact, ERROR_ZERO_BALANCE ou ERROR_WRONG_USER_KEY par exemple.

Pour aller plus loin

Montez ce flux dans votre environnement de test, puis récupérez votre clé API CaptchaAI pour le passer en production.

• Résoudre un reCAPTCHA v2 avec callback via l'API
• Gérer reCAPTCHA v2 et Turnstile sur un même site
• Comprendre le mécanisme de callback de reCAPTCHA v2
• La même intégration côté Zapier, sans code
• Le scénario équivalent dans Make (Integromat)
• Gérer les CAPTCHA dans un outil interne Retool