Comment exécuter un agent Claude Agent SDK sur WhatsApp (avec MonoChat)

Le Claude Agent SDK est le harness d’agent d’Anthropic : la même boucle de raisonnement, d’utilisation d’outils et d’auto-vérification qui fait fonctionner Claude Code, packagée pour que les développeurs puissent construire leurs propres agents. Pour en exécuter un sur WhatsApp, il vous faut trois choses de plus autour : une connexion à la WhatsApp Business Platform, un moyen de donner à l’agent vos outils métier et un chemin sûr vers un humain quand l’agent doit s’arrêter. Avec l’Agent Harness de MonoChat, vous ajoutez le Claude Agent SDK comme AI Harness, placez un nœud Agent IA dans un parcours, connectez votre numéro WhatsApp et testez. Aucun serveur à exploiter.

Ce guide explique ce que le Claude Agent SDK apporte aux conversations clients, comment fonctionne la configuration dans MonoChat et ce qu’il faut soigner avant que les clients ne commencent à écrire.

Ce qu’est le Claude Agent SDK (et pourquoi il convient au support)

Aujourd’hui, la plupart des IA sur WhatsApp se résument à un seul appel de modèle : un message arrive, le modèle rédige une réponse, c’est terminé. C’est suffisant pour « Quels sont vos horaires d’ouverture ? ». Cela ne tient plus pour « Ma commande n’est pas arrivée et je voyage vendredi. »

Un harness exécute le modèle en boucle. Le modèle décide de la suite, le harness exécute cette étape (chercher une information, appeler un outil, lire un fichier), renvoie le résultat au modèle et recommence, jusqu’à ce que la tâche soit terminée ou qu’une personne soit nécessaire. Le Claude Agent SDK est la version d’Anthropic de cette boucle. Il est le socle de Claude Code et fournit les briques sur lesquelles les développeurs s’appuient : utilisation d’outils, prise en charge de MCP, sous-agents, gestion du contexte pour les longues sessions et contrôles des autorisations.

Pour la messagerie client, cette boucle transforme une réponse en résolution :

• Il vérifie avant de promettre. Les stocks, l’état d’une livraison, les créneaux de rendez-vous ou une règle de remboursement sont consultés au moment de répondre au lieu d’être devinés.
• Il traite un dossier en plusieurs étapes. Retrouver la commande, vérifier le transporteur, constater que le colis est bloqué, proposer un remplacement, le tout dans une seule conversation.
• Il sait quand s’arrêter. Un bon harness confie le dossier à une personne au lieu d’improviser quand il atteint la limite de ce qu’il a le droit de faire.

Pour comprendre la différence entre un harness et une simple inférence, lisez ce qu’est un agent harness et pourquoi le support WhatsApp en a besoin.

Trois façons d’utiliser des agents Claude dans MonoChat

MonoChat propose trois voies vers un agent propulsé par Claude. Toutes trois utilisent le même nœud Agent IA, les mêmes canaux et le même passage de relais.

Option	Où il s’exécute	Ce dont vous avez besoin
Claude Agent SDK	L’agent runner de MonoChat ; chaque exécution est un processus d’agent isolé de type Claude Code	Rien de plus ; vos modèles IA via la passerelle de MonoChat
Claude Managed Agents	Le cloud d’Anthropic	Votre clé API Anthropic
Personnalisé (votre propre service Claude Agent SDK)	Votre propre serveur	Une URL d’endpoint et un secret partagé

Pour la plupart des équipes, la première option est le bon point de départ : vous obtenez le harness Claude Agent SDK sans rien déployer ni maintenir. Choisissez Claude Managed Agents si vous construisez déjà sur les agents hébergés d’Anthropic et souhaitez les y garder. Choisissez Personnalisé si vos développeurs ont construit et testé leur propre agent avec le SDK et veulent continuer à l’exécuter sur leur infrastructure ; notre guide pour connecter votre propre agent IA à WhatsApp couvre cette voie.

Pas à pas : un agent Claude Agent SDK sur WhatsApp

1. Ajouter un AI Harness

Dans MonoChat, un AI Harness est une définition de service que vous ajoutez une fois et réutilisez. Ajoutez-en un et choisissez Claude Agent SDK comme fournisseur. Il n’y a rien d’autre à configurer pour le fournisseur lui-même : il s’exécute sur l’agent runner de MonoChat et accède à vos modèles IA via la passerelle de MonoChat.

2. Ajouter un nœud Agent IA à un parcours

Ouvrez le parcours qui traite les conversations entrantes, ou créez-en un nouveau, et ajoutez un nœud Agent IA. Sélectionnez le harness que vous venez de créer. C’est ici que l’agent reçoit sa mission : rédigez des instructions qui décrivent qui il sert, ce qu’il a le droit de faire et quand il doit passer le relais.

3. Choisir les modèles principal, de secours et rapide

Chaque nœud Agent IA a trois rôles de modèles :

• Modèle principal : raisonne, décide et rédige les réponses.
• Modèle de secours : prend le relais après une limite souple ou quand le modèle principal échoue, pour que le client obtienne quand même une réponse.
• Modèle rapide : prend en charge les tâches de fond.

Définissez aussi une limite de budget par exécution. Une conversation client exige rarement une longue chaîne d’étapes, et un budget évite qu’un cas inhabituel ne devienne un cas coûteux. Notre article sur pourquoi votre agent en contact avec les clients a besoin d’un modèle de secours explique comment choisir le duo.

4. Donner des outils à l’agent

Un agent sans outils ne peut que parler. Dans MonoChat, l’agent peut utiliser :

• Les outils de fonctions IA pour appeler vos API avec des entrées structurées, par exemple « obtenir l’état d’une commande » ou « créer un retour ».
• Les serveurs MCP pour intégrer les outils de n’importe quel système compatible MCP.
• La base de connaissances IA pour des réponses fondées sur vos propres politiques et documents.
• Les fonctions personnalisées pour la logique métier qui s’exécute pendant la conversation.

Commencez avec deux ou trois outils qui couvrent vos demandes les plus courantes. Chaque outil ajouté est une chose de plus que l’agent peut faire, et une chose de plus à tester.

5. Connecter WhatsApp et vos autres canaux

Connectez votre numéro WhatsApp Business à MonoChat si ce n’est pas déjà fait (MonoChat est partenaire commercial officiel de Meta et utilise la WhatsApp Business Platform officielle). Comme l’agent vit dans un parcours, vous pouvez rattacher le même parcours à Instagram, Messenger, TikTok, Telegram, au chat web, aux SMS et à la voix sans rien reconstruire.

6. Tester, puis mettre en ligne

Envoyez à l’agent les messages que vos clients envoient réellement : courts, avec des fautes, dans plusieurs langues, trois questions dans un seul message. Vérifiez qu’il utilise le bon outil, reste dans vos règles et passe le relais au bon moment. Activez ensuite le parcours sur le trafic réel.

Rédiger les instructions d’un agent WhatsApp

Le Claude Agent SDK a grandi dans le développement logiciel, où les réponses longues et détaillées sont bienvenues. WhatsApp, c’est l’inverse. Quelques règles font une grande différence :

• Gardez des réponses courtes. Deux ou trois phrases par message, une question à la fois. Les clients lisent sur un téléphone.
• Confirmez avant d’agir. « Je peux annuler la commande 4821 et rembourser 39 €. Je procède ? » avant toute action qui coûte de l’argent ou ne peut pas être annulée.
• Énoncez explicitement la règle de passage de relais. Par exemple : « Passe le relais à une personne pour les plaintes concernant le personnel, les menaces juridiques, les remboursements supérieurs à 100 €, ou quand le client demande un humain. »
• Restez dans le périmètre de votre entreprise. Depuis le 15 janvier 2026, les conditions de WhatsApp excluent de la plateforme les assistants IA généralistes. Un agent qui sert vos propres clients est autorisé ; un agent qui rédige des dissertations sur n’importe quel sujet ne l’est pas. Notre guide de la politique WhatsApp sur les chatbots IA explique la règle.
• Respectez la fenêtre de 24 heures. Les réponses libres sont autorisées dans les 24 heures suivant le dernier message du client. Passé ce délai, un message nécessite un modèle approuvé.

Passage de relais : ce qui fait ou défait la confiance

Les clients pardonnent à un agent qui dit « Je vais chercher un collègue ». Ils ne pardonnent pas à celui qui tourne en boucle. Dans MonoChat, l’agent confie la conversation à votre équipe dans la boîte de réception partagée avec tout l’historique : ce que le client a demandé, ce que l’agent a consulté et ce qu’il a déjà essayé. La personne qui la reprend n’a pas besoin de demander au client de tout recommencer.

Prévoyez vos règles de passage de relais avant de prévoir vos outils. Décidez quels cas l’agent ne doit jamais traiter seul, qui les reçoit et ce que l’agent dit au client pendant qu’il attend.

Coûts et contrôle

Avec un agent, deux lignes de coûts s’ajoutent à votre formule MonoChat : l’usage des modèles d’IA et les frais WhatsApp de Meta. Depuis le 1er octobre 2026, Meta facture les réponses de service après les 1 000 premières par numéro d’entreprise chaque mois ; notre guide des tarifs de l’API WhatsApp détaille tout cela.

Côté IA, MonoChat n’ajoute aucune majoration quand vous utilisez vos propres clés de fournisseur. Une limite de budget par exécution, un modèle de secours pertinent et un modèle rapide pour les tâches de fond rendent l’usage prévisible quand le volume augmente.

Quand choisir un autre harness

Le Claude Agent SDK est un excellent choix par défaut pour les agents qui doivent raisonner en plusieurs étapes. Mais Agent Harness est conçu pour que vous ne soyez pas enfermé. Si votre équipe travaille déjà avec l’OpenAI Agents SDK, Pi, un agent OpenAI ou Anthropic hébergé, ou son propre framework, vous pouvez ajouter un autre AI Harness et y basculer le nœud Agent IA, sans toucher à vos canaux, à vos outils ni au passage de relais. Découvrez toutes les options sur la page Agent Harness.