Chapitre 07

Intégrations Make.com

Comment construire des agents IA avec Make.com et Claude API. Architecture, modules clés, gestion des erreurs et templates prêts à l'emploi.

Architecture d'un agent Make + Claude

Un agent IA dans Make.com suit généralement cette structure :

Flux typique
  1. Déclencheur : Webhook, nouveau lead Pipedrive, email reçu, schedule
  2. Collecte de contexte : Récupérer les données du lead, historique, enrichissement
  3. Appel Claude API : Envoyer le contexte + instructions, recevoir la décision/contenu
  4. Parser la réponse : Extraire les informations structurées (JSON)
  5. Action : Mettre à jour le CRM, envoyer un email, créer une tâche
  6. Logging : Tracer l'exécution pour le debug

Modules Make.com essentiels

  • HTTP > Make a request : Appeler l'API Claude/OpenAI
  • JSON > Parse JSON : Extraire les données de la réponse
  • Router : Brancher selon la décision de l'agent
  • Tools > Set variable : Stocker des valeurs intermédiaires
  • Error handler : Gérer les échecs d'API

Configurer le module HTTP pour Claude API

Voici la configuration du module HTTP pour appeler Claude API :

Paramètres de base

  • URL : https://api.anthropic.com/v1/messages
  • Méthode : POST
  • Headers :
    • x-api-key : Votre clé API Anthropic
    • anthropic-version : 2023-06-01
    • content-type : application/json

Corps de la requête (Body)

{
  "model": "claude-3-5-sonnet-20241022",
  "max_tokens": 1024,
  "system": "Tu es un assistant commercial expert en qualification de leads B2B. Tu réponds toujours en JSON valide.",
  "messages": [
    {
      "role": "user",
      "content": "Analyse ce lead et détermine son niveau de qualification : {{lead_data}}"
    }
  ]
}
Astuce
Utilisez le mode « Request content: Raw » dans Make pour avoir un contrôle total sur le JSON envoyé. Le mode formulaire peut mal encoder certains caractères.

Structure des prompts efficaces

La qualité de votre agent dépend largement de vos prompts. Voici une structure éprouvée :

System prompt (personnalité et règles)

Tu es un agent de qualification pour [Nom entreprise], spécialiste en [secteur].

CONTEXTE :
- Notre ICP : [description du client idéal]
- Nos produits : [liste des offres]
- Signaux d'achat : [critères positifs]
- Signaux de disqualification : [critères négatifs]

RÈGLES :
- Réponds UNIQUEMENT en JSON valide
- Ne fais pas d'hypothèses, base-toi sur les données fournies
- Si une information manque, indique "inconnu"

FORMAT DE RÉPONSE :
{
  "score": 0-100,
  "qualification": "hot|warm|cold|disqualifié",
  "raison": "explication en 1 phrase",
  "prochaine_action": "action recommandée"
}

User prompt (données et demande)

Analyse ce lead :

NOM : {{lead.name}}
ENTREPRISE : {{lead.company}}
POSTE : {{lead.title}}
SECTEUR : {{lead.industry}}
EFFECTIF : {{lead.employees}}
SOURCE : {{lead.source}}
MESSAGE : {{lead.message}}

Fournis ton analyse au format JSON.

Gestion des erreurs

Les appels API peuvent échouer. Voici comment gérer les erreurs dans Make :

Erreurs courantes

Code Cause Solution
401 Clé API invalide Vérifier la clé dans les headers
429 Rate limit atteint Ajouter un délai ou retry
500 Erreur serveur Claude Retry automatique après délai
Timeout Réponse trop longue Augmenter le timeout Make, réduire max_tokens

Pattern de retry

  1. Ajouter un Error Handler après le module HTTP
  2. Type : Resume avec Retry
  3. Configurer : 3 tentatives, délai de 10 secondes
  4. Si échec final : envoyer une notification Slack/email

Validation du JSON

Claude peut parfois retourner du JSON invalide. Ajoutez un module JSON > Parse avec un error handler qui :

  • Tente de nettoyer la réponse (supprimer les backticks, le texte avant/après)
  • Relance l'appel avec un prompt plus strict si échec
  • Log l'erreur pour améliorer le prompt

Templates d'agents Make + Claude

🎯 Agent de qualification

Déclencheur : Nouveau lead Pipedrive

Actions : Analyse le lead, attribue un score, met à jour un champ custom, déplace dans le bon pipeline stage

Complexité : ⭐⭐ (intermédiaire)

✉️ Agent de personnalisation email

Déclencheur : Scheduled (batch quotidien)

Actions : Récupère les leads à contacter, enrichit avec Clay API, génère un email personnalisé, pousse vers Smartlead

Complexité : ⭐⭐⭐ (avancé)

📞 Agent de résumé post-call

Déclencheur : Webhook depuis outil de transcription (Grain, Fathom)

Actions : Reçoit la transcription, génère un résumé structuré, extrait les actions, met à jour la note Pipedrive

Complexité : ⭐⭐ (intermédiaire)

🔄 Agent de relance intelligente

Déclencheur : Scheduled (check quotidien)

Actions : Identifie les deals sans activité depuis X jours, analyse le contexte, génère une relance adaptée, crée une tâche ou envoie directement

Complexité : ⭐⭐⭐ (avancé)

Besoin d'aide ?
Je peux vous accompagner dans la création de ces scénarios Make + Claude pour votre contexte spécifique. Réservez un audit gratuit pour en discuter.

Guide complet Make.com