Comment créer un agent WhatsApp avec l’OpenAI Agents SDK

L’OpenAI Agents SDK est le framework open source d’OpenAI pour construire des agents : un modèle avec des instructions, des outils qu’il peut appeler, des transferts vers d’autres agents et des garde-fous sur ses entrées et ses sorties, le tout exécuté en boucle jusqu’à ce que la tâche soit terminée. C’est un excellent moyen de construire un agent. En revanche, il ne vous fournit pas à lui seul un numéro WhatsApp, une boîte de réception d’équipe, des messages modèles ni un moyen pour une personne de prendre le relais. Avec l’Agent Harness de MonoChat, vous choisissez l’OpenAI Agents SDK comme AI Harness, placez un nœud Agent IA dans un parcours, connectez WhatsApp et testez, et MonoChat s’occupe du reste.

Ce guide présente ce que le SDK vous apporte, les trois façons d’utiliser des agents OpenAI dans MonoChat, une configuration pas à pas et les détails propres à WhatsApp qui déterminent si les clients font confiance à l’agent.

Ce que l’OpenAI Agents SDK vous apporte

Le SDK repose sur un petit nombre d’idées :

• Agents : un modèle plus des instructions qui décrivent sa mission.
• Outils : des fonctions que l’agent peut appeler, comme « consulter une commande » ou « vérifier un créneau », ainsi que des serveurs MCP.
• Transferts (handoffs) : un agent qui confie la tâche à un autre spécialisé, par exemple d’un agent de support généraliste à un agent des retours.
• Garde-fous : des contrôles qui s’exécutent en parallèle de l’agent pour bloquer les entrées ou sorties indésirables.
• Sessions et traçage : une mémoire d’un tour à l’autre et une trace de ce que l’agent a fait, étape par étape.

Ensemble, cela forme un agent harness : la boucle qui permet à un modèle d’agir, de vérifier son travail et de continuer, au lieu de répondre une seule fois. Pour la messagerie client, c’est la différence entre expliquer votre politique de retour et créer réellement le retour.

Ce que WhatsApp ajoute au problème

Construire l’agent n’est que la moitié du travail. Le placer devant des clients sur WhatsApp implique de gérer :

• La WhatsApp Business Platform. Une connexion API officielle, une entreprise vérifiée et un numéro approuvé.
• 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, il faut un modèle approuvé.
• La politique. Depuis le 15 janvier 2026, WhatsApp exclut de la plateforme les assistants IA généralistes. Un agent qui sert vos propres clients est autorisé, et une voie claire vers un humain est attendue lorsque les réponses sont automatisées.
• Les personnes. Certaines conversations doivent aller à une personne, avec l’historique intact, dans l’outil que votre équipe utilise déjà.
• Les autres canaux. Les clients qui écrivent sur Instagram, Messenger ou votre site web attendent les mêmes réponses.

MonoChat gère tout cela autour de l’agent, afin que votre travail se concentre sur l’agent lui-même.

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

Option	Où il s’exécute	Ce dont vous avez besoin
OpenAI Agents SDK	Dans MonoChat	Rien de plus ; utilise vos modèles IA
OpenAI Agents API (hébergée par OpenAI)	Le cloud d’OpenAI	Votre clé API OpenAI
Personnalisé (votre propre service Agents SDK)	Votre propre serveur	Une URL d’endpoint et un secret partagé

Commencez avec le harness OpenAI Agents SDK si vous voulez un agent de type OpenAI sans rien déployer. Choisissez l’OpenAI Agents API si vos agents vivent déjà sur la plateforme hébergée d’OpenAI. Choisissez Personnalisé si vos développeurs ont écrit leur propre agent avec le SDK, avec leurs outils, leurs transferts et leurs tests, et veulent continuer à exécuter ce code ; voyez comment connecter votre propre agent IA à WhatsApp.

Pas à pas : un agent OpenAI Agents SDK sur WhatsApp

1. Ajouter un AI Harness

Ajoutez un AI Harness dans MonoChat et choisissez OpenAI Agents SDK comme fournisseur. Il s’exécute dans MonoChat et utilise les modèles IA que vous avez déjà configurés : aucune clé ni aucun serveur supplémentaire pour cette étape.

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

Dans le parcours qui reçoit vos conversations WhatsApp, ajoutez un nœud Agent IA et sélectionnez le harness. Rédigez les instructions de l’agent : qui il sert, ce qu’il peut faire, ce qu’il ne doit jamais faire et quand il passe le relais.

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

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

• Le modèle principal raisonne et rédige les réponses.
• Le modèle de secours prend le relais après une limite souple ou une défaillance.
• Le modèle rapide prend en charge les tâches de fond.

Ajoutez une limite de budget par exécution pour qu’une conversation inhabituelle ne fasse pas grimper la facture. Vous ne savez pas comment choisir le modèle de secours ? Lisez pourquoi votre agent IA en contact avec les clients a besoin d’un modèle de secours.

4. Connecter vos outils

Donnez à l’agent les outils qui correspondent à vos demandes les plus fréquentes :

• Les outils de fonctions IA pour appeler vos propres API avec des entrées structurées.
• L’intégration MCP pour les outils de systèmes compatibles MCP.
• La base de connaissances IA pour des réponses fondées sur vos documents et vos politiques.
• Les fonctions personnalisées pour la logique qui s’exécute pendant la conversation.

Trois bons outils valent mieux que quinze outils à moitié testés. Ajoutez-en d’autres une fois que vous avez vu de vraies conversations.

5. Connecter WhatsApp (et tout le reste)

Connectez votre numéro WhatsApp Business via MonoChat, partenaire commercial officiel de Meta. Le même parcours peut fonctionner sur Instagram, Messenger, TikTok, Telegram, le chat web, les SMS et la voix : un seul agent couvre tous les canaux.

6. Tester avec de vrais messages

Utilisez les conversations du mois dernier comme jeu de test. Incluez les plus difficiles : clients en colère, questions vagues, plusieurs demandes dans un seul message, un client qui demande tout de suite une personne. Vérifiez les appels d’outils, le ton et le passage de relais. Puis mettez en ligne.

Bonnes pratiques sur WhatsApp

Une question par message. Les agents conçus pour le chat web ont tendance à répondre par de longues listes. Sur un téléphone, des messages courts et une question claire à la fois obtiennent de meilleures réponses des clients.

Confirmez avant les actions irréversibles. Laissez l’agent proposer et le client confirmer avant une annulation, un remboursement ou une modification de réservation.

Des spécialistes via les transferts, des personnes via la boîte de réception. Les transferts du SDK sont parfaits pour router entre agents (vente, support, retours). Le passage de relais à une personne relève de la boîte de réception d’équipe partagée de MonoChat, où la conversation arrive avec tout son historique.

Des instructions qui nomment les limites. « Vous pouvez approuver les remboursements jusqu’à 50 € ; au-delà, passez le relais à l’équipe de facturation. » Des chiffres explicites valent mieux que des règles vagues.

Restez dans le périmètre de votre entreprise. Un agent qui aide vos clients est autorisé sur WhatsApp. Un agent qui répond à n’importe quoi risque d’enfreindre les règles 2026 de WhatsApp ; notre guide de la politique WhatsApp sur les chatbots IA explique où se situe la limite.

Coûts

Trois éléments s’additionnent : votre formule MonoChat, l’usage des modèles d’IA et les frais de messages 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 ; voyez notre guide des tarifs de l’API WhatsApp.

Côté IA, MonoChat n’ajoute aucune majoration quand vous utilisez vos propres clés de fournisseur. Des budgets par exécution, un modèle rapide moins coûteux pour les tâches de fond et un modèle de secours fiable rendent la facture prévisible.

Pas d’enfermement

Agent Harness vous laisse choisir le framework, pas seulement le modèle. Si vous voulez plus tard essayer le Claude Agent SDK, Pi, Claude Managed Agents ou votre propre framework, ajoutez un autre AI Harness et pointez le nœud Agent IA dessus. Vos canaux, vos outils et votre passage de relais restent inchangés. Comparez tous les fournisseurs sur la page Agent Harness.