Construire un agent IA service client en 2 heures : tutoriel Claude + n8n

L'agent IA service client est devenu le cas d'usage IA #1 pour les PME marocaines en 2026. La raison est simple : c'est le seul cas d'usage où le ROI est mesurable en moins de 30 jours et où l'investissement initial est sous les 50 000 MAD.

Mais beaucoup d'agences vendent ça comme un projet à 80 000 MAD pour 4 mois. La vérité c'est qu'avec la bonne stack (Claude API + n8n + WhatsApp Business API), tu peux livrer un agent fonctionnel en 2 heures de travail, pour un coût d'API de 250 à 1 200 MAD par mois selon ton volume.

Ce tutoriel te montre comment, étape par étape. Tu peux suivre directement (compétence technique requise : intermédiaire), ou utiliser cet article comme grille de lecture si tu fais le projet avec une agence.

Ce qu'on va construire

Un agent IA conversationnel sur WhatsApp Business qui :

• Répond automatiquement aux questions de FAQ d'un hôtel ou commerce (heures d'ouverture, prix, disponibilités, etc.)
• Qualifie les leads entrants en posant 2-3 questions pertinentes
• Escalade vers un humain quand la question dépasse ses compétences (en envoyant une notification Slack)
• Sauvegarde l'historique des conversations dans Google Sheets pour analyse

Étude de cas réelle : un de nos clients hôtelier à Marrakech (80 chambres) traite 28 % de ses messages WhatsApp entrants entièrement automatiquement avec ce setup. Économie estimée : 22 heures par semaine sur le poste réception.

Stack technique

• Claude Sonnet 4.5 via API Anthropic (~0.003 € par message)
• n8n auto-hébergé ou cloud (compte gratuit OK pour démarrer)
• WhatsApp Business API via Twilio ou Meta directement
• Google Sheets pour le log des conversations
• Slack webhook pour les escalades

Coût mensuel estimé pour 1 000 conversations/mois : 35 € en API Claude + 25 € en WhatsApp + 0 € pour n8n self-hosted = ~60 € / mois.

Étape 1 : Préparation des accès (15 minutes)

Avant de construire le workflow, récupère 4 credentials.

Anthropic API key : crée un compte sur console.anthropic.com, génère une API key dans Settings → API Keys. Crédite 50 € pour démarrer (suffisant pour 2 mois de tests).

WhatsApp Business API : deux options. Soit via Twilio (plus simple à tester, API key sur le dashboard Twilio). Soit via Meta directement (moins cher en production, demande validation business 2-7 jours). Pour le tutoriel, on utilise Twilio.

n8n : si tu pars sur n8n Cloud, compte sur n8n.io (gratuit jusqu'à 5k exécutions/mois). Si tu auto-héberges (recommandé en production), suis le guide Docker officiel.

Google Sheets : crée un nouveau Sheet "WhatsApp Bot Logs" avec colonnes : timestamp, sender, message, response, action_taken (auto/escalated). Active l'API Google Sheets via Google Cloud Console, génère un Service Account JSON.

Étape 2 : Préparation du contexte business (20 minutes)

Cette étape est la plus importante. Un agent IA générique ne marche pas. Tu dois lui donner le contexte précis de ton entreprise.

Crée un document texte avec exactement ces sections :

1. Identité de l'entreprise : nom, secteur, ville, USP en 2 phrases
2. Heures et coordonnées : horaires d'ouverture, téléphone, email, adresse
3. Catalogue produits/services : liste structurée avec prix indicatifs
4. FAQ classique : 15 à 30 questions/réponses les plus fréquentes
5. Règles de qualification leads : si quelqu'un demande un devis, quelles 2-3 questions poser ?
6. Règles d'escalade : quels types de questions escalader vers humain ? (réclamations, devis personnalisés, situations sensibles)
7. Ton de voix : 3 lignes décrivant comment l'agent doit s'exprimer

Ce document fera entre 1 500 et 3 000 mots. C'est le system prompt que tu vas injecter dans Claude à chaque conversation. Plus il est précis et structuré, mieux l'agent répondra.

Exemple pour un hôtel :

# Identité
Riad Al Mamoun - 22 chambres - Médina Marrakech
USP : seul riad avec piscine chauffée toute l'année dans le quartier

# Coordonnées
Horaires : 24h/24 (réception), check-in 14h-22h, check-out avant 11h
Tel : +212 5 24 XX XX XX | Email : booking@almamoun.ma

# Tarifs
- Chambre standard : 850 MAD/nuit (basse saison) → 1 400 MAD/nuit (haute saison)
- Suite : 1 600 → 2 800 MAD/nuit
- Petit-déj inclus dans tous les tarifs

# Règles d'escalade
Escalader si : réclamation explicite, demande groupes >5 chambres, événement privé

# Ton
Professionnel mais chaleureux. Tutoiement seulement si le client tutoie.
Réponses courtes (max 3 phrases). Toujours proposer une action concrète.

Étape 3 : Workflow n8n principal (45 minutes)

Crée un nouveau workflow dans n8n. Structure :

Webhook Twilio (incoming) → Claude API (réponse) → Decision (escalade?)
                                                         ↓ NON
                                                  Twilio (envoi WhatsApp) → Google Sheets (log)
                                                         ↓ OUI
                                                  Slack webhook + Twilio ("un humain te recontacte")

Node 1 : Webhook Twilio. Configure dans Twilio Console → Phone Number → Messaging → Webhook URL = ton n8n URL. Méthode : POST. n8n recevra à chaque message entrant un payload contenant From (numéro), Body (message), MessageSid (id unique).

Node 2 : Claude API call. Type "HTTP Request" dans n8n. URL : https://api.anthropic.com/v1/messages. Méthode POST. Headers : x-api-key: TON_API_KEY, anthropic-version: 2023-06-01, content-type: application/json. Body :

{
  "model": "claude-sonnet-4-5",
  "max_tokens": 500,
  "system": "<TON SYSTEM PROMPT DE L'ÉTAPE 2>\n\nTu réponds aux messages WhatsApp entrants. Si la question dépasse ton contexte ou demande une décision humaine, réponds EXACTEMENT par 'ESCALATE_TO_HUMAN' suivi d'une raison courte. Sinon, réponds en respectant le ton défini.",
  "messages": [
    {"role": "user", "content": "{{$json.Body}}"}
  ]
}

Node 3 : Decision (IF) node. Condition : si la réponse Claude commence par "ESCALATE_TO_HUMAN", aller branche OUI ; sinon branche NON.

Node 4 (branche NON) : Twilio Send Message. Envoie la réponse Claude à From (numéro de l'utilisateur).

Node 5 (branche NON) : Google Sheets Append. Log dans le sheet : timestamp, sender, message reçu, réponse envoyée, "auto".

Node 6 (branche OUI) : Slack Webhook. Notifie l'équipe avec le numéro et le message original. Format : "🚨 Nouveau message à traiter de [number] : '[message]' — Raison escalade : [raison]".

Node 7 (branche OUI) : Twilio Send Message. Réponse au client : "Merci pour ton message. Un membre de notre équipe te recontacte dans l'heure pour mieux te répondre."

Node 8 (branche OUI) : Google Sheets Append. Log : timestamp, sender, message, "escaladé", la raison.

Active le workflow.

Étape 4 : Tests et tuning (30 minutes)

Envoie 10 messages tests au numéro WhatsApp depuis ton téléphone perso :

• 3 questions évidentes de FAQ (heures, prix, adresse) — l'agent doit répondre correctement
• 2 questions ambiguës mais traitables — l'agent doit se débrouiller en s'appuyant sur le contexte
• 2 questions clairement hors scope ("vous faites du tourisme privé en Mauritanie ?") — l'agent doit dire qu'il ne sait pas et proposer une suite
• 2 demandes complexes (devis groupe, réclamation) — doivent être escaladées
• 1 message en arabe ou en darija — vérifier que Claude répond correctement

Pour chaque test qui ne fonctionne pas comme attendu, ajuste le system prompt. Les ajustements typiques :

• Ajouter des exemples explicites pour les cas que Claude rate
• Préciser le format de réponse attendu ("max 3 phrases, toujours finir par une question ou une action")
• Renforcer les règles d'escalade pour éviter les faux positifs

Une fois 80 % des cas testés OK, l'agent est prêt à servir des vrais utilisateurs.

Étape 5 : Mise en production progressive (10 minutes)

Ne bascule pas tout d'un coup. Stratégie recommandée :

Semaine 1 : tous les messages passent encore par humain. L'agent traite les messages en mode "shadow" (génère une réponse mais ne l'envoie pas, log seulement). Tu compares les réponses générées vs réponses humaines pour calibrer.

Semaine 2 : agent envoie automatiquement les réponses pour les questions clairement "easy" (heures, prix, adresse). Le reste reste humain.

Semaine 3-4 : élargissement progressif. Tu surveilles les Google Sheets logs et les retours utilisateurs.

Semaine 5+ : régime de croisière. Agent traite 60-80 % du volume, équipe humaine se concentre sur les escalades et la relation client à valeur ajoutée.

Coûts réels constatés en production

Nos données 2025 sur 5 clients déployés avec ce setup :

• Volume moyen : 800 à 1 500 conversations par mois
• Coût API Claude : 25 à 60 € par mois
• Coût WhatsApp Business : 15 à 45 € par mois (selon volume et conversations initiées vs reçues)
• Coût n8n : 0 € (auto-hébergé) ou 20 € (cloud Pro)
• Total : 40 à 125 € par mois

ROI moyen sur les 5 clients : 18 à 28 % des messages traités automatiquement, soit 18 à 35 heures par semaine économisées sur les postes service client / réception. Le break-even est atteint en 2 à 4 semaines.

Erreurs à éviter

Erreur n°1 : ne pas faire la phase shadow (semaine 1). Si tu bascules direct en automatique, tu vas mécontenter des clients sur les 5 % de réponses ratées avant d'avoir calibré.

Erreur n°2 : system prompt trop court. 500 mots ne suffisent pas pour un service client efficace. Compte 1 500 à 3 000 mots avec FAQ détaillée et exemples concrets.

Erreur n°3 : pas de mécanique d'escalade claire. Si l'agent essaie de tout traiter sans jamais passer la main, les clients agacés vont contourner par téléphone et tu perds la confiance.

Erreur n°4 : pas de monitoring continu. Le contexte business évolue (nouveaux produits, nouvelles questions saisonnières). Sans relecture mensuelle des logs et mise à jour du system prompt, l'agent perd en pertinence en 3-6 mois.

Klicky a déployé ce type de setup chez plusieurs clients marocains depuis 2023. Si tu veux gagner du temps en passant par nous (setup en 1 semaine, formation, prompts pré-tunés pour ton secteur), le formulaire est sur klicky.ma/discuter-projet.